이 페이지는 각 저장소에 무엇이 들어 있는지, 센서와 앱의 데이터가 어떤 형식으로 어디에 전달되는지 정리합니다. 함수 인자나 레지스터 값처럼 구현에 따라 달라질 수 있는 내용은 링크한 원본 코드와 문서에서 확인하세요.
개발 저장소
| 저장소 | 주요 내용 | 원본 코드 |
|---|---|---|
| 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 합성기 → 출력 코어 |
| 장면의 일부 갱신 | 현재 M=32는 변경 payload·directory를 담은 BPT2 데이터. 기존 M=16은 BPT1. BS25 드라이버가 비활성 DDR 버퍼에 적용한 뒤 코어가 프레임 경계에서 주소를 전환. 첫 표시·형식 전환·복구 시 전체 snapshot 전송 | Bosio 합성기 → 드라이버 → 출력 코어 |
| 창 제어 메시지 | JSON 메시지, Unix 도메인 소켓 /tmp/bosio-wm.sock | 앱·BoAYo SDK ↔ Bosio 창 관리자 |
더 자세히 읽을 문서
- GY-521 배선과 센서 허브
- PYNQ-Z2 버튼 입력과 이벤트
- 투영·출력 단계의 안티에일리어싱
- BoAYo 런처 패널과 앱 창
- BoAYo 앱 작성 빠른 시작
- BoAYo SDK 함수와 이벤트 안내
- 통합 설치와 부팅 설정
앱 창의 크기·포커스를 읽거나 변경 이벤트를 처리하려면 앱 작성 예제를 먼저 보고, 함수별 설명은 SDK 안내에서 확인하세요. 각 구성 요소의 라이선스와 최신 소스는 해당 저장소에 있습니다.
이 문서의 검증 기준
2026-10-18 배포·푸시한 버전을 기준으로 2026-10-26 문서를 갱신했습니다. ProjectionCore는 독립 저장소이며 이번 화면 변환에서 변경하지 않았습니다.
| 저장소 | 고정 커밋 |
|---|---|
| OutputCore | a8a1ec3 |
| SphericalWM | 95ecdbb |
| BoAYO | b0caf69 |
| FullStack | 8f39cdb |
| ProjectionCore | 60943cc |
비트스트림 식별
기본 bosio_output_projection_dual.bit/.hwh와 배포한 bosio_output_projection_transform.bit/.hwh는 동일한 내용입니다.
bit SHA-256: da015895bb27727d1bbef4f357bd706362112ed850feb5394e390323627d64d9
hwh SHA-256: 5e88bc47677ad25befc72d2e9d9a5c1882bd500d15c733feaccf84e226c85db2배포 manifest는 IP 커밋, 런타임 소스 해시와 검증 내역을 포함합니다. 변환 빌드 manifest와 실측·캡처 자료를 함께 확인할 수 있습니다.