AA4TE
This page is the field reference for the Kershaw County Ground Report -- Resource Status hub.
It defines:
- Standard object names for all ten resource categories
- Comment field format for APRS transmissions
- Two-letter status and specifier codes
- How the format applies across all intake modes
Intake modes covered:
- APRS object beacons
- Winlink form submissions
- Meshtastic messages
All operators contributing to KCGR are expected to use these standards. Consistent formatting allows hub operators to cross-reference reports across radio modes and post accurate, timestamped information to the resource map without ambiguity.
This reference is also available as a PDF suitable for printing and storing in your go-box. Distribute the PDF to your club and mutual aid partners well before hurricane season -- lead time is one of the advantages we have over earthquake response. Download the quick reference (PDF).
Setting up Winlink for KCGR-RS? Download the Winlink forms (ZIP) -- the entry form, display form, message template, and legacy stylesheet, ready to drop into Pat's Standard_Forms folder or Winlink Express's Global Folders\Templates directory. See the README for exact install paths.
See also the live resource hub or the FAQ below.
APRS object names are fixed at 9 characters, padded with spaces if shorter. All KCGR objects use the KCGR- prefix.
Object names are self-describing by design. Any operator seeing one for the first time on their display understands it without a reference card -- unlike numbered code systems that require a lookup table.
Objects are listed in life-safety priority order:
- Shelter and medical first -- immediate survival
- Roads third -- determines if shelter and medical are reachable
- Water and food -- short survival window
- Fuel, power, cell, ATM in descending urgency
- Health and welfare relay last -- important but not immediate survival
File the most critical observations first if time or conditions are limited.
| Object Name | Meaning | Specifier Codes |
|---|---|---|
| KCGR-SHLT | Emergency shelter | CA capacity available NP no pets PP pets ok MO medical only |
| KCGR-MED | Medical facility | ER emergency room UC urgent care PH pharmacy OP open CL closed |
| KCGR-ROAD | Road / bridge status | OP passable CL closed CA caution BR bridge FL flooding TR trees/debris |
| KCGR-H2O | Potable water | DP distribution point BO boil order UK unknown quality |
| KCGR-FOOD | Food / restaurant / grocery | HF hot food GR grocery BT both |
| KCGR-FUEL | Fuel availability | GS gasoline DS diesel PP propane GD gasoline + diesel AL all three |
| KCGR-PWR | Power / charging / generator | GN generator CH device charging UT utility restored |
| KCGR-CELL | Cell signal location | AT AT&T VZ Verizon TM T-Mobile AL all carriers |
| KCGR-ATM | ATM / financial access | OP operational CL closed LM cash limited |
| KCGR-HW | Health & welfare relay | OP relay available HR hours follow NM no message limit |
If your observation does not fit cleanly into one of the ten object types, file it in the closest category and clarify in the comment field. When in doubt, KCGR-SHLT or KCGR-FOOD cover the widest range of general welfare reports.
Want a copy for quick reference?
One or two page downloads: One page Quick Start | Two page Large Print Quick Start
THIS CODE FOLLOWS the OBJECT NAME.
On the public resource map, each status renders as a marker colour.
See the FAQ for the reasoning behind the colour choices.
| Colour | Code | Meaning | Notes |
|---|---|---|---|
| OP | Open / operational | Resource is available and functioning at time of observation. Green -- go. | |
| CL | Closed | Resource is not available. Red -- stop, do not proceed. File a follow-up if status changes. | |
| LM | Limited | Available but restricted -- hours, supply, or capacity. Yellow -- proceed, expect a constraint. Clarify in comment field. | |
| UK | Unknown | Not verified by direct observation. Grey -- deliberately neutral, no judgment implied. Use sparingly -- report what you know. | |
| CA | Caution | Accessible but hazardous or unreliable. Amber -- proceed with caution, mostly used for roads. Clarify in comment field. |
SPEC 2-character specifier -- object-specific category detail
LOCATION abbreviated place name or road designation
DDHHMM local time: day / hour / minute -- always last
Fields are ordered most-critical to least-critical. A message that gets cut short loses its timestamp before it loses its location or status. Status and location survive even the worst signal conditions.
- Use a single space between fields
- Run words together when character count demands it -- drop the space, not the data
- DDHHMM is always last so any cutoff loses time before meaning
- Local time -- no UTC conversion required from field operators
If a message is received without a timestamp, the hub operator notes it as time-unconfirmed and watches for a follow-up. All of the following are acceptable:
- Full DDHHMM -- day, hour, and minute
- DDHH -- day and hour only
- DD -- day only
- No time field at all
A message missing its status code hinders the automatic reporting structure. Always lead with ST (changes marker color) and SPEC after the OBJECT NAME.
Each card shows the raw comment string as it would appear on an APRS display, followed by its plain English meaning.
Amber cards show incomplete messages -- cut short before the timestamp, but location and status are intact and still actionable.
The KCGR object prefix and ST/SPEC codes work on all three platforms. Use the compressed format on APRS where character count is strict. Expand to plain English on Winlink and Meshtastic where space allows.
- Prefix all objects with
KCGR- - Repeat beacon every 10-30 minutes during active reporting
- Send a follow-up report with updated status when the condition is resolved.
TO:
KCGR-OPS Subject: auto-filled as KCGR-RS - [callsign] - [date]⚠ The form's own "Send To" field is a reminder only -- it cannot set your compose window's address for you. Type or select
KCGR-OPS in your own compose window's To: field before or right after filling out the form. A message sent without doing this will bounce.The form uses the same ten categories and ST/SPEC codes. Full plain English notes are encouraged -- no compression needed. Works via HF or VHF when internet is down.
Unlike the Palmetto RR which requests inbound resources, KCGR-RS reports outbound observed conditions. File both during active events when possible.
Example:
KCGR-ROAD CL TR US601 north of Fairfield Rd. Large pine blocking both lanes. Chain saw needed. Observed 262145Operators in mutual aid areas outside Kershaw County should use their local prefix when that system is active:
MGS- for Midlands, SCGR- for statewide.
Does KCGR-RS modify or replace ICS-213?
Who's behind these reports, and what stops bad information from getting on the map?
This is the same trust model USGS uses for its Did You Feel It? earthquake reporting system: USGS formally partnered with Winlink and ARES in 2020 specifically because licensed-operator data holds up. If a federal earthquake damage map trusts this network, a county-level resource hub built on the same operators and the same infrastructure is starting from validated ground.
The hub operator additionally holds NWS Skywarn spotter and net control credentials, adding a second layer of vetted-observer standing beyond the amateur radio license itself. Every posted report has also passed through the hub operator before it reaches the map -- there is no visual "trust tier" shown to the public, because if it's posted, it's vetted. What differs is how much corroboration a report needs before that happens:
Auto-vetted, posted on receipt: Winlink and APRS reports from a licensed amateur callsign; NWS Columbia Skywarn Slack; direct government data feeds such as SCDOT and poweroutage.us.
Requires second-witness confirmation first: Meshtastic, GMRS, and other non-amateur-radio channels; unsolicited Tier 3 web/phone submissions. These channels don't carry amateur radio's identity/licensing guarantee, so an independent second report substitutes for it.
When in doubt, the hub operator holds the report and seeks a second source rather than post on a single unverified account. A late-but-correct map beats a fast-but-wrong one.
This map reflects the best information available at the time each report was filed -- not a live feed, and not a guarantee. Always check the timestamp before treating a report as current; conditions on the ground can change faster than a report gets updated.
This map is not a substitute for 911 or official emergency alerts. If you're in immediate danger, always call 911 first.
Why do markers use red, yellow, and green -- plus amber and grey?
Green and red are also kept at different brightness levels rather than pure hue alone, since roughly 1 in 12 men have red-green colour blindness. The object icon on each marker gives a second, colour-independent way to read what's being shown.
What forms should operators file during an active event?
To file a 43-character message via APRS, use the information above or quickly find step-by-step instructions at the KCGR Quick Start page.
Why are codes used instead of plain English in APRS comments?
KCGR-FUEL, OP, GS) rather than numbered -- an operator seeing one for the first time can understand it without a lookup table, unlike systems such as NTS ARL radiograms with 90+ numbered codes to memorize. On Winlink and Meshtastic, where space allows, operators are encouraged to expand into full plain English alongside the codes.
Who sees the codes vs. who sees the map?
A public-facing resource map, embedded weather information, and power outage (US) maps can be found at: KCGR-Resource Status Hub
What is Grist, and why not just use Google Sheets or Microsoft Excel?
Grist has no advertising model, and its free hosted tier remains free unless an organization exceeds $1M in total annual funding -- a threshold KCGR will never approach. Beginning August 31, 2026, getgrist.com expands from 3 team members to 10 on their free tier. CryptPad and Zoho Sheet were evaluated as privacy-respecting backup options, in case Grist's free tier ever stopped fitting.
Is this project open source and available to any Amateur Radio organization, EmComm, EOC, or ARES?
Why does this project exist?
Plain English definitions for terms used in this reference that may not be familiar to all operators.
was designed under three constraints:
1. APRS object comment field
limit of 43 characters
2. No numbered codes requiring
a lookup table under stress
3. Graceful handling of messages
cut short by poor conditions
All design decisions flow from
constraint 1. The NTS ARL numbered
radiogram system (90+ codes) was
considered and rejected. ARL codes
require memorization or lookup.
KCGR-ROAD and KCGR-FUEL are
self-describing to any operator
seeing them for the first time.
Field order (ST SPEC LOCATION
DDHHMM) places most-critical data
first. DDHHMM is always last so
a cut message loses time before
it loses location or status.
Status and location survive even
the worst signal conditions.
ObjectName/ST/SPEC/Location/Date
was chosen due to available 47 APRS
message limitations.
deliberately. A general or
miscellaneous object was proposed
and rejected -- operators filing
to the nearest category produces
more consistent, mappable data
than an undefined catchall.
If an observation truly fits no
category, KCGR-SHLT or KCGR-FOOD
are the broadest containers.
A light/dark display toggle was
proposed for this page and deferred.
Adding theme switching requires
JavaScript and additional CSS,
increasing page weight. This page
is explicitly designed to load
under degraded conditions. Dark
theme was chosen permanently for
readability in field conditions
and nighttime use. The FAQ
accordion above uses native
HTML details/summary elements
for the same reason -- zero
JavaScript, zero added weight.
KCGR-ROAD TR (trees/debris) was
added specifically because chain
saw operators self-deploying to
clear roads is documented community
behavior during Helene recovery.
KCGR- Kershaw County (5 chars)
MGS- Midlands (4 chars)
SCGR- South Carolina (5 chars)
MGS- gains one character in the
object name field. SCGR- matches
KCGR- exactly, so object names
port to the state level without
restructuring.
The prefix is the only redundant
element at Midlands and state level.
Field order and specifier codes
are load-bearing. Proposed changes
should shorten or replace the
prefix before modifying field
order or eliminating codes.
Developed June 2026 by AA4TE,
Camden SC, EM94. KC4RC / Kershaw
County ARES. Not a final standard
-- for review by Kershaw County
ARES EC, Midlands Section 3,
and SC ARES.