设置 RS485 波特率

设置支持该能力的设备的 RS485 波特率。设置后，RS485 从站应使用相同波特率。

端点与权限

PUT /wlte/v1/devices/{deviceId}/rs485/baud-rate

需要 device:config。

请求

PUT {baseUrl}/wlte/v1/devices/{deviceId}/rs485/baud-rate
Authorization: Bearer {accessToken}
Content-Type: application/json
Idempotency-Key: <调用方生成的唯一字符串>

{
  "baudRate": 9600
}

curl 示例：

curl --request PUT '{baseUrl}/wlte/v1/devices/{deviceId}/rs485/baud-rate' \
  --header 'Authorization: Bearer {accessToken}' \
  --header 'Content-Type: application/json' \
  --header 'Idempotency-Key: <调用方生成的唯一字符串>' \
  --data '{
    "baudRate": 9600
  }'

baudRate 为 1 到 65535 的整数，单位为 bps。

成功响应

{
  "code": "COMMAND_ACCEPTED",
  "message": "Command accepted.",
  "requestId": "req_001",
  "data": {
    "command": {
      "id": "cmd_001",
      "deviceId": "rek053537488",
      "operation": "device.rs485.baudRate.set",
      "status": "SUCCESS",
      "params": {
        "baudRate": 9600
      },
      "result": {
        "baudRate": 9600
      },
      "createdAt": "2026-07-15T08:30:00Z"
    }
  }
}

HTTP 状态码为 202 Accepted。params.baudRate 是请求值；只有设备确认成功时才返回 result.baudRate。TIMEOUT 时不返回 result。

配置修改不会通过 WebSocket 广播。需要确认当前值时，调用 查询设备配置。

新的配置操作使用新 Idempotency-Key；重试同一操作时复用原 key。使用 data.command.id 调用 查询命令结果。

可能返回 INVALID_REQUEST、AUTH_SCOPE_DENIED、DEVICE_NOT_FOUND、DEVICE_BUSY、DEVICE_OFFLINE、IDEMPOTENCY_CONFLICT、COMMAND_REJECTED、RATE_LIMITED、GATEWAY_UNAVAILABLE 或 INTERNAL_ERROR。