Skip to main content

Troubleshooting

Start with the symptom you can observe. Apply one change at a time, then retry the smallest Quick Start example.

SymptomCheckFix
I2C error, or the controller cannot find the boardTwo or more of these boards share one I2C bus, all at the default addressEvery 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 0OE is driven or pulled highOE 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 moveNo 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 rangePulse range does not match the servoCall 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 busJP7 still closed (its default) on more than one boardJP7 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