ChatterBack🔍Join
meshcore🕸 MeshCore· beginner

Using the Tulsa weather bot on MeshCore

Step by step: add the #tulwx channel, find the T&T WX BOT in your contacts, and every command it answers - forecasts, river gauges, fire and air quality, and mail for radios that are switched off.

8 min readUpdated 6d1 contributor

The T&T WX BOT is a MeshCore node in Owasso that answers questions over LoRa. You need no internet on your end — just a radio and the MeshCore app. Send it a direct message and it replies to you alone, so asking costs the channel almost nothing.

Setting up

  1. Add the channel. In the MeshCore app, add a channel named #tulwx. It is a hashtag channel, so there is no key to type and nobody to ask. The 6:30 briefing and severe weather warnings arrive here.
  2. Wait for the bot to appear. Once it is within reach, T&T WX BOT CB-10E3 shows up in your contacts on its own — it adverts periodically. That contact is what you send commands to.
  3. Try it. Send it wx. If a forecast comes back, you are done.
Flow chart: open the MeshCore app, add the hashtag tulwx channel, wait for the bot to appear in contacts, send it wx, and a forecast comes back.
The whole setup. If the bot never appears, you are out of reach rather than blocked.

Nothing is case sensitive and a leading slash is ignored, so WX, wx and /wx all work.

Areas

Leave the area off and you get the Tulsa area. Add one of these to ask about somewhere else.

CodeArea
tulTulsa area
osageOsage County
creekCreek County
delawareDelaware County

Weather

CommandWhat it doesExample
wx [area]Next two forecast periodswx osage
wx2 [area]Further out, four periodswx2 creek
today [area]Full day for one area: highs, lows, rain timing, wind, UVtoday delaware
morningThe whole 6:30 briefing, all four counties, on demandmorning
alerts [area]Watches, warnings and advisories in effect nowalerts tul
areasWhich areas the bot knowsareas

Water, sky and fire

Live numbers pulled off public feeds the moment you ask. Nothing goes out on the channel, so ask as often as you like.

CommandWhat it doesExample
river <name>Gauge height and flow, straight from the USGS gaugeriver lower
riversList the rivers and creeks it watchesrivers
sun [area]Sunrise, sunset, day length, moon phasesun
fire [area]Red flag warnings and fire weather watches in effectfire osage
aqi [area]Air quality index and fine particulatesaqi tul
kpPlanetary K index: aurora chances and HF conditionskp

Rivers and creeks it watches

Short names for river. Readings come from the USGS gauge, usually within the last fifteen minutes.

CodeGauge
arkArkansas River at Tulsa
verdVerdigris River near Claremore
birdBird Creek near Owasso
spavSpavinaw Creek near Eucha
illIllinois River near Tahlequah
lowerLower Illinois near Gore, below Tenkiller
baronBaron Fork at Eldon
flintFlint Creek near Kansas
neoshoNeosho River near Langley

Mail

Most radios on the mesh are asleep or out of range most of the day, so a message sent the moment you think of it usually reaches nobody. The bot holds it for you instead and hands it over the next time that person checks in.

Four steps: you send mail for bob, the bot confirms it is held, bob checks in later with the mail command, and the bot hands the message over.
Leaving a message for somebody whose radio is off.
CommandWhat it doesExample
mailRead what is waiting for youmail
mail <who> <text>Send a message straight awaymail bob heading to keystone sat
draft <who> <text>Start a longer message you will add todraft bob launching from walnut creek
+ <text>Add another line to the draft+ around 8am, bringing extra rods
sendSend the draftsend
abortThrow the draft awayabort
whoList the node names the bot knows, so you know how to address someonewho

Writing something longer

The app cannot send more than about 150 characters at once, so build a longer note a line at a time:

draft bob heading to keystone saturday
+ launching from the walnut creek ramp around 8
+ bringing the extra rods if you need one
send

Limits

  • 440 characters — the longest single piece of mail
  • 10 a day — how much mail one person can send
  • 7 days — how long unread mail is kept
  • 15 minutes — how long an unfinished draft stays open

Mail is a postcard, not a sealed envelope. It is encrypted on the air, but it sits in plain text on the machine running the bot until it is delivered, and whoever runs that machine can read it. Fine for “running late” and trip plans. Not for anything you would mind being read.

Nets and coverage

The bot keeps a record of every packet it hears, including signal strength and how many hops it took. That record is what these read from.

Four steps of a net: control opens it, members check in, anyone can read the roster, control closes it and the bot reports the count.
A net run through the bot. Check-ins are direct messages, so the net does not fill the channel.
CommandWhat it doesExample
statsLast 24 hours: packets, nodes heard, loudest, farthest, busiest hourstats
heardEvery node heard in the last 24 hoursheard
net statusIs a net running, and how many have checked innet
net open <name>Open a net. Net control only, if a control list is set.net open Tuesday Net
net closeClose the net and report the countnet close
checkin [note]Check in to the running net, with an optional notecheckin 71st and Mingo, mobile
rosterWho has checked in to this net, or the last oneroster

Everything else

CommandWhat it does
helpThe short command list
mailhelpThe short mail list
meshhelpThe short net and stats list
pingCheck the bot is alive

If it does not answer

  1. Send ping. A reply means the bot is fine and the problem is whatever you sent it.
  2. No reply at all usually means you are out of reach, not blocked. The bot answers anything it can hear, including through a repeater, so try again from higher ground or nearer a window.
  3. If the bot seems slow rather than silent, that is deliberate — it spaces its replies out so they do not collide with other traffic.

Being a good neighbour

  • Every command above is a direct message, so it answers only you and barely touches the channel. Ask away.
  • The channel itself stays quiet on purpose: the 6:30 forecast and severe weather warnings, nothing else.
  • Air time is shared by everyone on the mesh. A bot that chatters costs every other node.

About this bot

Run by ChatterBack at Owasso, on 910.525 MHz, 62.5 kHz, SF7, CR5. Questions, or a node name you want added, go to the #tulwx channel.