{"id":39467095,"url":"https://github.com/3mdeb/meta-rte","last_synced_at":"2026-01-18T04:51:05.344Z","repository":{"id":43971566,"uuid":"169231478","full_name":"3mdeb/meta-rte","owner":"3mdeb","description":"Yocto meta layer for the RTE https://3mdeb.com/products/open-source-hardware/rte/ board","archived":false,"fork":false,"pushed_at":"2026-01-12T17:48:37.000Z","size":6087,"stargazers_count":9,"open_issues_count":15,"forks_count":3,"subscribers_count":6,"default_branch":"master","last_synced_at":"2026-01-12T23:07:34.858Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"","language":"BitBake","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/3mdeb.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","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,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2019-02-05T11:38:30.000Z","updated_at":"2025-12-03T15:05:51.000Z","dependencies_parsed_at":"2026-01-06T11:03:23.526Z","dependency_job_id":null,"html_url":"https://github.com/3mdeb/meta-rte","commit_stats":{"total_commits":255,"total_committers":13,"mean_commits":"19.615384615384617","dds":0.3686274509803922,"last_synced_commit":"3ca9565949de26677e9956983225528ef24ac795"},"previous_names":[],"tags_count":30,"template":false,"template_full_name":null,"purl":"pkg:github/3mdeb/meta-rte","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/3mdeb%2Fmeta-rte","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/3mdeb%2Fmeta-rte/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/3mdeb%2Fmeta-rte/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/3mdeb%2Fmeta-rte/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/3mdeb","download_url":"https://codeload.github.com/3mdeb/meta-rte/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/3mdeb%2Fmeta-rte/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28530347,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-18T00:39:45.795Z","status":"online","status_checked_at":"2026-01-18T02:00:07.578Z","response_time":98,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"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":[],"created_at":"2026-01-18T04:51:03.983Z","updated_at":"2026-01-18T04:51:05.331Z","avatar_url":"https://github.com/3mdeb.png","language":"BitBake","funding_links":[],"categories":[],"sub_categories":[],"readme":"# meta-rte\n\n# Meta-RTE Yocto BSP documentation\n\n* [BSP layers description](docs/layer-description.md)\n\n* [Development process description](docs/development.md)\n\n* [Release process description](docs/release.md)\n\n* [Instruction of setting the MAC address in U-Boot](docs/rte-mac-setup.md)\n\n* [cpu command introduction and use case](docs/cpu.md)\n\n# Usage\n\n## Prerequisites\n\n[kas](https://github.com/siemens/kas) installed. The preferred way is to use it\ninside container, via the [kas-container] script.\n\n### docker installation\n\n* [docker installation](https://docs.docker.com/install/)\n\n### kas-container installation\n\n* [kas-container] installation:\n\n```sh\nwget -O ~/bin/kas-container https://raw.githubusercontent.com/siemens/kas/master/kas-container\nchmod +x ~/bin/kas-container\n```\n\n## Build\n\n```sh\nmkdir rte-sdk\ncd rte-sdk\ngit clone https://github.com/3mdeb/meta-rte.git\nKAS_IMAGE_VERSION=\"4.2\" kas-container build meta-rte/kas.yml\n```\n\n## Flash\n\nThere are two main ways to flash an image, etcher and bmaptool.\n\n### etcher\n\nThe easiest way to flash image on all system platforms is to use `etcher`. It\nis multi-platform application that is available for Linux, Windows or macOS.\n\n* Download and install [etcher](https://etcher.io/).\n\n* Insert the SD card to the SD card reader of your host PC.\n\n* Run etcher.\n\n* Click on `Select Image` and select built image. There is no need to unpack\nthe image first.\n\n   The SD card reader should be picked automatically. If more than one readers\n   are present, click on `Change` and select the one you want to use.\n\n* When confirmed, click on the `Flash` button to start flashing procedure.\n\n### bmaptool\n\nIf you prefer a command-line tool, then you should use bmaptool. To install it,\ndepending on the package manager your system uses, use one of the following\ncommands:\n\n**for Ubuntu:**\n\n```sh\nsudo apt install bmap-tools\n```\n\n**for Fedora:**\n\n```sh\nsudo dnf install bmap-tools\n```\n\nyou can then download the latest image from the\n[releases](https://github.com/3mdeb/meta-rte/releases) page. You should\ndownload both the `.wic.bmap` and `.wic.gz` files.\n\nOnce you have chosen the version you want and downloaded it (both files), you\ncan then flash it using bmaptool, like this:\n\n```sh\nbmaptool copy --bmap /path/to/example.wic.bmap /path/to/example.wic.gz /dev/sdX\n```\n\nin order to know what `/dev/sdX` you want to flash, its a good idea to use\nthe `lsblk` command, before and after plugging in your SD card. You should be\nable to see the difference in the output of those two commands, and determine\nwhat your SD card is called.\n\n## Login to the system\n\n```sh\nLogin: root\nPassword: meta-rte\n```\n\n## Update\n\nTo perform update on platform we will use\n[SWUpdate](https://sbabic.github.io/swupdate/index.html) software already\ninstalled on OS.\n\n* Download latest available .swu update image from [releases\n  page](https://github.com/3mdeb/meta-rte/releases).\n\n* Provide anyhow downloaded .swu update image to device, for example using scp\n\n  ```shell\n  $ scp path/to/swu/file.swu root@RTE_IP:/path/to/deploy/file/\n  ```\n\n  \u003eNote: you can check RTE_IP by running `ip a` command on RTE.\n\n* Check active partition, run `findmnt /` command on RTE\n\n  ```shell\n  # findmnt /\n  TARGET SOURCE         FSTYPE OPTIONS\n  /      /dev/mmcblk0p2 ext4   rw,relatime\n  ```\n\n* Now run `swupdate` command, for flag `-e` we need to provide an inactive\n  partition which in this case is `mmcblk0p3`. If `findmnt /` command would\n  return `mmcblk0p3` then `mmcblk0p2` should be provided for `-e`. Flag `-i` is\n  used to provide update image stored locally and `-v` will cause to print debug\n  logs.\n\n  ```shell\n  # swupdate -e \"rte,mmcblk0p3\" -i /path/to/file.swu -v\n  Swupdate v2020.04.0\n\n  Licensed under GPLv2. See source distribution for detailed copyright notices.\n  (...)\n  Software updated successfully\n  Please reboot the device to start the new software\n  [INFO ] : SWUPDATE successful !\n  [DEBUG] : SWUPDATE running :  [postupdate] : Running Post-update command\n  ```\n\n* After success reboot the board. Platform should start from different partition\n  and updated system. This can be verified by running `cat /etc/os-release`.\n\n  ```shell\n  # cat /etc/os-release\n  ID=rte\n  NAME=\"RTE (Remote Test Environment Distro)\"\n  VERSION=\"0.7.4-rc1 (rocko)\"\n  VERSION_ID=0.7.4-rc1\n  PRETTY_NAME=\"RTE (Remote Test Environment Distro) 0.7.4-rc1 (rocko)\"\n  ```\n\n* From now, updated partition will be set as active, so every next reboot will\n  cause to boot updated OS.\n\n## OpenVPN\n\nThere is a possibility to use OpenVPN. The only thing you have to do is\ncopy the config file to the `openvpn` folder on `data` partition of\nSD card with the name `rte.conf`.\n\n## Serial\n\nYou can access the DUT's serial connection from the RS232/UART port at\n`/dev/ttyS1`, for example, through Minicom:\n\n```sh\n# minicom -D /dev/ttyS1\n```\n\nAll possible devices can be listed using following command:\n\n```sh\n# ls /dev/tty*\n```\n\n### Telnet\n\nIt is also possible to use telnet communication via RTE. On RTE there is serial\nto network proxy service called `ser2net`. Its status can be seen by running a\ncommand:\n\n```sh\n# systemctl -all | grep ser2net\n  ser2net.service           loaded     active     running\n```\n\nService configuration is placed here:\n\n```sh\n# cat /etc/ser2net.yaml\n\n# Connection to read from /dev/ttyS1\nconnection: \u0026con1\n  accepter: telnet, tcp, 13541\n  connector: serialdev, /dev/ttyS1, 115200n81, local\n\n# Connection to read from /dev/ttyUSB0\nconnection: \u0026con2\n  accepter: telnet, tcp, 13542\n  connector: serialdev, /dev/ttyUSB0, 115200n81, local\n```\n\nThe first value indicates the port for telnet communication, the path /dev/tty*\nindicates the path to the device with which the connection is made.\n\nSerial connection with the device can be established by command:\n\n```sh\n$ telnet \u003cRTE_IP\u003e \u003cPORT\u003e\n```\n\nfor example:\n\n```sh\n$ telnet 192.168.4.170 13541\n```\n\nIn this case, a serial connection will be made via RTE with IP 192.168.4.170\nwith device `/dev/ttyUSB0` using above configuration.\n\n# Development workflow\n\n## Individual MR\n\n\u003e Our [change log](CHANGELOG.md) mostly depends on the merge events and the\n\u003e merge request names are presented as introduced changes in this file. Be sure\nto use `git add -p` and add only your version, so as not to change previous\nrelease notes (incorrect links to previous pull requests).\n\n* Commit changes\n\n* Push on branch and create pull request\n\n* Wait for review and merge\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2F3mdeb%2Fmeta-rte","html_url":"https://awesome.ecosyste.ms/projects/github.com%2F3mdeb%2Fmeta-rte","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2F3mdeb%2Fmeta-rte/lists"}