https://github.com/picocomputer/vscode-cc65
New Project Template for CC65
https://github.com/picocomputer/vscode-cc65
Last synced: 2 months ago
JSON representation
New Project Template for CC65
- Host: GitHub
- URL: https://github.com/picocomputer/vscode-cc65
- Owner: picocomputer
- Created: 2023-05-01T00:12:00.000Z (about 3 years ago)
- Default Branch: main
- Last Pushed: 2026-01-30T07:40:25.000Z (5 months ago)
- Last Synced: 2026-01-30T23:31:52.360Z (5 months ago)
- Language: Python
- Homepage:
- Size: 84 KB
- Stars: 8
- Watchers: 3
- Forks: 9
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# RP6502 VS Code Scaffolding for CC65
This provides scaffolding for a new Picocomputer 6502 software project. Both
C and assembly examples of "Hello, world!" are included. Make sure
`CMakeLists.txt` points to your choice of `main.c` or `main.s`, then delete
the one you aren't using.
### Linux Tools Install:
* [VS Code](https://code.visualstudio.com/) - This has its own installer.
* A source build of [CC65](https://cc65.github.io/getting-started.html).
* The following tools installed from your package managers:
* `sudo apt install cmake python3 git build-essential`
### Windows Tools Install:
* `winget install -e --id Microsoft.VisualStudioCode`
* `winget install -e --id Git.Git`
* `winget install -e --id Kitware.CMake`
* `winget install -e --id GnuWin32.Make`
Add `C:\Program Files (x86)\GnuWin32\bin` to your PATH.
* The current snapshot of [CC65](https://cc65.github.io/getting-started.html) -
Do not skip the step about adding the `bin` directory to your PATH.
* Install Python by typing `python3` in a command prompt, which will launch
the Microsoft Store where you can start the installation. If Python runs,
this has already been done - exit Python with Ctrl-Z plus Enter.
### Getting Started:
Go to the [GitHub template](https://github.com/picocomputer/vscode-cc65) and
select "Use this template" then "Create a new repository". GitHub will create
a clean project for you to start with. Then you can clone the repository and
open the files.
```bash
$ git clone [path_to_github]
$ cd [to_where_it_cloned]
$ code .
```
Install the recommended extensions when VS Code prompts you, choosing the
default or obvious choice for any other prompts. The tools we use in VS Code
are constantly improving and changing making it too difficult to maintain
documentation.
"Start Debugging" (F5) will build your project and run it on a Picocomputer.
Connect with a USB cable plugged into the RP6502-VGA USB port.
If you get a Python error about the communications device not being found,
edit `.rp6502` in the project root. This file will be created the first time
you "Start Debugging" and will be ignored by git.
Once the program is running, a debug console becomes available on the terminal
tab. It will say "Python Debug Console" because the rp6502.py tool is Python.
Ctrl-A then X will exit. Ctrl-A then B will send a break.
Edit `CMakeLists.txt` to add new source and asset files. From here on, it's
standard C/assembly development for the 6502 platform.