PSKmail-0.1.0 PSK_arq push button functions ============================= Connect/Quit ------------ Starts a connect sequence with the server. When the connect is established the button is used to send a 'QUIT' signal to the server. Quit will terminate the connection in an orderly manner. QTC? ---- The QTC? pushbutton tells the server to send the list of mail headers, e.g.: 2 Rein Couperus PA0R Re: [Tlf-devel] radio control problems 4413 The first number is the running number of the mail on the POP server. The last figure shows how big the email is (inclusiding the header, which is not sent to the client). You can subtract 1000 - 2000 characters for the header Download -------- Asks the server to send all mail to the client. Read ---- The Read button opens a window where you can specify the numbers of the mails which should be sent to the client. You can e.g. leave large mails on the server. E.g.: 2 5 6 The server will send mails 2,5 and 6. It will leave mails 1, 3 and 4 on the server. Send ---- The send button sends the mail file from the client to the server. When the server has passed the mail on to the SMTP server it sends "Message sent" to the client. Delete ------ The Delete button opens a window where you can specify the numbers of the mails which should be deleted from the POP server. E.g.: 2 5 6 After deleting the mail, the server will send "Mails 2 5 6 deleted..." to the client . WARNING: As soon as you delete an email the numbering on the POP server changes!!! Pos. ---- The Pos. button sends the APRS info to the server, which will send it to posit@findu.com. You have to set Latitude and Longitude before using the 'Preferences' button. After the transaction the server will send 'Message sent' to the client. For this function to work you need to have the APRS password in the user database. New --- The 'New' button opens a new window enabling you to input the To: address and the Subject: for a new email. When you click on OK, gedit will start to let you write the body of the mail. After you save the text for the body and leave 'gedit', PSK_arq will add the email to the file 'message'. The format of an email in the 'message' file is: ~SEND To: toaddress@isp.com Subject: Mail subject This is the body text. This is the body text. This is the body text. This is the body text. This is the body text. . . The mail ends with a period alone on a line (two to make sure there is one). In a later version of PSKmail the detour via 'gedit' will not be necessary, a matter of time input from the author :) Abort ----- The abort button is used to abort a connection. You should also use this button if a connection breaks off (this is WIRELESS). Exit ---- Leave PSKmail Options ------- The options button opens a window which lets you input: * The callsign of the server you want to connect * Your callsign * The block length index (4=16, 5=32, 6=64, 7=128). * Your Latitude (North = plus, South = minus), e.g. 51.37376 * Your Longitude (East = plus, West = minus), e.g. 5.71256 The protocol ============ Connect phase ------------- The client starts the procedure by sending a CONNECT block. This is repeated until the client receives a CONNECT_ACK block from the server. When this happens the two stations are connected on stream 0. The server uses port 24 (mailbox service), the client port 1024. These are the only ports implemented in PSKmail-0.1.0 . Traffic phase ------------- After the connection is established, client and server take turns in sending data frames to each other. Each frame can hold 8 data blocks and a status block. If there is no data for the other side only a status block is sent. If no status block is received a poll block sent (always without data). A station can answer a poll with either a status block or with a complete frame. Data blocks have a sequence number. The receiving station tells the sending station which frames are bad ( 1 bit eror is enough) by means of the status block. Next turn the sending station starts its frame with the missing blocks, and then fills up with the next blocks from the sequence. See ARQ2.pdf (from K9PS) for a precise rundown on the protocol specification. Disconnect phase ---------------- When the client is ready with traffic, it sends a QUIT signal to the mailbox application. The server then disconnects and sends a DISCONNECT block to the client. The stations also disconnect when one of them times out. A poll block will be repeated a number of times (default=8) before it times out. Parameters for the client ========================= The client produces a file ".PSKoptions" which contains the parameters. Parameters for the server ========================= The server needs to know its callsign. This can be set in the file arq.pm (parameter $ServerCall).