English | 简体中文
Application demos and sample projects for InHand Mo series single-board computers.
This repository holds runnable demos and sample projects for Mo boards: edge AI applications, camera pipelines, networking and R5F real-time core firmware.
Related repositories:
- Mo62A — board support package, OS image build and device-side runtime for the Mo 62A board.
- mo-docs — product documentation for the Mo series.
| Repository | Maintained source | Delivery responsibility |
|---|---|---|
| developer · GitLab | Website components, routes, search, integration and contracts | The complete website, release composition and deployment |
| mo-docs | Software/hardware tutorials, specifications, media, design files and training | Versioned content and reference assets |
| mo-tools | Toolchain/SDK selection, environment setup, reusable tools and Studio | Tool metadata and source packages |
| mo-models | Model catalog, compilation resources, compatibility and raw benchmarks | Model references, evidence and artifact status |
| mo-examples | Complete examples with related firmware, clients and configuration | Example sources and their requirements |
| Mo* · product repositories | Each product's BSP, drivers, root filesystem, image build and flashing | Product images and checksummed release metadata |
Mo* covers independently maintained product repositories such as Mo62A, Mo68A, Mo69A, Mo67A, Mo3588 and Mo3568. The framework does not fix their number. Hardware content and maintainer training live in mo-docs; the archived mo-hardware repository is only a migration record, and the pre-release website keeps no legacy /hardware-docs/ routes.
Each source repository publishes ordinary versions. Developer alone has website RC/final channels. The target composition binds developer + mo-docs + mo-tools + mo-models + mo-examples + selected Mo* to exact commits and consumed-asset hashes. A new source release does not change an already frozen website combination. Tutorial applicability, PCB revisions, image versions and actual validation remain distinct.
The directory layout, contribution rules and the CI and release pipelines are in place. products/mo62a/ai/ and products/mo62a/camera/ hold the first batch of examples imported from the Mo62A repository and the mo-docs tutorial packages; products/mo62a/network/ble/, products/mo62a/r5f/mcu-console/, products/mo62a/camera/jpeg-capture/ and products/mo62a/ai/npu-demo/ contain migrated tutorial resources. Importing an example into this repository did not re-build or re-run it; each directory README states what was verified and on which image. Catalog publication does not establish new hardware verification or model hosting.
Product directories: products.json lists the boards; each board keeps its examples under products/<board>/ (products/mo62a/ for Mo62A, products/mo68a/ reserved for Mo68A). Boards do not share example files; catalog paths are relative to the product directory.
| Path | Purpose |
|---|---|
products/mo62a/ai/ |
Edge AI examples: C/C++ SDK examples (edgeai-cpp/), a Python ONNX Runtime smoke test (python-smoke/) and the zone-occupancy tutorial application (zone-demo/). |
products/mo62a/camera/ |
Camera examples: IMX219 CSI live preview (imx219-preview/). |
products/mo62a/network/ |
BLE peripheral and GATT check. |
products/mo62a/r5f/ |
MCU console firmware, host client, RPMsg helper and reload-cycle check. |
scripts/ |
Repository maintenance scripts (commit message check, changelog generation). |
.githooks/ |
Git hooks that run the commit message check locally. |
.github/ |
Issue forms, pull request template and GitHub Actions workflows. |
release-notes/ |
Changelog baseline used by the release workflow. |
Contributions are welcome through pull requests to master. Read CONTRIBUTING.md for the commit message convention, the pull request process and how to enable the local Git hooks:
git config core.hooksPath .githooksEvery pull request must pass the commit-message and ci checks before it can be merged. Use GitHub issues for bugs, reproducible problems and feature requests in this repository.
New releases use annotated ordinary V<major>.<minor>.<patch> tags on checked master commits. Only developer publishes website release candidates. The release workflow validates catalogs, packages source with SPDX SBOM, records the source commit and catalog hashes in release.json, writes SHA-256 checksums, then publishes a complete GitHub Release. Historical RCs remain unchanged. Changelog headings are bilingual; entries retain their English commit summaries.
git switch master
git pull --ff-only
git tag -a V1.0.0 -m "V1.0.0"
git push origin V1.0.0Do not report security vulnerabilities in public issues. Follow SECURITY.md.
This repository is licensed under the terms in LICENSE. Third-party content added later keeps its own license, stated next to the content.
products/mo62a/examples.json lists actual source projects, entrypoints, image/model requirements and tutorial routes. Empty scaffold folders are excluded. source-available is not a new board-test claim. Developer reads a pinned source revision, validates the combined data, and renders the website; this repository has no documentation-site frontend or website deployment.
Run node scripts/check-catalog.mjs and node --test tests/*.test.mjs with Node 22. validation/ is exported from a committed developer contract and checked by hash; do not edit it locally. For integrated preview, run developer's npm run preview -- --source mo-examples=/path/to/mo-examples.
Diagrams are generated centrally by developer/scripts/render-architecture.mjs. Regenerate all repository diagrams after changing the common architecture. Diagrams show ownership; the status section and catalog define currently available content and verification.
R5F firmware, client and checks now live together in products/mo62a/r5f/mcu-console. products/mo62a/examples.json lists eight existing examples; its R5F entry pins SDK, compiler and SysConfig versions and hashes for validation against the selected mo-tools combination.
Regenerate these diagrams from developer with node scripts/render-architecture.mjs --repo mo-examples --out /path/to/mo-examples/architecture. Source releases validate the catalogs and resources; developer separately verifies the combined website release and deployment. Open each diagram to read the original SVG.
Zone-demo vendors a generated copy of the mo-models model.py interface, pinned in products/mo62a/dependencies/model-contract.json. Update it with node scripts/sync-model-contract.mjs /path/to/mo-models, which accepts committed authoritative bytes only. CI and website integration verify hashes. Example sources work independently; developer assembles the full tutorial bundle with model-compilation and host-setup scripts and records provenance for every file.