src.bluetooth_sig.gatt.characteristics.fitness_machine_control_point

Fitness Machine Control Point characteristic (0x2AD9).

Classes

Name

Description

FitnessMachineControlPointCharacteristic

Fitness Machine Control Point characteristic (0x2AD9).

FitnessMachineControlPointData

Parsed data from Fitness Machine Control Point characteristic.

FitnessMachineControlPointOpCode

Fitness Machine Control Point operation codes per FTMS specification.

FitnessMachineResultCode

Fitness Machine Control Point result codes per FTMS specification.

Module Contents

class src.bluetooth_sig.gatt.characteristics.fitness_machine_control_point.FitnessMachineControlPointCharacteristic

Bases: src.bluetooth_sig.gatt.characteristics.base.BaseCharacteristic[FitnessMachineControlPointData]

Fitness Machine Control Point characteristic (0x2AD9).

org.bluetooth.characteristic.fitness_machine_control_point

Used for control and configuration of fitness machines. Provides commands for starting, stopping, and setting targets.

allow_variable_length = True
min_length = 1
class src.bluetooth_sig.gatt.characteristics.fitness_machine_control_point.FitnessMachineControlPointData

Bases: msgspec.Struct

Parsed data from Fitness Machine Control Point characteristic.

The parameter field contains opcode-specific data as raw bytes, or None for opcodes with no parameters.

op_code: FitnessMachineControlPointOpCode
parameter: bytes | None = None
response_op_code: FitnessMachineControlPointOpCode | None = None
result_code: FitnessMachineResultCode | None = None
class src.bluetooth_sig.gatt.characteristics.fitness_machine_control_point.FitnessMachineControlPointOpCode

Bases: enum.IntEnum

Fitness Machine Control Point operation codes per FTMS specification.

REQUEST_CONTROL = 0
RESET = 1
RESPONSE_CODE = 128
SET_INDOOR_BIKE_SIMULATION_PARAMETERS = 17
SET_TARGETED_CADENCE = 20
SET_TARGETED_DISTANCE = 12
SET_TARGETED_EXPENDED_ENERGY = 9
SET_TARGETED_NUMBER_OF_STEPS = 10
SET_TARGETED_NUMBER_OF_STRIDES = 11
SET_TARGETED_TIME_IN_FIVE_HEART_RATE_ZONES = 16
SET_TARGETED_TIME_IN_THREE_HEART_RATE_ZONES = 15
SET_TARGETED_TIME_IN_TWO_HEART_RATE_ZONES = 14
SET_TARGETED_TRAINING_TIME = 13
SET_TARGET_HEART_RATE = 6
SET_TARGET_INCLINATION = 3
SET_TARGET_POWER = 5
SET_TARGET_RESISTANCE_LEVEL = 4
SET_TARGET_SPEED = 2
SET_WHEEL_CIRCUMFERENCE = 18
SPIN_DOWN_CONTROL = 19
START_OR_RESUME = 7
STOP_OR_PAUSE = 8
class src.bluetooth_sig.gatt.characteristics.fitness_machine_control_point.FitnessMachineResultCode

Bases: enum.IntEnum

Fitness Machine Control Point result codes per FTMS specification.

CONTROL_NOT_PERMITTED = 5
INVALID_PARAMETER = 3
OPERATION_FAILED = 4
OP_CODE_NOT_SUPPORTED = 2
SUCCESS = 1