System Internals¶
pypack.system contains the runtime transport and state machinery used by the
SDK. These types are documented here so cross-references from controller and
telemetry models resolve cleanly.
Data Center¶
datacenter
¶
PlaneType
module-attribute
¶
PlaneType = Enum('PlaneType', ('Height', 'Yaw', 'PlaneX', 'PlaneY', 'PlaneZ', 'TimeToken', 'AuxToken', 'Battery', 'RangeSafe', 'TakeoffAllow', 'LocationSensor', 'DanceX', 'DanceY', 'DanceZ', 'RealDanceMD5', 'DanceName', 'Time', 'Rgb_status', 'Socket', 'Address'))
UwbType
module-attribute
¶
UwbType = Enum('UwbType', ('DemarcateState', 'Station0_X', 'Station0_Y', 'Station0_Z', 'Station1_X', 'Station1_Y', 'Station1_Z', 'Station2_X', 'Station2_Y', 'Station2_Z', 'Station3_X', 'Station3_Y', 'Station3_Z'))
SysType
module-attribute
¶
DataCenter
¶
get_flight_data
¶
get_flight_data(drone_id: int = 0) -> FlightData | None
Get typed flight telemetry data.
Parameters:
| Name | Type | Description | Default |
|---|---|---|---|
drone_id
|
int
|
Drone ID (default 0) |
0
|
Returns:
| Type | Description |
|---|---|
FlightData | None
|
FlightData model or None if not available |
get_battery_percent
¶
Get battery percentage.
Parameters:
| Name | Type | Description | Default |
|---|---|---|---|
drone_id
|
int
|
Drone ID (default 0) |
0
|
Returns:
| Type | Description |
|---|---|
int | None
|
Battery percentage (0-100) or None if not available |
get_obstacles
¶
get_obstacles(drone_id: int = 0) -> Obstacles
Get obstacle detection state.
Parameters:
| Name | Type | Description | Default |
|---|---|---|---|
drone_id
|
int
|
Drone ID (default 0) |
0
|
Returns:
| Type | Description |
|---|---|
Obstacles
|
Obstacles model (empty if no data) |
get_drone_status
¶
Get drone status from heartbeat.
Parameters:
| Name | Type | Description | Default |
|---|---|---|---|
drone_id
|
int
|
Drone ID (default 0) |
0
|
Returns:
| Type | Description |
|---|---|
int | None
|
Drone status code or None if not available |
is_drone_ready
¶
Check if drone is in ready state.
Parameters:
| Name | Type | Description | Default |
|---|---|---|---|
drone_id
|
int
|
Drone ID (default 0) |
0
|
Returns:
| Type | Description |
|---|---|
bool
|
True if drone is ready (status == 2) |
has_telemetry
¶
Check if telemetry data is available.
Parameters:
| Name | Type | Description | Default |
|---|---|---|---|
drone_id
|
int
|
Drone ID (default 0) |
0
|
Returns:
| Type | Description |
|---|---|
bool
|
True if flight_data exists |
has_heartbeat
¶
Check if heartbeat data is available.
Parameters:
| Name | Type | Description | Default |
|---|---|---|---|
drone_id
|
int
|
Drone ID (default 0) |
0
|
Returns:
| Type | Description |
|---|---|
bool
|
True if heartbeat exists |