ArduinoBLE函数库中文.docx

1、ArduinoBLE函数库中文Arduino-BLE-函数库中文备注：Arduino Function:BLEPeripheral.connected()（缺失）Arduino BLE 函数库描述蓝牙低功耗（BLE）协议从蓝牙规范版本4.0开始。虽然以前的规范只允许制作一种无线UART，但该版本允许更智能的资源使用。结果是适用于大多数具有限制能量需求的芯片的低功率通信。BLE协议由多个角色组成。 BLE节点可以作为外设，中央，广播和观察者。广播角色周期性地发送具有数据的广告包。它不支持建立连接。理论上，广播机构的角色可以用于仅发射机的无线电。观察者角色收听来自广播对等体的广告数据包中嵌入的数据

2、。中心是能够建立到对等体的多个连接的设备。中心角色始终是连接的发起者，并且基本上允许设备进入网络。外设使用广告包来允许中心找到它，并且随后建立与之的连接。 BLE协议经过优化，至少在处理能力和内存方面要求极少的外设实现资源。中央和外围设备不得与客户端和服务器错误。他们之间没有联系。中央和外围设备可以是客户机，服务器或两者，具体取决于应用数据结构BLE数据结构分层组成。 属性是定义的最小数据实体。 属性被分组到服务中，每个服务可以包含零个或多个特征。 这些特征又可以包括零个或多个描述符。每个服务，特征和描述符都由UUID标识。通用唯一标识符（UUID）是保证（或具有高概率）的全局唯一的128位（

3、16字节）数字。您可以定义自己的UUID或使用标准的UUID。每个属性都可以有权限。权限是指定可以对每个特定属性执行哪些操作以及具体安全要求的元数据。广告包（广播包）广告包是周边中心知道可用的方式。 在广告包中有关于外设的主要信息。 广告包长度为31字节，并且必须符合减少内部有效信息数量的特定格式。 如果中心想要进一步的信息，它可以发送一个扫描请求来请求另一个称为扫描响应的数据包，以便拥有其他31字节的信息。 如果您没有足够的数据传输，并且31字节（或62个最终）广告数据包就足够了，您可以实现广播者角色并传输数据，而无需建立连接。 如果您有更多的数据要传输，则必须执行外设角色进行传输。有关广告

4、包的进一步信息可以在此链接中找到，其中包含对此参数的基本介绍。更多信息在本节中，我们尝试简要介绍BLE标准。然而，BLE标准比这更广泛。如果你想加深一些争论，那里是链接到BLE标准规范：有关BLE的其他有用信息及其在nRF52上的工作方式可以在北欧半导体网站上找到：北欧还提供了一个有用的应用程序，通过BLE与您的板进行交互。使用此应用程序可以读写特性并调试BLE通信：相关功能这个库由多个类组成：BLEPeripheralRole（或BLEPeripheral）用于启用具有外设角色的BLE模块BLECentralRole用于使BLE模块具有中心作用表示外设连接的设备的BLECentralPeer

5、（或BLECentral）表示中央连接的设备的BLEPeripheralPeerBLEService用于启用电路板提供的服务BLECharacteristic用于实现电路板提供的特性BLED描述符用于描述其所指的特征由arduino.org撰写函数介绍BLE：BLEPeripheralRoleBLEPeripheralRole是BLE库的一部分，允许您使用BLE来让您的电路板充当外设和广播角色。该库由Sandeep Mistry的BLEPeripheral库导出。 该类的旧名称已被维护，以保持与该库完全兼容。 这意味着该类可以称为BLEPeripheralRole或BLEPeripheral

6、indistinclty。Arduino Function: BLEPeripheral Constructor名称BLEPeripheral描述BLEPeripheral类的构造方法句法BLEPeripheral blePeripheral = BLEPeripheral（）;参数无void返回没有Arduino Function: BLEPeripheral.begin名称begin描述开始初始化BLEPeripheral对象并开始广告。句法blePeripheral.begin（）;参数无void返回没有Arduino Function: BLEPeripheral.poll名称轮询描述

7、为事件对广播进行轮询（询问）句法blePeripheral.poll（）;参数空虚返回没有注意此功能仅为了向后兼容而保留。 即使未调用此功能，所有BLE事件都将被转发。Arduino Function: BLEPeripheral.end名称结束描述断开连接中央，停止广告，并禁用广播。句法blePeripheral.end（）;参数空虚返回没有Arduino Function: BLEPeripheral.setAdvertisedServiceUuidsetServiceSolicitationUuid描述发布服务的UUID作为参数传递。服务请求的用途是指示外设希望通过具有该特定服务的设备来

8、连接。句法blePeripheral.setServiceSolicitationUuid（UUID）;参数uuid：const char *。 要广播的UUID返回没有注意您可以多次调用此功能来发布多个UUID。 由于广告包长度，广告UUID的最大数量有限制。 广告包的最大长度为62字节（分为广告包的31个字节和扫描响应包的31个字节），因此广告的UUID的最大数量被这个限制所限制，其他的你可能想要做广告 作为设备名称，外观等）。Arduino Function: BLEPeripheral.setServiceSolicitationUuid名称setServiceSolicitation

9、Uuid描述发布服务的UUID作为参数传递。 服务请求的用途是指示外设希望通过具有该特定服务的设备来连接。句法blePeripheral.setServiceSolicitationUuid（UUID）;参数uuid：const char *。 要广告的UUID返回没有Arduino Function: BLEPeripheral.setManufacturerData名称setManufacturerData描述使用广告包发送个性化数据。句法blePeripheral.setManufacturerData（manufacturerData，dataLength）;参数manufacture

10、rData：const unsigned char 。 要发布的字节数组。dataLength：数组长度，最多26字节。返回没有Arduino Function: BLEPeripheral.setLocalName名称setLocalName描述设置将为该设备发布的本地名称。句法blePeripheral.setLocalName（“本地名”）;参数const char *返回没有Arduino Function: BLEPeripheral.setAdvertisingInterval名称setAdvertisingInterval描述设置广告间隔为毫秒，默认为100毫秒。句法blePer

11、ipheral.setAdvertisingInterval（MS）;参数ms：unsigned short。 两个广告包之间的间隔返回没有Arduino Function: BLEPeripheral.setConnectionInterval名称setConnectionInterval描述配置在与Central连接期间使用的参数。句法blePeripheral.setConnectionInterval（minimumConnectionInterval，maximumConnectionInterval）;参数minimumConnectionInterval：unsigned sho

12、rt。 最小连接间隔，以1.25 ms为增量。maximumConnectionInterval：unsigned short。 最大连接间隔，以1.25 ms为增量。Arduino Function: BLEPeripheral.setTxPower名称setTxPower描述将TX功率设置为dBm，默认值为0 dBm。句法blePeripheral.setTxPower（TXPOWER）;参数txPower：int。 TX功率（dBm）。返回 bool：成功之后，否则为false。注意只能精确地设置某些值，否则使用下一个可设置值：-40，-30，-20，-16，-12，-8，-4，0，4A

13、rduino Function: BLEPeripheral.setConnectable名称setConnectable描述使外设可连接（*默认*）或不可连接（仅限广播）。句法blePeripheral.setConnectable（连接）;参数可连接：bool。 如果您希望板可连接，则为真，否则为false。返回没有Arduino Function: BLEPeripheral.setBondStore名称setBondStore描述使用作为参数传递的bond store作为连接的绑定数据。句法blePeripheral.setBondStore（bondStore）;参数bondStor

14、e：BLEBondStore。 BLEBondStore对象返回没有Arduino Function: BLEPeripheral.enableBond名称enableBond描述启用bonding并配置要使用的粘合类型。一旦bonding过程完成，bond数据将被永久保存，即使在断电后，即使与同一远程对等体进一步连接，设备也将被bond。要删除bond信息，请参阅clearBondStoreData函数。句法blePeripheral.enableBond（bondType）;参数bondType：BLEBondingType- 值：JUST_WORKS，DISPLAY_PASSKEY，返回

15、没有注意如果未选择参数，则将选择默认参数（JUST_WORKS）Arduino Function: BLEPeripheral.clearBondStoreData名称clearBondStoreData描述清除债券数据。句法bleHIDPeripheral.clearBondStoreData（）;参数空虚返回没有Arduino Function: BLEPeripheral.getPasskey名称getPasskey描述用于获得必须在本地确认或插入中央设备的绑定过程中生成的密钥的功能（取决于使用enableBond（）函数选择的绑定类型），以便完成绑定。句法blePeripheral.g

16、etPasskey（）;参数空虚返回 char *：生成密钥。Arduino Function: BLEPeripheral.sendPasskey名称sendPasskey描述发送其他设备生成的密钥以完成绑定过程的功能。句法blePeripheral.sendPasskey（passkey）;参数passkey：char passkey 。 包含密码的字符数组。返回没有Arduino Function: BLEPeripheral.setDeviceName名称setDeviceName描述设置设备的名称。句法setDeviceName(deviceName);参数deviceName：co

17、nst char *。 设备名称返回没有Arduino Function: BLEPeripheral.setAppearance名称setAppearance描述设置董事会发布的外观。句法blePeripheral.setAppearance（appearance）;参数appearance：unsigned short. 外观要广告。参数：BLE_APPEARANCE_UNKNOWNBLE_APPEARANCE_GENERIC_PHONEBLE_APPEARANCE_GENERIC_COMPUTERBLE_APPEARANCE_GENERIC_WATCHBLE_APPEARANCE_WAT

18、CH_SPORTS_WATCHBLE_APPEARANCE_GENERIC_CLOCKBLE_APPEARANCE_GENERIC_DISPLAYBLE_APPEARANCE_GENERIC_REMOTE_CONTROLBLE_APPEARANCE_GENERIC_EYE_GLASSESBLE_APPEARANCE_GENERIC_TAGBLE_APPEARANCE_GENERIC_KEYRINGBLE_APPEARANCE_GENERIC_MEDIA_PLAYERBLE_APPEARANCE_GENERIC_BARCODE_SCANNERBLE_APPEARANCE_GENERIC_THER

19、MOMETERBLE_APPEARANCE_THERMOMETER_EARBLE_APPEARANCE_GENERIC_HEART_RATE_SENSORBLE_APPEARANCE_HEART_RATE_SENSOR_HEART_RATE_BELTBLE_APPEARANCE_GENERIC_BLOOD_PRESSUREBLE_APPEARANCE_BLOOD_PRESSURE_ARMBLE_APPEARANCE_BLOOD_PRESSURE_WRISTBLE_APPEARANCE_GENERIC_HIDBLE_APPEARANCE_HID_KEYBOARDBLE_APPEARANCE_HI

20、D_MOUSEBLE_APPEARANCE_HID_JOYSTICKBLE_APPEARANCE_HID_GAMEPADBLE_APPEARANCE_HID_DIGITIZERSUBTYPEBLE_APPEARANCE_HID_CARD_READERBLE_APPEARANCE_HID_DIGITAL_PENBLE_APPEARANCE_HID_BARCODEBLE_APPEARANCE_GENERIC_GLUCOSE_METERBLE_APPEARANCE_GENERIC_RUNNING_WALKING_SENSORBLE_APPEARANCE_RUNNING_WALKING_SENSOR_

21、IN_SHOEBLE_APPEARANCE_RUNNING_WALKING_SENSOR_ON_SHOEBLE_APPEARANCE_RUNNING_WALKING_SENSOR_ON_HIPBLE_APPEARANCE_GENERIC_CYCLINGBLE_APPEARANCE_CYCLING_CYCLING_COMPUTERBLE_APPEARANCE_CYCLING_SPEED_SENSORBLE_APPEARANCE_CYCLING_CADENCE_SENSORBLE_APPEARANCE_CYCLING_POWER_SENSORBLE_APPEARANCE_CYCLING_SPEED

22、_CADENCE_SENSOR返回没有Arduino Function: BLEPeripheral.addAttribute名称addAttribute描述向外设添加一个属性。该属性可以是BLEService，BLECharacteristic或BLEDescriptor对象。句法blePeripheral.addAttribute(service）;参数service：BLELocalAttribute。服务，特征或描述符对象。返回没有注意必须按照要求精确订单的BLE标准添加服务，特征和描述符。必须遵循分层BLE数据结构：添加服务后，必须先添加其所有特性才能添加连续服务。以相同的方式，一旦

23、添加了特征，就必须先添加其所有描述符以添加连续的特征。例如，如果您有两个服务具有一定数量的特征，具有一定数量的描述符，则相对代码将是：/添加具有三个特征的第一个服务blePeripheral.addAttribute（serviceNoOne）;blePeripheral.addAttribute（characteristicOneOfSerivceOne）;blePeripheral.addAttribute（descriptorOne）;blePeripheral.addAttribute（characteristicTwoOfServiceOne）;blePeripheral.addAt

24、tribute（descriptorTwo）;blePeripheral.addAttribute（CharacteristicThreeOfSerivceOne）;/添加具有一个特征的第二个服务blePeripheral.addAttribute（serviceNoTwo）;blePeripheral.addAttribute（characteristicOfServiceTwo）;请注意，一个特征也可以没有描述符，而且一个服务也没有特征。Arduino Function: BLEPeripheral.addRemoteAttribute名称addRemoteAttribute描述当主板用作

25、客户端以指示板要查询到服务器的属性（服务，特性和描述符）时，可以使用此功能。此函数的用法与addAttribute函数相同。 需要遵循BLE标准以正确的顺序插入属性。 请参考addAttribute函数以获取更多信息。句法blePeripheral.addRemoteAttribute（remoteService）;参数remoteService：BLERemoteAttribute。 远程服务，特征或描述符对象。返回没有Arduino Function:BLEPeripheral.connected()（缺失）Arduino Function: BLEPeripheral.disconnec

26、t名称断开描述断开连接中央。句法blePeripheral.disconnect（）;参数空虚返回没有Arduino Function: BLEPeripheral.central名称中央描述返回表示板连接到的中央的BLECentralPeer对象。句法blePeripheral.central（）;参数空虚返回 BLECentralPeer：表示远程中央的对象。Arduino Function: BLEPeripheral.status名称状态描述说明外设是连接，断开还是正在广告的功能。句法blePeripheral.status（）;参数空虚返回 BLEStatus：可以是CONNECT，

27、DISCONNECT，ADVERTISING。Arduino Function: BLEPeripheral.printBleMessage名称printBleMessage描述打印有关BLE状态的有用信息。此函数必须被调用才能收到BLEMessage事件。 请参阅setEventHandler函数，以了解如何为传入事件设置回调。句法blePeripheral.printBleMessage（evtCode，messageCode）;参数evtCode：int。 代码检测当前消息的类型。messageCode：int。 代码检测具体消息。返回没有Arduino Function: BLEPer

28、ipheral.setEventHandler名称setEventHandler描述设置在特定事件发生时调用的回调。句法blePeripheral.setEventHandler（event，callback）;参数event：BLEPeripheralEvent。 BLE事件要监控。值：BLEConnectedBLEDisconnectedBLEBondedBLERemoteServicesDiscoveredBLEPasskeyReceivedBLEPasskeyRequestedBLEMessagecallback：BLEPeripheralEventHandler函数与BLECentr

29、alPeer（又称BLECentral）对象作为参数或BLEMessageEventHandler函数，两个整数作为参数（仅适用于BLEMessage事件）。返回没有Arduino Function: BLECentralRole Constructor名称BLECentralRole描述BLECentralRole类的构造方法句法BLECentralRole bleCentral = BLECentralRole();参数空虚返回没有Arduino Function: BLECentralRole.setScanParameters名称setScanParameters描述功能设置扫描过程的参数。扫描时，该板将作为观察者角色，并能够读取附近的所有广告数据包。句法bleCentral.setScanParameters（interval，window，timeout，active）;参数interval：短。在扫描窗口内的时间内，电路板将扫描。该值以0.625 ms为增量表示，必须介于0x0