How gizclaw/gizos works
GizOS is a portable firmware and application platform spanning embedded devices, desktop, mobile, and WebAssembly. Its principal architecture flow is application code through the shared runtime and reusable libraries, then PAL contracts to platform providers and board/SDK integrations. The repository also contains distinct product branches for device management, scripting, games, and loader tooling. Relationships below follow the README’s documented layer model and visible source-index references; unsampled subsystem internals are represented conservatively.
Main entry points: runtime Application runtime · pal PAL contracts · app/app.c H2Loader · app/app.c PIXA games
Components 18
Applications
- Apps and examples
projects - H2Loader
projects/h2loader/apps/loader/app/app.c - PIXA games
projects/pixa_games/apps/dinodive/app/app.c - Showcase app
projects/showcase/targets/cc_binary/showcase/main.cpp
Runtime and PAL
- Application runtime
libs/runtime - PAL contracts
libs/pal/include/h2/pal
Reusable Libraries
- Game runtime
libs/game_runtime/src/h2_game_runtime.cpp - Lua runtime
libs/lua/src/runtime/h2_lua.c - Networking and protocols
libs/bleikcp/src/h2_bleikcp_client.c - Audio mixer
libs/audio_mixer/src/h2_audio_mixer.c
Platform Integrations
- Desktop support
libs/pal/providers/desktop/app_support/h2_desktop_app_support.h - PAL providers
libs/pal/providers - Native components
native_component_src - Boards and SDKs
boards
Device Services
- GizClaw client
libs/gizclaw/src/h2_gizclaw_client.c - BLE Wi-Fi setup
libs/ble_wifi_config/src/h2_ble_wifi_config_service.c - Loader host services
libs/h2loader_host/src
Other components
- Product developer
Connections 19
- Product developer → Apps and examples: composes
README.md - Apps and examples → Application runtime: uses runtime
README.md - H2Loader → Application runtime: uses runtime
README.md - PIXA games → Game runtime: uses game APIs
projects/pixa_games/apps/dinodive/app/app.c - PIXA games → Application runtime: uses runtime
projects/pixa_games/apps/dinodive/app/app.c - Showcase app → Application runtime: configures runtime
projects/showcase/targets/cc_binary/showcase/main.cpp - Application runtime → PAL contracts: uses contracts
README.md - Game runtime → PAL contracts: uses audio and display
- Lua runtime → PAL contracts: uses PAL services
- BLE Wi-Fi setup → Application runtime: uses runtime
libs/ble_wifi_config/src/h2_ble_wifi_config_service.c - Desktop support → Application runtime: provides runtime config
libs/pal/providers/desktop/app_support/h2_desktop_app_support.h - Showcase app → Desktop support: uses desktop support
projects/showcase/targets/cc_binary/showcase/main.cpp - PAL contracts → PAL providers: implemented by
README.md - PAL providers → Native components: integrates
README.md - Native components → Boards and SDKs: targets boards
README.md - H2Loader → Loader host services: uses loader services
- GizClaw client → PAL contracts: uses PAL contracts
- Networking and protocols → PAL contracts: uses PAL networking
- Audio mixer → PAL contracts: uses audio