{"id":19168798,"url":"https://github.com/riscv-mcu/nuclei_vp","last_synced_at":"2025-04-14T20:56:02.067Z","repository":{"id":185759719,"uuid":"672834306","full_name":"riscv-mcu/nuclei_vp","owner":"riscv-mcu","description":"Nuclei Virtual Platform","archived":false,"fork":false,"pushed_at":"2023-08-15T03:51:18.000Z","size":258,"stargazers_count":4,"open_issues_count":0,"forks_count":0,"subscribers_count":6,"default_branch":"wip","last_synced_at":"2025-03-28T09:11:14.088Z","etag":null,"topics":["qbox","riscv","systemc","tlm2","virtual-platform"],"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/riscv-mcu.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","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":"2023-07-31T09:17:58.000Z","updated_at":"2024-12-04T13:51:10.000Z","dependencies_parsed_at":null,"dependency_job_id":"b00d7b2c-7d48-4267-afec-4be52c18e83d","html_url":"https://github.com/riscv-mcu/nuclei_vp","commit_stats":null,"previous_names":["riscv-mcu/nuclei_vp"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/riscv-mcu%2Fnuclei_vp","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/riscv-mcu%2Fnuclei_vp/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/riscv-mcu%2Fnuclei_vp/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/riscv-mcu%2Fnuclei_vp/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/riscv-mcu","download_url":"https://codeload.github.com/riscv-mcu/nuclei_vp/tar.gz/refs/heads/wip","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248961142,"owners_count":21189991,"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":["qbox","riscv","systemc","tlm2","virtual-platform"],"created_at":"2024-11-09T09:43:50.407Z","updated_at":"2025-04-14T20:56:02.038Z","avatar_url":"https://github.com/riscv-mcu.png","language":"C++","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Nuclei Open Source Virtual Platform\n\nNuclei Open Source Virtual Platform is modified based on https://github.com/nvdla/vp repo.\n\nIt integrated nuclei qemu into systemc environment to provide a virtual platform based on systemc tlm.\n\nIt use technology such as greensoc's qbox and greenlib to support systemc modeling.\n\n## Download Source Code\n\nGit clone the repository and update the submodules.\nAfter cloning the repository, run the following command to update the submodule:\n\n```sh\n# NOTE: for internal developer, please use internal git repo url\ngit clone https://github.com/riscv-mcu/nuclei_vp\ncd nuclei_vp\n# checkout wip branch or other branch you need\n# this is still under development, so branch is named wip\ngit checkout wip\n# make sure this step below executed successfully\ngit submodule update --init --recursive\n# check repo status and git submodule status\ngit status\ngit submodule\n```\n\n## Build steps\n\n\u003e **Caution**: Not all scripts located in `scripts/` and `docker/` works.\n\nWe are using docker ubuntu 20.04 to build and test this repo.\n\n### Download and run docker\n\n\u003e Make sure docker is installed in your system, and you have executation right.\n\n~~~shell\n# in host now\n# The docker is a prebuilt one, uploaded to docker hub, see https://hub.docker.com/r/nucleisoftware/ubuntu/tags\nbash scripts/run_docker.sh\n# now in docker\n~~~\n\n### Build repo in docker\n\nWe have made a script to build this project using cmake, see `scripts/build.sh`,\nif you want to know the details, please check script content.\n\n~~~shell\n# in docker now\ncd /work\n# build nuclei vp project in vp.build folder\n# it will automatically build and install this project\n# if you want to build it in a new folder, change vp.build to another name\nbash scripts/build.sh vp.build\n~~~\n\n## Test in docker\n\n~~~shell\n# in docker now\n## build freeloader and qemu disk images using nuclei linux sdk or use a prebuilt image\n## see https://github.com/Nuclei-Software/nuclei-linux-sdk/tree/dev_nuclei_6.1_v2#booting-linux-on-nuclei-qemu\n## simple steps in nuclei-linux-sdk repo is as below\n## $ make SOC=evalsoc CORE=ux900fd freeloader gendisk\n## then you can copy \u003cnuclei-linux-sdk\u003e/work/evalsoc/freeloader.elf and \u003cnuclei-linux-sdk\u003e/work/evalsoc/disk.img to \u003cnuclei_vp\u003e/images/\n## or you can download a prebuilt version from https://drive.weixin.qq.com/s?k=ABcAKgdSAFcZkIVSxF\n## extract it to \u003cnuclei_vp\u003e/images folder\n# run this virtual platform located in vp.build\nbash scripts/run.sh vp.build\n~~~\n\nSample output can be found in [runlog.txt](scripts/runlog.txt)\n\nIf you want to test baremetal case, please use command below:\n\n~~~shell\n# in docker now\n## build baremetal case for nx900fd using nuclei sdk\n## see https://doc.nucleisys.com/nuclei_sdk/design/app.html\n## using SOC=evalsoc CORE=nx900fd\n## extract it to \u003cnuclei_vp\u003e/images folder\n# run this virtual platform located in vp.build\n# default elf is images/baremetal.elf\nbash scripts/run.sh vp.build conf/riscv64_bare.lua\n~~~\n\nSample output can be found in [runlog_baremetal.txt](scripts/runlog_baremetal.txt)\n\n## Licence\n\nSee [License](License).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Friscv-mcu%2Fnuclei_vp","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Friscv-mcu%2Fnuclei_vp","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Friscv-mcu%2Fnuclei_vp/lists"}