Amateur Radio Emergency Service Radio Amateur Civil Emergency Service

D-StarLet - Program Help

D-StarLet diagram


DStarLet  is a web-based text messaging application using D-Star digital data technology. Features:

"Master/server" computer requirements:

"Client" computer requirements:

Advantages over other ARES/RACES messaging software:


Installation & configuration steps for the Java servlet:

  1. Download & install Sun Microsystems' Java.
  2. Download the RxTx JavaComm package. Unzip the .ZIP file into a separate directory. Copy the files appropriate for your computer, into the the following folders in your Java JRE installation directory, as described in the "Install.txt" file. For Windows users:RxTx binary builds are provided as a courtesy of Cloudhopper, Inc.
  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. Edit the conf\tomcat-users.xml file, replacing the <rolename ... > & <user ... > with:
    <role rolename="manager"/>
    <user username="your username" password="your password" roles="manager"/>
  5. Start Tomcat using the shortcut you created above (it may take 10–15 seconds to start).
  6. 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.
  7. Download the DStarLet.war file & deploy it into Tomcat using the "Manager" web page.
  8. Start your web browser and create a bookmark to http://localhost:8080/DStarLet/; this is the web page address for DStarLet. The first time you browse to each DStarLet web page after installing or replacing the DStarLet.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 DStarLet 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.
  9. On Tomcat, if you want DStarLet  to be the main web server page (instead of the Tomcat main web page), in the Tomcat installation directory, move webapps/DStarLet/index.html to webapps/ROOT/; then you can start DStarLet  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 D-StarLet.

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