Apple-2-HW
/
TommyPROM
mirror of https://github.com/TomNisbet/TommyPROM.git
2
0
Fork 1
Code Issues Projects Releases Wiki Activity

add getting-started doc page

This commit is contained in:
Tom Nisbet 2023-09-17 19:40:20 -04:00
parent 322de3d1a9
commit 544a3c0331
1 changed files with 0 additions and 44 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

44
docs/_docs/00-intro.md
View File

@ -75,50 +75,6 @@ near the top in TommyPROM.ino. The change to Configure.h will automatically cau
driver to be installed, but it may be necessary to modify the parameters for a specific
chip type.
## Operation
![TommyPROM console screenshot](docs/images/tommyprom-console.png)
To use the programmer, connect the Arduino USB to the host computer and run a terminal
program, such as TeraTerm (Windows) or Minicom (Linux). The Arduino development Serial
Monitor can also be used as a terminal initially, but it does not support XMODEM
transfers, so the READ and WRITE commands can't be used.
Disable both hardware and software flow control in the minicom settings for best results.
Set the terminal's serial parameters to 115200 baud, 8 bits, no parity, 1 stop bit to
match the Arduino. Press the Enter key. If the connection is successful, TommyPROM will
display a menu of options.
Most of the commands take a start address parameter, always entered as 1 to 5 hex
characters. Leading zeros are not required. If needed, the end address parameter is also
in hex. Parameters are separated by a space. For example, either of the commands:
d0000 01ff
d0 1ff
will dump memory from 0000H to 01ffH. Note that commands and parameters can be entered in
uppercase or lowercase.
The R command is used to read from a PROM and save a binary image on the host. The W
command receives a file from the host and writes (burns) it into the device. The R
command needs a start and end address. The W command determines the end address from the
received file size.
Once the READ or WRITE command is issued to the programmer, the transfer must
be started on the host program.
Note that previous versions of TommyPROM used the XMODEM-CRC protocol to complete the file
transfers for the READ and WRITE commands. This did not work well with minicom and other
Linux programs that rely on the sz/rz commands. Versions 2.5 and later of TommyPROM now
use basic XModem with the 8-bit checksum. The XModem-CRC support is still available as a
compile-time option. See [issue #19](https://github.com/TomNisbet/TommyPROM/issues/19)
for details.
The files used for READ and WRITE are simple binary images. This can be created directly
by [asm85](http://github.com/TomNisbet/asm85) or can be converted from S-record or Intel
HEX using an external utility.
## Troubleshooting
* Verify that the Arduino type you are using is a supported board or that its I/O port definitions match one of the supported boards. Some other Arduino boards, like the