이 페이지는 각 저장소에 무엇이 들어 있는지, 센서와 앱의 데이터가 어떤 형식으로 어디에 전달되는지 정리합니다. 함수 인자나 레지스터 값처럼 구현에 따라 달라질 수 있는 내용은 링크한 원본 코드와 문서에서 확인하세요.
개발 저장소
| 저장소 | 주요 내용 | 원본 코드 |
|---|---|---|
| bosio_OutputCore | 정이십면체 출력 코어 RTL, 투영, 안티에일리어싱, PYNQ 드라이버 | 저장소 열기 |
| bosio_SphericalWM | GY-521 센서 허브 RTL, Bosio 창 관리자, C++/NEON 합성기, 비트스트림 | 저장소 열기 |
| bosio_BoAYO | 런처, apps.json, BoAYo SDK, 앱 예제와 배포 도구 | 저장소 열기 |
| bosio_FullStack | 세 저장소의 버전을 고정하고 보드에 함께 배포하는 도구 | 저장소 열기 |
데이터 형식과 전달 경로
여기서 장면은 Bosio가 여러 창을 합성해 정이십면체 프레임버퍼에 저장한 결과를 뜻합니다. 아래 표는 장면을 만드는 입력부터 출력 코어에 전달되는 데이터까지 이어집니다.
| 데이터 | 형식 | 전달·처리 경로 |
|---|---|---|
| 센서 자세 | 96비트 AXI4-Stream. yaw·pitch·roll 각각 부호 있는 32비트 정수, 단위 mrad | GY-521 → FPGA 센서 허브 → 출력 코어 |
| 수동 투영 계수 | Q24 고정소수점 값. 출력 코어가 영상 프레임 경계에서 적용 | PYNQ 드라이버 → 출력 코어 |
| 앱 이미지 | 높이 × 너비 × 3의 NumPy RGB24 배열 | 앱 → BoAYo SDK → Bosio 창 관리자 |
| 창 위치와 크기 | 구면 중심 위치와 가로·세로 각도, 포커스와 창 겹침 순서 | Bosio 창 관리자에서 처리 |
| 정이십면체 장면 | 20면 × 면당 211타일 × 타일당 M² 삼각 셀, RGB332 색상표 | Bosio 합성기 → 출력 코어 |
| 장면의 일부 갱신 | 바뀐 타일만 담은 BPT1 데이터. 필요한 경우 전체 장면을 다시 전송 | Bosio 합성기 → 출력 코어 |
| 창 제어 메시지 | JSON 메시지, Unix 도메인 소켓 /tmp/bosio-wm.sock | 앱·BoAYo SDK ↔ Bosio 창 관리자 |
더 자세히 읽을 문서
- GY-521 배선과 센서 허브
- PYNQ-Z2 버튼 입력과 이벤트
- 투영·출력 단계의 안티에일리어싱
- BoAYo 런처 패널과 앱 창
- BoAYo 앱 작성 빠른 시작
- BoAYo SDK 함수와 이벤트 안내
- 통합 설치와 부팅 설정
앱 창의 크기·포커스를 읽거나 변경 이벤트를 처리하려면 앱 작성 예제를 먼저 보고, 함수별 설명은 SDK 안내에서 확인하세요. 각 구성 요소의 라이선스와 최신 소스는 해당 저장소에 있습니다.