{"id":22691854,"url":"https://github.com/cmst0us/meta-tspi","last_synced_at":"2026-05-17T03:42:33.625Z","repository":{"id":252974776,"uuid":"842071587","full_name":"CmST0us/meta-tspi","owner":"CmST0us","description":"LCEDA TaiShan-Pi board support yocto layer","archived":false,"fork":false,"pushed_at":"2024-08-18T16:05:07.000Z","size":1769,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"scarthgap","last_synced_at":"2025-02-04T17:52:09.407Z","etag":null,"topics":["lceda","lckfb","linux","rk3566","rockchip","tspi","yocto"],"latest_commit_sha":null,"homepage":"","language":"C","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/CmST0us.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"COPYING.MIT","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}},"created_at":"2024-08-13T16:01:00.000Z","updated_at":"2024-08-18T16:05:11.000Z","dependencies_parsed_at":"2024-08-18T16:37:46.306Z","dependency_job_id":null,"html_url":"https://github.com/CmST0us/meta-tspi","commit_stats":null,"previous_names":["cmst0us/meta-tspi"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/CmST0us%2Fmeta-tspi","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/CmST0us%2Fmeta-tspi/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/CmST0us%2Fmeta-tspi/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/CmST0us%2Fmeta-tspi/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/CmST0us","download_url":"https://codeload.github.com/CmST0us/meta-tspi/tar.gz/refs/heads/scarthgap","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":246215817,"owners_count":20741894,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","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":["lceda","lckfb","linux","rk3566","rockchip","tspi","yocto"],"created_at":"2024-12-10T01:12:39.604Z","updated_at":"2025-10-23T23:56:14.443Z","avatar_url":"https://github.com/CmST0us.png","language":"C","funding_links":[],"categories":[],"sub_categories":[],"readme":"# meta-rockchip\n\nYocto BSP layer for the Rockchip SOC boards\n  - wiki \u003chttp://opensource.rock-chips.com/wiki_Main_Page\u003e.\n\nThis README file contains information on building and booting the meta-rockchip BSP layers.\n\nPlease see the corresponding sections below for details.\n\n## Dependencies\n\nThis layer depends on:\n\n* URI: git://git.yoctoproject.org/poky\n* branch: scarthgap\n\n* URI: git://git.openembedded.org/meta-openembedded\n* layers: meta-oe\n* branch: scarthgap\n\n## Table of Contents\n\nI. Configure yocto/oe Environment\n\nII. Building meta-rockchip BSP Layers\n\nIII. Booting your Device\n\nIV. Tested Hardwares\n\nV. Supporting new Machine\n\n### I. Configure yocto/oe Environment\n\nIn order to build an image with BSP support for a given release, you need to download the corresponding layers described in the \"Dependencies\" section. Be sure that everything is in the same directory.\n\n```shell\n~ $ mkdir yocto; cd yocto\n~/yocto $ git clone git://git.yoctoproject.org/poky -b scarthgap\n~/yocto $ git clone git://git.openembedded.org/meta-openembedded.git -b scarthgap\n```\n\nAnd put the meta-rockchip layer here too.\n\nThen you need to source the configuration script:\n\n```shell\n~/yocto $ source poky/oe-init-build-env\n```\n\nHaving done that, you can build a image for a rockchip board by adding the location of the meta-rockchip layer to bblayers.conf, along with any other layers needed.\n\nFor example:\n\n```makefile\n# build/conf/bblayers.conf\nBBLAYERS ?= \" \\\n  ${TOPDIR}/../meta-rockchip \\\n  ${TOPDIR}/../poky/meta \\\n  ${TOPDIR}/../poky/meta-poky \\\n  ${TOPDIR}/../poky/meta-yocto-bsp \\\n  ${TOPDIR}/../meta-openembedded/meta-oe \\\n```\n\nTo enable a particular machine, you need to add a MACHINE line naming the BSP to the local.conf file:\n\n```makefile\n  MACHINE = \"xxx\"\n```\n\nAll supported machines can be found in meta-rockchip/conf/machine.\n\n### II. Building meta-rockchip BSP Layers\n\nYou should then be able to build a image with \"rockchip-image\" enabled in the local.conf file:\n\n```makefile\nINHERIT:append = \" rockchip-image\"\n```\n\n```shell\n$ bitbake core-image-minimal\n```\n\nAt the end of a successful build, you should have an .wic image in `/path/to/yocto/build/tmp/deploy/images/\u003cMACHINE\u003e/`, also with an rockchip firmware image: `update.img`.\n\n### III. Booting your Device\n\nUnder Linux, you can use upgrade_tool: \u003chttp://opensource.rock-chips.com/wiki_Upgradetool\u003e to flash the image:\n\n1. Put your device into rockusb mode: \u003chttp://opensource.rock-chips.com/wiki_Rockusb\u003e\n\n2. If it's maskrom rockusb mode, try to enter miniloader rockusb mode:\n\n```shell\n$ sudo upgrade_tool db \u003cIMAGE PATH\u003e/loader.bin\n```\n\n3. Flash the image (wic image or rockchip firmware image)\n\n```shell\n$ sudo upgrade_tool wl 0 \u003cIMAGE PATH\u003e/\u003cIMAGE NAME\u003e.wic # For wic image\n```\n\n```shell\n$ sudo upgrade_tool uf \u003cIMAGE PATH\u003e/update.img # For rockchip firmware image\n```\n\n### IV. Tested Hardwares\n\nThe following undergo regular basic testing with their respective MACHINE types.\n\n* px3se evb board\n\n* rk3308 evb board\n\n* rk3326 evb board\n\n* px30 evb board\n\n* rk3328 evb board\n\n* rk3288 evb board\n\n* rk3399 sapphire excavator board\n\n* rk3399pro evb board\n\n### V. Supporting new Machine\n\nTo support new machine, you can either add new machine config in meta-rockchip/conf/machine, or choose a similar existing machine and override it's configurations in local config file.\n\nIn general, a new machine needs to specify it's u-boot config, kernel config, kernel device tree and wifi/bt firmware:\n\nFor example:\n\n```makefile\nKBUILD_DEFCONFIG = \"rk3326_linux_defconfig\"\nKERNEL_DEVICETREE = \"rockchip/rk3326-evb-lp3-v10-linux.dtb\"\nUBOOT_MACHINE = \"evb-rk3326_defconfig\"\nRK_WIFIBT_RRECOMMENDS = \" \\\n        rkwifibt-firmware-ap6212a1-wifi \\\n        rkwifibt-firmware-ap6212a1-bt \\\n        brcm-tools \\\n\"\n```\n\nIf you want to use your own local u-boot and kernel sources, a simple way is to override related configurations in local config file.\n\nFor example using the kernel/ and u-boot/ in the same directory of meta-rockchip:\n\n```makefile\n# build/conf/local.conf\nSRC_URI:pn-linux-rockchip = \" \\\n        git://${TOPDIR}/../kernel;protocol=file;usehead=1 \\\n        file://cgroups.cfg \\\n\"\nSRCREV:pn-linux-rockchip = \"${AUTOREV}\"\nKBRANCH = \"HEAD\"\n\nSRC_URI:pn-u-boot = \" \\\n        git://${TOPDIR}/../u-boot;protocol=file;usehead=1 \\\n\"\nSRCREV:pn-u-boot = \"${AUTOREV}\"\n```\n\n## Maintainers\n\n* Jeffy Chen `\u003cjeffy.chen@rock-chips.com\u003e`\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcmst0us%2Fmeta-tspi","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcmst0us%2Fmeta-tspi","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcmst0us%2Fmeta-tspi/lists"}