-
Notifications
You must be signed in to change notification settings - Fork 0
CheeseStick
치즈스틱 로봇을 제어하기 위한 함수입니다.
치즈스틱은 다양한 입출력 포트(SaSc, LaLc, Mab/Mcd)와 버저, 가속도/온도 센서를 갖춘 로봇입니다.
포트의 입력 모드를 설정하여 센서 값을 읽거나, 디지털/PWM 출력 및 소리를 제어할 수 있습니다.
cheesestick = CheeseStick(0)| 이름 | 구분 | 설명 | 범위 / 종류 | 기본값 |
|---|---|---|---|---|
| index | 입력값 | 인스턴스 번호 (0부터 시작) | 0 이상 정수 | 0 |
치즈스틱에는 CSD01 / CSD02 / CSD03 / CSD07 / CSD09 / CSD10 / HAT010 / HAT022 / PID13 / PID26 / NeoPixel 등 확장 모듈을 연결할 수 있습니다.
각 확장 모듈의 함수는 별도의 확장 모듈 매뉴얼(cheesestick_ext)을 참고하세요.
치즈스틱 포트의 입력 모드를 설정합니다.
매개변수
| 이름 | 구분 | 설명 | 범위 / 종류 | 기본값 |
|---|---|---|---|---|
| unit | 드롭다운 옵션 | 입력 포트 | Sa, Sb, Sc, La, Lb, Lc | - |
| option | 드롭다운 옵션 | 입력 모드 | makey, button, digital_pullup, digital_pulldown, analog, analog_voltage | - |
예제
cheesestick = CheeseStick(0)
cheesestick.set_input_mode('Sa', 'button')치즈스틱 포트의 원본 입력값을 사용자 정의 범위로 선형 변환합니다.
매개변수
| 이름 | 구분 | 설명 | 범위 / 종류 | 기본값 |
|---|---|---|---|---|
| unit | 드롭다운 옵션 | 입력 포트 | Sa, Sb, Sc, La, Lb, Lc | - |
| src_min | 입력값 | 원본 최소값 | 정수 또는 실수 | - |
| src_max | 입력값 | 원본 최대값 | 정수 또는 실수 | - |
| dst_min | 입력값 | 변환 후 최소값 | 정수 또는 실수 | - |
| dst_max | 입력값 | 변환 후 최대값 | 정수 또는 실수 | - |
예제
cheesestick = CheeseStick(0)
cheesestick.set_input_range('Sa', 0, 1023, 0, 100)원본 (min, median, max) 세 점을 기준으로 변환된 (min, median, max) 세 점으로 매핑합니다.
매개변수
| 이름 | 구분 | 설명 | 범위 / 종류 | 기본값 |
|---|---|---|---|---|
| unit | 드롭다운 옵션 | 입력 포트 | Sa, Sb, Sc, La, Lb, Lc | - |
| src_min | 입력값 | 원본 최소값 | 정수 또는 실수 | - |
| src_median | 입력값 | 원본 중간값 | 정수 또는 실수 | - |
| src_max | 입력값 | 원본 최대값 | 정수 또는 실수 | - |
| dst_min | 입력값 | 변환 후 최소값 | 정수 또는 실수 | - |
| dst_median | 입력값 | 변환 후 중간값 | 정수 또는 실수 | - |
| dst_max | 입력값 | 변환 후 최대값 | 정수 또는 실수 | - |
예제
cheesestick = CheeseStick(0)
cheesestick.set_input_range_median('Sa', 0, 512, 1023, 0, 50, 100)치즈스틱 포트의 입력값을 반환합니다.
매개변수
| 이름 | 구분 | 설명 | 범위 / 종류 | 기본값 |
|---|---|---|---|---|
| unit | 드롭다운 옵션 | 입력 포트 | Sa, Sb, Sc, La, Lb, Lc | - |
반환값: 해당 포트의 입력값 (정수 또는 실수). 버튼 입력 모드에서 버튼이 눌렸는지 확인하려면 get_input('Sa') == 0 과 같이 비교합니다.
예제
cheesestick = CheeseStick(0)
cheesestick.get_input('Sa')치즈스틱 펄스 입력 모드를 설정합니다. 펄스 검출 가능한 포트는 Sc, Lc 입니다.
매개변수
| 이름 | 구분 | 설명 | 범위 / 종류 | 기본값 |
|---|---|---|---|---|
| unit | 드롭다운 옵션 | 펄스 입력 포트 | Sc, Lc | - |
| option | 드롭다운 옵션 | 풀 모드 | default, pull-up, pull-down | - |
예제
cheesestick = CheeseStick(0)
cheesestick.set_pulse_input_mode('Sc', 'pull-up')치즈스틱 펄스 입력값을 참(True) / 거짓(False)으로 반환합니다.
매개변수
| 이름 | 구분 | 설명 | 범위 / 종류 | 기본값 |
|---|---|---|---|---|
| unit | 드롭다운 옵션 | 펄스 입력 포트 | Sc, Lc | - |
반환값: 펄스가 검출되었으면 True, 아니면 False (bool).
예제
cheesestick = CheeseStick(0)
cheesestick.get_pulse_input('Sc')치즈스틱 포트의 디지털 출력값 (0/1) 을 설정합니다.
매개변수
| 이름 | 구분 | 설명 | 범위 / 종류 | 기본값 |
|---|---|---|---|---|
| unit | 드롭다운 옵션 | 디지털 출력 포트 | Sa, Sb, Sc, La, Lb, Lc, Mab, Mcd | - |
| value | 입력값 | 출력값 | 0 또는 1 | - |
예제
cheesestick = CheeseStick(0)
cheesestick.set_digital_output('Sa', 1)치즈스틱 포트의 PWM 출력값을 설정합니다.
매개변수
| 이름 | 구분 | 설명 | 범위 / 종류 | 기본값 |
|---|---|---|---|---|
| unit | 드롭다운 옵션 | PWM 출력 포트 | Sa, Sb, Sc, La, Lb, Lc | - |
| value | 입력값 | PWM 값 | 0 ~ 255 (정수 또는 실수) | - |
예제
cheesestick = CheeseStick(0)
cheesestick.set_pwm_output('Sa', 128)현재 PWM 출력값에 입력한 변화량을 더해 새로운 값을 설정합니다.
매개변수
| 이름 | 구분 | 설명 | 범위 / 종류 | 기본값 |
|---|---|---|---|---|
| unit | 드롭다운 옵션 | PWM 출력 포트 | Sa, Sb, Sc, La, Lb, Lc | - |
| value | 입력값 | 변경할 PWM 차 | 정수 또는 실수 | - |
예제
cheesestick = CheeseStick(0)
cheesestick.change_pwm_output('Sa', 10)치즈스틱의 버저음을 설정합니다.
매개변수
| 이름 | 구분 | 설명 | 범위 / 종류 | 기본값 |
|---|---|---|---|---|
| hz | 입력값 | 주파수 (Hz) | 0 ~ 6553.5 (정수 또는 실수) | - |
예제
cheesestick = CheeseStick(0)
cheesestick.sound_buzz(440)치즈스틱이 지정된 음계를 재생합니다.
매개변수
| 이름 | 구분 | 설명 | 범위 / 종류 | 기본값 |
|---|---|---|---|---|
| note | 드롭다운 옵션 | 음계 | 도(C), 도#(C#), 레(D), 레#(D#), 미(E), 파(F), 파#(F#), 솔(G), 솔#(G#), 라(A), 라#(A#), 시(B) | - |
| octave | 입력값 | 옥타브 | 1 ~ 7 정수 | 4 |
예제
cheesestick = CheeseStick(0)
cheesestick.sound_note('D', 5)치즈스틱이 특정 사운드 클립을 재생합니다.
매개변수
| 이름 | 구분 | 설명 | 범위 / 종류 | 기본값 |
|---|---|---|---|---|
| clip | 드롭다운 옵션 | 사운드 클립 이름 | mute, beep, beep2, beep3, beep_repeat, beep_random, beep_random_repeat, noise, noise_repeat, siren, siren_repeat, engine, engine_repeat, fart_a, fart_b, noise_random, noise_random_repeat, whistle, chop, chop_repeat, robot, dibidibidip, random_melody, good_job, happy, angry, sad, sleep, march, birthday | - |
| wait | 체크박스 | 완료 대기 여부 | True / False | True |
예제
cheesestick = CheeseStick(0)
cheesestick.sound_clip('siren', wait=True)치즈스틱의 소리를 끕니다.
매개변수: 없음
예제
cheesestick = CheeseStick(0)
cheesestick.sound_off()치즈스틱 특정 축의 가속도 값을 반환합니다.
매개변수
| 이름 | 구분 | 설명 | 범위 / 종류 | 기본값 |
|---|---|---|---|---|
| unit | 드롭다운 옵션 | 측정 축 | x, y, z | - |
반환값: 지정한 축의 가속도 값 (정수 또는 실수).
예제
cheesestick = CheeseStick(0)
cheesestick.acceleration('x')치즈스틱에 탭(두드림) 이벤트가 발생했는지 참(True) / 거짓(False)으로 반환합니다.
매개변수: 없음
반환값: 탭 이벤트가 발생했으면 True, 아니면 False (bool).
예제
cheesestick = CheeseStick(0)
cheesestick.tap()치즈스틱에 낙하 이벤트가 발생했는지 참(True) / 거짓(False)으로 반환합니다.
매개변수: 없음
반환값: 낙하 이벤트가 발생했으면 True, 아니면 False (bool).
예제
cheesestick = CheeseStick(0)
cheesestick.fall()치즈스틱의 내부 온도 센서 값을 반환합니다.
매개변수: 없음
반환값: 온도 센서 값 (정수 또는 실수).
예제
cheesestick = CheeseStick(0)
cheesestick.temperature()치즈스틱의 신호 세기 값을 반환합니다.
매개변수: 없음
반환값: 신호 세기 값 (정수 또는 실수).
예제
cheesestick = CheeseStick(0)
cheesestick.signal_strength()치즈스틱의 배터리 전압 값을 반환합니다.
매개변수: 없음
반환값: 배터리 전압 값 (정수 또는 실수).
예제
cheesestick = CheeseStick(0)
cheesestick.battery()