mirror of
https://git.kernel.org/pub/scm/bluetooth/bluez.git
synced 2024-11-25 21:24:16 +08:00
100 lines
2.7 KiB
Plaintext
100 lines
2.7 KiB
Plaintext
Cycling Speed and Cadence API description
|
|
*****************************************
|
|
|
|
|
|
Cycling Speed and Cadence Manager hierarchy
|
|
===========================================
|
|
|
|
Service org.bluez
|
|
Interface org.bluez.CyclingSpeedManager1
|
|
Object path [variable prefix]/{hci0,hci1,...}
|
|
|
|
Methods RegisterWatcher(object agent)
|
|
|
|
Registers a watcher to monitor cycling speed and
|
|
cadence measurements.
|
|
|
|
Possible Errors: org.bluez.Error.InvalidArguments
|
|
|
|
UnregisterWatcher(object agent)
|
|
|
|
Unregisters a watcher.
|
|
|
|
Cycling Speed and Cadence Profile hierarchy
|
|
===========================================
|
|
|
|
Service org.bluez
|
|
Interface org.bluez.CyclingSpeed1
|
|
Object path [variable prefix]/{hci0,hci1,...}/dev_XX_XX_XX_XX_XX_XX
|
|
|
|
Methods SetCumulativeWheelRevolutions(uint32 value)
|
|
|
|
Sets cumulative wheel revolutions value if
|
|
Cumulative Wheel Revolutions feature is supported.
|
|
|
|
Possible Errors: org.bluez.Error.NotSupported
|
|
|
|
Properties string Location (optional) [readwrite]
|
|
|
|
Current sensor location, if supported.
|
|
If Multiple Sensor Locations feature is supported,
|
|
this property can be set to one of values read from
|
|
SupportedLocations property.
|
|
|
|
Possible values: "other", "top-of-shoe", "in-shoe",
|
|
"hip", "front-wheel", "left-crank",
|
|
"right-crank", "left-pedal",
|
|
"right-pedal", "front-hub",
|
|
"rear-dropout", "chainstay",
|
|
"rear-wheel", "rear-hub"
|
|
|
|
array{string} SupportedLocations (optional) [readonly]
|
|
|
|
List of locations supported by sensor, only present
|
|
if Multiple Sensor Locations feature is supported.
|
|
|
|
boolean WheelRevolutionDataSupported [readonly]
|
|
|
|
true if sensor can read and set Cumulative Wheel
|
|
Revolutions value, false otherwise.
|
|
|
|
boolean MultipleSensorLocationsSupported [readonly]
|
|
|
|
true if sensor supports Multiple Sensor Locations
|
|
feature and can set Location, false otherwise.
|
|
|
|
Cycling Speed and Cadence Watcher hierarchy
|
|
===========================================
|
|
|
|
Service unique name
|
|
Interface org.bluez.CyclingSpeedWatcher1
|
|
Object path freely definable
|
|
|
|
Methods void MeasurementReceived(object device, dict measurement)
|
|
|
|
This callback is called whenever wheel and/or crank
|
|
revolutions measurement is received from sensor.
|
|
|
|
Measurement:
|
|
|
|
uint32 WheelRevolutions (optional):
|
|
|
|
Cumulative number of wheel revolutions.
|
|
|
|
uint16 LastWheelEventTime (optional):
|
|
|
|
Time of last event from wheel sensor.
|
|
Value is expressed in 1/1024 second
|
|
units and can roll over during a ride.
|
|
|
|
uint16 CrankRevolutions (optional):
|
|
|
|
Cumulative number of crank revolutions.
|
|
This value can occasionally roll over.
|
|
|
|
uint16 LastCrankEventTime (optional):
|
|
|
|
Time of last event from crank sensor.
|
|
Value is expressed in 1/1024 second
|
|
units and can roll over during a ride.
|