1# 蓝牙服务子系统错误码 2 3<!--Kit: Connectivity Kit--> 4<!--Subsystem: Communication--> 5<!--Owner: @enjoy_sunshine--> 6<!--Designer: @chengguohong; @tangjia15--> 7<!--Tester: @wangfeng517--> 8<!--Adviser: @zhang_yixin13--> 9 10> **说明：** 11> 12> 以下仅介绍本模块特有错误码，通用错误码请参考[通用错误码说明文档](../errorcode-universal.md)。 13 14## 2900001 15 16**错误信息** 17 18Service stopped. 19 20**错误描述** 21 22蓝牙服务已停止，蓝牙服务相关的接口无法调用。 23 24**可能原因** 25 26蓝牙服务启动异常。 27 28**处理步骤** 29 30重新执行打开或关闭蓝牙。 31 32## 2900003 33 34**错误信息** 35 36Bluetooth disabled. 37 38**错误描述** 39 40蓝牙开关已关闭。 41 42**可能原因** 43 44蓝牙开关已关闭。 45 46**处理步骤** 47 48重新执行打开蓝牙开关。 49 50## 2900004 51 52**错误信息** 53 54Profile not supported. 55 56**错误描述** 57 58配置文件是不支持的。 59 60**可能原因** 61 62该配置文件在当前设备环境不支持。 63 64**处理步骤** 65 66检查设备是否支持该配置文件功能，若不支持则停止调用。 67 68## 2900005 69 70**错误信息** 71 72Device not connected. 73 74**错误描述** 75 76该设备蓝牙未连接。 77 78**可能原因** 79 80设备配对异常。 81 82**处理步骤** 83 84重新打开蓝牙开关，执行配对流程。 85 86## 2900006 87 88**错误信息** 89 90The maximum number of connections has been reached. 91 92**错误描述** 93 94超过最大连接数量。 95 96**可能原因** 97 98超出设备最大连接数量。 99 100**处理步骤** 101 102检查已配对设备数量，是否超出阈值。 103 104## 2900007 105 106**错误信息** 107 108Asynchronous interface invoking timeout. 109 110**错误描述** 111 112异步接口调用超时。 113 114**可能原因** 115 116远端设备无响应。 117 118**处理步骤** 119 120超时后重试；若和远端设备存在链路，可以断开后，再重试。 121 122## 2900008 123 124**错误信息** 125 126The value of proxy is a null pointer. 127 128**错误描述** 129 130pimpl或proxy为空。 131 132**可能原因** 133 134设备配对异常。 135 136**处理步骤** 137 138重新打开蓝牙开关，执行配对流程。 139 140## 2900009 141 142**错误信息** 143 144Fails to start scan as it is out of hardware resources. 145 146**错误描述** 147 148由于硬件资源不足，无法启动本次扫描。 149 150**可能原因** 151 152当前系统中本应用或其他应用已启动的扫描通道过多，导致硬件资源不足。 153 154**处理步骤** 155 156本应用未启动过扫描，可重新关开蓝牙，释放其他应用占用的扫描资源； 157本应用已启动过其他通道的扫描，可调用停止扫描接口，停止其他已启动的扫描，释放硬件资源后再重新启动本次扫描。 158 159## 2900010 160 161**错误信息** 162 163Resources have reached the upper limit. 164 165**错误描述** 166 167资源达到上限。 168 169**可能原因** 170 171应用申请资源过多，需要释放资源。 172 173**处理步骤** 174 175调用对应接口释放资源。 176 177## 2900011 178 179**错误信息** 180 181The operation is busy. The last operation is not complete. 182 183**错误描述** 184 185操作忙碌，上一个执行的操作还未完成。 186 187**可能原因** 188 189上一个执行的操作还未完成即执行本次操作，例如[readCharacteristicValue](js-apis-bluetooth-ble.md#readcharacteristicvalue)未结束即进行下一次操作。 190其他涉及的接口有[writeCharacteristicValue](js-apis-bluetooth-ble.md#writecharacteristicvalue)、[readDescriptorValue](js-apis-bluetooth-ble.md#readdescriptorvalue)、[writeDescriptorValue](js-apis-bluetooth-ble.md#writedescriptorvalue)、[getRssiValue](js-apis-bluetooth-ble.md#getrssivalue)、[setCharacteristicChangeNotification](js-apis-bluetooth-ble.md#setcharacteristicchangenotification)、[setCharacteristicChangeIndication](js-apis-bluetooth-ble.md#setcharacteristicchangeindication)，如调用未完成均可能阻塞下一次操作。 191 192**处理步骤** 193 194异步接口需等待callback或promise返回后再执行下一次操作。 195 196## 2900013 197 198**错误信息** 199 200The user does not respond. 201 202**错误描述** 203 204用户未回复前置操作。 205 206**可能原因** 207 208用户在一定时间内未执行规定操作，导致前置操作超时。 209 210**处理步骤** 211 212重新执行前置操作。 213 214## 2900014 215 216**错误信息** 217 218User refuse the action. 219 220**错误描述** 221 222用户执行拒绝操作。 223 224**可能原因** 225 226用户拒绝前置操作的请求。 227 228**处理步骤** 229 230重新执行前置操作。 231 232## 2900099 233 234**错误信息** 235 236Operation failed. 237 238**错误描述** 239 240操作失败。 241 242**可能原因** 243 244该配置文件在当前设备环境不支持。 245 246**处理步骤** 247 248请重试该操作。 249 250## 2900100 251 252**错误信息** 253 254IPC failed. 255 256**错误描述** 257 258IPC 数据传输失败。 259 260**可能原因** 261 262数据传入异常。 263 264**处理步骤** 265 266请检查传入数据。 267 268## 2901000 269 270**错误信息** 271 272Read forbidden. 273 274**错误描述** 275 276禁止读操作。 277 278**可能原因** 279 280无读操作权限。 281 282**处理步骤** 283 284检查是否有读操作权限。 285 286## 2901001 287 288**错误信息** 289 290Write forbidden. 291 292**错误描述** 293 294禁止写操作。 295 296**可能原因** 297 298无写操作权限。 299 300**处理步骤** 301 302检查是否有写操作权限。 303 304## 2901003 305 306**错误信息** 307 308The connection is not established. 309 310**错误描述** 311 312GATT未连接。 313 314**可能原因** 315 316GATT处于未连接的状态下执行操作，例如调用[getServices](js-apis-bluetooth-ble.md#getservices)和[readCharacteristicValue](js-apis-bluetooth-ble.md#readcharacteristicvalue)。 317 318**处理步骤** 319 320确保GATT处于已连接的状态。 321 322## 2901004 323 324**错误信息** 325 326The connection is congested. 327 328**错误描述** 329 330GATT处于拥塞状态。 331 332**可能原因** 333 334读写特征值或描述符过于频繁，导致底层数据传输拥塞，例如入参[GattWriteType](js-apis-bluetooth-ble.md#gattwritetype)为WRITE_NO_RESPONSE的[writeCharacteristicValue](js-apis-bluetooth-ble.md#writecharacteristicvalue)接口调用过于频繁可能导致拥塞。 335 336**处理步骤** 337 338降低读写操作频率，如果是WRITE_NO_RESPONSE类型的写数据操作，建议调用间隔控制在50ms以上。 339 340## 2901005 341 342**错误信息** 343 344The connection is not encrypted. 345 346**错误描述** 347 348GATT处于未加密的状态下，执行需要加密权限的特征值或描述符读写操作。此操作是否需要加密由server端特征值或描述符的权限指定。 349 350**可能原因** 351 352GATT加密权限不足。 353 354**处理步骤** 355 356检查GATT是否有加密权限。 357 358## 2901006 359 360**错误信息** 361 362The connection is not authenticated. 363 364**错误描述** 365 366GATT处于未认证的状态下，执行需要认证权限的特征值或描述符读写操作。此操作是否需要加密由server端特征值或描述符的权限指定。 367 368**可能原因** 369 370GATT认证权限不足。 371 372**处理步骤** 373 374检查与对端设备是否配对，是否有认证权限。 375 376## 2901007 377 378**错误信息** 379 380The connection is not authorized. 381 382**错误描述** 383 384GATT处于未授权的状态下，执行需要授权的特征值或描述符读写操作。此操作是否需要授权由server端特征值或描述符的权限指定。 385 386**可能原因** 387 388GATT未授权。 389 390**处理步骤** 391 392检查GATT是否已授权。 393 394## 2901054 395 396**错误信息** 397 398IO error. 399 400**错误描述** 401 402IO传输失败。 403 404**可能原因** 405 406IO传输异常，造成失败。 407 408**处理步骤** 409 410请重试该操作。 411 412## 2902050 413 414**错误信息** 415 416Failed to start scan as Ble scan is already started by the app. 417 418**错误描述** 419 420开启扫描失败。 421 422**可能原因** 423 424Ble扫描已被app开启。 425 426**处理步骤** 427 428检查是否已经开启扫描。 429 430## 2902054 431 432**错误信息** 433 434The length of the advertising data exceeds the upper limit. 435 436**错误描述** 437 438广播报文超过最大长度。 439 440**可能原因** 441 442传统广播报文的最大长度为31字节，超过此长度将返回异常。当前，该长度限制仅适用于传统广播，不包括扩展广播。 443 444**处理步骤** 445 446检查广播报文是否超过最大长度限制。 447 448## 2902055 449 450**错误信息** 451 452Invalid advertising id. 453 454**错误描述** 455 456广播标识符无效。 457 458**可能原因** 459 460传入的广播标识符应为[startAdvertising](js-apis-bluetooth-ble.md#blestartadvertising11)接口返回的值，无效的广播标识符默认为0xFF。 461 462**处理步骤** 463 464检查传入的广播标识符是否为[startAdvertising](js-apis-bluetooth-ble.md#blestartadvertising11)接口返回的有效标识符。 465