-
Notifications
You must be signed in to change notification settings - Fork 18
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
- Loading branch information
1 parent
9a9aa6e
commit dc9c417
Showing
1 changed file
with
4 additions
and
62 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -1,66 +1,8 @@ | ||
# neo6502-firmware | ||
Firmware for a Neo6502 Retrocomputer | ||
|
||
## Getting Started: | ||
## The home page | ||
- http://www.neo6502.com | ||
|
||
The release files on the right contain eveything you need to get started: | ||
- documentation | ||
- samples and example code and explainers. | ||
- firmware for the RP 2040 with WozMon and BASIC for SDCard or USB Host. | ||
- tools for cross development | ||
- Windows and Ubuntu emulators | ||
|
||
## Note: | ||
|
||
There are two uf2 images, one for the SDCard, one for the USBHub. The USBHub requires the USBKey be present. | ||
So if you are just experimenting without storage, use firmware_sd.uf2 | ||
|
||
## Building: | ||
### required software: | ||
- Pico SDK (Remember to set PICO_SDK_PATH to point where it's installed) | ||
- 64tass | ||
- gcc-arm-none-eabi | ||
- cmake | ||
- build-essential | ||
- python3 | ||
- Python Imaging Library / Pillow | ||
|
||
run: | ||
|
||
``` | ||
build_all.sh | ||
``` | ||
|
||
## Building emulators only | ||
### required software | ||
- gcc-arm-none-eabi *OR* build-essential | ||
- python3 | ||
- Python Imaging Library / Pillow | ||
|
||
make linux or make windows | ||
|
||
#Release Contents | ||
|
||
see: release/neo6502.zip after running build_all.sh | ||
|
||
### Neo6502 firmware | ||
* firmware_usb.uf2 - Neo6502 firmware with USB mass storage support | ||
* firmware_sd.uf2 - Neo6502 firmware with SD Card support | ||
|
||
### Documents | ||
* api.pdf - Neo6502 API description | ||
* basic.pdf - Basic Reference | ||
* memorymap.pdf - The memory map | ||
* wozmon.pdf - documentation about the monitor | ||
* various text files | ||
|
||
### PC Software | ||
* neolinux.zip neowin.zip - emulators | ||
* listbasic.zip - Python zipapp for converting tokenized basic to ASCII basic source code | ||
* makebasic.zip - Python zipapp for converting ASCII text source code to tokenized basic. | ||
* createblanks.zip - create skeletons for graphics | ||
* makeimg.zip - convert graphics to the internal format | ||
|
||
### Neo6502 software | ||
* samples - assorted examples, games, demos, test programs | ||
* crossdev - a working example of cross platform development | ||
## The Documentation wiki | ||
- https://github.com/paulscottrobson/neo6502-firmware/wiki |