jcs.org
Terminal program for MailStation devices
1## msTERM
2
3
4
5A terminal program for the Cidco MailStation.
6
7msTERM currently targets version 2.54 of the MailStation OS.
8
9### Features
10
11- Support for [WiFiStation](https://jcs.org/wifistation) (`SOURCE_WIFI`)
12- Support for controlling the internal modem through `AT` comments
13 (`SOURCE_MODEM`)
14- Support for interfacing with the parallel port like a serial port with
15[`tribble_getty`](https://github.com/jcs/mailstation-tools/blob/master/util/tribble_getty.c)
16on the host side
17- Custom version of
18[Spleen 5x8](https://github.com/fcambus/spleen)
19with DOS 437 codepage characters giving a 64x15 terminal window with a
20status bar
21- Blinking the "New Mail" LED when modem data transfers
22- Caps Lock key can be used as a Control key and Main Menu as Escape
23
24### Compiling
25
26Install
27[SDCC](http://sdcc.sourceforge.net/).
28
29If your `make` is not a BSD Make, install it and use `bmake` instead of `make`.
30You'll also need `objcopy` from Binutils installed in your `$PATH`.
31
32Create an `obj` directory with `mkdir obj` and then run `make LOC=ram` to
33compile a version suitable for running from RAM (via the Loader).
34
35Then transfer `obj/msterm.bin` to the MailStation with
36[WSLoader](https://jcs.org/wifistation)
37which will load the application at memory address `0x8000`.
38
39### License
40
41Copyright (c) 2019-2021 [joshua stein](https://jcs.org/)
42
43Permission to use, copy, modify, and distribute this software for any
44purpose with or without fee is hereby granted, provided that the above
45copyright notice and this permission notice appear in all copies.
46
47THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
48WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
49MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
50ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
51WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
52ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
53OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.