Troubleshooting
Start with the symptom you can observe. Apply one change at a time, then retry the smallest Quick Start example.
| Symptom | Check | Fix |
|---|---|---|
Inputronic GRID not found. Check wiring. | Is the Qwiic cable seated at both ends? Is the board getting 3.3 V? | Reseat the cable or try another of the four Qwiic connectors, then reset the controller. With solder pads, check that SDA and SCL are not swapped. |
| The board stopped answering after you changed its address | The board keeps a new address after power-off, so it no longer answers on 0x30. | Create the object with the address you set, for example InputronicGrid grid(0x31); in Arduino or InputronicGrid(address=0x31) in MicroPython. To go back, run the Change the I2C address example with CURRENT_ADDRESS set to the current address and NEW_ADDRESS set to 0x30. |
setAddress() did nothing | Is the new address between 0x08 and 0x77? | The libraries ignore any other value and send nothing. Pick an address in that range that no other device on the bus uses. |
MicroPython: Board not recognized, pass an initialized I2C object | InputronicGrid() without an I2C object works only on the ports the module recognises: ESP32, ESP8266 and one Soldered board. | Create I2C(...) with your board's pins and pass it as InputronicGrid(i2c=i2c), as the commented lines at the top of each example show. |
Arduino: setLED() lights the wrong LED or the wrong brightness | Did you call setLED() with five arguments? | Five arguments select the LED by index, at intensity 128 by default. For a row and column, pass all six: setLED(row, col, r, g, b, intensity). |
| Several GRIDs or other I2C boards on one bus do not work together | Do two boards share an address? Does every board add its own pull-ups? | Give each GRID its own address. Where another board on the bus already has pull-ups, cut JP5 to disconnect this board's 10 kΩ pull-ups. |
| Your controller runs at 5 V | The GRID is a 3.3 V-only board with no regulator and no level shifter. | Use a controller that runs at 3.3 V. |
Still blocked?
Ask on the community forum. Include the following so someone can reproduce it:
- product name and SKU: Soldered Inputronic GRID,
333362 - 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