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
.
BNO055 USB Stick
comes with
Development Desktop 2.0
software package,
which is 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, Suse, 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.
Installation
pip install bno055_usb_stick_py
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
,
or use environment.yml
to create conda environment
with dependencies resolved.
For further details regarding creating conda
senvironment 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 chip id 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.9.0.tar.gz
Algorithm | Hash digest | |
---|---|---|
SHA256 | 4886b004dae26e72242e89e7ab23a368238097f51d98617b06beabd76004f93f |
|
MD5 | 71478b67d9ffa6b04307b9e124acee51 |
|
BLAKE2b-256 | 0ae40676cdaecdbefef6d229a2a48e2faf0625345b003e2492fd20fae2c48e18 |
Hashes for bno055_usb_stick_py-0.9.0-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 3e8386a13e7766a096fe033db6e75e47a32a772082c66cb21b40ebd8afcb59e9 |
|
MD5 | 203fe7d45b49e3c878ea4a715c3f5518 |
|
BLAKE2b-256 | bac3887fe88551941c204c17770441de00f35b4370185cd1d437d2d82be8d50a |