{"id":26889728,"url":"https://github.com/EngineersBox/QuAC-Assembler","last_synced_at":"2025-03-31T21:19:28.466Z","repository":{"id":109327597,"uuid":"523263726","full_name":"EngineersBox/QuAC-Assembler","owner":"EngineersBox","description":"Assembles QuAC assembly into 16 bit QuAC v1.0 ISA binaries","archived":false,"fork":false,"pushed_at":"2023-04-23T05:26:46.000Z","size":3019,"stargazers_count":3,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-03-31T21:19:24.425Z","etag":null,"topics":["asm","assembler","assembly","go","golang","quac"],"latest_commit_sha":null,"homepage":"","language":"Go","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/EngineersBox.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":"2022-08-10T08:34:45.000Z","updated_at":"2023-01-17T14:28:10.000Z","dependencies_parsed_at":"2023-03-27T16:16:55.990Z","dependency_job_id":null,"html_url":"https://github.com/EngineersBox/QuAC-Assembler","commit_stats":null,"previous_names":["engineersbox/quac-compiler"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/EngineersBox%2FQuAC-Assembler","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/EngineersBox%2FQuAC-Assembler/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/EngineersBox%2FQuAC-Assembler/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/EngineersBox%2FQuAC-Assembler/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/EngineersBox","download_url":"https://codeload.github.com/EngineersBox/QuAC-Assembler/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":246540528,"owners_count":20793930,"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":["asm","assembler","assembly","go","golang","quac"],"created_at":"2025-03-31T21:19:27.555Z","updated_at":"2025-03-31T21:19:28.459Z","avatar_url":"https://github.com/EngineersBox.png","language":"Go","readme":"# QuAC-Assembler\nAssembles QuAC assembly into 16-bit QuAC v1.0 ISA binaries\n\nThe specification for QuAC v1.0 can be found here: \u003chttps://comp.anu.edu.au/courses/comp3710-uarch/resources/08-QuAC-ISA\u003e\n\n## Installation\n\nThe standard installation can be done with `install.sh` which will build the assembler into a binary\nand store it in `/usr/bin/quac_assembler`.\n\n```shell\n./install.sh\n```\n\nIf you want to build from source, simply run the following.\n\n```shell\ngo build src/assembler.go\n```\n\n## Usage\n\nYou'll need to build the assembler first before doing this, see the above section for details on that.\n\n```shell\nquac_assembler \u003csource assembly\u003e \u003cdestination binary\u003e\n```\n\n### Example\n\n```shell\nquac_assembler test.S result.bin\n```\n\nThis will compile the following assembly\n\n```asm\nmovl r1, 0x9 ; 0x0109\n; Test\nmovl r2, 1\nldr r3, [r1]\ntest:\nadd r3, r3, r2\nstr r3, [r1]\njpeq test\nnop\n.word 0\n.word 0\n.word 0xFF\n```\n\nInto the following binary data\n\n```\n┌────────┬─────────────────────────┬─────────────────────────┬────────┬────────┐\n│00000000│ 01 09 02 01 53 10 83 32 ┊ 43 10 0f 30 00 00 00 00 │•_••S•×2┊C••00000│\n│00000010│ 00 00 00 00 00 ff       ┊                         │00000×  ┊        │\n└────────┴─────────────────────────┴─────────────────────────┴────────┴────────┘\n```\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FEngineersBox%2FQuAC-Assembler","html_url":"https://awesome.ecosyste.ms/projects/github.com%2FEngineersBox%2FQuAC-Assembler","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FEngineersBox%2FQuAC-Assembler/lists"}