2021-01-29 06:31:58 -05:00
|
|
|
|
|
|
|
|
[](https://github.com/marketplace/actions/arduino_ci)
|
2021-12-23 04:41:42 -05:00
|
|
|
[](https://github.com/RobTillaart/PCA9635/actions/workflows/arduino-lint.yml)
|
|
|
|
|
[](https://github.com/RobTillaart/PCA9635/actions/workflows/jsoncheck.yml)
|
2021-01-29 06:31:58 -05:00
|
|
|
[](https://github.com/RobTillaart/PCA9635/blob/master/LICENSE)
|
|
|
|
|
[](https://github.com/RobTillaart/PCA9635/releases)
|
|
|
|
|
|
|
|
|
|
|
2020-11-27 05:28:57 -05:00
|
|
|
# PCA9635
|
|
|
|
|
|
2022-01-06 14:19:35 -05:00
|
|
|
Arduino library for PCA9635 I2C 8 bit PWM LED driver, 16 channel.
|
2020-11-27 05:28:57 -05:00
|
|
|
|
2021-01-29 06:31:58 -05:00
|
|
|
|
2021-12-23 04:41:42 -05:00
|
|
|
## Description
|
2020-11-27 05:28:57 -05:00
|
|
|
|
|
|
|
|
This library is to control the I2C PCA9635 PWM extender.
|
2022-01-06 14:19:35 -05:00
|
|
|
The 16 channels are independently configurable in steps of 1/256.
|
2021-12-23 04:41:42 -05:00
|
|
|
this allows for better than 1% fine tuning of the duty-cycle
|
2020-11-27 05:28:57 -05:00
|
|
|
of the PWM signal.
|
|
|
|
|
|
|
|
|
|
|
2021-01-29 06:31:58 -05:00
|
|
|
## Interface
|
|
|
|
|
|
2021-12-23 04:41:42 -05:00
|
|
|
|
2021-01-29 06:31:58 -05:00
|
|
|
### Constructor
|
2020-11-27 05:28:57 -05:00
|
|
|
|
2021-12-23 04:41:42 -05:00
|
|
|
- **PCA9635(uint8_t deviceAddress, TwoWire \*wire = &Wire)** Constructor with I2C device address,
|
|
|
|
|
and optional the Wire interface as parameter.
|
|
|
|
|
- **bool begin()** initializes the library after startup. Mandatory.
|
|
|
|
|
- **bool begin(uint8_t sda, uint8_t scl)** idem, ESP32 ESP8266 only. Library does not support
|
2020-11-27 05:28:57 -05:00
|
|
|
multiple Wire instances (yet).
|
2021-12-23 04:41:42 -05:00
|
|
|
- **void reset()** resets the library to start up conditions.
|
|
|
|
|
- **bool isConnected()** checks if address is available on I2C bus.
|
2022-01-06 14:19:35 -05:00
|
|
|
- **uint8_t channelCount()** returns the number of channels = 16.
|
2021-01-29 06:31:58 -05:00
|
|
|
|
2020-11-27 05:28:57 -05:00
|
|
|
|
2021-01-29 06:31:58 -05:00
|
|
|
### LedDriverMode
|
2020-11-27 05:28:57 -05:00
|
|
|
|
2021-12-23 04:41:42 -05:00
|
|
|
- **uint8_t setLedDriverMode(uint8_t channel, uint8_t mode)** mode is 0..3 See datasheet for full details.
|
|
|
|
|
- **uint8_t getLedDriverMode(uint8_t channel)** returns the current mode of the channel.
|
2020-11-27 05:28:57 -05:00
|
|
|
|
2022-01-06 14:19:35 -05:00
|
|
|
| LED mode | Value | Description |
|
|
|
|
|
|:-------------------|:-----:|:----------------------------------|
|
|
|
|
|
| PCA9635_LEDOFF | 0x00 | led is 100% off, default @startup |
|
|
|
|
|
| PCA9635_LEDON | 0x01 | led is 100% on. |
|
|
|
|
|
| PCA9635_LEDPWM | 0x02 | set LED in PWM mode, 0..255 |
|
|
|
|
|
| PCA9635_LEDGRPPWM | 0x03 | add LED to the GRPPWM* |
|
2020-11-27 05:28:57 -05:00
|
|
|
|
2021-12-23 04:41:42 -05:00
|
|
|
\* all LEDs in the group GRPPWM can be set to the same PWM value in one set.
|
|
|
|
|
This is ideal to trigger e.g. multiple LEDs (servo's) at same time.
|
2020-11-27 05:28:57 -05:00
|
|
|
|
|
|
|
|
|
2021-01-29 06:31:58 -05:00
|
|
|
### Read and write
|
2020-11-27 05:28:57 -05:00
|
|
|
|
2021-12-23 04:41:42 -05:00
|
|
|
- **uint8_t write1(uint8_t channel, uint8_t value)** writes a single 8 bit PWM value.
|
|
|
|
|
- **uint8_t write3(uint8_t channel, uint8_t R, uint8_t G, uint8_t B)** writes three consecutive PWM registers.
|
|
|
|
|
typical use is to write R, G, B values for a full colour LED.
|
|
|
|
|
- **uint8_t writeN(uint8_t channel, uint8_t \* array, uint8_t count)** write count consecutive PWM registers.
|
2020-11-27 05:28:57 -05:00
|
|
|
May return **PCA9635_ERR_WRITE** if array has too many elements
|
2021-12-23 04:41:42 -05:00
|
|
|
(including channel as offset).
|
|
|
|
|
- **uint8_t writeMode(uint8_t reg, uint8_t value)** configuration of one of the two configuration registers.
|
2020-11-27 05:28:57 -05:00
|
|
|
check datasheet for details.
|
2021-12-23 04:41:42 -05:00
|
|
|
- **uint8_t readMode(uint8_t reg)** reads back the configured mode,
|
|
|
|
|
useful to add or remove a single flag (bit masking).
|
|
|
|
|
|
2020-11-27 05:28:57 -05:00
|
|
|
|
2021-01-29 06:31:58 -05:00
|
|
|
### Group PWM and frequency
|
2020-11-27 05:28:57 -05:00
|
|
|
|
2021-12-23 04:41:42 -05:00
|
|
|
- **void setGroupPWM(uint8_t value)** sets all channels that are part of the PWM group to value.
|
|
|
|
|
- **uint8_t getGroupPWM()** get the current PWM setting of the group.
|
|
|
|
|
- **void setGroupFREQ(value)** see datasheet for details.
|
|
|
|
|
- **uint8_t getGroupFREQ()** returns the freq of the PWM group.
|
2020-11-27 05:28:57 -05:00
|
|
|
|
|
|
|
|
|
2021-12-23 04:41:42 -05:00
|
|
|
### Miscellaneous
|
2020-11-27 05:28:57 -05:00
|
|
|
|
2021-12-23 04:41:42 -05:00
|
|
|
- **int lastError()** returns **PCA9635_OK** if all is OK, and other error codes otherwise.
|
2020-11-27 05:28:57 -05:00
|
|
|
|
2022-01-06 14:19:35 -05:00
|
|
|
| Error code | Value | Description |
|
|
|
|
|
|:------------------|:-----:|:--------------------|
|
2021-12-23 04:41:42 -05:00
|
|
|
| PCA9635_OK | 0x00 | Everything went well
|
|
|
|
|
| PCA9635_ERROR | 0xFF | Generic error
|
|
|
|
|
| PCA9635_ERR_WRITE | 0xFE | Tries to write more elements than PWM channels
|
|
|
|
|
| PCA9635_ERR_CHAN | 0xFD | Channel out of range
|
|
|
|
|
| PCA9635_ERR_MODE | 0xFC | Invalid mode
|
|
|
|
|
| PCA9635_ERR_REG | 0xFB | Invalid register
|
|
|
|
|
| PCA9635_ERR_I2C | 0xFA | PCA9635 I2C communication error
|
2020-11-27 05:28:57 -05:00
|
|
|
|
2021-12-23 04:41:42 -05:00
|
|
|
|
|
|
|
|
## Operation
|
2020-11-27 05:28:57 -05:00
|
|
|
|
|
|
|
|
See examples
|
2021-12-23 04:41:42 -05:00
|
|
|
|
|
|
|
|
|
|
|
|
|
## Future
|
|
|
|
|
|
|
|
|
|
- improve documentation
|
|
|
|
|
- unit tests
|
|
|
|
|
- add examples
|
|
|
|
|
|
|
|
|
|
|
