Skip to content
yoyopod vision

The Builders Guide

For engineers and contributors: what yoyopod is made of (hardware), how it thinks (software), and how to build, flash, and test one.

How this guide is organized

Section titled “How this guide is organized”

Three parts, from atoms to workflows:

  1. Hardware Platform — the physical device: display, audio, power, connectivity, and the path from Pi prototype to a product board.
  2. Software Platform — the running system: architecture, the device runtime, and the four peer engines — UI, media, VoIP, and speech — plus cloud, apps, and security.
  3. Developer Guide — you and the repo: environment, build & flash, testing, and the API/SDK surface.

Vision pages here describe the target platform. For what is implemented today, each page’s Today vs. target section points to the as-built engineering docs (the docsite/website/ site in this repository — coral accent), which include full deep-dive guides for the UI system and the runtime.

Hardware Platform

Section titled “Hardware Platform”
Device Overview & SpecsThe whole machine on one page — the V0 “Dawn” block diagram plus the spec table.
The Canvas: Display & InputThe small calm screen and the one physical button.
Audio PathSpeaker, microphone, and the signal chain between them.
Power & BatteryBattery, charging, and power management.
Connectivity: 4G & GPSThe modem, the SIM, and location hardware.
From Prototype to ProductV0 “Dawn” — off-the-shelf boards wired together — and V1 “Daylight”, the designed PCB.

Software Platform

Section titled “Software Platform”
Architecture at a GlanceTwo sides and a backbone: yoyoOS + yoyocore on the device, yoyocloud, the yoyopod app.
The yoyocore RuntimeThe supervisor that runs every engine as a separate process.
UI EngineHow shapes and motion reach the canvas.
Media EngineLocal-first playback: the media worker, mpv, and the playback contract.
VoIP EngineWhitelist calling: the voip worker and liblinphone.
Speech EnginePush-to-talk speech: STT/TTS and the Ask experience's engine.
Cloud & ProvisioningBackend, provisioning, and the device's cloud link.
App PlatformThe parent app and future shared packages.
Security ModelIdentity, whitelisting, transport, and updates.

Developer Guide

Section titled “Developer Guide”
Dev EnvironmentToolchain and repo orientation.
Build & Flash a DeviceFrom checkout to a running device.
Testing & ValidationWhat green means, on host and on hardware.
APIs & SDKsThe future contracts and packages surface.