Nordic UART Service (NUS)¶
The Bluetooth LE GATT Nordic UART Service is a custom service that receives and writes data and serves as a bridge to the UART interface.
The NUS Service is used in the Bluetooth: Peripheral UART sample.
The 128-bit vendor-specific service UUID is 6E400001-B5A3-F393-E0A9-E50E24DCCA9E (16-bit offset: 0x0001).
This service has two characteristics.
- Write or Write Without Response
Write data to the RX Characteristic to send it on to the UART interface.
Enable notifications for the TX Characteristic to receive data from the application. The application transmits all data that is received over UART as notifications.
Nordic UART (NUS) GATT Service API.
UUID of the NUS Service.
UUID of the TX Characteristic.
UUID of the RX Characteristic.
bt_nus_init(struct bt_nus_cb *callbacks)¶
Initialize the service.
This function registers a GATT service with two characteristics, TX and RX. A remote device that is connected to this service can send data to the RX Characteristic. When the remote enables notifications, it is notified when data is sent to the TX Characteristic.
callbacks – [in] Struct with function pointers to callbacks for service events. If no callbacks are needed, this parameter can be NULL.
- Returns 0
If initialization is successful. Otherwise, a negative value is returned.
bt_nus_send(struct bt_conn *conn, const uint8_t *data, uint16_t len)¶
This function sends data to a connected peer, or all connected peers.
conn – [in] Pointer to connection object, or NULL to send to all connected peers.
data – [in] Pointer to a data buffer.
len – [in] Length of the data in the buffer.
- Returns 0
If the data is sent. Otherwise, a negative value is returned.
- #include <nus.h>
Pointers to the callback functions for service events.
received)(struct bt_conn *conn, const uint8_t *const data, uint16_t len)¶
Data received callback.
The data has been received as a write request on the NUS RX Characteristic.
conn – [in] Pointer to connection object that has received data.
data – [in] Received data.
len – [in] Length of received data.
sent)(struct bt_conn *conn)¶
Data sent callback.
The data has been sent as a notification and written on the NUS TX Characteristic.
conn – [in] Pointer to connection object, or NULL if sent to all connected peers.
- void (*