BNO055 USB Stick Linux Python Driver
Project description
BNO055 USB Stick Python driver
TL;DR: "Swiss army knife" for using
BNO055 USB Stick
under Linux from python3
.
Long version:
BNO055 USB Stick
comes with
Development Desktop 2.0
software package,
which unfortunately available for Windows only.
If you have a BNO055 USB Stick
and want to
use it on a Linux platform
(e.g. Ubuntu, Raspbian, Yocto, etc.)
this repo provides you with a python 3
driver,
capable of reading / writing registers / burst read,
and stream data read.
OS Prerequisites
-
When plugged in on a Linux system, the
BNO055 USB Stick
should appear as/dev/ttyACM*
device. This device is a so-calledcdc_acm
(communication device class), but let us leave these details for now. -
Your Linux user must be a member of the
dialout
group (e.g. see this thread) to be able to read/writettyACM*
devices without root privileges. -
udev
is installed on the system. We do autodetect the USB stick by relying on information from udev.
Supported Python version
python v3.6+
Python dependencies
TL;DR: install
(i) pyserial
,
(ii) pyudev
,
(iii) dataclasses
(if using python3.6
), and
(iv) optionally: pyquaternion
and matplotlib
yourself,
or use environment.yml
to create conda environment
with dependencies resolved (see below).
For further details read this guide.
Quick start
Read register:
from bno055_usb_stick import BnoUsbStick
bno_usb_stick = BnoUsbStick()
reg_val = bno_usb_stick.read_register(0x00)
print(f"bno addr: {0x00}, value: {reg_val}")
Get 10 packets in streaming mode:
from bno055_usb_stick import BnoUsbStick
bno_usb_stick = BnoUsbStick()
bno_usb_stick.activate_streaming()
for packet in bno_usb_stick.recv_streaming_generator(num_packets=10):
print(f"bno data: {packet}")
Prevent modem manager to capture serial device
When plugging bno_usb_stick
on Ubuntu,
the device is unavailable for the first 10-15 seconds,
due to the fact that ModemManager
process
takes over and tries to use the device.
To avoid this Ubuntu-specific behavior,
add an exception to the udev
rules,
s.t. the ModemManager
ignores the bno_usb_stick
.
Run the script:
python disable_modem_manager_bno_usb_stick.py
The script requires root privileges. Essentially it copies
the 97-ttyacm.rules
file to /etc/udev/rules.d
and reloads the
udev rules.
Maintainer
Dr. Konstantin Selyunin, for suggestions / questions / comments please contact: selyunin [dot] k [dot] v [at] gmail [dot] com
Project details
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for bno055_usb_stick_py-0.1.0.tar.gz
Algorithm | Hash digest | |
---|---|---|
SHA256 | 84f86a8e3daa92ad771d08c061eefd8153eaa9acb33d9ccdef3ccf2c70955f70 |
|
MD5 | ee6749854fe795ece835796330c64f7c |
|
BLAKE2b-256 | 504358c2c316e374dc0476c39459bad7cd7517320b63d0dd313a40dec120e65f |
Hashes for bno055_usb_stick_py-0.1.0-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | a84abda8bafeccf573cc3f8dfc876fe1f308b4605379695641b8d0510ea9146b |
|
MD5 | 518c8d035d5b9c29a4ca9a2ca746d35e |
|
BLAKE2b-256 | becd12cc76f1743176c05cc9c4d88125c2038ae053df140ed4f52eb72c65eca2 |