There's a few oddities when running Blinka/CircuitPython on linux. Here's a list of stuff to watch for that we know of!
This FAQ covers all the various platforms and hardware setups you can run Blinka on. Therefore, some of the information may not apply to your specific setup.
Update Blinka/Platform Libraries
Most issues can be solved by forcing Python to upgrade to the latest blinka
/ platform-detect
libraries. Try running
sudo python3 -m pip install --upgrade --force-reinstall adafruit-blinka Adafruit-PlatformDetect
Somehow you have ended up with either the wrong board module or no board module at all.
DO NOT try to fix this by manually installing a library named board
. There is one out there and it has nothing to do with Blinka. You will break things if you install that library!
The easiest way to recover is to simply force a reinstall of Blinka with:python3 -m pip install --upgrade --force-reinstall adafruit-blinka
Due to the way we share an SPI peripheral, you cannot have two SPI devices with different 'mode/polarity' on the same SPI bus - you'll get weird data
95% of SPI devices are mode 0, check the driver to see mode or polarity settings. For example:
- LSM9DS1 is mode 1, please use in I2C mode instead of SPI
- MAX31865 is phase 1, try using this on a separate SPI device, or read data twice.
This is due to having an older version of spidev. You need at least version 3.4. This should have been taken care of when you installed Blinka, but in some cases it does not seem to happen.
To check what version of spidev Python is using:
$ python3
Python 3.6.8 (default, Oct 7 2019, 12:59:55)
[GCC 8.3.0] on linux
Type "help", "copyright", "credits" or "license" for more information.
>>> import spidev
>>> spidev.__version__
'3.4'
>>>
If you see a version lower then 3.4 reported, then try a force upgrade of spidev with (back at command line):
sudo python3 -m pip install --upgrade --force-reinstall spidev
Some linux boards, for example, AllWinner-based, do not have support to set pull up or pull down on their GPIO. Use an external resistor instead!
If you are getting a stack trace that ends with something like:
return self._hid.read(64)
File "hid.pyx", line 122, in hid.device.read
OSError: read error
Try setting an environment variable named BLINKA_MCP2221_RESET_DELAY to a value of 0.5 or higher.
Windows:
set BLINKA_MCP2221_RESET_DELAY=0.5
Linux:
export BLINKA_MCP2221_RESET_DELAY=0.5
This is a value in seconds to wait between resetting the MCP2221 and the attempt to reopen it. The reset is seen by the operating system as a hardware disconnect/reconnect. Different operating systems can need different amounts of time to wait after the reconnect before the attempt to reopen. Setting the above environment variable will override the default reset delay time, allowing it to be increased as needed for different setups.
Blinka uses the libusbk driver to talk to the FT232H directly. If you have other FTDI devices installed that are using the FTDI VCP drivers, you may run into issues. See here for a possible workaround:
This is probably only an issue for older versions of Windows. If you run into something like this, see this issue thread:
https://github.com/pyusb/pyusb/issues/120
which describes copying the 32bit and 64bit DLLs into specific folders. (example for Win7)
Check out this issue thread:
https://github.com/pyusb/pyusb/issues/355
which has lots of discussion. It is probably worth reading through it all to determine what applies for your setup. Most solutions seem to rely on setting the DYLD_LIBRARY_PATH environment variable.
This issue thread has further information:
Some CircuitPython modules like may not be supported.
- Most SBCs do not have analog inputs so there is no
analogio
- Few SBCs have
neopixel
support so that is only available on Raspberry Pi (and any others that have low level neopixel protocol writing - Rotary encoders (
rotaryio
) is handled by interrupts on microcontrollers, and is not supported on SBCs at this time - Likewise
pulseio
PWM support is not supported on many SBCs, and if it is, it will not support a carrier wave (Infrared transmission) - For display usage, we suggest using python
Pillow
library orPygame
, we do not havedisplayio
support
We aim to have, at a minimum, digitalio
and busio
(I2C/SPI). This lets you use the vast number of driver libraries
For analog inputs, the MCP3xxx library will give you AnalogIn
objects. For PWM outputs, try the PCA9685. For audio, use pygame or other Python3 libraries to play audio.
Some libraries, like Adafruit_CircuitPython_DHT will try to bit-bang if pulsein isn't available. Slow linux boards (<700MHz) may not be able to read the pins fast enough), you'll just have to try!
It looks like libgpiod may not be installed on your board.
Try running the command: sudo apt-get install libgpiod2
Be sure you have the latest libgpiod.py script and run it with the -l
or --legacy
flag:
sudo python3 libgpiod.py --legacy
All Raspberry Pi Computers Have:
- 1 x I2C port with busio (but clock stretching is not supported in hardware, so you must set the I2C bus speed to 10KHz to 'fix it')
- 2 x SPI ports with busio
- 1 x UART port with serial - note this is shared with the hardware console
- pulseio.pulseIn using gpiod
- neopixel support on a few pins
- No AnalogIn support (Use an MCP3008 or similar to add ADC)
- No PWM support (Use a PCA9685 or similar to add PWM)
Google Coral TPU Dev Boards Have:
- 1 x I2C port with busio
- 1 x SPI ports with busio
- 1 x UART port with serial - note this is shared with the hardware console
- 3 x PWMOut support
- No NeoPixel support
- No AnalogIn support (Use an MCP3008 or similar to add ADC)
Orange Pi PC Plus Boards Have:
- 1 x I2C port with busio
- 1 x SPI ports with busio
- 1 x UART port with serial
- No NeoPixel support
- No AnalogIn support (Use an MCP3008 or similar to add ADC)
- No PWM support (Use a PCA9685 or similar to add PWM)
Orange Pi R1 Boards Have:
- 1 x I2C port with busio
- 1 x SPI port with busio
- 1 x UART port with serial
- No NeoPixel support
- No AnalogIn support (Use an MCP3008 or similar to add ADC)
- No PWM support (Use a PCA9685 or similar to add PWM)
ODROID C2 Boards Have:
- 1 x I2C port with busio
- No SPI support
- 1 x UART port with serial - note this is shared with the hardware console
- No NeoPixel support
- No AnalogIn support (Use an MCP3008 or similar to add ADC)
- No PWM support (Use a PCA9685 or similar to add PWM)
DragonBoard 410c Boards Have:
- 2 x I2C port with busio
- 1 x SPI port with busio
- 1 x UART port with serial
- No NeoPixel support
- No AnalogIn support (Use an MCP3008 or similar to add ADC)
- No PWM support (Use a PCA9685 or similar to add PWM)
NVIDIA Jetson Nano Boards Have:
- 2 x I2C port with busio
- 2 x SPI ports with busio
- 2 x UART port with serial - note one of these is shared with the hardware console
- No NeoPixel support
- No AnalogIn support (Use an MCP3008 or similar to add ADC)
- No PWM support (Use a PCA9685 or similar to add PWM)
FT232H Breakouts Have:
- 1x I2C port OR SPI port with busio
- 12x GPIO pins with digitalio
- No UART
- No AnalogIn support
- No AnalogOut support
- No PWM support
If you are using Blinka in FT232H mode, then keep in mind these basic limitations.
- SPI and I2C can not be used at the same time since they share the same pins.
- GPIO speed is not super fast, so trying to do arbitrary bit bang like things may run into speed issues.
- There are no ADCs.
- There are no DACs.
- UART is not available (its a different FTDI mode)
MCP2221 Breakouts Have:
- 1x I2C port with busio
- 4x GPIO pins with digitalio
- 3x AnalogIn with analogio
- 1x AnalogOut with analogio
- 1x UART with pyserial
- No PWM support
- No hardware SPI support
If you are using Blinka in MCP2221 mode, then keep in mind these basic limitations.
- GPIO speed is not super fast, so trying to do arbitrary bit bang like things may run into speed issues.
- UART is available via
pyserial
, the serial COM port shows up as a second USB device during enumeration
Text editor powered by tinymce.