Added some firmware hacking documentation for customization, white-space cleanup, etc

This commit is contained in:
Dionysus 2024-04-29 14:15:38 -04:00
parent 3fabecb8aa
commit e0754f1f02
Signed by: acidvegas
GPG Key ID: EF4B922DB85DC9DE
4 changed files with 64 additions and 28 deletions

39
FIRMWARE_HACKS.md Normal file
View File

@ -0,0 +1,39 @@
# Meshtastic Firmware Hacks
### Custom Boot Logo & Message
- Download & install [PlatformIO](https://platformio.org/platformio-ide)
- `git clone https://github.com/meshtastic/firmware.git`
- `cd firmware && git submodule update --init`
- Use [XMB Viewer](https://windows87.github.io/xbm-viewer-converter/) to convert an image to XMB
- The data from this goes in `firmware/src/graphics/img/icon.xbm`
### Custom boot message
- Navigate to `firmware/src/graphics/Screen.cpp`
- Find & replace `const char *title = "meshtastic.org";` with your custom message.
### Custom screen color
- Navigate to `src/graphics/TFTDisplay.cpp`
- Find & replace `#define TFT_MESH COLOR565(0x67, 0xEA, 0x94)` with your custom color.
### Custom alert sound (for T-Deck & devices with a buzzer)
- From the mobile app, click the 3 dots on the top right, and select `Radio configuration`
- Under `Module configuration`, select `External Notification`
- Scroll down & you will see a `Ringtone` option that takes [RTTTL](https://en.wikipedia.org/wiki/Ring_Tone_Text_Transfer_Language) formatted tones.
As far as I know, at the time of writing this, the onyl way to change the Ringtone is from the App...
## Compile & flash firmware
- Select `PlatformIO: Pick Project Environment` & select your board.
- Run `PLatformIO: Build` to compile the firmware.
- Place device in DFU mode & plug in to the computer
- Do `PlatformIO: Upload` to send the firmware to the device
- Press the RESET button or reboot your device.
See [here](https://meshtastic.org/docs/development/firmware/build/) for more information building & flashing custom firmware.

View File

@ -10,6 +10,8 @@ The goal here is to create simple & clean modules to interface with the hardware
The hardware I am experimenting with: [Lilygo T-Deck](https://www.lilygo.cc/products/t-deck), [Lilygo T-Beam](https://www.lilygo.cc/products/t-beam-v1-1-esp32-lora-module), [Heltec Lora 32 v3](https://heltec.org/project/wifi-lora-32-v3/), and [RAK Wireless 4631](https://store.rakwireless.com/products/wisblock-core-modules?variant=42440631419078)
## Notes to self & developers
- The node id formula is: f'!{hex(node_num)[2:]}'
## Hardware & Software related Issues
- T-Deck must have Wifi turned off when going mobile. Upon leaving my house with WiFi still enabled, the UI & connection was EXTREMELY laggy & poor. Couldn't even type well...

View File

@ -7,6 +7,7 @@ import logging
import ssl
import time
# EF576MkXA3aEURbCfNn6p0FfZdua4I
# Formatting Control Characters / Color Codes
bold = '\x02'

View File

@ -17,24 +17,18 @@ except ImportError:
try:
from pubsub import pub
except ImportError:
raise ImportError('pubsub library not found (pip install pypubsub)') # Confirm this Pypi package name...
raise ImportError('pubsub library not found (pip install pypubsub)')
# Initialize logging
logging.basicConfig(level=logging.INFO, format='%(asctime)s | %(levelname)9s | %(funcName)s | %(message)s', datefmt='%Y-%m-%d %I:%M:%S')
def now():
'''Returns the current date and time in a formatted string'''
return time.strftime('%Y-%m-%d %H:%M:%S')
class MeshtasticClient(object):
def __init__(self):
self.interface = None # We will define the interface in the connect() function
self.me = {} # We will populate this with the event_connect() callback
self.nodes = {} # Nodes will populate with the event_node() callback
self.interface = None
self.me = {}
self.nodes = {}
def connect(self, option: str, value: str):
@ -71,7 +65,7 @@ class MeshtasticClient(object):
break
def send(self, message: str):
def sendmsg(self, message: str, destination: int, channelIndex: int = 0):
'''
Send a message to the Meshtastic interface
@ -82,7 +76,7 @@ class MeshtasticClient(object):
logging.warning('Message exceeds 255 characters')
message = message[:255]
self.interface.sendText(message)
self.interface.sendText(message, destination, wantAck=True, channelIndex=channelIndex) # Do we need wantAck?
logging.info(f'Sent broadcast message: {message}')
@ -121,7 +115,7 @@ class MeshtasticClient(object):
:param interface: Meshtastic interface
'''
logging.info(f'Data update: {data}')
logging.info(f'Data update: {packet}')
def event_disconnect(self, interface, topic=pub.AUTO_TOPIC):
@ -149,7 +143,7 @@ class MeshtasticClient(object):
self.nodes[node['num']] = node
logging.info(f'Node found: {node["user"]["id"]} - {node["user"]["shortName"].ljust(4)} - {node["user"]["longName"]}')
logging.info(f'Node recieved: {node["user"]["id"]} - {node["user"]["shortName"].ljust(4)} - {node["user"]["longName"]}')
def event_position(self, packet: dict, interface):
@ -161,7 +155,7 @@ class MeshtasticClient(object):
'''
sender = packet['from']
msg = packet['decoded']['payload'].hex()
msg = packet['decoded']['payload'].hex() # What exactly is contained in this payload?
id = self.nodes[sender]['user']['id'] if sender in self.nodes else '!unk '
name = self.nodes[sender]['user']['longName'] if sender in self.nodes else 'UNK'
longitude = packet['decoded']['position']['longitudeI'] / 1e7
@ -170,7 +164,7 @@ class MeshtasticClient(object):
snr = packet['rxSnr']
rssi = packet['rxRssi']
logging.info(f'{id} - {name}: {longitude}, {latitude}, {altitude}m (SNR: {snr}, RSSI: {rssi}) - {msg}')
logging.info(f'Position recieved: {id} - {name}: {longitude}, {latitude}, {altitude}m (SNR: {snr}, RSSI: {rssi}) - {msg}')
def event_text(self, packet: dict, interface):
@ -187,7 +181,7 @@ class MeshtasticClient(object):
name = self.nodes[sender]['user']['longName'] if sender in self.nodes else 'UNK'
target = self.nodes[to]['user']['longName'] if to in self.nodes else 'UNK'
logging.info(f'{id} {name} -> {target}: {msg}')
logging.info(f'Message recieved: {id} {name} -> {target}: {msg}')
print(packet)