{"id":21286582,"url":"https://github.com/jeancahu/bash-dragon-12-tool","last_synced_at":"2026-05-19T00:38:48.226Z","repository":{"id":69816853,"uuid":"111142087","full_name":"jeancahu/bash-dragon-12-tool","owner":"jeancahu","description":"Dragon 12 plus 2 simple command interface on bash shell, Archlinux.","archived":false,"fork":false,"pushed_at":"2020-09-03T00:59:49.000Z","size":44,"stargazers_count":2,"open_issues_count":0,"forks_count":2,"subscribers_count":3,"default_branch":"master","last_synced_at":"2025-01-22T05:23:56.229Z","etag":null,"topics":["bash","bash-script"],"latest_commit_sha":null,"homepage":null,"language":"Shell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/jeancahu.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":"2017-11-17T19:22:19.000Z","updated_at":"2020-05-19T22:21:07.000Z","dependencies_parsed_at":null,"dependency_job_id":"7b21d467-bd49-4bbd-9dc9-093a89f53cc9","html_url":"https://github.com/jeancahu/bash-dragon-12-tool","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/jeancahu%2Fbash-dragon-12-tool","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jeancahu%2Fbash-dragon-12-tool/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jeancahu%2Fbash-dragon-12-tool/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jeancahu%2Fbash-dragon-12-tool/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/jeancahu","download_url":"https://codeload.github.com/jeancahu/bash-dragon-12-tool/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":243746684,"owners_count":20341284,"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":["bash","bash-script"],"created_at":"2024-11-21T11:29:58.704Z","updated_at":"2026-05-19T00:38:48.157Z","avatar_url":"https://github.com/jeancahu.png","language":"Shell","funding_links":[],"categories":[],"sub_categories":[],"readme":"# bash-dragon-12-tool\nDragon 12 plus 2 simple command interface on bash shell, Archlinux.\n\nRecommended: bash 4.4+\n\nDepends: screen, wine, wine-mono, wine_gecko\n\n## Install:\n\nFirst clone the repository directory.\n\n    git clone https://github.com/jeancahu/bash-dragon-12-tool.git ~/.dragon_12\n\nIf you desire, you can use the configure script to automatically configure the tool.\n\n    ./config\n\nOtherwise, add ~/.dragon\\_12 directory to PATH environment variable.\n\n\tPATH=$PATH:$HOME/.dragon_12\n\nAnd customize the dragon\\_12\\_vars\\_config.sh file to your needs.\n\n\n## Uninstall:\n\nRemove script directory:\n\n\trm -ir ~/.dragon_12/\n\n## How to use:\n| Flag | Interpretation |\n| ------ | ------ |\n| -h     | Help option. |\n|  -f \u003cfile.asm\u003e | Indicate \u003cfile\u003e.asm script input. |\n| -l\t\t\u003cfile.lst\u003e | Define list file out name. |\n| -o \u003cfile.s19\u003e | Define object file out name. |\n| -a | Use asm12 to create the object file. |\n| -b | Send the object file to board. |\n|-g\t\t\u003cXXXX\u003e| Indicate program counter initial value and run program on board, 16b HEX. |\n|-c\t\t[STRING]| Send a char/string to serial TTY. This does not permit spaces, all string is concatenated. \u003cbr/\u003e Control chars are: \u003cbr/\u003e-S Space \u003cbr/\u003e -R CarrieReturn|\n|-C|Send a char/string to serial TTY. This does permit spaces. \u003cbr/\u003eControl chars are: \u003cbr/\u003e-S Space \u003cbr/\u003e-R CarrieReturn \u003cbr/\u003e -E Exit loop|\n| -s | Run the object file with the simulator.  |\n| -S |\tOpen TTY serial access to communicate with board through Terminal.|\n\n\n\nFirst, open a terminal to communicate over RS232 with the board.\n\n    dragon_12.sh -S\n\nTo generate the object file:\n\n\tdragon_12.sh -af \u003cname.asm\u003e -o \u003cname.s19\u003e\n\nwhere \u003cname.asm\u003e is the source assembly code.\nTo write the object file to the board:\n\n\tdragon_12.sh -bo \u003cname.s19\u003e\n\nTo send the value of the program counter (PC) and execute the program on the board:\n\n\tdragon_12.sh -g XXXX\n\nwhere XXXX corresponds to the hexadecimal value in which the execution of the program begins.\n\n\nAll previous steps can be executed on a single program call, by typing:\n\n\n\tdragon_12.sh -af \u003cname.asm\u003e -o \u003cname.s19\u003e -b -g XXXX\n\n\nIf the name of either the object file or the list file is not specified, the program will assume the same name as the source file and will proceed to change only the suffix.\n\nIf you want to run the .s19 with the simulator you have three options:\n\n1. If you want to open an existing object file with the simulator.\n\n        dragon_12.sh -so \u003cname.s19\u003e\n\n2. If you want to assemble the .asm and run the object file generated by the assembler.\n\n        dragon_12.sh -saf \u003cname.asm\u003e\n\nThis will run the object file named after the .asm.\n\n3. If you want to bring the object file a different name.\n\n        dragon_12.sh -saf \u003cname.asm\u003e -o \u003cname.s19\u003e\n\nIf you just want to run the simulator, you can type:\n\n    dragon_12.sh simulator\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjeancahu%2Fbash-dragon-12-tool","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fjeancahu%2Fbash-dragon-12-tool","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjeancahu%2Fbash-dragon-12-tool/lists"}