네오픽셀 매트릭스
일반
WS281x (네오픽셀)을 이용한 매트릭스 라이브러리입니다. 문자, 도형, 그림등을 표시할 수 있으며, 여러 개의 매트릭스를 연결하여 전광판과 같은 대형 디스플레이로 사용할 수 있습니다.
사용 가능한 GPIO
- 라즈베리파이 0~4
명령
[INIT]
초기 설정을 입력합니다.
| 항목 | 타입 | 설명 |
|---|---|---|
| GPIO 핀 * | WRITE | LED와 연결된 GPIO핀 번호를 입력합니다. |
| 가로픽셀 갯수 | WRITE | 매트릭스 1개의 가로픽셀 갯수를 입력합니다. |
| 세로픽셀 갯수 | WRITE | 매트릭스 1개의 세로픽셀 갯수를 입력합니다. |
| 첫번째픽셀의 위치 | WRITE | 매트릭스에서 시작픽셀의 위치를 선택합니다.라즈베리파이 GPIO와 연결되는 LED를 의미합니다.(좌측상단,우측상단,좌측하단,우측하단) |
| 픽셀의 배치방향 | WRITE | 매트릭스에서 픽셀이 배치(연결)된 방향을 선택합니다. (가로, 세로) |
| 픽셀의 배치방식 ² | WRITE | 매트릭스에서 픽셀이 배치(연결)된 방식을 선택합니다. (프로그래시브,지그재그) |
| 모듈타입 | WRITE | 모듈의 타입을 선택합니다. (WS281x,SK6812) |
| 작동주파수 | WRITE | 모듈의 작동 주파수를 선택합니다.(400kHz, 800kHz) |
| RGB순서 | WRITE | 모듈의 RGB순서를 선택합니다. (RGB,RBG,GRB,GBR,BRG,BGR,RGBW,RBGW,GRBW,GBRW,BRGW,BGRW) |
| 매트릭스 가로방향 개수 | WRITE | 가로방향으로 매트릭스가 배치된 갯수입니다. |
| 매트릭스 세로방향 개수 | WRITE | 세로방향으로 매트릭스가 배치된 갯수입니다. |
| 첫번째 매트릭스 위치 | WRITE | 첫번째 매트릭스의 위치를 선택합니다. (좌측상단,우측상단,좌측하단,우측하단) |
| 매트릭스의 배치방향 | WRITE | 매트릭스가 배치(연결)된 방향을 선택합니다. (가로, 세로) |
| 매트릭스의 배치방식 ** | WRITE | 매트릭스가 배치(연결)된 방식을 선택합니다.(프로그래시브,지그재그) |
* 라즈베리파이 모델에 따라 특정 GPIO핀만 사용가능합니다. 네오픽셀 (WS281x) LED 라이브러리를 참고합니다.
** 픽셀 또는 매트릭스의 배치방식 (프로그래시브, 지그재그)에 대한 설명은 아래와 같습니다.
** 픽셀 또는 매트릭스의 배치방식 (프로그래시브, 지그재그)에 대한 설명은 아래와 같습니다.
매트릭스의 방향, 배치관련 초기설정 예시는 아래와 같습니다.
| 항목 | 값 |
|---|---|
| 가로픽셀 갯수 | 8 |
| 세로픽셀 갯수 | 8 |
| 첫번째픽셀의 위치 | 좌측상단 |
| 픽셀의 배치방향 | 가로 |
| 픽셀의 배치방식 | 프로그래시브 |
| 매트릭스 가로방향 개수 | 3 |
| 매트릭스 세로방향 개수 | 2 |
| 첫번째 매트릭스 위치 | 좌측상단 |
| 매트릭스의 배치방향 | 세로 |
| 매트릭스의 배치방식 | 지그재그 |
[SET_BRIGHTNESS]
매트릭스의 밝기를 설정합니다.
| 항목 | 타입 | 설명 |
|---|---|---|
| 밝기 | WRITE | 연결된 모든 LED의 밝기를 설정합니다. (0~255) |
[SET_ROTATION]
매트릭스의 표시방향을 설정합니다.
| 항목 | 타입 | 설명 |
|---|---|---|
| 회전방향 | WRITE | 매트릭스에 문자, 그림등이 표시되는 방향을 선택합니다. (0도,90도,180도,270도) |
[SET_CURSOR]
매트릭스에 텍스트를 쓸 위치를 지정합니다.
| 항목 | 타입 | 설명 |
|---|---|---|
| 위치(x) | WRITE | 텍스트의 시작위치(x)를 입력합니다. 가장 왼쪽 픽셀이 0 이며, 오른쪽으로 갈수록 증가합니다. |
| 위치(y) | WRITE | 텍스트의 시작위치(y)를 입력합니다. 가장 위의 픽셀이 0이며, 아래로 갈수록 증가합니다. |
[PRINT_TEXT]
매트릭스에 텍스트를 설정합니다. SHOW 명령을 실행해야 디스플레이에 표시됩니다.
| 항목 | 타입 | 설명 |
|---|---|---|
| 텍스트 | WRITE | 표시할 텍스트를 입력합니다. |
| 크기 | WRITE | 텍스트의 크기입니다. (1~255) |
| 자동줄바꿈 | WRITE | 텍스트가 가로 표시길이를 초과할 경우 자동줄바꿈을 할지 여부를 결정합니다. |
| 색상 타입 | WRITE | 설정할 색상의 타입을 선택합니다. |
색상 타입 : RGB
| 항목 | 타입 | 설명 |
|---|---|---|
| R | WRITE | 색상의 R성분을 입력합니다. (0~255) |
| G | WRITE | 색상의 G성분을 입력합니다. (0~255) |
| B | WRITE | 색상의 B성분을 입력합니다. (0~255) |
| W | WRITE | 색상의 W성분을 입력합니다. (0~255, RGBW 타입의 LED만 해당) |
색상 타입 : HSV
| 항목 | 타입 | 설명 |
|---|---|---|
| H | WRITE | 색상의 H (Hue)성분을 입력합니다. (0~360) |
| S | WRITE | 색상의 S (Saturation, 채도)성분을 입력합니다. (0~100) |
| V | WRITE | 색상의 V (Value, 명도)성분을 입력합니다. (0~100) |
[DRAW_PIXEL]
매트릭스의 지정위치의 픽셀을 설정합니다. SHOW 명령을 실행해야 디스플레이에 표시됩니다.
| 항목 | 타입 | 설명 |
|---|---|---|
| 위치(x) | WRITE | 픽셀의 위치(x)를 입력합니다. 가장 왼쪽 픽셀이 0 이며, 오른쪽으로 갈수록 증가합니다. |
| 위치(y) | WRITE | 픽셀의 위치(y)를 입력합니다. 가장 위의 픽셀이 0이며, 아래로 갈수록 증가합니다. |
| 색상 타입 | WRITE | 설정할 색상의 타입을 선택합니다. |
색상 타입 : RGB
| 항목 | 타입 | 설명 |
|---|---|---|
| R | WRITE | 색상의 R성분을 입력합니다. (0~255) |
| G | WRITE | 색상의 G성분을 입력합니다. (0~255) |
| B | WRITE | 색상의 B성분을 입력합니다. (0~255) |
| W | WRITE | 색상의 W성분을 입력합니다. (0~255, RGBW 타입의 LED만 해당) |
색상 타입 : HSV
| 항목 | 타입 | 설명 |
|---|---|---|
| H | WRITE | 색상의 H (Hue)성분을 입력합니다. (0~360) |
| S | WRITE | 색상의 S (Saturation, 채도)성분을 입력합니다. (0~100) |
| V | WRITE | 색상의 V (Value, 명도)성분을 입력합니다. (0~100) |
[DRAW_LINE]
매트릭스에 직선을 설정합니다. SHOW 명령을 실행해야 디스플레이에 표시됩니다.
| 항목 | 타입 | 설명 |
|---|---|---|
| 시작점(x) | WRITE | 직선의 시작점 위치(x)를 입력합니다. 가장 왼쪽 픽셀이 0 이며, 오른쪽으로 갈수록 증가합니다. |
| 시작점(y) | WRITE | 직선의 시작점 위치(y)를 입력합니다. 가장 위의 픽셀이 0이며, 아래로 갈수록 증가합니다. |
| 종료점(x) | WRITE | 직선의 종료점 위치(x)를 입력합니다. 가장 왼쪽 픽셀이 0 이며, 오른쪽으로 갈수록 증가합니다. |
| 종료점(y) | WRITE | 직선의 종료점 위치(y)를 입력합니다. 가장 위의 픽셀이 0이며, 아래로 갈수록 증가합니다. |
| 색상 타입 | WRITE | 설정할 색상의 타입을 선택합니다. |
색상 타입 : RGB
| 항목 | 타입 | 설명 |
|---|---|---|
| R | WRITE | 색상의 R성분을 입력합니다. (0~255) |
| G | WRITE | 색상의 G성분을 입력합니다. (0~255) |
| B | WRITE | 색상의 B성분을 입력합니다. (0~255) |
| W | WRITE | 색상의 W성분을 입력합니다. (0~255, RGBW 타입의 LED만 해당) |
색상 타입 : HSV
| 항목 | 타입 | 설명 |
|---|---|---|
| H | WRITE | 색상의 H (Hue)성분을 입력합니다. (0~360) |
| S | WRITE | 색상의 S (Saturation, 채도)성분을 입력합니다. (0~100) |
| V | WRITE | 색상의 V (Value, 명도)성분을 입력합니다. (0~100) |
[DRAW_TRIANGLE]
매트릭스에 속이 빈 삼각형을 설정합니다. SHOW 명령을 실행해야 디스플레이에 표시됩니다.
| 항목 | 타입 | 설명 |
|---|---|---|
| 점1(x) | WRITE | 삼각형의 점1의 위치(x)를 입력합니다. 가장 왼쪽 픽셀이 0 이며, 오른쪽으로 갈수록 증가합니다. |
| 점1(y) | WRITE | 삼각형의 점1의 위치(y)를 입력합니다. 가장 위의 픽셀이 0이며, 아래로 갈수록 증가합니다. |
| 점2(x) | WRITE | 삼각형의 점2의 위치(x)를 입력합니다. 가장 왼쪽 픽셀이 0 이며, 오른쪽으로 갈수록 증가합니다. |
| 점2(y) | WRITE | 삼각형의 점2의 위치(y)를 입력합니다. 가장 위의 픽셀이 0이며, 아래로 갈수록 증가합니다. |
| 점3(x) | WRITE | 삼각형의 점3의 위치(x)를 입력합니다. 가장 왼쪽 픽셀이 0 이며, 오른쪽으로 갈수록 증가합니다. |
| 점3(y) | WRITE | 삼각형의 점3의 위치(y)를 입력합니다. 가장 위의 픽셀이 0이며, 아래로 갈수록 증가합니다. |
| 색상 타입 | WRITE | 설정할 색상의 타입을 선택합니다. |
색상 타입 : RGB
| 항목 | 타입 | 설명 |
|---|---|---|
| R | WRITE | 색상의 R성분을 입력합니다. (0~255) |
| G | WRITE | 색상의 G성분을 입력합니다. (0~255) |
| B | WRITE | 색상의 B성분을 입력합니다. (0~255) |
| W | WRITE | 색상의 W성분을 입력합니다. (0~255, RGBW 타입의 LED만 해당) |
색상 타입 : HSV
| 항목 | 타입 | 설명 |
|---|---|---|
| H | WRITE | 색상의 H (Hue)성분을 입력합니다. (0~360) |
| S | WRITE | 색상의 S (Saturation, 채도)성분을 입력합니다. (0~100) |
| V | WRITE | 색상의 V (Value, 명도)성분을 입력합니다. (0~100) |
[FILL_TRIANGLE]
매트릭스에 속이 찬 삼각형을 설정합니다. SHOW 명령을 실행해야 디스플레이에 표시됩니다.
| 항목 | 타입 | 설명 |
|---|---|---|
| 점1(x) | WRITE | 삼각형의 점1의 위치(x)를 입력합니다. 가장 왼쪽 픽셀이 0 이며, 오른쪽으로 갈수록 증가합니다. |
| 점1(y) | WRITE | 삼각형의 점1의 위치(y)를 입력합니다. 가장 위의 픽셀이 0이며, 아래로 갈수록 증가합니다. |
| 점2(x) | WRITE | 삼각형의 점2의 위치(x)를 입력합니다. 가장 왼쪽 픽셀이 0 이며, 오른쪽으로 갈수록 증가합니다. |
| 점2(y) | WRITE | 삼각형의 점2의 위치(y)를 입력합니다. 가장 위의 픽셀이 0이며, 아래로 갈수록 증가합니다. |
| 점3(x) | WRITE | 삼각형의 점3의 위치(x)를 입력합니다. 가장 왼쪽 픽셀이 0 이며, 오른쪽으로 갈수록 증가합니다. |
| 점3(y) | WRITE | 삼각형의 점3의 위치(y)를 입력합니다. 가장 위의 픽셀이 0이며, 아래로 갈수록 증가합니다. |
| 색상 타입 | WRITE | 설정할 색상의 타입을 선택합니다. |
색상 타입 : RGB
| 항목 | 타입 | 설명 |
|---|---|---|
| R | WRITE | 색상의 R성분을 입력합니다. (0~255) |
| G | WRITE | 색상의 G성분을 입력합니다. (0~255) |
| B | WRITE | 색상의 B성분을 입력합니다. (0~255) |
| W | WRITE | 색상의 W성분을 입력합니다. (0~255, RGBW 타입의 LED만 해당) |
색상 타입 : HSV
| 항목 | 타입 | 설명 |
|---|---|---|
| H | WRITE | 색상의 H (Hue)성분을 입력합니다. (0~360) |
| S | WRITE | 색상의 S (Saturation, 채도)성분을 입력합니다. (0~100) |
| V | WRITE | 색상의 V (Value, 명도)성분을 입력합니다. (0~100) |
[DRAW_RECT]
매트릭스에 속이 빈 사각형을 설정합니다. SHOW 명령을 실행해야 디스플레이에 표시됩니다.
| 항목 | 타입 | 설명 |
|---|---|---|
| 시작점(x) | WRITE | 사각형의 시작점(왼쪽상단)의 위치(x)를 입력합니다. 가장 왼쪽 픽셀이 0 이며, 오른쪽으로 갈수록 증가합니다. |
| 시작점(y) | WRITE | 사각형의 시작점(왼쪽상단)의 위치(y)를 입력합니다. 가장 위의 픽셀이 0이며, 아래로 갈수록 증가합니다. |
| 가로길이 | WRITE | 사각형의 가로길이를 입력합니다. |
| 세로길이 | WRITE | 사각형의 세로길이를 입력합니다. |
| 색상 타입 | WRITE | 설정할 색상의 타입을 선택합니다. |
색상 타입 : RGB
| 항목 | 타입 | 설명 |
|---|---|---|
| R | WRITE | 색상의 R성분을 입력합니다. (0~255) |
| G | WRITE | 색상의 G성분을 입력합니다. (0~255) |
| B | WRITE | 색상의 B성분을 입력합니다. (0~255) |
| W | WRITE | 색상의 W성분을 입력합니다. (0~255, RGBW 타입의 LED만 해당) |
색상 타입 : HSV
| 항목 | 타입 | 설명 |
|---|---|---|
| H | WRITE | 색상의 H (Hue)성분을 입력합니다. (0~360) |
| S | WRITE | 색상의 S (Saturation, 채도)성분을 입력합니다. (0~100) |
| V | WRITE | 색상의 V (Value, 명도)성분을 입력합니다. (0~100) |
[FILL_RECT]
매트릭스에 속이 찬 사각형을 설정합니다. SHOW 명령을 실행해야 디스플레이에 표시됩니다.
| 항목 | 타입 | 설명 |
|---|---|---|
| 시작점(x) | WRITE | 사각형의 시작점(왼쪽상단)의 위치(x)를 입력합니다. 가장 왼쪽 픽셀이 0 이며, 오른쪽으로 갈수록 증가합니다. |
| 시작점(y) | WRITE | 사각형의 시작점(왼쪽상단)의 위치(y)를 입력합니다. 가장 위의 픽셀이 0이며, 아래로 갈수록 증가합니다. |
| 가로길이 | WRITE | 사각형의 가로길이를 입력합니다. |
| 세로길이 | WRITE | 사각형의 세로길이를 입력합니다. |
| 색상 타입 | WRITE | 설정할 색상의 타입을 선택합니다. |
색상 타입 : RGB
| 항목 | 타입 | 설명 |
|---|---|---|
| R | WRITE | 색상의 R성분을 입력합니다. (0~255) |
| G | WRITE | 색상의 G성분을 입력합니다. (0~255) |
| B | WRITE | 색상의 B성분을 입력합니다. (0~255) |
| W | WRITE | 색상의 W성분을 입력합니다. (0~255, RGBW 타입의 LED만 해당) |
색상 타입 : HSV
| 항목 | 타입 | 설명 |
|---|---|---|
| H | WRITE | 색상의 H (Hue)성분을 입력합니다. (0~360) |
| S | WRITE | 색상의 S (Saturation, 채도)성분을 입력합니다. (0~100) |
| V | WRITE | 색상의 V (Value, 명도)성분을 입력합니다. (0~100) |
[DRAW_ROUND_RECT]
매트릭스에 속이 빈 모서리가 둥근 사각형을 설정합니다. SHOW 명령을 실행해야 디스플레이에 표시됩니다.
| 항목 | 타입 | 설명 |
|---|---|---|
| 시작점(x) | WRITE | 사각형의 시작점(왼쪽상단)의 위치(x)를 입력합니다. 가장 왼쪽 픽셀이 0 이며, 오른쪽으로 갈수록 증가합니다. |
| 시작점(y) | WRITE | 사각형의 시작점(왼쪽상단)의 위치(y)를 입력합니다. 가장 위의 픽셀이 0이며, 아래로 갈수록 증가합니다. |
| 가로길이 | WRITE | 사각형의 가로길이를 입력합니다. |
| 세로길이 | WRITE | 사각형의 세로길이를 입력합니다. |
| 모서리반지름 | WRITE | 사각형 모서리의 반지름을 입력합니다. |
| 색상 타입 | WRITE | 설정할 색상의 타입을 선택합니다. |
색상 타입 : RGB
| 항목 | 타입 | 설명 |
|---|---|---|
| R | WRITE | 색상의 R성분을 입력합니다. (0~255) |
| G | WRITE | 색상의 G성분을 입력합니다. (0~255) |
| B | WRITE | 색상의 B성분을 입력합니다. (0~255) |
| W | WRITE | 색상의 W성분을 입력합니다. (0~255, RGBW 타입의 LED만 해당) |
색상 타입 : HSV
| 항목 | 타입 | 설명 |
|---|---|---|
| H | WRITE | 색상의 H (Hue)성분을 입력합니다. (0~360) |
| S | WRITE | 색상의 S (Saturation, 채도)성분을 입력합니다. (0~100) |
| V | WRITE | 색상의 V (Value, 명도)성분을 입력합니다. (0~100) |
[FILL_ROUND_RECT]
매트릭스에 속이 찬 모서리가 둥근 사각형을 설정합니다. SHOW 명령을 실행해야 디스플레이에 표시됩니다.
| 항목 | 타입 | 설명 |
|---|---|---|
| 시작점(x) | WRITE | 사각형의 시작점(왼쪽상단)의 위치(x)를 입력합니다. 가장 왼쪽 픽셀이 0 이며, 오른쪽으로 갈수록 증가합니다. |
| 시작점(y) | WRITE | 사각형의 시작점(왼쪽상단)의 위치(y)를 입력합니다. 가장 위의 픽셀이 0이며, 아래로 갈수록 증가합니다. |
| 가로길이 | WRITE | 사각형의 가로길이를 입력합니다. |
| 세로길이 | WRITE | 사각형의 세로길이를 입력합니다. |
| 모서리반지름 | WRITE | 사각형 모서리의 반지름을 입력합니다. |
| 색상 타입 | WRITE | 설정할 색상의 타입을 선택합니다. |
색상 타입 : RGB
| 항목 | 타입 | 설명 |
|---|---|---|
| R | WRITE | 색상의 R성분을 입력합니다. (0~255) |
| G | WRITE | 색상의 G성분을 입력합니다. (0~255) |
| B | WRITE | 색상의 B성분을 입력합니다. (0~255) |
| W | WRITE | 색상의 W성분을 입력합니다. (0~255, RGBW 타입의 LED만 해당) |
색상 타입 : HSV
| 항목 | 타입 | 설명 |
|---|---|---|
| H | WRITE | 색상의 H (Hue)성분을 입력합니다. (0~360) |
| S | WRITE | 색상의 S (Saturation, 채도)성분을 입력합니다. (0~100) |
| V | WRITE | 색상의 V (Value, 명도)성분을 입력합니다. (0~100) |
[DRAW_CIRCLE]
매트릭스에 속이 빈 원을 설정합니다. SHOW 명령을 실행해야 디스플레이에 표시됩니다.
| 항목 | 타입 | 설명 |
|---|---|---|
| 중심(x) | WRITE | 원의 중심의 위치(x)를 입력합니다. 가장 왼쪽 픽셀이 0 이며, 오른쪽으로 갈수록 증가합니다. |
| 중심(y) | WRITE | 원의 중심의 위치(y)를 입력합니다. 가장 위의 픽셀이 0이며, 아래로 갈수록 증가합니다. |
| 반지름 | WRITE | 원의 반지름을 입력합니다. |
| 색상 타입 | WRITE | 설정할 색상의 타입을 선택합니다. |
색상 타입 : RGB
| 항목 | 타입 | 설명 |
|---|---|---|
| R | WRITE | 색상의 R성분을 입력합니다. (0~255) |
| G | WRITE | 색상의 G성분을 입력합니다. (0~255) |
| B | WRITE | 색상의 B성분을 입력합니다. (0~255) |
| W | WRITE | 색상의 W성분을 입력합니다. (0~255, RGBW 타입의 LED만 해당) |
색상 타입 : HSV
| 항목 | 타입 | 설명 |
|---|---|---|
| H | WRITE | 색상의 H (Hue)성분을 입력합니다. (0~360) |
| S | WRITE | 색상의 S (Saturation, 채도)성분을 입력합니다. (0~100) |
| V | WRITE | 색상의 V (Value, 명도)성분을 입력합니다. (0~100) |
[FILL_CIRCLE]
매트릭스에 속이 찬 원을 설정합니다. SHOW 명령을 실행해야 디스플레이에 표시됩니다.
| 항목 | 타입 | 설명 |
|---|---|---|
| 중심(x) | WRITE | 원의 중심의 위치(x)를 입력합니다. 가장 왼쪽 픽셀이 0 이며, 오른쪽으로 갈수록 증가합니다. |
| 중심(y) | WRITE | 원의 중심의 위치(y)를 입력합니다. 가장 위의 픽셀이 0이며, 아래로 갈수록 증가합니다. |
| 반지름 | WRITE | 원의 반지름을 입력합니다. |
| 색상 타입 | WRITE | 설정할 색상의 타입을 선택합니다. |
색상 타입 : RGB
| 항목 | 타입 | 설명 |
|---|---|---|
| R | WRITE | 색상의 R성분을 입력합니다. (0~255) |
| G | WRITE | 색상의 G성분을 입력합니다. (0~255) |
| B | WRITE | 색상의 B성분을 입력합니다. (0~255) |
| W | WRITE | 색상의 W성분을 입력합니다. (0~255, RGBW 타입의 LED만 해당) |
색상 타입 : HSV
| 항목 | 타입 | 설명 |
|---|---|---|
| H | WRITE | 색상의 H (Hue)성분을 입력합니다. (0~360) |
| S | WRITE | 색상의 S (Saturation, 채도)성분을 입력합니다. (0~100) |
| V | WRITE | 색상의 V (Value, 명도)성분을 입력합니다. (0~100) |
[FILL_SCREEN]
매트릭스 전체를 지정된 색상으로 채웁니다. SHOW 명령을 실행해야 디스플레이에 표시됩니다.
| 항목 | 타입 | 설명 |
|---|---|---|
| 색상 타입 | WRITE | 설정할 색상의 타입을 선택합니다. |
색상 타입 : RGB
| 항목 | 타입 | 설명 |
|---|---|---|
| R | WRITE | 색상의 R성분을 입력합니다. (0~255) |
| G | WRITE | 색상의 G성분을 입력합니다. (0~255) |
| B | WRITE | 색상의 B성분을 입력합니다. (0~255) |
| W | WRITE | 색상의 W성분을 입력합니다. (0~255, RGBW 타입의 LED만 해당) |
색상 타입 : HSV
| 항목 | 타입 | 설명 |
|---|---|---|
| H | WRITE | 색상의 H (Hue)성분을 입력합니다. (0~360) |
| S | WRITE | 색상의 S (Saturation, 채도)성분을 입력합니다. (0~100) |
| V | WRITE | 색상의 V (Value, 명도)성분을 입력합니다. (0~100) |
[DRAW_RGB_BITMAP]
매트릭스에 bmp 형식의 이미지파일을 설정합니다. SHOW 명령을 실행해야 디스플레이에 표시됩니다.
| 항목 | 타입 | 설명 |
|---|---|---|
| 파일경로 * | WRITE | 이미지 파일의 로컬 경로를 입력합니다. (예: /home/pi/test.bmp) |
| 시작점(x) | WRITE | 이미지의 좌측상단이 위치할 픽셀의 위치(x)를 입력합니다. 가장 왼쪽이 0 이며, 오른쪽으로 갈수록 증가합니다. |
| 시작점(y) | WRITE | 이미지의 좌측상단이 위치할 픽셀의 위치(y)를 입력합니다.아래로 갈수록 증가합니다. |
* Windows bitmap (*.bmp) 형식의 이미지만 사용할 수 있습니다. (OS/2 bitmap은 지원하지 않음)
[SCROLL_TEXT]
매트릭스에 텍스트를 표시하고 좌측 또는 우측방향으로 한칸씩 이동합니다. 이 명령을 일정주기로 실행하면 텍스트가 스크롤되는 효과가 나타납니다.
| 항목 | 타입 | 설명 |
|---|---|---|
| 텍스트 | WRITE | 표시할 텍스트를 입력합니다. |
| 크기 | WRITE | 텍스트의 크기입니다. (1~255) |
| 자동줄바꿈 | WRITE | 텍스트가 가로 표시길이를 초과할 경우 자동줄바꿈을 할지 여부를 결정합니다. |
| 스크롤방향 | WRITE | 스크롤 방향을 선택합니다. (좌측, 우측) |
| 색상 타입 | WRITE | 설정할 색상의 타입을 선택합니다. |
색상 타입 : RGB
| 항목 | 타입 | 설명 |
|---|---|---|
| R | WRITE | 색상의 R성분을 입력합니다. (0~255) |
| G | WRITE | 색상의 G성분을 입력합니다. (0~255) |
| B | WRITE | 색상의 B성분을 입력합니다. (0~255) |
| W | WRITE | 색상의 W성분을 입력합니다. (0~255, RGBW 타입의 LED만 해당) |
색상 타입 : HSV
| 항목 | 타입 | 설명 |
|---|---|---|
| H | WRITE | 색상의 H (Hue)성분을 입력합니다. (0~360) |
| S | WRITE | 색상의 S (Saturation, 채도)성분을 입력합니다. (0~100) |
| V | WRITE | 색상의 V (Value, 명도)성분을 입력합니다. (0~100) |
[SHOW]
설정된 내용을 매트릭스에 표시합니다.
[CLEAR]
모든 LED를 끕니다.
예제
목표
대시보드 위젯 버튼을 누르면 움직이는 캐릭터를 네오픽셀 매트릭스에 표시합니다.
부품
| 부품 | 갯수 |
|---|---|
| 라즈베리파이 4 * | 1 |
| 네오픽셀 매트릭스 | 4 |
| 5V DC Power Supply | 1 |
* 다른 하드웨어를 사용할 수도 있습니다. 사용 가능한 GPIO를 참고하세요.
연결
| 5V DC Power ** | 네오픽셀 매트릭스 | GPIO |
|---|---|---|
| + | +5V | |
| | Din | 12 * |
| – | GND | GND |
* 라즈베리파이 모델에 따라 특정 GPIO핀만 사용가능합니다. 네오픽셀 (WS281x) LED 라이브러리를 참고바랍니다.
** LED의 전압과 소모전류를 고려한 적절한 외부 DC Power Supply를 사용합니다.
** LED의 전압과 소모전류를 고려한 적절한 외부 DC Power Supply를 사용합니다.
연결된 구성은 아래와 같습니다.
- 매트릭스의 가로픽셀 갯수 : 8
- 매트릭스의 세로픽셀 갯수 : 8
- 첫번째 픽셀의 위치 : 좌측상단
- 픽셀방향 : 가로
- 픽셀배치 : 프로그래시브
- 매트릭스 가로방향 갯수 : 2개
- 매트릭스 세로방향 갯수 : 2개
- 첫번째 매트릭스 : 좌측상단
- 매트릭스 배치방향 : 가로
- 매트릭스 배치방식 : 프로그래시브
프로젝트
