G-CUBE FIRMWARE / RELEASE NOTES
1.0.4.85Firmware
통신 응답과 센서 스트림 개선
센서 스트림 출력 주기, 응답 메타데이터, 하위 큐브 응답 중계 및 일부 주변장치 동작이 변경된 버전입니다.
SENSOR
스트림 주기
InAction × 0.005초로 실효 주기 변경
PACKET
신규 필드
배터리 · 펌웨어 빌드 · 0x77 구분자 추가
MULTIROLE
응답 중계
하위 큐브의 일부 응답을 호스트로 직접 전달
DISPLAY
주변장치
음악 표시·도트매트릭스 재연결 동작 변경
01
주요 변경사항
앱·서비스 연동 시 영향을 받을 수 있는 변경사항입니다.
SENSOR
센서 스트림 주기 변경
- GetSensors(
0xB8) 연속 스트림 실효 주기가InAction × 0.005초로 변경되었습니다. - InAction 10~100 기준 약 0.05~0.5초 범위입니다.
- 84 이하와 동일한 주기를 유지하려면 85 이상에서는 InAction 값을 2배로 지정합니다.
- 여러 큐브 연결 시 한 주기만 놓쳐도 프레임을 강제로 출력하도록 변경되었습니다. 이전 임계값은 3주기였습니다.
- 강제 출력 시 특정 큐브 데이터가 아직 도착하지 않은 경우 해당 위치에는 직전값이 포함될 수 있습니다.
PACKET
센서 응답 신규 필드
| 바이트 | 내용 |
|---|---|
[1] | 배터리 잔량 0~100% |
[2] | 펌웨어 빌드 번호 |
[5] | 85 이상 구분자 0x77 |
위 값은 큐브이노·마이크로비트가 연결되지 않은 경우에 채워지며, [5] == 0x77 여부로 85 이상 응답을 판별할 수 있습니다.
MULTIROLE
하위 큐브 응답 중계
집계기는 하위 큐브의 0xBA(GetPeripherals), 0xE8(음악), 0xB1(제품정보·펌웨어 버전) 응답을 호스트로 그대로 전달합니다. 이를 통해 각 하위 큐브의 배터리와 펌웨어 버전을 개별 조회할 수 있습니다.
DISPLAY
음악·도트매트릭스 동작 변경
- 음 재생 중 HT16K33 도트매트릭스에 음을 막대그래프로 자동 표시하던 기능이 기본 비활성화되었습니다.
- 음 재생 명령 형식에는 변화가 없으며, 필요한 경우 앱에서
0xA2도트매트릭스 명령을 별도로 전송합니다. - 부팅 시 인식된 HT16K33 도트매트릭스를 분리했다가 다시 연결하면 약 0.5초 내에 자동 복구합니다.
ETC
그룹번호·보드 ID
- 그룹번호
0x90~0x99에서는 5V 충전기를 연결한 상태에서도 큐브가 자동으로 꺼지지 않는 특수 동작이 적용됩니다. 일반 사용에는0x00~0x89를 권장합니다. - Cubeino 시리얼 프로토콜의 보드 ID에 점자보드(마이크로비트)
0x73이 85 이상 항목으로 포함됩니다.
02
관련 구현 수정 기록
분할 패킷과 멀티큐브 전달 경로에 대한 관련 수정 기록입니다.
수신 스테이징 버퍼
분할 명령의 뒤 조각이 폐기되는 문제를 수신 스테이징 버퍼로 수정.
GATTC 전송 큐 확장
20바이트를 넘는 스케줄 명령의 후속 조각이 하위 큐브에 전달되지 않던 문제를 수정.
다음 버전 작성 방법
이 글을 복제한 뒤 버전명과 변경사항만 수정해 사용하면 됩니다. Firmware 카테고리에서는 버전 번호가 높은 글이 위에 표시됩니다.
