meshing-around

Random Mesh Scripts for BBS activities for use with Meshtastic nodes

pong-bot.sh

Little bot which will trap keywords like ping and respond on a DM with pong. The script will also monitor the group channels for keywords to trap on. you can also Ping @Data to Echo as a example for further processing.

other features

• motd or to set the message motd $New Message Of the day
• lheard returns the last 5 heard nodes with SNR, can also use sitrep
• cmd returns the list of commands (the help message)

mesh-bot.sh

alternate bot, adds internet and other telemetry data which goes beyond just ping

• Various solar details for radio propagation
  • sun and moon return info on rise and set local time
  • solar gives an idea of the x-ray flux
  • hfcond returns a table of HF solar conditions
• Bulletin Board (BBS) functions
  • bbshelp returns the following
  • bbslist list the messages by ID and subject
  • bbsread read a message example use: bbsread #1
  • bbspost post a message to public board or send a DM example use: bbspost $subject #message, or bbspost @nodeNumber #message
  • bbsdelete delete a message example use: bbsdelete #4
• Other functions
  • whereami returns the address of location of sender if known
  • tide returns the local tides, NOAA data source
  • wx and wxc returns local weather forecast, NOAA data source (wxc is metric value)
  • wxa and wxalert returns NOAA alerts. short title or expanded details
  • joke tells a joke
  • messages Replay the last messages heard, like Store and Forward

Install

• Clone the project with git clone https://github.com/spudgunman/meshing-around
• install.sh will automate optional venv and requirements install
• launch.sh will activate and launch the app in the venv if built

Configurations

Some config is via code, converting to config.ini set the appropriate interface for your method (serial/ble/tcp). Only one at a time is supported to a single node at a time.

the config.template can be used to make a new config.ini

#config.ini
# type can be serial, tcp, or ble
# port is the serial port to use, commented out will try to auto-detect
# hostname is the IP address of the device to connect to for tcp type
# mac is the MAC address of the device to connect to for ble type

[interface]
type = serial
# port = '/dev/ttyUSB0'
# hostname = 192.168.0.1
# mac = 00:11:22:33:44:55

The following pair of settings determine how to respond, default action is to not spam the default channel. Setting DM_ONLY will force all DM which may not be wanted. Setting the Default channel is the channel which wont be spammed by the bot.

[general]
respond_by_dm_only = True
defaultChannel = 0

Modules can be disabled or enabled

[bbs]
enabled = False

[general]
DadJokes = True
StoreForward = True
StoreLimit = 3 # The number of StoreForward messages to retain

The BBS has admin and block lists, see the modules/bbstools.py for details

requirements

can also be installed with pip install -r requirements.txt

pip install meshtastic
pip install pubsub

mesh-bot enhancments

pip install pyephem
pip install requests
pip install geopy
pip install maidenhead
pip install beautifulsoup4
pip install dadjokes

Recognition

Used ideas and snippets from other responder bots want to call them out!

• https://github.com/Murturtle/MeshLink
• https://github.com/pdxlocations/Meshtastic-Python-Examples

GitHub user https://github.com/PiDiBi

• providing looking at test functions and other suggestions like wxc, cpu use and alerting code

Discord and Mesh user Cisien, and github Hailo1999, for testing and ideas!