-
Notifications
You must be signed in to change notification settings - Fork 15
About Qwiic [HC-1624] #476
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
base: main
Are you sure you want to change the base?
Changes from all commits
File filter
Filter by extension
Conversations
Jump to
Diff view
Diff view
There are no files selected for viewing
| Original file line number | Diff line number | Diff line change | ||||
|---|---|---|---|---|---|---|
| @@ -0,0 +1,56 @@ | ||||||
| --- | ||||||
| title: About Qwiic | ||||||
| --- | ||||||
| In this article: | ||||||
|
|
||||||
| - [Technical Specifications](#technical-specifications) | ||||||
| - [Pinout](#pinout) | ||||||
| - [Daisy Chanining](£daisy-chaining) | ||||||
|
Collaborator
There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more.
Suggested change
|
||||||
| - [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. | ||||||
|
Collaborator
There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more.
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} | ||||||
|
There was a problem hiding this comment. Choose a reason for hiding this commentThe 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
Collaborator
There was a problem hiding this comment. Choose a reason for hiding this commentThe 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. | ||||||
There was a problem hiding this comment.
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".