{"id":22580434,"url":"https://github.com/nitros9project/nitros9","last_synced_at":"2025-08-05T01:31:39.168Z","repository":{"id":195251718,"uuid":"692304064","full_name":"nitros9project/nitros9","owner":"nitros9project","description":"NitrOS-9 Operating System","archived":false,"fork":false,"pushed_at":"2024-10-18T00:02:17.000Z","size":33586,"stargazers_count":14,"open_issues_count":5,"forks_count":15,"subscribers_count":8,"default_branch":"main","last_synced_at":"2024-10-20T11:23:04.288Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Assembly","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/nitros9project.png","metadata":{"files":{"readme":"README.md","changelog":"ChangeLog","contributing":null,"funding":null,"license":null,"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":"2023-09-16T04:26:49.000Z","updated_at":"2024-10-12T15:57:56.000Z","dependencies_parsed_at":"2024-03-20T02:39:55.720Z","dependency_job_id":null,"html_url":"https://github.com/nitros9project/nitros9","commit_stats":null,"previous_names":["nitros9project/nitros9"],"tags_count":27,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nitros9project%2Fnitros9","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nitros9project%2Fnitros9/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nitros9project%2Fnitros9/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nitros9project%2Fnitros9/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/nitros9project","download_url":"https://codeload.github.com/nitros9project/nitros9/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":228691909,"owners_count":17958005,"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-12-08T05:22:23.660Z","updated_at":"2024-12-08T05:22:29.513Z","avatar_url":"https://github.com/nitros9project.png","language":"Assembly","funding_links":[],"categories":["Programming"],"sub_categories":["Source Code"],"readme":"# The NitrOS-9 Repository (on GitHub)\n\nNitrOS-9 is a community-based distribution of the [Microware OS-9 operating system](https://en.wikipedia.org/wiki/OS-9) for the [Motorola 6809](https://en.wikipedia.org/wiki/Motorola_6809) that was introduced in the late 1970s and sold into the 1980s.\n\nThe [Hitachi 6309](https://en.wikipedia.org/wiki/Hitachi_6309), which contains additional registers and enhanced instructions, is also supported.\n\nHere are the current ports of NitrOS-9:\n\n| Computer  | Port | Processor |\n| ------------- | ------------- |  ------------- |\n| TRS-80 Color Computer  | NitrOS-9 Level 1 | 6809 \u0026 6309 |\n| Radio Shack Color Computer 2 | NitrOS-9 Level 1 | 6809 \u0026 6309 |\n| Tandy Color Computer 3 | NitrOS-9 Level 2 | 6809 \u0026 6309 |\n| [CoCo3FPGA](https://groups.io/g/CoCo3FPGA) | NitrOS-9 Level 2 | 6809 |\n| Dragon 64 \u0026 Tano Dragon | NitrOS-9 Level 1 | 6809 |\n| Dragon Alpha | NitrOS-9 Level 1 | 6809 |\n| [Atari w/ Liber809](http://www.github.com/boisy/liber809) | NitrOS-9 Level 1 | 6809 |\n| [Corsham 6809 SS-50](https://www.corshamtech.com/product/ss-50-6809-cpu-board/) | NitrOS-9 Level 1 | 6809 |\n| [Foenix F256 with FNX6809](https://www.c256foenix.com/) | NitrOS-9 Level 1 \u0026 2 | 6809 |\n\n# Downloading and Building\n\nTo build NitrOS-9, you need the following:\n\n- [lwtools](http://lwtools.projects.l-w.ca). This package contains the required 6809 assembler and linker.\n- [ToolShed](https://github.com/n6il/toolshed). ToolShed provides file system tools for creating disk images, copying files to and from those disk images, and more.\n\nOnce downloaded and installed, you can build the entire project:\n\n```\nexport NITROS9DIR=$HOME/nitros9\nmake\n```\n\nThe result is a number of disk images (ending in .dsk) that can be used on real floppy drives, emulators, and DriveWire.\n\n# Contributing\n\nIf you wish to contribute, please fork the repository and submit pull requests.\n\nAlso, assembly source code is formatted to the following specifications:\n\n- Spaces only (no tabs)\n- Labels start at column 1\n- Opcodes start at column 21\n- Operands start at column 31\n- Comments start at column 51\n\nPut [this file](https://github.com/nitros9project/nitros9/blob/main/scripts/pre-commit) in your .git/hooks folder to ensure that any source code you submit is automatically formatted.\n\n# Coding Style Guidelines\n\nHere are some general coding guidelines for the project.\n\n## Add a comment to every line of assembly\n\nHaving a comment on each line of assembly may seem excessive, but doing so keeps the meaning behind flow of the code intact and gives the reader a clear understanding of what is happening.\n\n## Make comments meaningful\n\nTake time to write clearly about what a line of code is doing. Avoid repeating the obvious, if possible.\n\nInstead of this:\n\n```\n     clra        clear A\n```\n\ndo this:\n\n```\n     clra        set the path to standard input\n```      \n\n## Write comments in lowercase and don't use punctuation\n\nComments may or may not be complete sentences; as such, dispense with the formalism of capitalization and punctuation.\n\nInstead of this:\n\n```\n     ldb   #E$PNNF      Prepare the \"pathname not found\" error.\n```\n\ndo this:\n\n```\n     ldb   #E$PNNF      prepare the \"pathname not found\" error\n```      \n## Use full words\n\nAvoid abbreviations. Spelling out words increases the readability of the comments.\n\nInstead of this:\n\n```\n     pshs  d,x,y,u      push regs\n     leax  ,u           load path desc ptr in X\n```\n\ndo this:\n\n```\n     pshs  d,x,y,u      save the registers on the stack\n     leax  ,u           load the path descriptor pointer in X\n```\n\n## Ensure an empty line is at the end of a source file\n\nAdding an empty line to the end of a source file ensures that some programs that parse\nthe input do not abandon any important information on the last line.\n\nInstead of this:\n\n```\n     rts\n```\n\ndo this:\n\n```\n     rts\n\n```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnitros9project%2Fnitros9","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fnitros9project%2Fnitros9","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnitros9project%2Fnitros9/lists"}