8x8 LED Matrix Library

Control and monitor 8x8 LED Matrix display. More...

Data Structures

struct  led_matrix8x8_frame_t
 Frame. More...
 
struct  led_matrix8x8_animate_context_t
 Animate context. More...
 
struct  led_matrix8x8_context_t
 Context. More...
 

Enumerations

enum  led_matrix8x8_operation_t {
  LED_MATRIX_NO_OPERATION = 0,
  LED_MATRIX_ROTATE90_CLOCKWISE = 1,
  LED_MATRIX_ROTATE90_ANTICLOCKWISE = 2
}
 Operation. More...
 

Functions

zos_result_t led_matrix8x8_init (zos_i2c_t i2c_port)
 Initialize.
 
void led_matrix8x8_deinit (void)
 De-initialize.
 
const led_matrix8x8_context_tled_matrix8x8_get_context (void)
 Get context.
 
zos_result_t led_matrix8x8_set_brightness (uint8_t brightness)
 Set brightness. More...
 
zos_result_t led_matrix8x8_set_blink_rate (uint8_t rate)
 Set blink rate. More...
 
zos_result_t led_matrix8x8_set_operation (led_matrix8x8_operation_t operation)
 Set operation.
 
zos_result_t led_matrix8x8_set_text (const char *text)
 Set text. More...
 
zos_result_t led_matrix8x8_get_text (const char **text)
 Get text.
 
zos_result_t led_matrix8x8_update_display (const uint8_t *display_buffer)
 Update display.
 
zos_result_t led_matrix8x8_clear_display (void)
 Clear display.
 
zos_result_t led_matrix8x8_set_scroll_rate (uint16_t rate_ms)
 Set scroll rate. More...
 
zos_result_t led_matrix8x8_animate (led_matrix8x8_animate_context_t *context, void(*populate_event_handler)(void *arg), uint8_t queue_size)
 Animate.
 
zos_result_t led_matrix8x8_flush_frames (void)
 Flush frames.
 
zos_result_t led_matrix8x8_push_frame (const led_matrix8x8_frame_t *frame, uint32_t timeout_ms)
 Push frame.
 
zos_result_t led_matrix8x8_get_current_frame (led_matrix8x8_frame_t *frame_buffer)
 Get current frame.
 

Detailed Description

Control and monitor 8x8 LED Matrix display.

Enumeration Type Documentation

Operation.

Enumerator
LED_MATRIX_NO_OPERATION 

No operation.

LED_MATRIX_ROTATE90_CLOCKWISE 

Rotate 90 degrees clockwise.

LED_MATRIX_ROTATE90_ANTICLOCKWISE 

Rotate 90 degrees anticlockwise.

Function Documentation

zos_result_t led_matrix8x8_set_blink_rate ( uint8_t  rate)

Set blink rate.

  • HT16K33_BLINKRATE_OFF 0x00
  • HT16K33_BLINKRATE_2HZ 0x01
  • HT16K33_BLINKRATE_1HZ 0x02
  • HT16K33_BLINKRATE_HALFHZ 0x03
zos_result_t led_matrix8x8_set_brightness ( uint8_t  brightness)

Set brightness.

Ht16K33_BRIGHTNESS_MAX 15

zos_result_t led_matrix8x8_set_scroll_rate ( uint16_t  rate_ms)

Set scroll rate.

Parameters
rate_msThe period in ms after which the display is scrolled a single pixel to the left.

Range 0 to 65635, however setting below 10 may result in errors. Smaller is faster.

zos_result_t led_matrix8x8_set_text ( const char *  text)

Set text.

Dynamically allocates memory depending on the length of the text text_len: DISPLAY_BUFFER_LEN + TEXT_BUFFER_LEN + text_len

where

  • DISPLAY_BUFFER_LEN = (sizeof(uint16_t)*8)
  • TEXT_BUFFER_LEN = text_len * 8