# Peripheral Types

## Devices with Peripherals

Note: This table will be moving into the [dynamic hardware table](https://www.chameleoncloud.org/edge/hardware/) soon, but lives here for the moment.

| Name             | Peripheral Type         | Device Profile         |
| ---------------- | ----------------------- | ---------------------- |
| iot-rpi-cm4-02   | Waveshare Sense Hat (B) | pi\_gpio               |
| iot-rpi4-picam2  | Raspberry Pi Sense HAT  | pi\_sensehat           |
| iot-rpi4-picam2  | Pi Camera v2.1          | pi\_camera             |
| iot-rpi4-picam3  | Raspberry Pi Sense HAT  | pi\_sensehat           |
| iot-rpi4-picam3  | Pi Camera v3            | pi\_camera,pi\_camera3 |
| iot-rpi4-ov5647  | Wide Angle 160 OV5647   | pi\_camera             |
| Iot-rpi5-nvme-01 | Pi Camera v3            | pi\_camera,pi\_camera3 |

## CHI\@Edge Peripheral Types

Peripherals require explicit `device_profiles` during container creation to map physical hardware paths into the container namespace.

For example, a camera might require /dev/video0. The device profile "pi\_camera" makes /dev/video0 (among others), get passed from the host device into your container.

## Vision and Imaging

### Raspberry Pi Camera

Support for official Raspberry Pi Camera modules (v2, v3, and HQ).

* Device Profile**:** `pi_camera`
* Driver Stack**:** Uses the **libcamera** stack. Legacy `raspistill`/`raspivid` tools are deprecated in favor of `libcamerastill` and related. The following artifact and git repo provide a docker image with necessary drivers pre-installed.
* Artifacts**:**
  * Trovi**:** [Camera Peripheral Example](https://trovi.chameleoncloud.org/dashboard/artifacts/7d35f884-68d8-4b91-b42b-207717c9b742)
  * GitHub**:** [edge-picamera-image](https://github.com/ChameleonCloud/edge-picamera-image)
* Specs**:** [Raspberry Pi Camera Documentation](https://www.raspberrypi.com/documentation/accessories/camera.html)
* Device Nodes mapped**:**
  * `/dev/video0` - `/dev/video31`
  * `/dev/media0-4`
  * `/dev/vchiq`
  * `/dev/dma_heap`

#### Pi Camera 3

<div align="left"><figure><img src="https://239544857-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fg88rFJkby8fmPSPBK6Ju%2Fuploads%2Foi0LL3pqaDeL8lc3Haft%2Fimage.png?alt=media&#x26;token=cc063e2e-8389-44a2-babe-994c1eb47468" alt="" width="307"><figcaption></figcaption></figure></div>

* Sensor: Sony IMX708
* Autofocus
* 12MP
* Specs: <https://www.raspberrypi.com/products/camera-module-3/>

Note: The Pi Camera3 needs both the `pi_libcamera` and the `pi_camera3` device profiles.\
This is because it exposes additional interfaces under /dev for things like autofocus.\
\
Upcoming work on peripheral management will remove the need to do this.

#### Pi Camera 2.1

<div align="left"><figure><img src="https://239544857-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fg88rFJkby8fmPSPBK6Ju%2Fuploads%2FxIIwNmUArlSWDe1Ltyl2%2Fimage.png?alt=media&#x26;token=b1a08d37-9ba0-40a2-b28c-bc1f20166c15" alt="" width="375"><figcaption></figcaption></figure></div>

* Sensor: Sony IMX219
* No Autofocus
* 8MP
* Specs: <https://www.raspberrypi.com/products/camera-module-v2/>

#### Wide Angle 160 OV5647

* Sensor: OV5647
* 5MP
* No Autofocus
* Datasheet: <https://files.seeedstudio.com/wiki/OV5647_Series_Camera_Module/OV5647-160_FOV_IR_Camera_module.pdf>

## Environmental and Motion Sensors

### Official Raspberry Pi Sense HAT

{% embed url="<https://www.raspberrypi.com/documentation/accessories/sense-hat.html>" %}

<figure><img src="https://239544857-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fg88rFJkby8fmPSPBK6Ju%2Fuploads%2FGOjEvbdGBWDFPGaT0nd2%2Fimage.png?alt=media&#x26;token=4a765524-0c75-469c-8c1e-e3afe58b6a75" alt="" width="563"><figcaption></figcaption></figure>

* Device Profile: `pi_sensehat`
* Sensors/Interfaces:
  * I2C: **Humidity** (HTS221), **Pressure**/**Temp** (LPS25H), **IMU** (LSM9DS1).
  * **Framebuffer**: 8x8 RGB LED Matrix (`/dev/fb0`).
  * **Input**: 5-button Joystick (`/dev/input/event0-4`).
* Artifacts:
  * Trovi: [CHI@Edge Sensors and GPIO Tutorial](https://trovi.chameleoncloud.org/dashboard/artifacts/1b8cdcba-e10c-4cae-8b1e-145037bc4cda)
  * GitHub: [edge\_sensehat\_image](https://github.com/ChameleonCloud/edge_sensehat_image)
* Docker Image: `chameleoncloud/edge_sensehat_image:latest`&#x20;

### Waveshare Sense HAT (B)

{% embed url="<https://www.waveshare.com/wiki/Sense_HAT_(B)>" %}

<figure><img src="https://239544857-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fg88rFJkby8fmPSPBK6Ju%2Fuploads%2FE7wdHXsiDCTyBc94nQzS%2Fimage.png?alt=media&#x26;token=34954b72-e19e-43be-9648-35c4efa61e82" alt=""><figcaption></figcaption></figure>

* Sensors/Interfaces:
  * I2C: Temp/Humidity (SHTC3), Pressure (LPS22HB), IMU (ICM20948), Color (TCS34725).
  * ADC: SGM58031 (4-ch 16-bit) for external analog inputs.
  * GPIO: Extended pins for additional peripheral integration.
* Artifacts:
  * Trovi (Primary): [CHI@Edge Sensors and GPIO Tutorial](https://trovi.chameleoncloud.org/dashboard/artifacts/1b8cdcba-e10c-4cae-8b1e-145037bc4cda) (includes Waveshare-specific notebook).
  * GitHub: [edge\_sensehat\_image](https://github.com/ChameleonCloud/edge_sensehat_image)
* Docker Image: `chameleoncloud/edge_sensehat_image:latest` (Packages `adafruit-blinka` and `rpilgpio` for Waveshare hat support).
* Device Profile: `pi_gpio` (Shared profile providing I2C and GPIO access).


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://chameleoncloud.gitbook.io/chi-edge/hardware-info/peripheral-types.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.