Zx-Ide

███████╗██╗  ██╗     ██╗██████╗ ███████╗
╚══███╔╝╚██╗██╔╝     ██║██╔══██╗██╔════╝
  ███╔╝  ╚███╔╝█████╗██║██║  ██║█████╗  
 ███╔╝   ██╔██╗╚════╝██║██║  ██║██╔══╝  
███████╗██╔╝ ██╗     ██║██████╔╝███████╗
╚══════╝╚═╝  ╚═╝     ╚═╝╚═════╝ ╚══════╝

Extension for developing on retro computers with vscode.

Features

Currently the following types of projects are allowed:

• Zx Spectrum
  • sjasmplus, pasmo (asm)
  • z88dk (c/asm)

Requirements

• Installed visual studio code dev-container extension: https://marketplace.visualstudio.com/items?itemName=ms-vscode-remote.remote-containers

• Docker environment

  • Windows: https://docs.docker.com/docker-for-windows/install/
  • Mac: https://docs.docker.com/docker-for-mac/install/
  • Linux: https://docs.docker.com/engine/install/

Usage

• Press F1, then execute ZxIde: Create new project
• Follow the steps of the Assistant in the terminal
• Wait for open new project.
• Press F1, then execute Dev Containers: Reopen in container
• Wait for install container and recomended extensions (First time it may take a few minutes)
• Press (F5) to Start Debugging or (Ctrl + Shift + B) to execute build task.
• All ready to develop your project

Refers to Wiki for more information.

Remarks: If the path project folder is changed after the container is created, the container must be deleted so that it can be recreated with the new path, otherwise it will give an error indicating that the container already exists.

Debugging z88dk

Debugging in z88dk is by using .lis file generated by z88dk compiler with all comments and c source code, you can debug c or asm code files. To debug a project with z88dk follow the next steps:

• Create and open a new project with z88dk
• Put breakpoints in c or asm source files (breackpoints are mappet to debug lis file)
• Press F5 or select play button in debug panel to start debugging
• Wait for compile and run the project
• All ready to debug your project

Refers to Wiki for more information.

Remarks: Adding or removing breakpoints should always be done in the source code file, this will create or remove a breakpoint in the .lis file that will be used in debugging.

Clean containers

To remove containers that have not been used in a while and free up memory, you can run the following command:

# (168h = 7 days)
docker container prune --filter "until=168h"

Documentation

For more information, visit the Wiki

License

This project is licensed under the MIT license. This means you can use, copy, modify, and distribute this code, always including the copyright notice and the permission notice. For more details, see the LICENSE file or visit the MIT License page.

Contact

Any questions or suggestions, please contact me.