​
px4.parameter.cbrk_usb_chk.set

开放平台 PX4 参数命令。PX4 参数：CBRK_USB_CHK 设置 PX4 USB 连接检查的 circuit breaker。0 表示保留 USB 连接检查，197848 表示关闭该检查。 PX4 官方描述里明确建议生产飞行保持 USB 检查开启，避免用户在 USB 供电或 USB 连接状态下飞行。该参数适合研发/HITL 调试，不应默认对普通云端业务开放。

​
请求参数

​
vendor
string
必填
固定 px4
​
device_id
string
必填
目标 PX4 设备 ID
​
command_type
string
必填
固定 px4.parameter.cbrk_usb_chk.set
​
idempotency_key
string
必填
幂等键；重复请求返回同一命令
​
timeout_seconds
integer
超时秒数，范围 0~300
​
payload
object
必填
CbrkUsbChkSetRequest
​
payload.value
integer
必填
参数值，范围 0~197848；推荐生产值为 0

​
PX4 帧映射

  • PX4 source: docs/px4/build/px4_sitl_default/parameters.json
  • PX4 handler: docs/px4/src/modules/mavlink/mavlink_parameters.cpp
  • PX4 parameter: CBRK_USB_CHK
  • Category: Developer
  • Group: Circuit Breaker
  • Parameter type: int32
  • Default: 197848
  • Range: 0~197848
  • Reboot required: no
  • Cloud write policy: guarded allowlist only
  • MAVLink frame: PARAM_SET
  • Message ID: 23
  • Guard: PX4_PARAMETER_WRITE_ALLOWLIST 必须包含 CBRK_USB_CHK

​
创建响应

​
command_id
string
平台命令 ID，用于后续查询
​
status
string
受理状态：ACCEPTED
​
accepted_at
string(datetime)
命令受理时间（UTC）

​
查询响应

​
status
string
执行状态：ACCEPTED / DELIVERED / SUCCEEDED / FAILED / TIMED_OUT / UNMATCHED_RESPONSE
​
vendor_response
object
CbrkUsbChkSetResponse 摘要，包含 PARAM_VALUE 或 PARAM_ERROR 结果
{
  "vendor": "px4",
  "device_id": "px4-real-1",
  "command_type": "px4.parameter.cbrk_usb_chk.set",
  "payload": {
    "value": 0
  },
  "idempotency_key": "req-set-CBRK_USB_CHK-001",
  "timeout_seconds": 30
}

{
  "command_id": "8cdb5bf3-8902-c5f7-f9aa-dc7fa0af1de0",
  "status": "SUCCEEDED",
  "vendor": "px4",
  "device_id": "px4-real-1",
  "command_type": "px4.parameter.cbrk_usb_chk.set",
  "response_code": "PARAM_VALUE",
  "response_message": "parameter value confirmed",
  "vendor_response": {
    "message": "PARAM_VALUE",
    "param_id": "CBRK_USB_CHK",
    "value": 0,
    "value_type": "int32"
  }
}