jcs.org
Tools for working with Cidco Mailstations
README: update with parallel port info
+24
-7
+24
-7
README.md
+24
-7
README.md
···
56
56
visible with the proper name (but a blank icon) under the Yahoo menu or the
57
57
Extras menu (depending on the firmware version).
58
58
59
-
### `loader.asm`
59
+
### Parallel port access
60
+
61
+
Host tools (`sendload`, `recvdump`, and `tribble_getty`) need direct access
62
+
to the parallel port to communicate with the Mailstation over the Laplink
63
+
cable using `inb` and `outb` system calls.
64
+
A USB IEEE 1284 printer cable will *NOT* work, though a PCI parallel port card
65
+
will (including via a Thunderbolt enclosure if on a laptop).
66
+
If you are using a parallel port other than the standard port of `0x378`,
67
+
supply the `-p <port>` option to the host programs with the port in
68
+
hexadecimal.
69
+
70
+
On OpenBSD, direct port access will require the `machdep.allowaperture` sysctl
71
+
set to `1` or higher. On OpenBSD and Linux, these host tools will also have
72
+
to be executed as root.
73
+
74
+
### Included tools
75
+
76
+
#### `loader.asm`
60
77
61
78
Loader is used to load binary code over the Laplink cable into RAM and then
62
79
execute it.
···
68
85
Then run `obj/sendload <your binary file>` to send your binary code over the
69
86
Laplink cable and it will be executed as soon as the transfer is done.
70
87
71
-
### `codedump.asm`
88
+
#### `codedump.asm`
72
89
73
90
Code Dump is used to read the contents of the 1Mb flash chip containing the
74
91
Mailstation's code and send it over the Laplink cable.
···
76
93
You need to type the hex values of `z80/codedump.bin` into one of the
77
94
application slots as detailed above.
78
95
79
-
Run `obj/recvdump -code` to wait for the code dump to begin.
96
+
Run `obj/recvdump code` to wait for the code dump to begin.
80
97
81
98
Then run the new Code Dump app on the Mailstation and `recvdump` should show
82
99
its progress as it reads the transmitted data and saves it to `codeflash.bin`.
83
100
You may want to run it twice and compare checksums of the two resulting files.
84
101
85
-
### `datadump.asm`
102
+
#### `datadump.asm`
86
103
87
104
Data Dump is used to read the contents of the 512Kb flash chip containing the
88
105
Mailstation's data area (containing downloaded programs, e-mails, etc.) and
···
91
108
You need to type the hex values of `z80/datadump.bin` into one of the
92
109
application slots as detailed above.
93
110
94
-
Run `obj/recvdump -data` to wait for the data dump to begin.
111
+
Run `obj/recvdump data` to wait for the data dump to begin.
95
112
96
113
Then run the new Data Dump app on the Mailstation and `recvdump` should show
97
114
its progress as it reads the transmitted data and saves it to `dataflash.bin`.
98
115
You may want to run it twice and compare checksums of the two resulting files.
99
116
100
-
### `memdump.asm`
117
+
#### `memdump.asm`
101
118
102
119
Mem Dump is used to read the contents of the current 64Kb of memory.
103
120
It does not read additional pages of memory but shows the current layout of
···
106
123
You need to type the hex values of `z80/memdump.bin` into one of the
107
124
application slots as detailed above.
108
125
109
-
Run `obj/recvdump -mem` to wait for the memory dump to begin.
126
+
Run `obj/recvdump mem` to wait for the memory dump to begin.
110
127
111
128
Then run the new Mem Dump app on the Mailstation and `recvdump` should show
112
129
its progress as it reads the transmitted data and saves it to `mem.bin`.