Setting up your XM112

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

Windows COM port drivers#

If no COM port is recognized when plugging in a module, you might need to install a driver:

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.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 20.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.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.