Skip to content

Commit d279156

Browse files
Add Linux Setup Instructions
1 parent 7abe65e commit d279156

File tree

1 file changed

+51
-0
lines changed

1 file changed

+51
-0
lines changed

docs/linux_setup.md

Lines changed: 51 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1 +1,52 @@
11
# Using Qwiic with Python on Linux
2+
3+
## Contents
4+
* [Supported Platforms](#hardware)
5+
* [Raspberry Pi Setup](#raspberry-pi-setup)
6+
* [Jetson Orin Nano Setup](#jetson-orin-nano-setup)
7+
* [Qwiic Shim Setup](#qwiic-shim-or-qwiic-cable-female-jumper-setup)
8+
* [Installation](#installation)
9+
* [Drivers](#drivers)
10+
11+
## Supported Platforms
12+
[Raspberry Pi](https://www.sparkfun.com/raspberry-pi-5-8gb.html) , [NVIDIA Jetson Orin Nano](https://www.sparkfun.com/nvidia-jetson-orin-nano-developer-kit.html) via the [SparkFun Qwiic SHIM](https://www.sparkfun.com/sparkfun-qwiic-shim-for-raspberry-pi.html)
13+
14+
## Raspberry Pi Setup
15+
Follow the [instructions here](https://www.raspberrypi.com/software/operating-systems/) to to download a Raspberry PI OS image. It is expected that most/all RaspberryPi OS versions will work with our Qwiic I2C drivers, but testing was done with Kernel v6.6, Debian GNU/Linux 12 (bookworm). Image an SD card with your favorite SD card imager, we recommend the [Raspberry Pi Imager](https://www.raspberrypi.com/software/).
16+
17+
## Jetson Orin Nano Setup
18+
Follow the [in-depth instructions here](https://developer.nvidia.com/embedded/learn/get-started-jetson-orin-nano-devkit#intro) to set up your Jetson Orin Nano Developer kit with a JetPack 6.2 (or higher) Linux image.
19+
20+
## Qwiic Shim or Qwiic Cable Female Jumper Setup
21+
On either of the above platforms, a pysical hardware interface is required to connect the I2C pins of the board to a qwiic connector on a qwiic device. Connect a [Qwiic Shim](https://www.sparkfun.com/sparkfun-qwiic-shim-for-raspberry-pi.html) or a [Qwiic Cable Female Jumper](https://www.sparkfun.com/flexible-qwiic-cable-female-jumper-4-pin.html) to your board, making sure to connect the correct pins for PWR, GND, SDA, and SCL. See the [instructions here](https://learn.sparkfun.com/tutorials/qwiic-shim-for-raspberry-pi-hookup-guide) for more information. Then connect a qwiic cable to your SparkFun Qwiic Device.
22+
23+
> [!Warning]
24+
> IMPROPER ORIENTATION OF A QWIIC SHIM CAN SHORT POWER TO GROUND, DAMAGING YOUR BOARD!
25+
26+
## Installation
27+
You can install the [qwiic_i2c_py](https://github.com/sparkfun/Qwiic_I2C_Py) package to get Qwiic I2C support for your board. Also check out our comprehensive [qwiic_py](https://github.com/sparkfun/Qwiic_Py) repository.
28+
29+
The qwiic_i2c_py package is primarily installed using the `pip3` command, downloading the package from the Python Index - "PyPi".
30+
31+
First, setup a virtual environment from a specific directory using venv:
32+
```sh
33+
python3 -m venv ~/sparkfun_venv
34+
```
35+
You can pass any path instead of ~/sparkfun_venv, just make sure you use the same one for all future steps. For more information on venv [click here](https://docs.python.org/3/library/venv.html).
36+
37+
Next, install the qwiic package with:
38+
```sh
39+
~/sparkfun_venv/bin/pip3 install sparkfun-qwiic-i2c
40+
```
41+
Now you should be able to run any example or custom python scripts that have `import qwiic_i2c` by running e.g.:
42+
```sh
43+
~/sparkfun_venv/bin/python3 example_script.py
44+
```
45+
46+
To get started with any of the Qwiic Drivers, check out our list of Qwiic Python Driver Repos below and follow the device-specific "PyPi Installation" instructions in your device's repository.
47+
48+
As an alternative to pip, at you could also manually clone/download the qwiic_i2c_py repository and the repository for your desired driver and then utilize the qwiic files directly.
49+
50+
## Drivers
51+
Check out our growing list of Python Drivers: [https://github.com/topics/sparkfun-python](https://github.com/topics/sparkfun-python)
52+

0 commit comments

Comments
 (0)