Node.js library for UART communication with uBeacons.

Usage no npm install needed!

<script type="module">
  import nodeUbeaconUartLib from '';




The following files provide a node.js library, allowing to communicate with uBeacon v2.0 devices over USB-UART cable, provided with the devices.

The communication allows to adjust various settings of the device, as well as sending and receiving messages, over mesh supported from the 2.0 version.


npm install node-ubeacon-uart-lib


Refer to scripts in examples folder for demonstration of using the library.

To launch the scripts you will need to specify identifier of the serial port to use. Depending on your specific configuration and platform it will be something similar to the following:


node basic-reader.js --serial-port=/dev/tty.usbserial-A703JWRZ


node basic-reader.js --serial-port=COM1

To determine the identifier of your serial port for OSX open terminal and type:

ls /dev/tty.*

It will result in a list similar to the following:

$ ls /dev/tty.*
/dev/tty.Bluetooth-Incoming-Port	/dev/tty.usbserial-A703JWRZ

To determine the identifier for Windows you will need to go into device manager and look an entry named "USB Serial Port (COMX)" under "Ports (COM and LPT)" section.