BLE SDK

Note

For more information about the used integer types, refer to the source code instead.

Advertisement

class oralb.blesdk.BrushAdvertisement(protocol: ProtocolVersion | int, type: BrushType | int, version: int, state: State | int, status: Any, brush_time_min: int, brush_time_sec: int, brush_mode: Any, brush_progress: int, quadrant_completion: Quadrant | int, total_quadrants: int)

Bluetooth Low Energy advertise sent from oral-b devices.

brush_mode: Any

Specifies the currently used brushing mode. The used enumeration varies based on the current protocol version.

brush_progress: int

This field displays the current brushing progress (no real use-case?)

brush_time_min: int

Defines the current brushing time in minutes

brush_time_sec: int

Defines the current brushing time in seconds

protocol: ProtocolVersion | int

The used protocol version. Note that the packet structure may change according to the version configuration

quadrant_completion: Quadrant | int

describes, which quadrant is currently processed (only during a brushing session)

state: State | int

Describes the current state of the device.

status: Any

In packets using protocol version below V006, this value describes the current pressure measurement. Otherwise, another device status is set.

total_quadrants: int

This fields specifies either the amount of quadrants or (only in V008) a device substate.

type: BrushType | int

the device type (this value conforms to a model identifier and is not the model name)

version: int

the current firmware version

Model Structs

class oralb.blesdk.model.BatteryLevel(level: int, seconds_left: int = None, milli_volts: int = None, milli_amperes: int = None, temperature: int = None, avail_soc: int = None, dcmas: int = None, rcmas: int = None, soc_state: int = None)

class oralb.blesdk.model.Button(state: oralb.blesdk.model.Button.State | int)

class State(value, names=<not given>, *values, module=None, qualname=None, type=None, start=1, boundary=None)

class oralb.blesdk.model.CalibrationData(calibration_x: int, calibration_y: int, calibration_z: int)

class oralb.blesdk.model.Color(red: int, green: int, blue: int, identifier: int)

Characteristic representing a color.

blue: int

The blue component of the color.

green: int

The green component of the color.

identifier: int

The identifier of the color.

red: int

The red component of the color.

class oralb.blesdk.model.Control(command: int, parameter: int = None)

class DataRead(value, names=<not given>, *values, module=None, qualname=None, type=None, start=1, boundary=None)

class METADATA(value, names=<not given>, *values, module=None, qualname=None, type=None, start=1, boundary=None)

class oralb.blesdk.model.DashboardConfig(session_id: int, divider: oralb.blesdk.model.DashboardConfig.Divider | int)

class Divider(value, names=<not given>, *values, module=None, qualname=None, type=None, start=1, boundary=None)

class oralb.blesdk.model.DashboardData(status: oralb.blesdk.model.DashboardData.Status | int, timestamp: int, gyro_x: int, gyro_y: int, gyro_z: int, motion_x: int, motion_y: int, motion_z: int)

class Status(value, names=<not given>, *values, module=None, qualname=None, type=None, start=1, boundary=None)

class oralb.blesdk.model.DeviceName(text: str)

class oralb.blesdk.model.DeviceState(state: State | int, sub_state: SubState | int)

Represents the state of a device.

class State(value, names=<not given>, *values, module=None, qualname=None, type=None, start=1, boundary=None)

Enumeration representing the main states of the device.

class SubState(value, names=<not given>, *values, module=None, qualname=None, type=None, start=1, boundary=None)

Enumeration representing the sub-states of the device.

state: State | int

The main state of the device.

sub_state: SubState | int

The sub-state of the device.

class oralb.blesdk.model.GyroMotionData(timestamp: int, gyro_x: int, gyro_y: int, gyro_z: int, motion_x: int, motion_y: int, motion_z: int)

class oralb.blesdk.model.HighResolutionMotionData(motion_x: int, motion_y: int, motion_z: int)

class oralb.blesdk.model.MotionData(timestamp: int, motion_x: int, motion_y: int, motion_z: int)

class oralb.blesdk.model.OTACommand(command: oralb.blesdk.model.OTACommand.Command | int)

class Command(value, names=<not given>, *values, module=None, qualname=None, type=None, start=1, boundary=None)

class oralb.blesdk.model.OTAPayload(payload: memoryview)

class oralb.blesdk.model.OTAState(state: oralb.blesdk.model.OTAState.State | int)

class State(value, names=<not given>, *values, module=None, qualname=None, type=None, start=1, boundary=None)

class oralb.blesdk.model.OTATransferSize(value: int)

class oralb.blesdk.model.Pressure(state: oralb.blesdk.model.Pressure.State | int, timestamp_a: int, record_a: int, timestamp_b: int, record_b: int, identifier: int)

class State(value, names=<not given>, *values, module=None, qualname=None, type=None, start=1, boundary=None)

class oralb.blesdk.model.RTC(epochMillis: int = 946684800000)

class oralb.blesdk.model.RefillRemainder(state: oralb.blesdk.model.RefillRemainder.State | int, days_left: int, brushing_seconds_left: int)

class State(value, names=<not given>, *values, module=None, qualname=None, type=None, start=1, boundary=None)

class oralb.blesdk.model.SensorData

class Data(value, names=<not given>, *values, module=None, qualname=None, type=None, start=1, boundary=None)

decode(parsed: bytes, context) → None

Decode data using the wrapped _StructLike object.

Parameters:

• parsed – The parsed data to be decoded.

• context – The current context.

Returns:

The decoded data.

encode(obj, context) → bytes

Encode data using the wrapped _StructLike object.

Parameters:

• obj – The original data to be encoded.

• context – The current context.

Returns:

The encoded data.

class oralb.blesdk.model.Smiley(face: oralb.blesdk.model.Smiley.Face | int)

class Face(value, names=<not given>, *values, module=None, qualname=None, type=None, start=1, boundary=None)

class oralb.blesdk.model.Timezone(zone: int)

class oralb.blesdk.model.TongueTime(duration: int)

class oralb.blesdk.model.UserID(id_: int)

Characteristic representing a user ID.

id_: int

The user ID.

oralb.blesdk.model.make_uuid(cid: str) → str

Generates a uuid from the given short uuid

oralb.blesdk.model.register(cid: str, model) → None

Registers a new struct type to the given uuid

Metadata Structs

class oralb.blesdk.metadata.BLEProfile(*, magic: int = 6, prefix_bootloader: str, num_bootloader: int, build_bootloader: int, prefix_sec_program: str, num_sec_program: int, build_sec_program: int)

class oralb.blesdk.metadata.DeviceUUID(id: uuid.UUID)

class oralb.blesdk.metadata.ServiceDataA(ideal_full_capacity: int, average_motor_current: int, total_monitor_runtime: int, total_pressure: int, total_charge_time: int)

class oralb.blesdk.metadata.ServiceDataB(total_charge_events: int, total_full_charge_events: int, total_over_temp_Events: int, total_low_temp_events: int, total_brushing_cycles: int, short_term_motor_current: int, total_recharging_hours: int)

class oralb.blesdk.metadata.SonosMetadata(*, magic: int = 255, model: oralb.blesdk.metadata.SonosMetadata.Model | int, color: oralb.blesdk.metadata.SonosMetadata.Color | int, language: oralb.blesdk.metadata.SonosMetadata.Language | int, brush_modes: List[int], gum_guard: oralb.blesdk.metadata.SonosMetadata.GumGuard | int)

class Color(value, names=<not given>, *values, module=None, qualname=None, type=None, start=1, boundary=None)

class GumGuard(value, names=<not given>, *values, module=None, qualname=None, type=None, start=1, boundary=None)

class Language(value, names=<not given>, *values, module=None, qualname=None, type=None, start=1, boundary=None)

class Model(value, names=<not given>, *values, module=None, qualname=None, type=None, start=1, boundary=None)

class oralb.blesdk.metadata.SystemController1(*, magic: int = 7, media_content_version: int, hardware_config: int, mmap_version: int, info_sector_version: int)

class oralb.blesdk.metadata.SystemController2(*, magic: int = 7, version: int)

Client