Updated docs to include PRINT65.

This commit is contained in:
Bobbi Webber-Manners 2021-06-13 18:22:18 -04:00
parent 733edc18c5
commit 82835c508d
2 changed files with 45 additions and 0 deletions

43
README-print65.md Normal file
View File

@ -0,0 +1,43 @@
# Apple II Email and Usenet News Suite
<p align="center"><img src="img/emailler-logo.png" alt="emai//er-logo" height="200px"></p>
[Back to Main emai//er Docs](README.md#detailed-documentation-for-email-functions)
## `PRINT65.SYSTEM`
<!-- <p align="center"><img src="img/SMTP65.jpg" alt="SMTP65" height="400px"></p> -->
`PRINT65.SYSTEM` is a utility for printing to a network-connected printer using the Hewlett Packard Jetdirect protocol. It requires an Uthernet-II ethernet card and will not work with other interfaces without modification, because it uses the W5100 hardware TCP/IP stack.
Before running `PRINT65.SYSTEM` for the first time, use `EDIT.SYSTEM` to create a configuration file called `PRINT.CFG`. This file consists of a single line specifying the IP address of the network printer to use, optionally followed by a colon and a port number. If the port number is omitted it defaults to 9100. For example:
```
192.168.10.4:9100
```
`PRINT65.SYSTEM` performs the following tasks:
- If no filename was provided on the command line, prompt for the filename to print
- Detect Uthernet-II
- Obtain IP address using DHCP
- Connect to Jetdirect printer
- Open file
- Send file contents to printer over TCP/IP
- Close file
- Disconnect
### Using Command Line Argument to Specify the File to Print
`PRINT65.SYSTEM` supports command line arguments in a way that is compatible with the Davex shell (and possibily other environments.) In Davex you can print a file as follows:
```
print65.system /path/to/my/file
```
### HP Jetdirect
Most HP printers support Jetdirect. I am using an HP Photosmart 7520 which supports the Jetdirect protocol on port 9100 over it's wifi connection. Jetdirect defaults to a simple plain text mode, which we exploit here to print in 80 column text mode.
[Back to Main emai//er Docs](README.md#detailed-documentation-for-email-functions)

View File

@ -31,6 +31,7 @@ Emai//er is implemented as a number of ProDOS executables, each of which perform
- `ATTACHER.SYSTEM` is used for creating multi-part MIME messages with attached files.
- `REBUILD.SYSTEM` is a utility for rebuilding mailbox databases, should they become corrupted. This can also be used for bulk import of messages.
- `DATE65.SYSTEM` is a Network Time Protocol (NTP) client which can be used for setting the system time and date if you do not have a real time clock.
- `PRINT65.SYSTEM` allows text file to be printed to a network-attached printer that supports the Hewlett Packard Jetdirect protocol.
The following diagram shows the various executables that form the emai//er suite and how they execute one another. Note how `EMAIL.SYSTEM` serves as the hub from which all the other programs may be invoked.
@ -105,6 +106,7 @@ Please refer to the linked documents for detailed instructions on how to configu
- [Receiving Email with `POP65.SYSTEM`](README-pop65.md)
- [Sending Email with `SMTP65.SYSTEM`](README-smtp65.md)
- [Rebuilding Mailboxes with `REBUILD.SYSTEM`](README-rebuild.md)
- [Printing Files with `PRINT65.SYSTEM`](README-print65.md)
## Detailed Documentation for Usenet Functions