max7219 base driver function

max7219 base driver modules More...

Data Structures
struct	max7219_handle_s
	max7219 handle structure definition More...
struct	max7219_info_s
	max7219 info structure definition More...

Typedefs
typedef struct max7219_handle_s	max7219_handle_t
	max7219 handle structure definition More...
typedef struct max7219_info_s	max7219_info_t
	max7219 info structure definition More...

Enumerations
enum	max7219_segment_t {   MAX7219_SEGMENT_A = (1 << 6) , MAX7219_SEGMENT_B = (1 << 5) , MAX7219_SEGMENT_C = (1 << 4) , MAX7219_SEGMENT_D = (1 << 3) ,   MAX7219_SEGMENT_E = (1 << 2) , MAX7219_SEGMENT_F = (1 << 1) , MAX7219_SEGMENT_G = (1 << 0) , MAX7219_SEGMENT_DP = (1 << 7) }
	max7219 segment enumeration definition More...
enum	max7219_codeb_font_t {   MAX7219_CODEB_FONT_0 = 0x00 , MAX7219_CODEB_FONT_1 = 0x01 , MAX7219_CODEB_FONT_2 = 0x02 , MAX7219_CODEB_FONT_3 = 0x03 ,   MAX7219_CODEB_FONT_4 = 0x04 , MAX7219_CODEB_FONT_5 = 0x05 , MAX7219_CODEB_FONT_6 = 0x06 , MAX7219_CODEB_FONT_7 = 0x07 ,   MAX7219_CODEB_FONT_8 = 0x08 , MAX7219_CODEB_FONT_9 = 0x09 , MAX7219_CODEB_FONT_LINE = 0x0A , MAX7219_CODEB_FONT_E = 0x0B ,   MAX7219_CODEB_FONT_H = 0x0C , MAX7219_CODEB_FONT_L = 0x0D , MAX7219_CODEB_FONT_P = 0x0E , MAX7219_CODEB_FONT_BLACK = 0x0F }
	max7219 code b font enumeration definition More...
enum	max7219_no_decode_font_t {   MAX7219_NO_DECODE_FONT_0 = 0x7E , MAX7219_NO_DECODE_FONT_1 = 0x30 , MAX7219_NO_DECODE_FONT_2 = 0x6D , MAX7219_NO_DECODE_FONT_3 = 0x79 ,   MAX7219_NO_DECODE_FONT_4 = 0x33 , MAX7219_NO_DECODE_FONT_5 = 0x5B , MAX7219_NO_DECODE_FONT_6 = 0x5F , MAX7219_NO_DECODE_FONT_7 = 0x70 ,   MAX7219_NO_DECODE_FONT_8 = 0x7F , MAX7219_NO_DECODE_FONT_9 = 0x7B , MAX7219_NO_DECODE_FONT_LINE = 0x01 , MAX7219_NO_DECODE_FONT_E = 0x4F ,   MAX7219_NO_DECODE_FONT_H = 0x37 , MAX7219_NO_DECODE_FONT_L = 0x0E , MAX7219_NO_DECODE_FONT_P = 0x67 , MAX7219_NO_DECODE_FONT_BLACK = 0x00 }
	max7219 no decode font enumeration definition More...
enum	max7219_scan_limit_t {   MAX7219_SCAN_LIMIT_DIGIT_0_0 = 0x00 , MAX7219_SCAN_LIMIT_DIGIT_0_1 = 0x01 , MAX7219_SCAN_LIMIT_DIGIT_0_2 = 0x02 , MAX7219_SCAN_LIMIT_DIGIT_0_3 = 0x03 ,   MAX7219_SCAN_LIMIT_DIGIT_0_4 = 0x04 , MAX7219_SCAN_LIMIT_DIGIT_0_5 = 0x05 , MAX7219_SCAN_LIMIT_DIGIT_0_6 = 0x06 , MAX7219_SCAN_LIMIT_DIGIT_0_7 = 0x07 }
	max7219 scan limit enumeration definition More...
enum	max7219_intensity_t {   MAX7219_INTENSITY_1_32 = 0x00 , MAX7219_INTENSITY_3_32 = 0x01 , MAX7219_INTENSITY_5_32 = 0x02 , MAX7219_INTENSITY_7_32 = 0x03 ,   MAX7219_INTENSITY_9_32 = 0x04 , MAX7219_INTENSITY_11_32 = 0x05 , MAX7219_INTENSITY_13_32 = 0x06 , MAX7219_INTENSITY_15_32 = 0x07 ,   MAX7219_INTENSITY_17_32 = 0x08 , MAX7219_INTENSITY_19_32 = 0x09 , MAX7219_INTENSITY_21_32 = 0x0A , MAX7219_INTENSITY_23_32 = 0x0B ,   MAX7219_INTENSITY_25_32 = 0x0C , MAX7219_INTENSITY_27_32 = 0x0D , MAX7219_INTENSITY_29_32 = 0x0E , MAX7219_INTENSITY_31_32 = 0x0F }
	max7219 intensity enumeration definition More...
enum	max7219_mode_t { MAX7219_MODE_SHUT_DOWN = 0x00 , MAX7219_MODE_NORMAL = 0x01 }
	max7219 mode enumeration definition More...
enum	max7219_display_test_mode_t { MAX7219_DISPLAY_TEST_MODE_OFF = 0x00 , MAX7219_DISPLAY_TEST_MODE_ON = 0x01 }
	max7219 display test mode enumeration definition More...
enum	max7219_decode_t { MAX7219_DECODE_CODEB_DIGITS_NONE = 0x00 , MAX7219_DECODE_CODEB_DIGITS_0 = 0x01 , MAX7219_DECODE_CODEB_DIGITS_3_0 = 0x0F , MAX7219_DECODE_CODEB_DIGITS_7_0 = 0xFF }
	max7219 decode enumeration definition More...
enum	max7219_digital_t {   MAX7219_DIGITAL_0 = 0x01 , MAX7219_DIGITAL_1 = 0x02 , MAX7219_DIGITAL_2 = 0x03 , MAX7219_DIGITAL_3 = 0x04 ,   MAX7219_DIGITAL_4 = 0x05 , MAX7219_DIGITAL_5 = 0x06 , MAX7219_DIGITAL_6 = 0x07 , MAX7219_DIGITAL_7 = 0x08 }
	max7219 digital enumeration definition More...

Functions
uint8_t	max7219_info (max7219_info_t *info)
	get chip's information More...
uint8_t	max7219_init (max7219_handle_t *handle)
	initialize the chip More...
uint8_t	max7219_deinit (max7219_handle_t *handle)
	close the chip More...
uint8_t	max7219_set_display (max7219_handle_t *handle, max7219_digital_t digital, uint8_t data)
	set the display content More...
uint8_t	max7219_set_matrix (max7219_handle_t *handle, uint8_t matrix[8])
	set the content matrix More...
uint8_t	max7219_set_decode (max7219_handle_t *handle, max7219_decode_t decode)
	set the decode mode More...
uint8_t	max7219_set_mode (max7219_handle_t *handle, max7219_mode_t mode)
	set the chip mode More...
uint8_t	max7219_set_display_test_mode (max7219_handle_t *handle, max7219_display_test_mode_t mode)
	set the display test mode More...
uint8_t	max7219_set_intensity (max7219_handle_t *handle, max7219_intensity_t intensity)
	set the display intensity More...
uint8_t	max7219_set_scan_limit (max7219_handle_t *handle, max7219_scan_limit_t limit)
	set the scan limit More...

Detailed Description

max7219 base driver modules

Typedef Documentation

max7219_handle_t

typedef struct max7219_handle_s max7219_handle_t

max7219 handle structure definition

max7219_info_t

typedef struct max7219_info_s max7219_info_t

max7219 info structure definition

Enumeration Type Documentation

max7219_codeb_font_t

enum max7219_codeb_font_t

max7219 code b font enumeration definition

Enumerator
MAX7219_CODEB_FONT_0	code b font 0
MAX7219_CODEB_FONT_1	code b font 1
MAX7219_CODEB_FONT_2	code b font 2
MAX7219_CODEB_FONT_3	code b font 3
MAX7219_CODEB_FONT_4	code b font 4
MAX7219_CODEB_FONT_5	code b font 5
MAX7219_CODEB_FONT_6	code b font 6
MAX7219_CODEB_FONT_7	code b font 7
MAX7219_CODEB_FONT_8	code b font 8
MAX7219_CODEB_FONT_9	code b font 9
MAX7219_CODEB_FONT_LINE	code b font line
MAX7219_CODEB_FONT_E	code b font e
MAX7219_CODEB_FONT_H	code b font h
MAX7219_CODEB_FONT_L	code b font l
MAX7219_CODEB_FONT_P	code b font p
MAX7219_CODEB_FONT_BLACK	code b font black

Definition at line 94 of file driver_max7219.h.

max7219_decode_t

enum max7219_decode_t

max7219 decode enumeration definition

Enumerator
MAX7219_DECODE_CODEB_DIGITS_NONE	decode code b digits none
MAX7219_DECODE_CODEB_DIGITS_0	decode code b digits 0
MAX7219_DECODE_CODEB_DIGITS_3_0	decode code b digits 3 - 0
MAX7219_DECODE_CODEB_DIGITS_7_0	decode code b digits 7 - 0

Definition at line 196 of file driver_max7219.h.

max7219_digital_t

enum max7219_digital_t

max7219 digital enumeration definition

Enumerator
MAX7219_DIGITAL_0	digital 0
MAX7219_DIGITAL_1	digital 1
MAX7219_DIGITAL_2	digital 2
MAX7219_DIGITAL_3	digital 3
MAX7219_DIGITAL_4	digital 4
MAX7219_DIGITAL_5	digital 5
MAX7219_DIGITAL_6	digital 6
MAX7219_DIGITAL_7	digital 7

Definition at line 207 of file driver_max7219.h.

max7219_display_test_mode_t

enum max7219_display_test_mode_t

max7219 display test mode enumeration definition

Enumerator
MAX7219_DISPLAY_TEST_MODE_OFF	test mode off
MAX7219_DISPLAY_TEST_MODE_ON	test mode on

Definition at line 187 of file driver_max7219.h.

max7219_intensity_t

enum max7219_intensity_t

max7219 intensity enumeration definition

Enumerator
MAX7219_INTENSITY_1_32	intensity 1 / 32
MAX7219_INTENSITY_3_32	intensity 3 / 32
MAX7219_INTENSITY_5_32	intensity 5 / 32
MAX7219_INTENSITY_7_32	intensity 7 / 32
MAX7219_INTENSITY_9_32	intensity 9 / 32
MAX7219_INTENSITY_11_32	intensity 11 / 32
MAX7219_INTENSITY_13_32	intensity 13 / 32
MAX7219_INTENSITY_15_32	intensity 15 / 32
MAX7219_INTENSITY_17_32	intensity 17 / 32
MAX7219_INTENSITY_19_32	intensity 19 / 32
MAX7219_INTENSITY_21_32	intensity 21 / 32
MAX7219_INTENSITY_23_32	intensity 23 / 32
MAX7219_INTENSITY_25_32	intensity 25 / 32
MAX7219_INTENSITY_27_32	intensity 27 / 32
MAX7219_INTENSITY_29_32	intensity 29 / 32
MAX7219_INTENSITY_31_32	intensity 31 / 32

Definition at line 155 of file driver_max7219.h.

max7219_mode_t

enum max7219_mode_t

max7219 mode enumeration definition

Enumerator
MAX7219_MODE_SHUT_DOWN	shut down mode
MAX7219_MODE_NORMAL	normal mode

Definition at line 178 of file driver_max7219.h.

max7219_no_decode_font_t

enum max7219_no_decode_font_t

max7219 no decode font enumeration definition

Enumerator
MAX7219_NO_DECODE_FONT_0	no decode font 0
MAX7219_NO_DECODE_FONT_1	no decode font 1
MAX7219_NO_DECODE_FONT_2	no decode font 2
MAX7219_NO_DECODE_FONT_3	no decode font 3
MAX7219_NO_DECODE_FONT_4	no decode font 4
MAX7219_NO_DECODE_FONT_5	no decode font 5
MAX7219_NO_DECODE_FONT_6	no decode font 6
MAX7219_NO_DECODE_FONT_7	no decode font 7
MAX7219_NO_DECODE_FONT_8	no decode font 8
MAX7219_NO_DECODE_FONT_9	no decode font 9
MAX7219_NO_DECODE_FONT_LINE	no decode font line
MAX7219_NO_DECODE_FONT_E	no decode font e
MAX7219_NO_DECODE_FONT_H	no decode font h
MAX7219_NO_DECODE_FONT_L	no decode font l
MAX7219_NO_DECODE_FONT_P	no decode font p
MAX7219_NO_DECODE_FONT_BLACK	no decode font black

Definition at line 117 of file driver_max7219.h.

max7219_scan_limit_t

enum max7219_scan_limit_t

max7219 scan limit enumeration definition

Enumerator
MAX7219_SCAN_LIMIT_DIGIT_0_0	scan limit digit 0 - 0
MAX7219_SCAN_LIMIT_DIGIT_0_1	scan limit digit 0 - 1
MAX7219_SCAN_LIMIT_DIGIT_0_2	scan limit digit 0 - 2
MAX7219_SCAN_LIMIT_DIGIT_0_3	scan limit digit 0 - 3
MAX7219_SCAN_LIMIT_DIGIT_0_4	scan limit digit 0 - 4
MAX7219_SCAN_LIMIT_DIGIT_0_5	scan limit digit 0 - 5
MAX7219_SCAN_LIMIT_DIGIT_0_6	scan limit digit 0 - 6
MAX7219_SCAN_LIMIT_DIGIT_0_7	scan limit digit 0 - 7

Definition at line 140 of file driver_max7219.h.

max7219_segment_t

enum max7219_segment_t

max7219 segment enumeration definition

Enumerator
MAX7219_SEGMENT_A	segment A
MAX7219_SEGMENT_B	segment B
MAX7219_SEGMENT_C	segment C
MAX7219_SEGMENT_D	segment D
MAX7219_SEGMENT_E	segment E
MAX7219_SEGMENT_F	segment F
MAX7219_SEGMENT_G	segment G
MAX7219_SEGMENT_DP	segment DP

Definition at line 79 of file driver_max7219.h.

Function Documentation

max7219_deinit()

uint8_t max7219_deinit

(

max7219_handle_t *

handle

)

close the chip

Parameters

[in]

*handle

pointer to a max7219 handle structure

Returns

status code

• 0 success
• 1 spi deinit failed
• 2 handle is NULL
• 3 handle is not initialized
• 4 power down failed

Note

none

Definition at line 443 of file driver_max7219.c.

max7219_info()

uint8_t max7219_info

(

max7219_info_t *

info

)

get chip's information

Parameters

[out]

*info

pointer to a max7219 info structure

Returns

status code

• 0 success
• 2 handle is NULL

Note

none

Definition at line 518 of file driver_max7219.c.

max7219_init()

uint8_t max7219_init

(

max7219_handle_t *

handle

)

initialize the chip

Parameters

[in]

*handle

pointer to a max7219 handle structure

Returns

status code

• 0 success
• 1 spi initialization failed
• 2 handle is NULL
• 3 linked functions is NULL

Note

none

Definition at line 380 of file driver_max7219.c.

max7219_set_decode()

uint8_t max7219_set_decode	(	max7219_handle_t *	handle,
		max7219_decode_t	decode
	)

set the decode mode

Parameters

[in]	*handle	pointer to a max7219 handle structure
[in]	decode	decode mode

Returns

status code

• 0 success
• 1 set decode failed
• 2 handle is NULL
• 3 handle is not initialized

Note

none

Definition at line 196 of file driver_max7219.c.

max7219_set_display()

uint8_t max7219_set_display	(	max7219_handle_t *	handle,
		max7219_digital_t	digital,
		uint8_t	data
	)

set the display content

Parameters

[in]	*handle	pointer to a max7219 handle structure
[in]	digital	set part
[in]	data	set data

Returns

status code

• 0 success
• 1 set display failed
• 2 handle is NULL
• 3 handle is not initialized

Note

none

Definition at line 73 of file driver_max7219.c.

max7219_set_display_test_mode()

uint8_t max7219_set_display_test_mode	(	max7219_handle_t *	handle,
		max7219_display_test_mode_t	mode
	)

set the display test mode

Parameters

[in]	*handle	pointer to a max7219 handle structure
[in]	mode	display test mode

Returns

status code

• 0 success
• 1 set display test mode failed
• 2 handle is NULL
• 3 handle is not initialized

Note

none

Definition at line 270 of file driver_max7219.c.

max7219_set_intensity()

uint8_t max7219_set_intensity	(	max7219_handle_t *	handle,
		max7219_intensity_t	intensity
	)

set the display intensity

Parameters

[in]	*handle	pointer to a max7219 handle structure
[in]	intensity	display intensity

Returns

status code

• 0 success
• 1 set intensity failed
• 2 handle is NULL
• 3 handle is not initialized

Note

none

Definition at line 307 of file driver_max7219.c.

max7219_set_matrix()

uint8_t max7219_set_matrix	(	max7219_handle_t *	handle,
		uint8_t	matrix[8]
	)

set the content matrix

Parameters

[in]	*handle	pointer to a max7219 handle structure
[in]	*matrix	pointer to a content matrix

Returns

status code

• 0 success
• 1 set matrix failed
• 2 handle is NULL
• 3 handle is not initialized

Note

none

Definition at line 108 of file driver_max7219.c.

max7219_set_mode()

uint8_t max7219_set_mode	(	max7219_handle_t *	handle,
		max7219_mode_t	mode
	)

set the chip mode

Parameters

[in]	*handle	pointer to a max7219 handle structure
[in]	mode	chip mode

Returns

status code

• 0 success
• 1 set mode failed
• 2 handle is NULL
• 3 handle is not initialized

Note

none

Definition at line 233 of file driver_max7219.c.

max7219_set_scan_limit()

uint8_t max7219_set_scan_limit	(	max7219_handle_t *	handle,
		max7219_scan_limit_t	limit
	)

set the scan limit

Parameters

[in]	*handle	pointer to a max7219 handle structure
[in]	limit	scan limit

Returns

status code

• 0 success
• 1 set scan limit failed
• 2 handle is NULL
• 3 handle is not initialized

Note

none

Definition at line 344 of file driver_max7219.c.