Amateur Radio Emergency Service Radio Amateur Civil Emergency Service

AX.25 Packet - Program Help

PackLet diagram


PackLet  is a web-based text messaging application using AX.25 packet radio technology. Features:

"Master/server" computer requirements:

"Client" computer requirements:

Advantages over other ARES/RACES messaging software:

Unimplemented features:


Installation & configuration steps for the Java servlet:

  1. Download & install SV2AGW's AGWPE packet engine software and get it working, either with a sound card or a TNC. If necessary, use SV2AGW's monitor & terminal programs (or the Java monitor & terminal programs above) to verify that you have AGWPE configured correctly.
  2. Download & install Sun Microsystems' Java JDK (Java Development Kit), v1.5.0 or later; all you need to install is the "Development Tools", and not the included JRE. If you are running Windows NT 4, Windows 2000, or Windows XP, you can install the Sun Java JRE (Java Runtime Environment) v1.5.0 instead. Technically, Java need not be installed on the same computer as that running AGWPE, but in that case the two computers must be connected via a LAN.
  3. Download & install Apache's Tomcat web server, v5.5.10 or later (or another suitable web/servlet server) on the same computer on which you installed Java. Configure Tomcat as follows (all directory references are relative to the Tomcat base directory):
  4. Start Tomcat using the shortcut you created above (it may take 10–15 seconds to start).
  5. Start your web browser and create a bookmark to http://localhost:8080/manager/html; this is the web page for the Tomcat "Manager" web page used to install Java Servlet applications.
  6. Download the PackLet.war file & deploy it into Tomcat using the "Manager" web page.
  7. Start your web browser and create a bookmark to http://localhost:8080/PackLet/; this is the web page address for PackLet. The first time you browse to each PackLet web page after installing or replacing the PackLet.war file, Tomcat has to "compile" the web page (this may take 3–5 seconds), but subsequent accesses should be quick. The first time you browse to the PackLet main page, it will take you to a configuration web page where you must enter at least the following parameters: You can change the other values if necessary. To protect against unwanted changes to the configuration, the link to the configuration page is password-protected using the username & password you set up in Tomcat for the "Manager" role.
  8. On Tomcat, if you want PackLet  to be the main web server page (instead of the Tomcat main web page), in the Tomcat installation directory, move webapps/PackLet/index.html to webapps/ROOT/; then you can start PackLet  at: http://localhost:8080/. You can still get to the Tomcat main web page at http://localhost:8080/index.jsp.

Note that the servlet logic is in a .JAR (Java Archive) file and thus separated from the .JSP (Java Server Page) files used for interfacing the web pages to the servlet. The .JSP files contain normal HMTL interspersed with Java servlet interface code. The Java servlet interface code in the .JSP files is enclosed in <% & %>; avoid modifying the Java servlet interface code. This separation of functions allows for users familiar with HTML to reformat or add to the layout of the web pages without risking damage to the functioning of the program.

So you need additional fields on the message form? No problem; just edit the Message.jsp file. Decide on an internal field name, add a default value for the internal field name in the Java code near the top of the file, and then create an HTML <input> field. Use the same pattern that is used for the rest of the input fields.

Note that the servlet is designed to support multiple users composing and/or reading messages at the same time in multiple windows, on the same or different computers, browsing to the web server machine. Further, you do not need to leave a browser window open to receive messages. Operation of the servlet and web pages should be obvious. If at any time starting the servlet does not work (by clicking on the main page's Start button), stop and restart AGWPE.

You can test the program without going on the air, by using two computers & the AGWPE "loopback" feature:

  1. Install AGWPE on one Windows computer, and add an AGWPE loopback port.
  2. Install the Java JDK, Tomcat, and this program on two computers. These computers can be Linux or Windows computers, and neither one needs to be the same computer running AGWPE.
  3. Configure the StationId values for the two computers to be different (e.g., use a different SSID).
  4. Configure the AgwpeTcpIpHost values for the two computers to refer to the computer running AGWPE.
  5. Configure the AgwpeRadioPort values for the two computers to refer to the new AGWPE loopback port number (0-based).

Control Panel Help

To be supplied ...

Message Form Help

To be supplied ...

View Log Help

To be supplied ...

Configuration Help

To be supplied ...

GNU General Public License (GPL)

Copyright © 2005 by Dean K. Gibson.

This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, version 2 of the License.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with this program; if not, write to the Free Software Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA