Skip to content
Open
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
56 changes: 56 additions & 0 deletions content/Hardware Support/Generic/About-Qwiic.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,56 @@
---
title: About Qwiic
---
In this article:
Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

As a rule, put the TOC after the opening paragraphs.

In this article, that will be immediatly before the "Technical Specification".


- [Technical Specifications](#technical-specifications)
- [Pinout](#pinout)
- [Daisy Chanining](£daisy-chaining)
Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
- [Daisy Chanining](£daisy-chaining)
- [Daisy Chanining](#daisy-chaining)

- [Voltage Compatibility](#voltage-compatibility)
- [Compatible Arduino products](#compatible-arduino-products)
- [Modulino Nodes and Qwiic compatibility](#modulino-nodes-and-qwiic-compatibility)

Qwiic is a system of breakout modules and development boards that use a specific connector for easy I2C communication.

Wiring I2C devices can be complicated, but Qwiic simplifies this with pre-made cables, allowing you to connect additional sensors and actuators without soldering. You can chain devices together using a single cable, enabling them to work right away.

## Technical Specification{#technical-specifications}

Qwiic uses a **JST SH 4-pin 1.0mm pitch** connector. This small, polarized connector ensures that you cannot plug it in backwards, making it beginner-friendly.

## Pinout{#pinout}

Each Qwiic cable consists of four wires with standard color coding:

| Wire Color | Signal | Description |
|:---:|:---:|---|
| **Black** | GND | Ground |
| **Red** | 3.3V | Power Supply |
| **Blue** | SDA | I2C Data |
| **Yellow** | SCL | I2C Clock |

## Daisy Chaining{#daisy-chaining}

One of the most powerful features of Qwiic is the ability to "daisy chain" multiple sensors. If a Qwiic module has two connectors, you can connect the first to your Arduino board, and the second to another Qwiic module.

- **Unique I2C Addresses:** Each module in the chain must have a unique I2C address. If you connect two identical sensors (e.g., two temperature sensors with the same I2C address), they will conflict.
- **Power Limits:** All modules in the chain are powered by the Arduino's 3.3V regulator. Be mindful of the total current draw of your chain to avoid overloading the regulator.

## Voltage Compatibility{#voltage-compatibility}

> [!CAUTION]
> **Qwiic is a 3.3V-only system.**
> Most Qwiic-enabled boards and sensors are not 5V tolerant. Connecting a 5V source to a Qwiic connector or using it with a 5V I2C bus without proper level shifting will likely damage your hardware.
Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Most Qwiic-enabled boards [...] are not 5V tolerant

UNO R4 and Nano R4 operate at 5 V, but have Qwiic connectors powered with 3.3 V.

I think this only becomes a risk when adding a Qwiic connector on your own, or when using level shifters?

In that case, the key message for a beginner using compatible products should be "use the qwiic connectors"


## Compatible Arduino products{#compatible-arduino-products}
Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I am not sure the title is compatible arduino products, because all are compatible, you just need a qwiic connector. also on may 21st we will launch the nano connector carrier, adding qwiic connector to the nano family

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@charlesbones I think a clearer phrasing could be "Arduino products with Qwiic connectors"

The connector is an important part of the standard. Without it, I would just call it I2C support.

But we can mention the possiblity of adding a connector to any Arduino board with I2C support.


- [Alvik](https://docs.arduino.cc/tutorials/alvik/user-manual/#qwiic-connectors)
- [Modulino Nodes (included in the Plug and Make Kit)](https://docs.arduino.cc/hardware/plug-and-make-kit/#features:~:text=Qwiic%20Connectors,building%20complex%20circuits.)
- [Nano Connector Carrier](https://docs.arduino.cc/tutorials/nano-connector-carrier/getting-started-nano-connector-carrier/#qwiic-connector)
- [Nano R4](https://docs.arduino.cc/tutorials/nano-r4/user-manual/#qwiic-connector)
- [UNO R4 WiFi](https://docs.arduino.cc/tutorials/uno-r4-wifi/qwiic/#qwiic)
- [UNO Q](https://docs.arduino.cc/tutorials/uno-q/user-manual/#qwiic)

## Modulino Nodes and Qwiic compatibility{#modulino-nodes-and-qwiic-compatibility}

Modulino nodes are compatible with the entire Qwiic ecosystem, both mechanically and electrically. They can be connected in series with other Qwiic components. This setup uses I2C communication, making it simple to add multiple devices without complex wiring.
Loading