GY-63_MS5611/libraries/TLC5947

TLC5947

TLC5947 is an Arduino library for the TLC5947, 24 channel 12 bit, PWM module.

Description

This experimental library allows easy control over a TLC5947 module. To communicate this module uses three (bit banging) serial lines.

The TLC5947 module provides in total 24 outputs of 12 bit PWM. So it allows 4096 greyscales or levels to be set, making the output pretty well tunable. Main purpose is to drive LED's, see datasheet.

The library is experimental and needs more testing, so please share your experiences. (changes of the interface are definitely possible).

Daisy chaining

This library does NOT support daisy chaining (yet). The current version can control only 1 module. To control multiple modules, you need to give them their own clock line, and preferable their own latch line. The data can be shared (to be tested) as data won't be clocked in if the clock line is not shared.

Related

• https://www.adafruit.com/product/1429
• https://github.com/RobTillaart/TLC5947
• https://github.com/RobTillaart/PCA9634 (I2C)
• https://github.com/RobTillaart/PCA9635 (I2C)
• https://github.com/RobTillaart/PCA9685 (I2C)

Interface

#include TLC5947.h

• TLC5947(uint8_t clock, uint8_t data, uint8_t latch, uint8_t blank) constructor. Defines the pins used for uploading / writing the PWM data to the module. The blank pin is explained in more detail below.
• ~TLC5947() destructor
• bool begin() set the pinModes of the pins and their initial values.
• bool setPWM(uint8_t channel, uint16_t PWM). set a PWM value to the buffer to be written later.
  channel = 0..23, PWM = 0..4095
  Returns true if successful.
• void setAll(uint16_t PWM) set the same PWM value for all channels to the buffer, and writes them to device.
• uint16_t getPWM(uint8_t channel) get PWM value from the buffer, Note this value might differ from device when a new value is set after the last write().
• void write() writes the buffer (24 x 12 bit) to the device.

Percentage wrappers

Wrapper functions to set the device in percentages. The accuracy of these functions is about 1/4095 = ~0.025%.

Note: the percentages will be rounded to the nearest integer PWM value.

• bool setPercentage(uint8_t channel, float perc) wrapper setPWM().
  channel = 0..23, perc = 0.0 .. 100.0
  Returns true if successful.
• void setPercentageAll(float perc) wrapper setAll().
• float getPercentage(uint8_t channel) wrapper getPWM().
  Note: the error code 0xFFFF will return as 1600%.

Blank line

The blank pin (line) is used to set all channels on or off. This allows to "preload" the registers with values and enable them all at once.

• void enable() all channels reflect last updated PWM value.
• void disable() all channels are off / 0.

Performance

Writing 24 x 12 bit takes time, however is still pretty fast. On a 16 MHz UNO writing all 24 channels takes less than 4 milliseconds.

Note that all channels must be written.

platform (MHz)	version	command	time (us)	notes
AVR/UNO (16)	0.1.0	setPWM()	16	24 channels
AVR/UNO (16)	0.1.0	write()	3808	24 channels
AVR/UNO (16)	0.1.1	setPWM()	16	24 channels
AVR/UNO (16)	0.1.1	write()	804	24 channels
ESP32 (240)	0.1.0	setPWM()	6	24 channels
ESP32 (240)	0.1.0	write()	128	24 channels

Measured with TLC5947_performance.ino.

Future

Must

• update documentation
  • links etc.
  • schema for multiple devices
• buy hardware
  • test test test

Should

• setPWM() should return set value or error
  • revisit all functions..
• add examples
  • extend performance sketch
• test if partial write (e.g. first N channels) works.
• test "preloading" when module is disabled.
• "dirty" flag for bool writePending()?
  • set by setPWM() if value changes.
  • would speed up unneeded write() too.

Could

• add unit-tests
• investigate how to reduce memory usage (now 48 bytes)
  • could be 36 (12 bits / channel)
  • or even 24 (8 bits/channel) = derived class?
• add setRGB(LED, R, G, B) wrapper (channel 0..7) 24 channels == 3 x 8 RGB LEDs
• return value for setPWM() ?

Wont

Support

If you appreciate my libraries, you can support the development and maintenance. Improve the quality of the libraries by providing issues and Pull Requests, or donate through PayPal or GitHub sponsors.

Thank you,