ATOM Library

English | 中文

Description

ATOM Matrix and ATOM Lite are ESP32 development board with a size of only 24 * 24mm.It provides more GPIO for user customization which is very suitable for embedded smart home devices and in making smart toys. The main control adopts the ESP32-PICO chip which comes integrated with Wi-Fi and Bluetooth technologies and has a 4MB of integrated SPI flash memory. ATOM board provides an Infra-Red LED, RGB LED, buttons, and a PH2.0 interface. In addition, it can connect to external sensors and actuators through 6 GPIOs. The on-board Type-C USB interface enables rapid program upload and execution. ATOM Matrix have 5 * 5 RGB LED matrix, built-in IMU sensor (MPU6886).

PinMap

Neo	GPIO27
Btn	GPIO39
CLK(MPU6886)	GPIO21
SDA(MPU6886)	GPIO25
IR	GPIO12
Btn	GPIO39

GROVE interface

ESP32 chip	GPIO32	GPIO26	5V	GND
PH2.0 interface	SCL	SDA	5V	GND

Atom pixel tool

Click here to download

Display API Document

Public Types

enum	Am_mode{kMoveRight,kMoveLeft,kMoveTop,kMoveButtom}

Public Functions

void	animation(uint8_t *buffptr, uint8_t amspeed, uint8_t ammode, int64_t amcount = -1)
void	displaybuff(uint8_t *buffptr, int8_t offsetx = 0, int8_t offsety = 0)
void	MoveDisPlayBuff(int8_t offsetx = 0, int8_t offsety = 0)
void	setBrightness(uint8_t brightness)
void	drawpix(uint8_t xpos, uint8_t ypos, CRGB Color)
void	drawpix(uint8_t Number, CRGB Color)
void	fillpix(CRGB Color)
void	clear()

enum Am_mode

Constant	Value	Description
LED_Display::kMoveRight	0x01	Move the image to the right
LED_Display::kMoveLeft	0x02	Move the image to the left
LED_Display::kMoveTop	0x04	Move the image to the top
LED_Display::kMoveButtom	0x08	Move the image to the buttom

Member Function Documentation

---

    void animation(uint8_t *buffptr, uint8_t amspeed, uint8_t ammode, int64_t amcount = -1)

Start moving animation of an image

parameter list

name	type	range	default	description
buffptr	uint8_t*	-	-	Image pointer
amspeed	uint8_t	0 ~ MAXSIZE of uint8_t	-	Time interval of image movement
ammode	uint8_t	See also Am_mode	-	Animation mode of image movement
amcount	int64_t	-1 ~ MAXSIZE of int64_t	-1	The distance the image moves (pixels)

return value
null

---

    void displaybuff(uint8_t *buffptr, int8_t offsetx = 0, int8_t offsety = 0)

Display an image

parameter list

name	type	range	default	description
buffptr	uint8_t*	-	-	Image pointer
offsetx	uint8_t	-127 ~ 127	0	Horizontal image offset
offsety	uint8_t	-127 ~ 127	0	Vertical image offset

return value
null

---

    void MoveDisPlayBuff(int8_t offsetx = 0, int8_t offsety = 0)

Move the image data in the display buff

parameter list

name	type	range	default	description
offsetx	int8_t	-127 ~ 127	0	Horizontal image offset
offsety	int8_t	-127 ~ 127	0	Vertical image offset

return value
null

---

    void setBrightness(uint8_t brightness)

Set the Leds Brightness
Warning: It is not recommended to set the LED brightness to 100. Setting the LED brightness to 100 may cause overheating

parameter list

name	type	range	default	description
brightness	uint8_t	0 ~ 100	-	Brightness of Leds

return value
null

---

    void drawpix(uint8_t xpos, uint8_t ypos, CRGB Color)

Set the color of a LED in coordinate mode

parameter list

name	type	range	default	description
xpos	uint8_t	0 ~ 255	0	coordinate x
ypos	uint8_t	0 ~ 255	0	coordinate y
Color	CRGB	-	-	Color of Led

return value
null

---

    void drawpix(uint8_t Number, CRGB Color)

Set the color of a LED

parameter list

name	type	range	default	description
Number	uint8_t	0 ~ 255	0	number of Led
Color	CRGB	-	-	Color of Led

return value
null

---

    void fillpix(CRGB Color)

Set the color of all LEDs

parameter list

name	type	range	default	description
Color	CRGB	-	-	Color of Leds

return value
null

---

    void clear()

Close all of LEDs

parameter list
null

return value
null