dandri/HaloKeymind
1
0 Fork 0
mirror of https://github.com/mikecarper/MeshCore.git synced 2026-10-22 20:01:17 +00:00
Code Issues Packages Projects Releases Wiki Activity

Link Cascade features and document Full profiles and LiFePO4 protection

Browse Source
This commit is contained in:
mikecarper committed 2026-10-06 18:44:42 -07:00
1 parent c5fe8a0edd
commit c9ca39b5dd
1 file changed
+26 -14
Download Patch File Download Diff File Expand all files Collapse all files
README.md
+26 -14
View File
@@ -1,21 +1,33 @@
## Halo Keymind Cascade Branch Changes over Stock
* **Two parallel LoRa radio settings on one device at the same time.** Alternate rx & tx between two frequencies and/or modulation settings. Choose transmission profiles per contact or channel, enable or isolate crossover traffic, schedule profiles, and use a temporary update profile alongside the normal network. Includes timing calibration and separate R2 screen pages. These are time-shared profiles on one transceiver.
* **Firmware updates over LoRa.** Update repeaters/rooms/sensors over LoRa.
* **Repeater forwarding policies.** Actions include dropping, rate limiting, assigning scopes, selecting retries, and controlling forwarding priority. Separate policies cover ordinary radio forwarding, bridges, and profile crossover.
* **Flood retries that account for network topology.** Configure retry counts, path limits, packet-type limits, target prefixes, ignored repeaters, and channel-specific eligibility. Bridge buckets keep retrying until traffic is heard on the intended sides of a relay or the retry budget expires. Qualifying echoes cancel unnecessary attempts.
* **Enhanced direct-message and direct-route retries.** Dynamic coding-rate, keep trying until echo hear.
* **Enhanced Telemetry.** Single LoRa packet supports multiple days of temperature or battery voltage or GPS history.
* **Unified Full Companion firmware.** Combines USB, BLE, WiFi, and Ethernet/serial transports in one image; with runtime controls and a LoRa firmware-serving mode. Most supported targets can operate multiple transports together; some boards have explicit transport restrictions.
* **Operational reporting and alerts.** Adds optional management reports with firmware version, bootloader version, LoRa update capabilities, uptime, and historical voltage and temperature ranges.
* **Set time using LoRa Network.** Automatically set the clock based off the LoRa network. Better than 2024.
* **Companion Bluetooth privacy and recovery improvements.** Configurable mac address policies, paired-peer stealth behavior, and changes to reconnect, subscription, and startup handling.
* **Single Key DMs.** Allow for you to send your advert in the initial DM. Makes DMing a bot/bbs/etc a lot easier if they're also running this firmware.
* **agessaman Observer - ESP32 Integrated MQTT observation.** Send directly from the node to the observer api endpoint.
* **IoTThinks PowerSaving - Broader power-saving controls.** Integrates device sleep, LoRa receive duty cycling, WiFi modem-sleep policies, and GPS acquisition/cache schedules across supported roles. These controls are independently configurable; actual savings depend on hardware and workload.
* **[Two LoRa profiles on one device](https://mikecarper.github.io/MeshCore/radio_profiles/).** Time-share one transceiver between two frequencies and/or modulation settings. Choose transmission profiles per contact or channel, enable or isolate crossover traffic, schedule profiles, and use a temporary update profile alongside the normal network. Includes timing calibration and separate R2 screen pages.
* **[Firmware updates over LoRa](https://mikecarper.github.io/MeshCore/lora_ota_automation/).** Update repeaters, room servers, and sensors over LoRa on supported firmware and storage layouts.
* **[Repeater forwarding policies](https://mikecarper.github.io/MeshCore/flood_filtering/).** Actions include dropping, rate limiting, assigning scopes, selecting retries, and controlling forwarding priority. Separate policies cover ordinary radio forwarding, bridges, and profile crossover.
* **[Flood retries that account for network topology](https://mikecarper.github.io/MeshCore/halo_keymind_settings/#flood-and-advert-settings).** Configure retry counts, path limits, packet-type limits, target prefixes, ignored repeaters, and channel-specific eligibility. Bridge buckets keep retrying until traffic is heard on the intended sides of a relay or the retry budget expires. Qualifying echoes cancel unnecessary attempts.
* **[Enhanced direct-message and direct-route retries](https://mikecarper.github.io/MeshCore/halo_keymind_settings/#direct-retry-settings).** Adapt the coding rate across bounded retry attempts and cancel unnecessary retries when a qualifying echo is heard.
* **[Enhanced telemetry history](https://mikecarper.github.io/MeshCore/telemetry_decoder/).** Send compact temperature and battery-voltage snapshots of up to 165 samples per packet, plus external-voltage history in chunks. Read retained GPS history through the CLI; GPS history is not included in the automatic telemetry packets. Decode snapshots and CLI history in the browser.
* **[Full firmware profiles](https://mikecarper.github.io/MeshCore/firmware_picker/#full-versus-standard).** ESP32 Full images combine the exact board and role's supported features, selected through runtime settings, with documented capacity exceptions. Expanded Full images need matching application slots and may require a partition migration. Qualified nRF52 repeater, room-server, and sensor builds offer separate Full supported sensors and Reduced sensors packages, both with LoRa OTA; Reduced omits selected optional sensor drivers while retaining generic I2C and supported board peripherals.
* **[Unified Full Companion firmware](https://mikecarper.github.io/MeshCore/companion_radio_full/).** Combines the target's supported USB, BLE, WiFi, and Ethernet/serial transports in one image, with runtime controls and a LoRa firmware-serving mode. Most supported targets can operate multiple transports together; some boards have explicit transport restrictions.
* **[Combined ESP32 infrastructure bridges](https://mikecarper.github.io/MeshCore/espnow_bridge_setup/).** Supported Full images combine MQTT, ESP-NOW, and RS-232 where the board provides those interfaces. Enable each transport independently at runtime; boards with capacity exceptions retain separate images.
* **[Operational reporting and alerts](https://mikecarper.github.io/MeshCore/management_reports/).** Adds optional management reports with firmware version, bootloader version, LoRa update capabilities, uptime, and historical voltage and temperature ranges.
* **[Set time using the LoRa network](https://mikecarper.github.io/MeshCore/cli_commands/#estimate-and-correct-infrastructure-node-time-after-startup).** Infrastructure nodes can estimate time from fresh mesh evidence and correct their clocks when a consensus is available. Successful manual, GPS, or NTP synchronization takes precedence until reboot.
* **[Companion Bluetooth privacy and recovery improvements](https://mikecarper.github.io/MeshCore/companion_radio_full/#interfaces).** Configurable MAC address policies, paired-peer stealth behavior, and changes to reconnect, subscription, and startup handling on supported Bluetooth targets.
* **[Single Key DMs](https://mikecarper.github.io/MeshCore/companion_protocol/#private-text-when-only-the-sender-knows-the-recipient).** Send private text to a chat contact when only the sender knows the recipient's key. Compatible Companion firmware sends a signed, encrypted introduction before the normal DM; the recipient accepts the sender through the app or opts into automatic acceptance. Compact STM32WL builds omit this feature.
* **[Programmable Companion radio notifications](https://mikecarper.github.io/MeshCore/notifications/).** Build per-contact, room, or channel rules for the radio's vibration, LED, melody, screen, and supported GPIO outputs. Select rules by client connection state and configure repeat/stop behavior. Available on ESP32, nRF52, and RP2040 Companions with the required outputs.
* **[agessaman Observer - integrated ESP32 MQTT observation](https://mikecarper.github.io/MeshCore/WiFi/#mqtt-observer-setup).** Publish packets from the node over WiFi to a configured MQTT broker, without a separate USB host bridge.
* **[USB packet streaming and recovery](https://mikecarper.github.io/MeshCore/cli_commands/#control-live-usb-logging).** Select USB packet logging and diagnostic output at runtime for host bridges such as meshcoretomqtt. The saved [native-USB logging watchdog](https://mikecarper.github.io/MeshCore/usb_logging_watchdog/) provides staged transport recovery and, when explicitly armed, bounded MCU reset recovery for physical USB faults.
* **[IoTThinks PowerSaving - broader power-saving controls](https://mikecarper.github.io/MeshCore/role_feature_switches/#infrastructure-power-saving-and-bridges).** Integrates device sleep, LoRa receive duty cycling, WiFi modem-sleep policies, and GPS acquisition/cache schedules across supported roles. These controls are independently configurable; actual savings depend on hardware and workload.
* **[LiFePO4 low-voltage cutoff and protection](https://mikecarper.github.io/MeshCore/cli_commands/#configure-nrf52-battery-protection).** On supported nRF52 power-management boards with a text CLI, the saved LiFePO4 profile sets a 2.9 V boot lock and 2.7 V running cutoff. Three valid low readings 30 seconds apart trigger protective shutdown; external power bypasses these checks. Use compatible charging hardware: selecting a battery profile does not change the charger.
* **[Exact-board Full partition migrations](https://mikecarper.github.io/MeshCore/firmware_picker/#full-versus-standard).** The picker links matching ESP32 board/role migration packages for supported source layouts and update routes. Use the matching merged image for USB layout changes; an app-only firmware image cannot change the partition table.
Get the correct firmware file here for your hardware:
**https://mikecarper.github.io/MeshCore/firmware_picker/**
**[Firmware picker](https://mikecarper.github.io/MeshCore/firmware_picker/)**
Related source projects:
* [agessaman Observer firmware](https://github.com/agessaman/MeshCore/tree/observer-firmware-dev): embedded WiFi/MQTT observation.
* [Cisien meshcoretomqtt](https://github.com/Cisien/meshcoretomqtt): a host-side Python USB/serial packet-log publisher.
* [IoTThinks PowerSaving branch](https://github.com/IoTThinks/MeshCore/tree/PowerSaving-v17): power-saving integration.
---