Skip to content
One-stop Visual Code Extension to compile and debug Amiga C programs compiled by included gcc 8.3.0 in WinUAE.
Roff C TypeScript C++ Assembly Shell Other
Branch: master
Clone or download
Latest commit ad4a0ee Aug 19, 2019

README.md

amiga-debug Visual Studio Code Extension (Windows only)

One-stop Visual Code Extention to compile and debug Amiga C programs compiled by included gcc 8.3.0 in WinUAE.

Quick-start

  1. Create a project folder with File > Open Folder...
  2. From the command palette Ctrl+Shift+P select Amiga: Init Project
  3. Open .vscode/launch.json and point "kickstart" to your Kickstart 1.3 ROM
  4. Hit F5 to build and run a minimal sample project

Features

  • No additional tools required. Everything is included (except Kickstart ROM 😒). Ready to go make your next Amiga 500 production!
  • State-of-the-art code generation by GCC with Link-Time-Optimizations (LTO) for increased performance and smaller code size
  • IntelliSense
  • Full source-level and assembly-level debugging with callstack, breakpoints, watches, registers, memory view with GDB-enabled WinUAE
  • Fully AmigaOS compatible via included .h files
  • INCBIN support
  • Output to debug console from WinUAE
  • WinUAE warp-launch (turbo-boot)
  • WinUAE warp-mode control from your Amiga project

How-to-use

  • amiga: View Memory, amiga: Set Force Disassembly, amiga: View Disassembly (Function) are available from the command palette Ctrl+Shift+P
  • WinUAE:
    • ^ = single step, Pause = pause/resume Page-up = warp mode
    • all necessary options are already configured for Amiga 500, Kickstart 1.3 (for debugging), if you want to change some things (resolution, window size, etc.) just go into the Configurations tab, select default, and hit Save

Credits

Code by Bartman/Abyss

Acknowledgements

This extension is based in part on Marcel Ball's Cortex-Debug extension.

Some modifications of GCC are based on work by Stefan "Bebbo" Franke.

Amiga system-includes (NDK 3.9) copied from an installation of Bebbo's amiga-gcc and modified to work with GCC 8. Originally downloaded from http://www.haage-partner.de/download/AmigaOS/NDK39.lha

This extension contains binaries of:

  • modified GCC 8.3.0
    • Copyright (C) 2018 Free Software Foundation, Inc.
    • This is free software; see the source for copying conditions. There is NO warranty; not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
  • modified GNU Binutils 2.32.51.20190311
    • Copyright (C) 2019 Free Software Foundation, Inc.
    • License GPLv3+: GNU GPL version 3 or later http://gnu.org/licenses/gpl.html
    • This is free software: you are free to change and redistribute it. There is NO WARRANTY, to the extent permitted by law.
  • modified GNU gdb (GDB) 8.3.50.20190311-git
    • Copyright (C) 2019 Free Software Foundation, Inc.
    • This program is free software; you may redistribute it under the terms of the GNU General Public License version 3 or (at your option) any later version.
  • modified WinUAE 4.2.0
  • modified elf2hunk (source included)
    • Copyright (c) 1995-2017, The AROS Development Team. All rights reserved.
    • Modified 2018-2019, Bartman/Abyss
  • GNU Make 4.2.1
    • Copyright (C) 1988-2016 Free Software Foundation, Inc.
    • License GPLv3+: GNU GPL version 3 or later http://gnu.org/licenses/gpl.html
    • This is free software: you are free to change and redistribute it. There is NO WARRANTY, to the extent permitted by law.

Caveats

  • sometimes when you're multiplying 2 WORDs together, gcc tries to use a (slow) 32-bit multiply. So if you have performance-critical multiplications, consider using the muluw and mulsw functions from gcc8_c_support.h

Known Issues

  • finish package.json fertigmachen. Configs, settings, ...
  • store assembly breakpoints in one "virtual" file in breakpointMap (how?!)
  • when stepping out of IRQ handler, stack frames are corrupt until next step
  • disassemble address always creates new disassembly even if just stepping. check title of current disassembly window if current PC is in range.
  • sometimes fail at start: Unable to open 'main.amigaasm': Cannot read property 'customRequest' of undefined.
  • restartRequest not implemented
  • vscode.debug.activeDebugSession is undefined when program is stopped on entry
  • not getting handleThreadSelected(), thread ID now set in class
  • sometimes Pause/Resume button doesn't correctly switch to "Pause" icon while amiga program is running
  • step out of kickstart: set fake breakpoint at 0xfffffff, WinUAE should enter TRACE_RANGE_PC mode (TODO: tighten range around loaded program), but keeps breaking later
You can’t perform that action at this time.