{"id":20713282,"url":"https://github.com/linaro/lite-cornea","last_synced_at":"2025-04-23T08:04:50.232Z","repository":{"id":65748506,"uuid":"515312310","full_name":"Linaro/lite-cornea","owner":"Linaro","description":"A command line shim to interact with the Iris Debug server of an ARM FVP","archived":true,"fork":false,"pushed_at":"2024-04-04T01:23:20.000Z","size":1220,"stargazers_count":2,"open_issues_count":0,"forks_count":3,"subscribers_count":6,"default_branch":"main","last_synced_at":"2025-04-23T08:04:34.447Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Rust","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Linaro.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}},"created_at":"2022-07-18T19:17:43.000Z","updated_at":"2025-04-10T08:45:36.000Z","dependencies_parsed_at":"2023-12-12T20:39:52.835Z","dependency_job_id":"a9355c74-dcf8-4a68-9c7b-4b5c58866a78","html_url":"https://github.com/Linaro/lite-cornea","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Linaro%2Flite-cornea","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Linaro%2Flite-cornea/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Linaro%2Flite-cornea/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Linaro%2Flite-cornea/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Linaro","download_url":"https://codeload.github.com/Linaro/lite-cornea/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":250395281,"owners_count":21423400,"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":[],"created_at":"2024-11-17T02:24:16.246Z","updated_at":"2025-04-23T08:04:50.214Z","avatar_url":"https://github.com/Linaro.png","language":"Rust","readme":"# lite-cornea\nA command line shim to interact with the Iris Debug server of an ARM FVP\n\n/!\\ This is alpha /!\\\n\nFor the time being, run the help command `cargo run help` or `cornea help` to figure out usage.\n\nBe aware that you need to add the `-I` option to the Fast Model/FVP command line.\nAs far as I can tell, there's not default way to add this parameter to a west build from the command line.\nI have added it manually to `ARM_FVP_FLAGS` in `board.cmake` within my board's directory.\nThis is not an ideal solution, so it would be nice to standardize something.\n\n## A note on instances\n\nFVPs and Fast Models are built on 'instances', which simulate an individual ip block\nor ip block connection.\nInstances are named within a model are organized in a tree-like manner and\nnamed separating layers with a `.`.\nMany subcommands of cornea accept an instance as a parameter.\n\n## Usage Examples\n\nThe following examples all use the FVP for the Corstone1000.\n\nPrinting the children instances of the secure element in the hierarchy:\n\n```bash\n$ cornea child-list component.IoT_Corstone_1000.se\n.cpu\n.ClkCtrl.clkSelect\n.ClkCtrl.clkGate\n.ClkCtrl\n.cpu_labeller\n.SysCtrlRegs\n.ChassisCtrlRegs\n.uart0\n---- etc. ----\n```\n\nPrint a table describing the resources of the host-cluster0, cpu0:\n```bash\n$ cornea resource-list component.IoT_Corstone_1000.host.cluster0.core0\ntype  │ bits │                 name │ description\n══════╪══════╪══════════════════════╪═════════════════════\nReg   │   32 │          PC_MEMSPACE │ Iris memory space id of the current PC and the current SP.\nReg   │   64 │                   X0 │ X0\nReg   │   64 │                   X1 │ X1\nReg   │   64 │                   X2 │ X2\n---- etc. ----\n```\n\nPrinting the PC of the host cpu0:\n\n```bash\n$ cornea resurce-read component.IoT_Corstone_1000.host.cluster0.cpu0 PC\n   value │ name\n═════════╪════════════════════════════════════\n       0 │ PC_MEMSPACE\n       0 │ PC\n```\n\nReading 8 bytes of memory at address 6 as seen by the flash memory\ngrouped into u16 sized entries:\n\n```\n$ cornea memory-read component.IoT_Corstone_1000.board.flash0 6 8 --group-by u16\n         0    2    4    6    8    a    c    e\n00000000                e800 0010 e7ff e800            ........\n```\n\nCreate a gdb connection to the model from the perspective of the secure\nenclave processor:\n\n```\n#!/bin/env -S gdb -ix\nset arch armv6-m\ntarget remote | cornea gdb-proxy component.IoT_Corstone_1000.se.cpu\n```\nNote: The above is a script that, when made executable, will connect to the\nmodel automatically, similar to the behavior when you run gdb with an executable\nparameter or a process id flag.\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Flinaro%2Flite-cornea","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Flinaro%2Flite-cornea","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Flinaro%2Flite-cornea/lists"}