Setting up your XM112

Finding the serial port

On Windows, use device manager to find the port which will be listed as USB Serial Port. It’s most likely COMx where x is 3 or higher. On Linux, it’s likely /dev/ttyUSBx where x is 0 or some other integer.

PySerial has a simple tool for listing all ports available:

python -m serial.tools.list_ports

Flashing

For detailed flashing instructions visit our developer page.

We recommend flashing using BOSSA (website, GitHub). BOSSA 1.9 or newer is supported.

To get into the bootloader:

  • Hold down the ERASE button
  • Push the NRST button
  • Release the NRST button
  • Let go of the ERASE button

Now you should be able to flash the Module software (acc_module_server_xm112.bin). After flashing, press the NRST button to reboot into the flashed software.

BOSSA on Linux

If you’re on Linux you likely will need to compile BOSSA on your own. Here’s how to do it on Ubuntu 18.04.

Get everything you need to build:

sudo apt update
sudo apt install -y make build-essential

Clone the BOSSA repository to a suitable location (below we use the home directory):

cd ~
git clone https://github.com/shumatech/BOSSA.git

Go into to the repository:

cd BOSSA

Build bossac (the CLI tool):

make -j8 bossac

To flash:

sudo ./bin/bossac -e -w -v -p /dev/ttyUSB0 -b /path/to/acc_module_server_xm112.bin

Note: If you want the full BOSSA GUI, you will also need to install libreadline-dev and libwxgtk3.0-dev before compiling with make.