{"id":15060519,"url":"https://github.com/grahambates/uae-dap","last_synced_at":"2025-04-10T06:10:15.112Z","repository":{"id":57689829,"uuid":"491465276","full_name":"grahambates/uae-dap","owner":"grahambates","description":"Debug Adapter Protocol for Amiga development with FS-UAE or WinUAE","archived":false,"fork":false,"pushed_at":"2025-03-13T00:04:57.000Z","size":217138,"stargazers_count":12,"open_issues_count":1,"forks_count":2,"subscribers_count":4,"default_branch":"master","last_synced_at":"2025-04-01T22:56:07.852Z","etag":null,"topics":["68000","amiga","asm","assembly","commodore","dap","debug","fs-uae","m68k","win-uae"],"latest_commit_sha":null,"homepage":"","language":"TypeScript","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/grahambates.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","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-05-12T10:22:48.000Z","updated_at":"2025-03-21T08:00:19.000Z","dependencies_parsed_at":"2024-06-21T02:54:42.697Z","dependency_job_id":null,"html_url":"https://github.com/grahambates/uae-dap","commit_stats":{"total_commits":171,"total_committers":1,"mean_commits":171.0,"dds":0.0,"last_synced_commit":"04395567f11c87cd8d3f1055c86089c0169b45dd"},"previous_names":[],"tags_count":36,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/grahambates%2Fuae-dap","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/grahambates%2Fuae-dap/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/grahambates%2Fuae-dap/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/grahambates%2Fuae-dap/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/grahambates","download_url":"https://codeload.github.com/grahambates/uae-dap/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248166925,"owners_count":21058481,"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":["68000","amiga","asm","assembly","commodore","dap","debug","fs-uae","m68k","win-uae"],"created_at":"2024-09-24T22:59:47.438Z","updated_at":"2025-04-10T06:10:14.964Z","avatar_url":"https://github.com/grahambates.png","language":"TypeScript","readme":"# UAE Debug Adapter Protocol\n\nStand-alone[Debug Adapter](https://microsoft.github.io/debug-adapter-protocol/) for Amiga assembly development with\n[FS-UAE](https://fs-uae.net/) or [WinUAE](https://www.winuae.net/).\n\nThis package was extracted from the [vscode-amiga-assembly](https://github.com/prb28/vscode-amiga-assembly) extension,\nto create stand-alone adapter for use with other editors that support [Debug Adapter Protocol](https://microsoft.github.io/debug-adapter-protocol/).\n\nThis library relies on patched binaries for FS-UAE and WinUAE with changes from @prb28 and @bartman to provide a remote\nGDB server. These are now bundled with the package for Windows, Mac and Debian Linux x64. Note that the FS-UAE\nimplementation is now based on the current 4.x dev build, and as such has some limitations and missing features. It is\ntotally usable though and is much closer to current WinUAE, allowing us to share common patches rather than maintaining\ntwo separate GDB implementations.\n\nTested with:\n\n- NeoVim [nvim-dap plugin](https://github.com/mfussenegger/nvim-dap). See example below.\n- Emacs [dap-mode](https://github.com/emacs-lsp/dap-mode).\n  See [emacs-m68k](https://github.com/themkat/emacs-m68k) (currently using 0.x version).\n\n## Installation\n\nInstall the `uae-dap` npm package globally: `npm i -g uae-dap`\n\n## Usage\n\nThe Amiga binaries to be debugged must include SAS/C-compatible LINE DEBUG hunks. Use the `-linedebug` option is vasm\nand `-hunkdebug` in vbcc to include these.\n\n### Example configuration:\n\nHere's a minimal example configuration for NeoVim with the [Amiga Assembly example workspace](https://github.com/prb28/vscode-amiga-wks-example).\n\n```lua\ndap.adapters.asm68k = {\n  type = 'executable',\n  command = 'uae-dap',\n  options = { initialize_timeout_sec = 20 },\n}\n\ndap.configurations.asm68k = {\n  {\n    type = 'asm68k',\n    request = 'launch',\n    program = '${workspaceFolder}/uae/dh0/gencop',\n    stopOnEntry = true,\n    emulatorType = \"fs-uae\",\n    emulatorArgs = {\n      \"--chip_memory=2048\",\n      \"--amiga_model=A1200\",\n      \"--automatic_input_grab=0\",\n      \"--floppy_drive_0_sounds=off\",\n      \"--hide_hud=1\",\n      \"--window_resizable=1\"\n    }\n  }\n}\n```\n\n### Configuration options:\n\n| Option          | Type                   | Description                                                                                   | Default                                              |\n| --------------- | ---------------------- | --------------------------------------------------------------------------------------------- | ---------------------------------------------------- |\n| `program`       | `string`               | Local path of target Amiga binary                                                             | -                                                    |\n| `remoteProgram` | `string`               | Remote path of target Amiga binary                                                            | `\"SYS:{basename(program)}\"`                          |\n| `stopOnEntry`   | `boolean`              | Automatically stop target after launch                                                        | `false`                                              |\n| `noDebug`       | `boolean`              | Just launch emulator without debugging                                                        | `false`                                              |\n| `trace`         | `boolean`              | Enable verbose logging                                                                        | `false`                                              |\n| `serverName`    | `string`               | Host name of the debug server                                                                 | `\"localhost\"`                                        |\n| `serverPort`    | `number`               | Port number of the debug server                                                               | `2345`                                               |\n| `exceptionMask` | `number`               | Mask used to catch the exceptions                                                             | `0b1111111111100`                                    |\n| `emulatorType`  | `\"fs-uae\" \\| \"winuae\"` | Emulator program type                                                                         | `\"winuae\"` on windows, `\"fs-uae\"` on other platforms |\n| `emulatorBin`   | `string`               | Path of emulator executable                                                                   | bundled version                                      |\n| `emulatorArgs`  | `string[]`             | Additional CLI args to pass to emulator program. Remote debugger args are added automatically | `[]`                                                 |\n\n## Changes\n\n### 1.0\n\n- Changed configuration schema\n- No longer supports the patched fs-uae 3.x implementation.\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgrahambates%2Fuae-dap","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fgrahambates%2Fuae-dap","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgrahambates%2Fuae-dap/lists"}