Added some firmware hacking documentation for customization, white-space cleanup, etc
This commit is contained in:
parent
3fabecb8aa
commit
e0754f1f02
39
FIRMWARE_HACKS.md
Normal file
39
FIRMWARE_HACKS.md
Normal 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.
|
@ -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...
|
||||
|
@ -7,6 +7,7 @@ import logging
|
||||
import ssl
|
||||
import time
|
||||
|
||||
# EF576MkXA3aEURbCfNn6p0FfZdua4I
|
||||
|
||||
# Formatting Control Characters / Color Codes
|
||||
bold = '\x02'
|
||||
|
@ -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)
|
||||
|
||||
|
||||
|
Loading…
Reference in New Issue
Block a user