{"id":20425347,"url":"https://github.com/catseye/situ-sol","last_synced_at":"2026-03-09T15:03:13.761Z","repository":{"id":35571760,"uuid":"39843929","full_name":"catseye/SITU-SOL","owner":"catseye","description":"A programming environment that was written by hand during RetroChallenge 2015/07","archived":false,"fork":false,"pushed_at":"2023-08-13T06:36:20.000Z","size":5366,"stargazers_count":7,"open_issues_count":0,"forks_count":0,"subscribers_count":3,"default_branch":"master","last_synced_at":"2025-01-15T15:12:26.822Z","etag":null,"topics":["6502","hand-assembled","hand-written","retrochallenge","retrocomputing"],"latest_commit_sha":null,"homepage":"http://catseye.tc/node/SITU-SOL","language":"BASIC","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/catseye.png","metadata":{"files":{"readme":"README.md","changelog":null,"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,"publiccode":null,"codemeta":null}},"created_at":"2015-07-28T16:00:27.000Z","updated_at":"2023-08-08T13:04:07.000Z","dependencies_parsed_at":"2025-01-15T15:08:57.896Z","dependency_job_id":"aafdd17b-60c6-4cfe-8f33-90582bf2c263","html_url":"https://github.com/catseye/SITU-SOL","commit_stats":null,"previous_names":[],"tags_count":4,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/catseye%2FSITU-SOL","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/catseye%2FSITU-SOL/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/catseye%2FSITU-SOL/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/catseye%2FSITU-SOL/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/catseye","download_url":"https://codeload.github.com/catseye/SITU-SOL/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":241966977,"owners_count":20050324,"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":["6502","hand-assembled","hand-written","retrochallenge","retrocomputing"],"created_at":"2024-11-15T07:13:01.194Z","updated_at":"2026-03-09T15:03:08.737Z","avatar_url":"https://github.com/catseye.png","language":"BASIC","funding_links":[],"categories":[],"sub_categories":[],"readme":"SITU-SOL\n========\n\nSITU-SOL is a programming environment for 6502-based computers that was\nwritten by hand during RetroChallenge 07/2015.\n\nFor more information, see the posts to the Bootstrap Zero blog, archived\nin this repo in [doc/bootstrap-zero/README.md](doc/bootstrap-zero/README.md).\n\nWhile SITU-SOL is quite generic, an emulated Commodore 64 was used to\nhost it and test it during its development, so many of the instructions\nbelow are specific to the C64.\n\nSupporting tools\n----------------\n\nThis repository contains the following supporting tools, written in\nCommodore BASIC 2.0:\n\n*   `binloader`, the first version of the simulated bit-entering facility,\n    used in the warm-up\n*   `frontpanel`, the improved version of the front-panel simulator,\n    used to enter SITU-MON.  (This tool is also now known as SITU-PAN.)\n\nBASIC sources for these are in `src`; the tokenized PRG files are in `bin`.\n\nNote that these programs begin writing to memory at $8100, which is normally\ninside the memory range that BASIC will also use — thus you are in danger of\nBASIC overwriting what you enter with its own variable data.  So, to safely\nrun either of these programs, you should do something like this:\n\n    POKE 56,128:NEW\n    LOAD \"FRONTPANEL\",8\n    RUN\n\nMemory images\n-------------\n\n*   `situ-mon` is a PRG file containing a dump of what memory $8100-$81FF\n    looked like just after SITU-MON was entered and fixed.  You can run\n    it from BASIC immediate mode like so:\n    \n        LOAD \"SITU-MON\",8,1\n        SYS 33024\n        \n*   `situ-sol` is a PRG file containing a dump of what memory $8100-$8520\n    looked like just after SITU-SOL was entered and fixed.  It also includes\n    SITU-MON — because SITU-SOL calls routines from it — and 256 bytes of\n    almost-unused code between $8200 and $82FF.\n    \n    It can be started from BASIC immediate mode like so:\n    \n        LOAD \"SITU-SOL\",8,1\n        POKE 2304,0:SYS 33830\n    \n    But!  There is no symbal table.  (The `POKE 2304,0` is to stop SITU-SOL\n    from mistakenly behaving as if there's a symbal table at that address,\n    in case that byte isn't zero.)  You may wish to load a symbal table\n    first, but I haven't got one handy, yet.\n\nOther things\n------------\n\nThis repository might, at some point, also contain text files containing\ndisassembled machine code that was entered.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcatseye%2Fsitu-sol","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcatseye%2Fsitu-sol","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcatseye%2Fsitu-sol/lists"}