Jump to content

Component: LED Matrix (HT16K33) (LEDs): Difference between revisions

From Flowcode Help
← Older edit

SteveT (talk | contribs)

4 user groups
6,422 edits
m Text replacement - "width="10%" align="center" style="background-color:#D8C9D8;"" to "width="10%" align="center" class="mtx-class-macrohead""
m Text replacement - "style="background-color:#EAE1EA;"" to "class="mtx-class-propfolder""
 
(2 intermediate revisions by the same user not shown)
Line 79: Line 79:
|-
|-
| width="10%" align="center" class="mtx-class-macrohead" | [[File:Fc9-comp-macro.png]]
| width="10%" align="center" class="mtx-class-macrohead" | [[File:Fc9-comp-macro.png]]
| width="90%" style="background-color:#D8C9D8; color:#4B008D;" | '''ChangeAddress'''
| width="90%" class="mtx-class-macrohead" | '''ChangeAddress'''
|-
|-
| colspan="2" | Change the address and Configures the I2C peripheral and sets up the HT16K33 IC ready to drive the LEDs. Returns 0 for fail & 1 for success. 
| colspan="2" | Change the address and Configures the I2C peripheral and sets up the HT16K33 IC ready to drive the LEDs. Returns 0 for fail & 1 for success. 
Line 98: Line 98:
|-
|-
| width="10%" align="center" class="mtx-class-macrohead" | [[File:Fc9-comp-macro.png]]
| width="10%" align="center" class="mtx-class-macrohead" | [[File:Fc9-comp-macro.png]]
| width="90%" style="background-color:#D8C9D8; color:#4B008D;" | '''ClearLEDs'''
| width="90%" class="mtx-class-macrohead" | '''ClearLEDs'''
|-
|-
| colspan="2" | Sets all of the LEDs in the matrix to the off state. 
| colspan="2" | Sets all of the LEDs in the matrix to the off state. 
Line 112: Line 112:
|-
|-
| width="10%" align="center" class="mtx-class-macrohead" | [[File:Fc9-comp-macro.png]]
| width="10%" align="center" class="mtx-class-macrohead" | [[File:Fc9-comp-macro.png]]
| width="90%" style="background-color:#D8C9D8; color:#4B008D;" | '''DisplayString'''
| width="90%" class="mtx-class-macrohead" | '''DisplayString'''
|-
|-
| colspan="2" | Prints an ASCII string onto the LED Matrix a column at a time. 
| colspan="2" | Prints an ASCII string onto the LED Matrix a column at a time. 
Line 151: Line 151:
|-
|-
| width="10%" align="center" class="mtx-class-macrohead" | [[File:Fc9-comp-macro.png]]
| width="10%" align="center" class="mtx-class-macrohead" | [[File:Fc9-comp-macro.png]]
| width="90%" style="background-color:#D8C9D8; color:#4B008D;" | '''Initialise'''
| width="90%" class="mtx-class-macrohead" | '''Initialise'''
|-
|-
| colspan="2" | Configures the I2C peripheral and sets up the HT16K33 IC ready to drive the LEDs. 
| colspan="2" | Configures the I2C peripheral and sets up the HT16K33 IC ready to drive the LEDs. 
Line 165: Line 165:
|-
|-
| width="10%" align="center" class="mtx-class-macrohead" | [[File:Fc9-comp-macro.png]]
| width="10%" align="center" class="mtx-class-macrohead" | [[File:Fc9-comp-macro.png]]
| width="90%" style="background-color:#D8C9D8; color:#4B008D;" | '''SetBrightness'''
| width="90%" class="mtx-class-macrohead" | '''SetBrightness'''
|-
|-
| colspan="2" | Configures the brightness of the LEDs by varying the On portion of the duty. 
| colspan="2" | Configures the brightness of the LEDs by varying the On portion of the duty. 
Line 184: Line 184:
|-
|-
| width="10%" align="center" class="mtx-class-macrohead" | [[File:Fc9-comp-macro.png]]
| width="10%" align="center" class="mtx-class-macrohead" | [[File:Fc9-comp-macro.png]]
| width="90%" style="background-color:#D8C9D8; color:#4B008D;" | '''ShiftColumns'''
| width="90%" class="mtx-class-macrohead" | '''ShiftColumns'''
|-
|-
| colspan="2" | Shifts the columns one place left or right.  Used for things like displaying scrolling text. 
| colspan="2" | Shifts the columns one place left or right.  Used for things like displaying scrolling text. 
Line 203: Line 203:
|-
|-
| width="10%" align="center" class="mtx-class-macrohead" | [[File:Fc9-comp-macro.png]]
| width="10%" align="center" class="mtx-class-macrohead" | [[File:Fc9-comp-macro.png]]
| width="90%" style="background-color:#D8C9D8; color:#4B008D;" | '''WriteColumn'''
| width="90%" class="mtx-class-macrohead" | '''WriteColumn'''
|-
|-
| colspan="2" | Allows a single column of 8 LEDs to be controlled in a single action. 
| colspan="2" | Allows a single column of 8 LEDs to be controlled in a single action. 
Line 227: Line 227:
|-
|-
| width="10%" align="center" class="mtx-class-macrohead" | [[File:Fc9-comp-macro.png]]
| width="10%" align="center" class="mtx-class-macrohead" | [[File:Fc9-comp-macro.png]]
| width="90%" style="background-color:#D8C9D8; color:#4B008D;" | '''WriteCommand'''
| width="90%" class="mtx-class-macrohead" | '''WriteCommand'''
|-
|-
| colspan="2" | Writes a command. 
| colspan="2" | Writes a command. 
Line 246: Line 246:
|-
|-
| width="10%" align="center" class="mtx-class-macrohead" | [[File:Fc9-comp-macro.png]]
| width="10%" align="center" class="mtx-class-macrohead" | [[File:Fc9-comp-macro.png]]
| width="90%" style="background-color:#D8C9D8; color:#4B008D;" | '''WriteLED'''
| width="90%" class="mtx-class-macrohead" | '''WriteLED'''
|-
|-
| colspan="2" | Allows a single LED to be controlled using the basic column / row coordinate system. Each column is comprised of 8 rows. 
| colspan="2" | Allows a single LED to be controlled using the basic column / row coordinate system. Each column is comprised of 8 rows. 
Line 275: Line 275:
|-
|-
| width="10%" align="center" class="mtx-class-macrohead" | [[File:Fc9-comp-macro.png]]
| width="10%" align="center" class="mtx-class-macrohead" | [[File:Fc9-comp-macro.png]]
| width="90%" style="background-color:#D8C9D8; color:#4B008D;" | '''WriteLEDXY'''
| width="90%" class="mtx-class-macrohead" | '''WriteLEDXY'''
|-
|-
| colspan="2" | Allows a single LED to be controlled using a more standard X, Y coordinate system. 0,0 refers to the bottom left hand LED. Only works with the fixed display modules, custom module not supported. 
| colspan="2" | Allows a single LED to be controlled using a more standard X, Y coordinate system. 0,0 refers to the bottom left hand LED. Only works with the fixed display modules, custom module not supported. 
Line 304: Line 304:
|-
|-
| width="10%" align="center" class="mtx-class-macrohead" | [[File:Fc9-comp-macro.png]]
| width="10%" align="center" class="mtx-class-macrohead" | [[File:Fc9-comp-macro.png]]
| width="90%" style="background-color:#D8C9D8; color:#4B008D;" | '''WriteRegister'''
| width="90%" class="mtx-class-macrohead" | '''WriteRegister'''
|-
|-
| colspan="2" | Writes a value to a register. 
| colspan="2" | Writes a value to a register. 
Line 329: Line 329:
|-
|-
| width="10%" align="center" class="mtx-class-macrohead" | [[File:Fc9-prop-icon.png]]
| width="10%" align="center" class="mtx-class-macrohead" | [[File:Fc9-prop-icon.png]]
| width="90%" style="background-color:#D8C9D8; color:#4B008D;" | '''Properties'''  
| width="90%" class="mtx-class-macrohead" | '''Properties'''  
|-
|-
|-
|-
Line 342: Line 342:
| colspan="2" | Total number of LEDs in the component 
| colspan="2" | Total number of LEDs in the component 
|-
|-
| width="10%" align="center" style="background-color:#EAE1EA;" | [[File:Fc9-conn-icon.png]]
| width="10%" align="center" class="mtx-class-propfolder" | [[File:Fc9-conn-icon.png]]
| width="90%" style="background-color:#EAE1EA; color:#4B008D;" | Connections
| width="90%" class="mtx-class-propfolder" | Connections
|-
|-
|-
|-
Line 381: Line 381:
| colspan="2" | Pin used for SCL (clock signal) 
| colspan="2" | Pin used for SCL (clock signal) 
|-
|-
| width="10%" align="center" style="background-color:#EAE1EA;" | [[File:Fc9-conn-icon.png]]
| width="10%" align="center" class="mtx-class-propfolder" | [[File:Fc9-conn-icon.png]]
| width="90%" style="background-color:#EAE1EA; color:#4B008D;" | Colours
| width="90%" class="mtx-class-propfolder" | Colours
|-
|-
|-
|-
Line 405: Line 405:
| colspan="2" |  
| colspan="2" |  
|-
|-
| width="10%" align="center" style="background-color:#EAE1EA;" | [[File:Fc9-conn-icon.png]]
| width="10%" align="center" class="mtx-class-propfolder" | [[File:Fc9-conn-icon.png]]
| width="90%" style="background-color:#EAE1EA; color:#4B008D;" | Simulation
| width="90%" class="mtx-class-propfolder" | Simulation
|-
|-
|-
|-
Line 414: Line 414:
| colspan="2" | Sets the simulation type. Component GUI allows the object on the panel to reflect what the reakl life LED matrix should do. I2C Injector allows the I2C communications to be simulated via injectors. 
| colspan="2" | Sets the simulation type. Component GUI allows the object on the panel to reflect what the reakl life LED matrix should do. I2C Injector allows the I2C communications to be simulated via injectors. 
|-
|-
| width="10%" align="center" style="background-color:#EAE1EA;" | [[File:Fc9-conn-icon.png]]
| width="10%" align="center" class="mtx-class-propfolder" | [[File:Fc9-conn-icon.png]]
| width="90%" style="background-color:#EAE1EA; color:#4B008D;" | GUI
| width="90%" class="mtx-class-propfolder" | GUI
|-
|-
|-
|-

Latest revision as of 14:37, 13 July 2026

Author Matrix Ltd
Version 2.0
Category LEDs


LED Matrix component

LED Matrix component designed to work using a HT16K33 LED driver IC. Can drive up to 16 x 8 (128) LEDs. Includes support for 8x16 Backpack, 16x8 Featherwing, 8x8 Backpack and Custom.

Version information

Library Version, Component Version, Date, Author, Info
12, 1.0, 12-03-25, MW, Modified  component icon to look better in dark mode


Detailed description

No detailed description exists yet for this component

Examples

Example to display a bitmap image on the LED matrix using the Bitmap Drawer component.

File:HT16K33 Bitmap.zip







Macro reference

ChangeAddress

ChangeAddress
Change the address and Configures the I2C peripheral and sets up the HT16K33 IC ready to drive the LEDs. Returns 0 for fail & 1 for success. 
- BYTE SlaveAddress
New slave address 0x70 - 0x78 (112-120) 
- BOOL Return


ClearLEDs

ClearLEDs
Sets all of the LEDs in the matrix to the off state. 
- VOID Return


DisplayString

DisplayString
Prints an ASCII string onto the LED Matrix a column at a time. 
- STRING Data
Data string to display on the LEDs 
- UINT Animation_Delay
Delay in milliseconds between writing to the next column 
- BYTE Leadout
Allows the text to scroll completely off the display before returning 0=No, 1=Yes 
- BYTE Add_Spaces
Add spaces between each ASCII character 0=No, 1=Yes 
- BYTE Orientation
0=Normal, 1=Rotated 90 Degrees 
- VOID Return


Initialise

Initialise
Configures the I2C peripheral and sets up the HT16K33 IC ready to drive the LEDs. 
- VOID Return


SetBrightness

SetBrightness
Configures the brightness of the LEDs by varying the On portion of the duty. 
- BYTE Brightness
Range: 0-15 - 0 = Min Brightness, 15 = Full Brightness 
- VOID Return


ShiftColumns

ShiftColumns
Shifts the columns one place left or right. Used for things like displaying scrolling text. 
- BYTE Direction
0 = Shift Left, 1 = Shift Right 
- VOID Return


WriteColumn

WriteColumn
Allows a single column of 8 LEDs to be controlled in a single action. 
- BYTE Column
Range: 0-15 
- BYTE Data
Data to display on the column of LEDs 
- VOID Return


WriteCommand

WriteCommand
Writes a command. 
- BYTE Command
 
- VOID Return


WriteLED

WriteLED
Allows a single LED to be controlled using the basic column / row coordinate system. Each column is comprised of 8 rows. 
- BYTE Column
Range: 0-15 
- BYTE Row
Range: 0-7 
- BYTE Data
0 = LED Off, 1 = LED On 
- VOID Return


WriteLEDXY

WriteLEDXY
Allows a single LED to be controlled using a more standard X, Y coordinate system. 0,0 refers to the bottom left hand LED. Only works with the fixed display modules, custom module not supported. 
- BYTE X
X coordinate. Range: 0-15 
- BYTE Y
Y coordinate. Range: 0-15 
- BYTE State
State 0=Off, 1=On 
- VOID Return


WriteRegister

WriteRegister
Writes a value to a register. 
- BYTE Address
 
- BYTE Value
 
- VOID Return


Property reference

Properties
Display Module
Selects the layout of the module you are controlling. Several modules are available in pre wired formats to provide an off the shelf LED matrix. 
LED Count
Total number of LEDs in the component 
Connections
Slave Address
Sets the software device slave address. Must be configured to match the wiring of the three hardware address pins. 
Channel
Channel selection 
Baud Select
Baud rate option selector 
Baud Rate
Baud rate to be used 
Stop Delay
On older microcontroller devices there is a potential for the I2C hardware channel to lock up if there is not a 10ms delay between an I2C stop event and the next I2C start event. Most modern microcontrollers will not have a problem so this property can be disabled to speed up the I2C communications.  
SDA
Pin used for SDA (data signal) 
SCL
Pin used for SCL (clock signal) 
Colours
On Color
Simulated colour of the LEDs when switched On 
Off Color
Simulated colour of the LEDs when switched Off 
PCB Colour
 
Label Colour
 
Simulation
Simulation Type
Sets the simulation type. Component GUI allows the object on the panel to reflect what the reakl life LED matrix should do. I2C Injector allows the I2C communications to be simulated via injectors. 
GUI
Column Spacing
Simulation column spacing 
Width
Simulation LED width 
Row Spacing
Simulation row spacing 
Height
Simulated LED height 
Depth
Simulated LED Depth (3D environments only) 
LED Shape
Simulated LED basic shape  

Component Source Code

Please click here to download the component source project: FC_Comp_Source_LED_Matrix_HT16K33.fcfx

Please click here to view the component source code (Beta): FC_Comp_Source_LED_Matrix_HT16K33.fcfx

Retrieved from "https://www.flowcode.co.uk/wiki/index.php?title=Component:_LED_Matrix_(HT16K33)_(LEDs)&oldid=48206"