Troubleshooting
Start with the symptom you can observe. Apply one change at a time, then retry the smallest Quick Start example.
| Symptom | Check | Fix |
|---|---|---|
| I2C error, or the controller cannot find the board | Two or more of these boards share one I2C bus, all at the default address | Every board on a shared bus needs a different address. Solder-close one or more of JP1 to JP6 on all but one board. |
| Every channel output stays at 0 | OE is driven or pulled high | OE is active low and pulled low on the board, so the outputs are enabled by default. Leave it unconnected, or tie it low, unless you want to switch all 16 outputs off. |
| A connected servo does not move | No supply on V+ | Servos run from the V+ rail, which the Qwiic connector does not carry: it carries only 3.3 V. Connect the servo supply to the screw terminal or the header's V+ pin. |
| Servo does not reach its full range | Pulse range does not match the servo | Call setServoPulseRange() and setServoAngleRange() with the values from your servo's own datasheet. The library defaults to 500-2500 us over 0-180°, which does not fit every servo. |
| Two or more of these boards are chained on one Qwiic bus | JP7 still closed (its default) on more than one board | JP7 ships closed, adding a 10 kΩ pull-up on SDA and SCL. Every closed JP7 on the bus adds another pair in parallel. Cut JP7 on every board except at most one. |
Still blocked?
Ask on the community forum. Include the following so someone can reproduce it:
- product name and SKU: Soldered PWM & Servo Driver 16-Channel 12-bit PCA9685 breakout,
333191 - controller board and software environment
- library or module revision
- complete error text or unexpected output
- connection method and power source
- a clear photo of the wiring