Destination Trail holds an ultra trail marathon event in Washington State every summer called Bigfoot 200. The event spans a 200+ mile course through the Gifford Pinchot National Forest and the Mt.St.Helens Volcanic Monument.
Participants are tracked as they arrive and depart (or drop out of the race) at each one of the many remote aid station sites along the route.
Hams volunteer their time and equipment to provide communications between aid station sites and race headquarters. One component of tracking runners is to capture and transmit reports of participant's bib numbers from each checkpoint. In the past this was done by voice transmissions, either simplex or a local repeater network. More recently, Winlink has become the preferred method to transfer these 'bib reports' to race coordinators via hams at the Finish line. Winlink is like 'email over ham radio', allowing more rapid transfer or large amounts of information (like bib numbers), freeing the simplex and repeater channels for other voice traffic such as requesting medical supplies, water, and so on. Hams at race HQ receives the Winlink "bib reports" and enters them into a database. The database can be cross-referenced when estimating runner arrival at specific stations, or finding when and where a runner last checked in along the route.
This form was developed to standardize the message and data to race headquarters from the many remote Aid Stations, reducing time to get the data, and simplifying data entry into the database.
For more information about Destination Trail and their ultra trail running marathons, see DestinationTrailRun.com.
25-June-2024: v2.1.3
5-June-2024: v2.0.1
6-Aug-2023: v1.1.7
Prior versions:
Prior versions were built from original form files created by the Winlink Development Team:
These files have been customized to meet the needs of the Bigfoot 200 ultramarathon specifically.
There are two components to a Form:
The plain text Winlink Template describes how data is placed within a new Winlink Message.
The Winlink Form is a single-page website that prompts the user for the necessary data and formats it to be placed into a Winlink Message, as declared in the plain-text Winlink Template file.
Recipients of messages formatted this way will see consistent data formatting and layout with each message, every time.
For more information about Winlink Express, the Winlink System, and Winlink Forms, see Winlink.org.
Aid Station volunteers should have a notebook of all the possible bib numbers that are registered for the race. As runners enter and leave each Aid Station (or drop from the event), their bib information is updated in that notebook. Hams take note of each bib number in/out/drop time and date, and enter them into this form. Some hams choose to record all runner events at their assigned Aid Station themselves, and will update the Aid Station Captain on semi-regular intervals, since the hams will have the most up-to-date runner information.
When the Form is launched from Winlink Express by selecting the template in a New Message window, the form can be submitted and the New Message will get populated with the form-entered data. The Winlink Operator can then transmit the message via whatever mode works to get the message through to its recipients, foro example Peer-to-peer direct to another station, or via the Winlink System using an RMS (Relay) station.
The latest release of Bigfoot Bib Report Form can be interacted with online using this demonstration page so you can see what the form looks like and its functionality without having to install it locally. You will not be able to submit the form successfully. Other features of the form can be freely explored.
You can also view the Bib Report plain text Template file and see how the Winlink Message is formulated using data entered in the Form, above.
See How to Install This Form and Template for details on integrating this form with your Winlink Express station.
Follow steps in these subsections:
There are 2 files to download: "Bigfoot Bib Report Initial.html" and "Bigfoot Bib Report.txt".
You have options as to where to get them (in preferential order):
The Two Files you will need are:
When downloading from the GitHub Releases page the files will be inside of a .zip
file. After downloading, either right-click and select "Extract All..." and follow the wizard screen to unzip the files, or use your favorite "unzipping" utility (there are many to choose from, free and paid).
Bigfoot-Bib-Report-Initial.html
and Bigfoot-Bib-Report.txt
to your Winlink Express installation within the directory named {your callsign}\Templates
.New Message
.Select Template
.{your callsign} Templates
.Bigfoot-Bib-Report-txt
and then click Select
.Note: Winlink Express might be installed in either C:\RMS Express
or C:\Winlink Express
. Either way, navigate to your callsign directory, then the Templates directory, and place the files there.
Note: It is up to the Winlink operator to select an appropriate amateur channel and mode to transfer that runner data to "Bigfoot Base". Usual methods include simplex P2P over VHF or HF, Winlink over HF to RMS relays across the US and beyond, or using Winlink Telnet for those that have satellite or other internet connectivity.
The overall steps to use this form are:
Explore the form a little to get familiar with its behavior:
Tab
key and the orange outline will move to the Message # field.Tab
again and the "increment" button becomes highlighted with the orange outline.Use that orange outline to help you quickly find where the "focus" is on the form.
If you click into a field and the orange highlight does not appear, that means the field is read only and you are not allowed to input or change anything within that field.
Also try this: Click on Form Information - READ
and a pop-up screen will appear with additional instructions about the form and how to use it. Read This Friendly Manual. When done, click the white-on-black text "Click To Close This" and you will be allowed to edit the form again.
Enter information into the top section of the form. What you enter here will update the subject line of the message, and will stick with the form until you submit it.
Note: Many browsers will store previously entered data into fields. It is not a feature of the Form. You might (or might not) want your browser to do this.
Note: The Subject will get automatically updated. Review it to be sure it is accurrate before continuing.
The Save and Load buttons are there to help you save data you have already entered, and load it again later to continue where you left off.
You could use the Save and Load buttons to store data in a Form on one computer, copy it to a thumb drive or transfer using Bluetooth, and then have another computer with Winlink Express installed Load the data and then send it via Telnet or RF means.
You can also use the Save button to keep a local copy of all Bib Report Messages you have sent, and review the data on any computer by just using a plain text editor like Notepad++, UltraEdit, TextEdit, Nano, etc.
Always use the Save button before submitting your data to a message, that way you can always go back to the data using the Load button.
This functionality will help you store all of the form field data in the form including the top (header) section and entered bib data.
Downloads
directory (by default).Here's a sample of what that saved data looks like:
{
"FormVersion": "2.1.3",
"EventTitle": "BF24 Test",
"MessageNumber": "5",
"address": "k7rmz",
"Location": "JR_Johnston Ridge",
"msgsubject": "BF24 Test Johnston Ridge Message #5",
"entryCount": "4",
"Comment": "",
"TheCsvData": [
"234, drop, 1511, 04, JR",
"234, IN, 0001, 03, JR",
"123, OUT, 1102, 04, JR",
"123, IN, 1343, 03, JR"
]
}
You can record bib data using a phone, tablet, or computer (so long as it has a browser that will launch the HTML file) and store the data locally. Just give a copy of the file to the Winlink Operator and they can load existing race data from that file.
Note 1: The last entry from the previously submitted batch will be displayed in the End of Prior
textbox. This indicates the last bib entry from the last time the Submit
button was pressed. This entry can be used in place of or supplement notations made on your source paperwork, for example, recording bib actions on paper and then relaying to this form.
Note 2: Whenever you press Save Race data
the form will store the last entered bib data to the file so that next time you Load Race data
, the End of Prior
field will be updated accordingly.
The form allows you to click or tap on input fields to select them, and you can use the TAB key on your keyboard to move between fields. Selecting items can be done with a click, tap, or using the spacebar.
Bib or Rider
.101
.Yesterday
to tell the Form the time references yesterday.Action
was.The correctly formatted bib data will appear in the window below and the Number of Entries
count will increase by 1
for every enty you complete.
Important: All bib data inside the entries window will disappear without a chance for recovery if you click the Clear Entries button. The only way to recover those entries is to had previously pressed SAVE RACE DATA Button as described above.
There are times when a bib number is mis-keyed, or 'OUT' was clicked instead of 'DROP', etc. In previous versions this was very difficult to fix, and occasionally those fixes caused data issues at Bigfoot Base. With this version you can edit data after clicking IN, OUT, or DROP to make an important fix, and it is simpler than it was before because the data is in comma-separated format now.
Simply click on the data you need to edit, type-over it, and then press the Tab
key and the entries will auto-reformat, ready for submission.
Number of Entries
contains an accurrate count of entries.Message Number
is actually incremented by one compared to the previous message already posted to the outbox or sent successfully.Save Race data
to store the completed data.SUBMIT
.Alt + Tab
on the keyboard or select the Winlink Message icon on the Task Bar).Post Message to Outbox
and follow appropriate procedures for transmitting the message at an appropriate time.After Submit is pressed, the new Winlink Message will be populated with data in this tab-delimited format:
234 drop 1511 04 JR
234 IN 0001 03 JR
123 OUT 1102 04 JR
123 IN 1343 03 JR
Note: In order to emulate how the tab-delimited data is displayed in Winlink Express, I used an 8-character tab-stop instead, which is pretty close to what you will see as the sender and as the recipient.
Other data is also populated into the new Message, including:
It is best practice to refrain from editing the Winlink Message once it is created. Instead, stick to using the Form, it will save time and effort.
You can set up to 3 Forms as Favorites following these steps:
Set Favorite Templates
.BF-Form
.Browse
and locate Bigfoot Bib Report Initial.html
.Save
.BF-Form
has been added along the top of the New Message window (highlighted green in the example image below).BF-Form
button to launch the Form in your default web browser.For detailed instructions on the installation of Winlink Forms and Templates see Winlink.org.
This project utilizes HTML, Javascript, CSS, and plain text. Compatibility is biased toward supporting Windows 7-era browsers and mobile devices, over latest-greatest features and functionality.
Good news for developers is single-page websites have no specific build requirements. It is helpful to have an operable and up-to-date version of Winlink Express installed on (or near) your development machine, as well as a bunch of browsers and devices for testing/viewing results.
This form should support browsers and devices released after March 2010 including Chrome, Firefox, Opera, Edge, IE 11, Android Chrome and Firefox, and Opera iOS.
If you run across issues using this form in a specific browser, use the Discussions page to search for existing information, submit a GitHub Issue, or contact me.
Highly recommended: VS Code (available for Windows, mac, Linux, and GitHub Codespaces).
Many other IDEs can be used however your changes might be excessive if you reformat the code at any time. Development best practices has more about information.
Wanted: Your help and input developing this form!
Contact K7RMZ at ARRL dot NET with a message about your interest(s) and a link to your Github profile. Be sure to include the name of this repository in the subject line.
.vscode/settings.json
file, it is necessary for development in this repo. If it is changed in the future, you must update it in your local..gitignore
and .gitattributes
. These are necessary to keep this codebase clean, and ensure cr-lf
characters are maintained for Winlink Express.main
. If your PR has merge conflicts, I will work with you to help resolve merge conflicts after you have tried to do so.#
shortened linking method.This repository uses a Root branching pattern, pointing to main.
main
and ready to merge without merge conflicts in order to be considered (see Handling merge conflicts above).A Pull Request should have helpful comments within it:
#
.Have fun!
This is a personal effort of love for coding and for the hobby and community of ham radio. This project open to benefit the amateur community.
The original author might assert restrictions or limitations on use of their source code. See Winlink.org for details.