{"id":20819648,"url":"https://github.com/jeremygrosser/meta-clockwork","last_synced_at":"2026-04-20T22:04:14.597Z","repository":{"id":66445369,"uuid":"217208333","full_name":"JeremyGrosser/meta-clockwork","owner":"JeremyGrosser","description":"Yocto BSP for ClockworkPi boards","archived":false,"fork":false,"pushed_at":"2021-08-06T07:42:11.000Z","size":130,"stargazers_count":2,"open_issues_count":1,"forks_count":2,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-12-27T08:25:28.760Z","etag":null,"topics":["clockworkpi","gameshell","lima","sunxi","yocto-bsp"],"latest_commit_sha":null,"homepage":null,"language":"PHP","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/JeremyGrosser.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"COPYING","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2019-10-24T04:03:37.000Z","updated_at":"2022-11-02T12:22:44.000Z","dependencies_parsed_at":"2026-02-24T20:02:24.213Z","dependency_job_id":null,"html_url":"https://github.com/JeremyGrosser/meta-clockwork","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/JeremyGrosser/meta-clockwork","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/JeremyGrosser%2Fmeta-clockwork","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/JeremyGrosser%2Fmeta-clockwork/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/JeremyGrosser%2Fmeta-clockwork/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/JeremyGrosser%2Fmeta-clockwork/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/JeremyGrosser","download_url":"https://codeload.github.com/JeremyGrosser/meta-clockwork/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/JeremyGrosser%2Fmeta-clockwork/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":32067637,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-20T21:26:33.338Z","status":"ssl_error","status_checked_at":"2026-04-20T21:26:22.081Z","response_time":94,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.6:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["clockworkpi","gameshell","lima","sunxi","yocto-bsp"],"created_at":"2024-11-17T22:07:01.180Z","updated_at":"2026-04-20T22:04:14.580Z","avatar_url":"https://github.com/JeremyGrosser.png","language":"PHP","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Yocto BSP for ClockworkPi boards\n\n## Naming\n\n[Clockwork Tech](https://www.clockworkpi.com) is a company that sells the\nGameShell, a handheld game console kit. One of the modules in the GameShell kit\nis a compute board based on the AllWinner R16, also known as A33, or sun8i in\nsome codebases. Presumably, Clockwork Tech could release upgraded compute\nmodules for the GameShell in the future, so we've named this layer\n\"meta-clockwork\" to encompass BSPs for all Linux compatible boards from this\ncompany.\n\nCurrently, the only board is known as *cpi3*. I have no idea what happened to\ncpi1 and cpi2. I assume the Pi in the name is meant to remind you of the\nRaspberryPi, a similar and much more popular development board.\n\n## Features\n\n - Building u-boot and SPL from source, no copying binaries from the clockwork images!\n - Patched mainline Linux 5.4 kernel from meta-sunxi, includes Lima drivers\n - Mesa 19.1.6, also with Lima, from Yocto core\n - Broadcom wifi firmware configuration\n\n## Known Issues\n\n - DRAM clock can probably be increased, but the current setting is a safe\n   default.\n - No HDMI output. Need to combine the -hdmi dts and configure wayland for a\n   second output. Note: supposedly this only works on the CPI rev 3.1 boards\n   due to a PCB error.\n - Distro layer not yet public, but it does boot to weston and run an app.\n\n## Yocto\n\nSkip this is you're already familiar with Yocto Linux.\n\nYocto Linux is a system of build scripts and recipes for building bespoke Linux\nimages. A Yocto environment is composed of several layers, generally including\nthe \"core\" layer, named \"meta\", along with a BSP (Board Support Package) for\nthe target system, and a distro layer that defines all of the libraries and\napplications that will be included in the image. Yocto includes a reference\ndistro called Poky and BSPs for a small number of common systems, such as\nx86_64.\n\n# Building\n\n## Dependencies\n\n - Yocto core \"meta\"\n - meta-sunxi\n\n## Getting Started\n\nStart with [Setting Up to Use The Yocto Project](https://www.yoctoproject.org/docs/2.0/yocto-project-qs/yocto-project-qs.html#yp-resources).\n\n    git clone -b zeus git://git.yoctoproject.org/poky\n    cd poky\n    git clone -b zeus https://github.com/linux-sunxi/meta-sunxi\n    git clone -b zeus https://github.com/JeremyGrosser/meta-clockwork\n    source oe-init-build-env\n    \u003cedit conf/bblayers.conf to add meta-sunxi and meta-clockwork\u003e\n    \u003cedit conf/local.conf change MACHINE to clockwork-cpi3\u003e\n    bitbake core-image-minimal\n\nThis will take a while. Depending on your hardware configuration, it may take\nseveral hours. Only changed recipes and their dependencies are built, so\nsubsequent runs should be faster.\n\nIf all went well, you should now have some files in `tmp-glibc/deploy/images/clockwork-cpi3/`\n\nInsert a microSD card and `dd` the\n`core-image-minimal-clockwork-cpi3.wks` file to it. If you don't know\nhow to do this, [read this guide](https://www.raspberrypi.org/documentation/installation/installing-images/linux.md).\n\nPut the microSD card in your cpi3 board and hold the power button for 10\nseconds, or until the display turns on. If it worked, you should see a bunch of\npenguins and eventually a login prompt. If nothing happens, try poking the\nreset button next to the GPIO connector.\n\n# Next Steps\n\nYou may have noticed that you cannot type with a D-Pad. You could try to come\nup with some obscene combination of USB adapters to get a keyboard attached to\nyour GameShell, but a serial console is much more usable. If you connect the\nGPIO cable (the rainbow octopus thing) that came with your GameShell to a [3.3V USB-Serial](https://www.amazon.com/JBtek-WINDOWS-Supported-Raspberry-Programming/dp/B00QT7LQ88/?tag=synack-20)\nadapter, you can use a terminal emulator to poke at it. Use of a serial console\nis outside the scope of this README but the pinout you'll need is included\nbelow.\n\n## Serial Console\n\n[From the schematic](https://github.com/clockworkpi/GameShellDocs/blob/master/clockwork_Mainboard_Schematic.pdf),\nthis is connector J46 in the DEBUG block on page 8.\n\nFrom left to right, with the cpi3's flat-flex display connector on the left)\n\n    1   Blue    Not Connected\n    2   Green   TX\n    3   Yellow  RX\n    4   White   GND\n\nThe blue wire is 5V output. DO NOT FEED 5V INTO THIS PIN. Configure your serial\nterminal for 115200 baud, [8n1](https://en.wikipedia.org/wiki/8-N-1).\n\n## Yocto Distro\n\nIf you want your GameShell to do more than boot to a shell, you're going to\nneed a more complete Yocto distro to install some software with some graphics\nor something. I'm currently working on this, but it's not ready yet. In the\nmeantime, you can `bitbake core-image-sato` for a desktop-like experience.\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjeremygrosser%2Fmeta-clockwork","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fjeremygrosser%2Fmeta-clockwork","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjeremygrosser%2Fmeta-clockwork/lists"}