HAT010

HAT010 (HAT-010 5x5 매트릭스)

CheeseStick 의 HAT 슬롯에 장착하는 5×5 LED 매트릭스 모듈입니다.
점, 도형, 숫자, 사용자 패턴을 색을 지정해 표시하고 두 개의 버튼 입력을 읽습니다.

인스턴스 선언

cheesestick = CheeseStick(0)
hat010 = cheesestick.HAT010()

함수

start

HAT010 (5×5 LED 매트릭스) 을 초기화합니다. 다른 함수를 사용하기 전에 한 번 호출해야 합니다.

매개변수: 없음

예제

cheesestick = CheeseStick(0)
hat010 = cheesestick.HAT010()
hat010.start()

---

set_one

5×5 매트릭스의 지정한 좌표에 색을 켭니다.

매개변수

이름	구분	설명	범위 / 종류	기본값
x	입력값 (필드)	가로 좌표	0 ~ 4 정수	-
y	입력값 (필드)	세로 좌표	0 ~ 4 정수	-
color	드롭다운 옵션	색상	off, red, orange, yellow, green, cyan, blue, violet, magenta, white	-

예제

cheesestick = CheeseStick(0)
hat010 = cheesestick.HAT010()
hat010.start()
hat010.set_one(2, 3, 'red')

---

draw_shape

5×5 매트릭스에 미리 정의된 도형을 그립니다. 도형 이름 대신 길이 25 의 셀 배열을 직접 넘길 수도 있습니다.

매개변수

이름	구분	설명	범위 / 종류	기본값
x	입력값 (필드)	도형의 좌측 상단 x	정수	-
y	입력값 (필드)	도형의 좌측 상단 y	정수	-
color	드롭다운 옵션	색상	off, red, orange, yellow, green, cyan, blue, violet, magenta, white	-
shape	드롭다운 옵션	도형 이름	rectangle, triangle, diamond, circle, x, like, dislike, angry, mouth_open, mouth_close, heart, star, up_arrow, down_arrow, left_arrow, right_arrow, walking, dog, butterfly, airplane, quarter_note, eighth_note	-
shape	입력값 (배열)	도형 이름 대신 직접 넘기는 25칸 셀 배열 (0/1)	길이 25 의 정수 배열	-

예제

cheesestick = CheeseStick(0)
hat010 = cheesestick.HAT010()
hat010.start()
hat010.draw_shape(0, 0, 'red', 'heart')

---

draw_number

5×5 매트릭스에 0~9 사이의 숫자를 그립니다. 숫자 대신 길이 25 의 셀 배열을 직접 넘길 수도 있습니다.

매개변수

이름	구분	설명	범위 / 종류	기본값
x	입력값 (필드)	숫자의 좌측 상단 x	정수	-
y	입력값 (필드)	숫자의 좌측 상단 y	정수	-
color	드롭다운 옵션	색상	off, red, orange, yellow, green, cyan, blue, violet, magenta, white	-
number	드롭다운 옵션	그릴 숫자	0 ~ 9 정수	-
number	입력값 (배열)	숫자 대신 직접 넘기는 25칸 셀 배열 (0/1)	길이 25 의 정수 배열	-

예제

cheesestick = CheeseStick(0)
hat010 = cheesestick.HAT010()
hat010.start()
hat010.draw_number(0, 0, 'red', 5)

---

draw_pattern

사용자가 정의한 25개 셀 배열로 5×5 매트릭스에 패턴을 그립니다. 0 은 꺼짐, 0 이 아닌 값은 켜짐을 의미합니다.

매개변수

이름	구분	설명	범위 / 종류	기본값
x	입력값 (필드)	좌측 상단 x	정수	-
y	입력값 (필드)	좌측 상단 y	정수	-
color	드롭다운 옵션	색상	off, red, orange, yellow, green, cyan, blue, violet, magenta, white	-
matrix	입력값 (배열)	25칸 픽셀 배열 (0/1)	길이 25 의 정수 배열	-

예제

cheesestick = CheeseStick(0)
hat010 = cheesestick.HAT010()
hat010.start()
hat010.draw_pattern(0, 0, 'red', [1, 0, 1, 0, 1, 0, 1, 0, 1, 0, 1, 0, 1, 0, 1, 0, 1, 0, 1, 0, 1, 0, 1, 0, 1])

---

shift

매트릭스 표시 원점을 지정한 양만큼 이동합니다.

매개변수

이름	구분	설명	범위 / 종류	기본값
x	입력값 (필드)	가로 이동량	정수	-
y	입력값 (필드)	세로 이동량	정수	-

예제

cheesestick = CheeseStick(0)
hat010 = cheesestick.HAT010()
hat010.start()
hat010.shift(1, 0)

---

turn_off_one

5×5 매트릭스의 지정한 좌표 한 칸을 끕니다.

매개변수

이름	구분	설명	범위 / 종류	기본값
x	입력값 (필드)	가로 좌표	0 ~ 4 정수	-
y	입력값 (필드)	세로 좌표	0 ~ 4 정수	-

예제

cheesestick = CheeseStick(0)
hat010 = cheesestick.HAT010()
hat010.start()
hat010.turn_off_one(2, 3)

---

turn_off_all

5×5 매트릭스의 모든 LED 를 끕니다.

매개변수: 없음

예제

cheesestick = CheeseStick(0)
hat010 = cheesestick.HAT010()
hat010.start()
hat010.turn_off_all()

---

set_brightness

매트릭스 LED 의 밝기를 설정합니다.

매개변수

이름	구분	설명	범위 / 종류	기본값
value	입력값 (필드)	밝기	0 ~ 10 정수	-

예제

cheesestick = CheeseStick(0)
hat010 = cheesestick.HAT010()
hat010.start()
hat010.set_brightness(5)

---

change_brightness

현재 매트릭스 밝기에 입력한 변화량을 더해 새로운 밝기를 설정합니다.

매개변수

이름	구분	설명	범위 / 종류	기본값
value	입력값 (필드)	밝기 변화량	정수	-

예제

cheesestick = CheeseStick(0)
hat010 = cheesestick.HAT010()
hat010.start()
hat010.change_brightness(1)

---

button_input

HAT010 의 버튼 입력값을 반환합니다. 눌리지 않은 상태는 1, 눌린 상태는 0 입니다.

매개변수

이름	구분	설명	범위 / 종류	기본값
unit	드롭다운 옵션	버튼 이름	A, B	-

반환값

버튼 입력값 (1: 떨어짐, 0: 눌림)

예제

cheesestick = CheeseStick(0)
hat010 = cheesestick.HAT010()
hat010.start()
hat010.button_input('A')

---

button_click

HAT010 의 버튼을 클릭했는지 여부를 참(True) / 거짓(False) 으로 반환합니다.

매개변수

이름	구분	설명	범위 / 종류	기본값
unit	드롭다운 옵션	버튼 이름	A, B	-

반환값

버튼을 클릭했으면 True, 아니면 False

예제

cheesestick = CheeseStick(0)
hat010 = cheesestick.HAT010()
hat010.start()
hat010.button_click('A')

---