mirror of
https://github.com/mikecarper/MeshCore.git
synced 2026-11-04 14:27:16 +00:00
2882 lines
60 KiB
HTML
2882 lines
60 KiB
HTML
|
|
<!doctype html>
|
|
<html lang="en" class="no-js">
|
|
<head>
|
|
|
|
<meta charset="utf-8">
|
|
<meta name="viewport" content="width=device-width,initial-scale=1">
|
|
|
|
<meta name="description" content="Documentation for the open source MeshCore firmware">
|
|
|
|
|
|
|
|
<link rel="canonical" href="https://mikecarper.github.io/MeshCore/management_reports/">
|
|
|
|
|
|
<link rel="prev" href="../ota_protocol/">
|
|
|
|
|
|
<link rel="next" href="../stats_binary_frames/">
|
|
|
|
|
|
|
|
|
|
|
|
<link rel="icon" href="../assets/images/favicon.png">
|
|
<meta name="generator" content="mkdocs-1.6.1, mkdocs-material-9.7.7">
|
|
|
|
|
|
|
|
<title>Management reports - MeshCore Docs</title>
|
|
|
|
|
|
|
|
<link rel="stylesheet" href="../assets/stylesheets/main.ec1eaa64.min.css">
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
<link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>
|
|
<link rel="stylesheet" href="https://fonts.googleapis.com/css?family=Roboto:300,300i,400,400i,700,700i%7CRoboto+Mono:400,400i,700,700i&display=fallback">
|
|
<style>:root{--md-text-font:"Roboto";--md-code-font:"Roboto Mono"}</style>
|
|
|
|
|
|
|
|
<link rel="stylesheet" href="../_stylesheets/notification_builder.css?v=20261006-channel9">
|
|
|
|
<link rel="stylesheet" href="https://unpkg.com/leaflet@1.9.4/dist/leaflet.css">
|
|
|
|
<link rel="stylesheet" href="../_stylesheets/extra.css">
|
|
|
|
<link rel="stylesheet" href="../_stylesheets/firmware_picker.css?v=20261001-feedback-1">
|
|
|
|
<link rel="stylesheet" href="../_stylesheets/telemetry_decoder.css">
|
|
|
|
<link rel="stylesheet" href="../_stylesheets/management_decoder.css">
|
|
|
|
<link rel="stylesheet" href="../_stylesheets/filter_tool.css">
|
|
|
|
<link rel="stylesheet" href="../_stylesheets/preset_test.css?v=20260923-2">
|
|
|
|
<link rel="stylesheet" href="../_stylesheets/esp32_partition_catalog.css?v=20261001-1">
|
|
|
|
<script>__md_scope=new URL("..",location),__md_hash=e=>[...e].reduce(((e,_)=>(e<<5)-e+_.charCodeAt(0)),0),__md_get=(e,_=localStorage,t=__md_scope)=>JSON.parse(_.getItem(t.pathname+"."+e)),__md_set=(e,_,t=localStorage,a=__md_scope)=>{try{t.setItem(a.pathname+"."+e,JSON.stringify(_))}catch(e){}}</script>
|
|
|
|
|
|
|
|
|
|
|
|
</head>
|
|
|
|
|
|
<body dir="ltr">
|
|
|
|
|
|
<input class="md-toggle" data-md-toggle="drawer" type="checkbox" id="__drawer" autocomplete="off">
|
|
<input class="md-toggle" data-md-toggle="search" type="checkbox" id="__search" autocomplete="off">
|
|
<label class="md-overlay" for="__drawer"></label>
|
|
<div data-md-component="skip">
|
|
|
|
|
|
<a href="#management-reports-mgr1mgr2" class="md-skip">
|
|
Skip to content
|
|
</a>
|
|
|
|
</div>
|
|
<div data-md-component="announce">
|
|
|
|
</div>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
<header class="md-header md-header--shadow" data-md-component="header">
|
|
<nav class="md-header__inner md-grid" aria-label="Header">
|
|
<a href=".." title="MeshCore Docs" class="md-header__button md-logo" aria-label="MeshCore Docs" data-md-component="logo">
|
|
|
|
<img src="../_assets/meshcore.svg" alt="logo">
|
|
|
|
</a>
|
|
<label class="md-header__button md-icon" for="__drawer">
|
|
|
|
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M3 6h18v2H3zm0 5h18v2H3zm0 5h18v2H3z"/></svg>
|
|
</label>
|
|
<div class="md-header__title" data-md-component="header-title">
|
|
<div class="md-header__ellipsis">
|
|
<div class="md-header__topic">
|
|
<span class="md-ellipsis">
|
|
MeshCore Docs
|
|
</span>
|
|
</div>
|
|
<div class="md-header__topic" data-md-component="header-topic">
|
|
<span class="md-ellipsis">
|
|
|
|
Management reports
|
|
|
|
</span>
|
|
</div>
|
|
</div>
|
|
</div>
|
|
|
|
|
|
<script>var palette=__md_get("__palette");if(palette&&palette.color){if("(prefers-color-scheme)"===palette.color.media){var media=matchMedia("(prefers-color-scheme: light)"),input=document.querySelector(media.matches?"[data-md-color-media='(prefers-color-scheme: light)']":"[data-md-color-media='(prefers-color-scheme: dark)']");palette.color.media=input.getAttribute("data-md-color-media"),palette.color.scheme=input.getAttribute("data-md-color-scheme"),palette.color.primary=input.getAttribute("data-md-color-primary"),palette.color.accent=input.getAttribute("data-md-color-accent")}for(var[key,value]of Object.entries(palette.color))document.body.setAttribute("data-md-color-"+key,value)}</script>
|
|
|
|
|
|
|
|
|
|
|
|
<label class="md-header__button md-icon" for="__search">
|
|
|
|
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.52 6.52 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5"/></svg>
|
|
</label>
|
|
<div class="md-search" data-md-component="search" role="dialog">
|
|
<label class="md-search__overlay" for="__search"></label>
|
|
<div class="md-search__inner" role="search">
|
|
<form class="md-search__form" name="search">
|
|
<input type="text" class="md-search__input" name="query" aria-label="Search" placeholder="Search" autocapitalize="off" autocorrect="off" autocomplete="off" spellcheck="false" data-md-component="search-query" required>
|
|
<label class="md-search__icon md-icon" for="__search">
|
|
|
|
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.52 6.52 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5"/></svg>
|
|
|
|
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M20 11v2H8l5.5 5.5-1.42 1.42L4.16 12l7.92-7.92L13.5 5.5 8 11z"/></svg>
|
|
</label>
|
|
<nav class="md-search__options" aria-label="Search">
|
|
|
|
<button type="reset" class="md-search__icon md-icon" title="Clear" aria-label="Clear" tabindex="-1">
|
|
|
|
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M19 6.41 17.59 5 12 10.59 6.41 5 5 6.41 10.59 12 5 17.59 6.41 19 12 13.41 17.59 19 19 17.59 13.41 12z"/></svg>
|
|
</button>
|
|
</nav>
|
|
|
|
<div class="md-search__suggest" data-md-component="search-suggest"></div>
|
|
|
|
</form>
|
|
<div class="md-search__output">
|
|
<div class="md-search__scrollwrap" tabindex="0" data-md-scrollfix>
|
|
<div class="md-search-result" data-md-component="search-result">
|
|
<div class="md-search-result__meta">
|
|
Initializing search
|
|
</div>
|
|
<ol class="md-search-result__list" role="presentation"></ol>
|
|
</div>
|
|
</div>
|
|
</div>
|
|
</div>
|
|
</div>
|
|
|
|
|
|
|
|
<div class="md-header__source">
|
|
<a href="https://github.com/mikecarper/MeshCore/" title="Go to repository" class="md-source" data-md-component="source">
|
|
<div class="md-source__icon md-icon">
|
|
|
|
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 7.1.0 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2025 Fonticons, Inc.--><path d="M439.6 236.1 244 40.5c-5.4-5.5-12.8-8.5-20.4-8.5s-15 3-20.4 8.4L162.5 81l51.5 51.5c27.1-9.1 52.7 16.8 43.4 43.7l49.7 49.7c34.2-11.8 61.2 31 35.5 56.7-26.5 26.5-70.2-2.9-56-37.3L240.3 199v121.9c25.3 12.5 22.3 41.8 9.1 55-6.4 6.4-15.2 10.1-24.3 10.1s-17.8-3.6-24.3-10.1c-17.6-17.6-11.1-46.9 11.2-56v-123c-20.8-8.5-24.6-30.7-18.6-45L142.6 101 8.5 235.1C3 240.6 0 247.9 0 255.5s3 15 8.5 20.4l195.6 195.7c5.4 5.4 12.7 8.4 20.4 8.4s15-3 20.4-8.4l194.7-194.7c5.4-5.4 8.4-12.8 8.4-20.4s-3-15-8.4-20.4"/></svg>
|
|
</div>
|
|
<div class="md-source__repository">
|
|
mikecarper/MeshCore
|
|
</div>
|
|
</a>
|
|
</div>
|
|
|
|
</nav>
|
|
|
|
</header>
|
|
|
|
<div class="md-container" data-md-component="container">
|
|
|
|
|
|
|
|
|
|
|
|
|
|
<main class="md-main" data-md-component="main">
|
|
<div class="md-main__inner md-grid">
|
|
|
|
|
|
|
|
<div class="md-sidebar md-sidebar--primary" data-md-component="sidebar" data-md-type="navigation" >
|
|
<div class="md-sidebar__scrollwrap">
|
|
<div class="md-sidebar__inner">
|
|
|
|
|
|
|
|
|
|
<nav class="md-nav md-nav--primary" aria-label="Navigation" data-md-level="0">
|
|
<label class="md-nav__title" for="__drawer">
|
|
<a href=".." title="MeshCore Docs" class="md-nav__button md-logo" aria-label="MeshCore Docs" data-md-component="logo">
|
|
|
|
<img src="../_assets/meshcore.svg" alt="logo">
|
|
|
|
</a>
|
|
MeshCore Docs
|
|
</label>
|
|
|
|
<div class="md-nav__source">
|
|
<a href="https://github.com/mikecarper/MeshCore/" title="Go to repository" class="md-source" data-md-component="source">
|
|
<div class="md-source__icon md-icon">
|
|
|
|
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 7.1.0 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2025 Fonticons, Inc.--><path d="M439.6 236.1 244 40.5c-5.4-5.5-12.8-8.5-20.4-8.5s-15 3-20.4 8.4L162.5 81l51.5 51.5c27.1-9.1 52.7 16.8 43.4 43.7l49.7 49.7c34.2-11.8 61.2 31 35.5 56.7-26.5 26.5-70.2-2.9-56-37.3L240.3 199v121.9c25.3 12.5 22.3 41.8 9.1 55-6.4 6.4-15.2 10.1-24.3 10.1s-17.8-3.6-24.3-10.1c-17.6-17.6-11.1-46.9 11.2-56v-123c-20.8-8.5-24.6-30.7-18.6-45L142.6 101 8.5 235.1C3 240.6 0 247.9 0 255.5s3 15 8.5 20.4l195.6 195.7c5.4 5.4 12.7 8.4 20.4 8.4s15-3 20.4-8.4l194.7-194.7c5.4-5.4 8.4-12.8 8.4-20.4s-3-15-8.4-20.4"/></svg>
|
|
</div>
|
|
<div class="md-source__repository">
|
|
mikecarper/MeshCore
|
|
</div>
|
|
</a>
|
|
</div>
|
|
|
|
<ul class="md-nav__list" data-md-scrollfix>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
<li class="md-nav__item">
|
|
<a href=".." class="md-nav__link">
|
|
|
|
|
|
|
|
<span class="md-ellipsis">
|
|
|
|
|
|
Home
|
|
|
|
|
|
|
|
</span>
|
|
|
|
|
|
|
|
</a>
|
|
</li>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
<li class="md-nav__item md-nav__item--nested">
|
|
|
|
|
|
|
|
<input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_2" >
|
|
|
|
|
|
<label class="md-nav__link" for="__nav_2" id="__nav_2_label" tabindex="0">
|
|
|
|
|
|
|
|
<span class="md-ellipsis">
|
|
|
|
|
|
Firmware and tools
|
|
|
|
|
|
|
|
</span>
|
|
|
|
|
|
|
|
<span class="md-nav__icon md-icon"></span>
|
|
</label>
|
|
|
|
<nav class="md-nav" data-md-level="1" aria-labelledby="__nav_2_label" aria-expanded="false">
|
|
<label class="md-nav__title" for="__nav_2">
|
|
<span class="md-nav__icon md-icon"></span>
|
|
|
|
|
|
Firmware and tools
|
|
|
|
|
|
</label>
|
|
<ul class="md-nav__list" data-md-scrollfix>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
<li class="md-nav__item">
|
|
<a href="../firmware_picker/" class="md-nav__link">
|
|
|
|
|
|
|
|
<span class="md-ellipsis">
|
|
|
|
|
|
Firmware picker
|
|
|
|
|
|
|
|
</span>
|
|
|
|
|
|
|
|
</a>
|
|
</li>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
<li class="md-nav__item">
|
|
<a href="../notifications/" class="md-nav__link">
|
|
|
|
|
|
|
|
<span class="md-ellipsis">
|
|
|
|
|
|
Notifications
|
|
|
|
|
|
|
|
</span>
|
|
|
|
|
|
|
|
</a>
|
|
</li>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
<li class="md-nav__item">
|
|
<a href="../preset_test/" class="md-nav__link">
|
|
|
|
|
|
|
|
<span class="md-ellipsis">
|
|
|
|
|
|
Preset test
|
|
|
|
|
|
|
|
</span>
|
|
|
|
|
|
|
|
</a>
|
|
</li>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
<li class="md-nav__item">
|
|
<a href="../filter_tool/" class="md-nav__link">
|
|
|
|
|
|
|
|
<span class="md-ellipsis">
|
|
|
|
|
|
Filter tool
|
|
|
|
|
|
|
|
</span>
|
|
|
|
|
|
|
|
</a>
|
|
</li>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
<li class="md-nav__item">
|
|
<a href="../telemetry_decoder/" class="md-nav__link">
|
|
|
|
|
|
|
|
<span class="md-ellipsis">
|
|
|
|
|
|
Telemetry decoder
|
|
|
|
|
|
|
|
</span>
|
|
|
|
|
|
|
|
</a>
|
|
</li>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
<li class="md-nav__item">
|
|
<a href="../management_decoder/" class="md-nav__link">
|
|
|
|
|
|
|
|
<span class="md-ellipsis">
|
|
|
|
|
|
Management decoder
|
|
|
|
|
|
|
|
</span>
|
|
|
|
|
|
|
|
</a>
|
|
</li>
|
|
|
|
|
|
|
|
|
|
</ul>
|
|
</nav>
|
|
|
|
</li>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
<li class="md-nav__item md-nav__item--active md-nav__item--nested">
|
|
|
|
|
|
|
|
<input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_3" checked>
|
|
|
|
|
|
<label class="md-nav__link" for="__nav_3" id="__nav_3_label" tabindex="0">
|
|
|
|
|
|
|
|
<span class="md-ellipsis">
|
|
|
|
|
|
Documentation
|
|
|
|
|
|
|
|
</span>
|
|
|
|
|
|
|
|
<span class="md-nav__icon md-icon"></span>
|
|
</label>
|
|
|
|
<nav class="md-nav" data-md-level="1" aria-labelledby="__nav_3_label" aria-expanded="true">
|
|
<label class="md-nav__title" for="__nav_3">
|
|
<span class="md-nav__icon md-icon"></span>
|
|
|
|
|
|
Documentation
|
|
|
|
|
|
</label>
|
|
<ul class="md-nav__list" data-md-scrollfix>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
<li class="md-nav__item md-nav__item--nested">
|
|
|
|
|
|
|
|
<input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_3_1" >
|
|
|
|
|
|
<label class="md-nav__link" for="__nav_3_1" id="__nav_3_1_label" tabindex="0">
|
|
|
|
|
|
|
|
<span class="md-ellipsis">
|
|
|
|
|
|
Getting started and features
|
|
|
|
|
|
|
|
</span>
|
|
|
|
|
|
|
|
<span class="md-nav__icon md-icon"></span>
|
|
</label>
|
|
|
|
<nav class="md-nav" data-md-level="2" aria-labelledby="__nav_3_1_label" aria-expanded="false">
|
|
<label class="md-nav__title" for="__nav_3_1">
|
|
<span class="md-nav__icon md-icon"></span>
|
|
|
|
|
|
Getting started and features
|
|
|
|
|
|
</label>
|
|
<ul class="md-nav__list" data-md-scrollfix>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
<li class="md-nav__item">
|
|
<a href="../faq/" class="md-nav__link">
|
|
|
|
|
|
|
|
<span class="md-ellipsis">
|
|
|
|
|
|
Faq
|
|
|
|
|
|
|
|
</span>
|
|
|
|
|
|
|
|
</a>
|
|
</li>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
<li class="md-nav__item">
|
|
<a href="../full_profiles/" class="md-nav__link">
|
|
|
|
|
|
|
|
<span class="md-ellipsis">
|
|
|
|
|
|
Full profiles
|
|
|
|
|
|
|
|
</span>
|
|
|
|
|
|
|
|
</a>
|
|
</li>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
<li class="md-nav__item">
|
|
<a href="../role_feature_switches/" class="md-nav__link">
|
|
|
|
|
|
|
|
<span class="md-ellipsis">
|
|
|
|
|
|
Role feature switches
|
|
|
|
|
|
|
|
</span>
|
|
|
|
|
|
|
|
</a>
|
|
</li>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
<li class="md-nav__item">
|
|
<a href="../full_companion_features/" class="md-nav__link">
|
|
|
|
|
|
|
|
<span class="md-ellipsis">
|
|
|
|
|
|
Full companion features
|
|
|
|
|
|
|
|
</span>
|
|
|
|
|
|
|
|
</a>
|
|
</li>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
<li class="md-nav__item">
|
|
<a href="../companion_radio_full/" class="md-nav__link">
|
|
|
|
|
|
|
|
<span class="md-ellipsis">
|
|
|
|
|
|
Companion radio full
|
|
|
|
|
|
|
|
</span>
|
|
|
|
|
|
|
|
</a>
|
|
</li>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
<li class="md-nav__item">
|
|
<a href="../full_companion_usb_switcher/" class="md-nav__link">
|
|
|
|
|
|
|
|
<span class="md-ellipsis">
|
|
|
|
|
|
Full companion usb switcher
|
|
|
|
|
|
|
|
</span>
|
|
|
|
|
|
|
|
</a>
|
|
</li>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
<li class="md-nav__item">
|
|
<a href="../companion_offline_queue/" class="md-nav__link">
|
|
|
|
|
|
|
|
<span class="md-ellipsis">
|
|
|
|
|
|
Companion offline queue
|
|
|
|
|
|
|
|
</span>
|
|
|
|
|
|
|
|
</a>
|
|
</li>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
<li class="md-nav__item">
|
|
<a href="../halo_keymind_settings/" class="md-nav__link">
|
|
|
|
|
|
|
|
<span class="md-ellipsis">
|
|
|
|
|
|
Halo keymind settings
|
|
|
|
|
|
|
|
</span>
|
|
|
|
|
|
|
|
</a>
|
|
</li>
|
|
|
|
|
|
|
|
|
|
</ul>
|
|
</nav>
|
|
|
|
</li>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
<li class="md-nav__item md-nav__item--nested">
|
|
|
|
|
|
|
|
<input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_3_2" >
|
|
|
|
|
|
<label class="md-nav__link" for="__nav_3_2" id="__nav_3_2_label" tabindex="0">
|
|
|
|
|
|
|
|
<span class="md-ellipsis">
|
|
|
|
|
|
Firmware updates and partitions
|
|
|
|
|
|
|
|
</span>
|
|
|
|
|
|
|
|
<span class="md-nav__icon md-icon"></span>
|
|
</label>
|
|
|
|
<nav class="md-nav" data-md-level="2" aria-labelledby="__nav_3_2_label" aria-expanded="false">
|
|
<label class="md-nav__title" for="__nav_3_2">
|
|
<span class="md-nav__icon md-icon"></span>
|
|
|
|
|
|
Firmware updates and partitions
|
|
|
|
|
|
</label>
|
|
<ul class="md-nav__list" data-md-scrollfix>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
<li class="md-nav__item">
|
|
<a href="../upgrading_1.17.1.8_to_1.17.1.9/" class="md-nav__link">
|
|
|
|
|
|
|
|
<span class="md-ellipsis">
|
|
|
|
|
|
Upgrading 1.17.1.8 to 1.17.1.9
|
|
|
|
|
|
|
|
</span>
|
|
|
|
|
|
|
|
</a>
|
|
</li>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
<li class="md-nav__item">
|
|
<a href="../ota_user_guide/" class="md-nav__link">
|
|
|
|
|
|
|
|
<span class="md-ellipsis">
|
|
|
|
|
|
Ota user guide
|
|
|
|
|
|
|
|
</span>
|
|
|
|
|
|
|
|
</a>
|
|
</li>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
<li class="md-nav__item">
|
|
<a href="../ota_easy/" class="md-nav__link">
|
|
|
|
|
|
|
|
<span class="md-ellipsis">
|
|
|
|
|
|
Ota easy
|
|
|
|
|
|
|
|
</span>
|
|
|
|
|
|
|
|
</a>
|
|
</li>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
<li class="md-nav__item">
|
|
<a href="../lora_ota_automation/" class="md-nav__link">
|
|
|
|
|
|
|
|
<span class="md-ellipsis">
|
|
|
|
|
|
Lora ota automation
|
|
|
|
|
|
|
|
</span>
|
|
|
|
|
|
|
|
</a>
|
|
</li>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
<li class="md-nav__item">
|
|
<a href="../ota_nrf52_bootloader_update/" class="md-nav__link">
|
|
|
|
|
|
|
|
<span class="md-ellipsis">
|
|
|
|
|
|
Ota nrf52 bootloader update
|
|
|
|
|
|
|
|
</span>
|
|
|
|
|
|
|
|
</a>
|
|
</li>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
<li class="md-nav__item">
|
|
<a href="../ota_nrf52_qspi/" class="md-nav__link">
|
|
|
|
|
|
|
|
<span class="md-ellipsis">
|
|
|
|
|
|
Ota nrf52 qspi
|
|
|
|
|
|
|
|
</span>
|
|
|
|
|
|
|
|
</a>
|
|
</li>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
<li class="md-nav__item">
|
|
<a href="../ota_meshtower_v2_sdcard/" class="md-nav__link">
|
|
|
|
|
|
|
|
<span class="md-ellipsis">
|
|
|
|
|
|
Ota meshtower v2 sdcard
|
|
|
|
|
|
|
|
</span>
|
|
|
|
|
|
|
|
</a>
|
|
</li>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
<li class="md-nav__item">
|
|
<a href="../esp32_partition_catalog/" class="md-nav__link">
|
|
|
|
|
|
|
|
<span class="md-ellipsis">
|
|
|
|
|
|
Esp32 partition catalog
|
|
|
|
|
|
|
|
</span>
|
|
|
|
|
|
|
|
</a>
|
|
</li>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
<li class="md-nav__item">
|
|
<a href="../esp32_wifi_partition_migration/" class="md-nav__link">
|
|
|
|
|
|
|
|
<span class="md-ellipsis">
|
|
|
|
|
|
Esp32 wifi partition migration
|
|
|
|
|
|
|
|
</span>
|
|
|
|
|
|
|
|
</a>
|
|
</li>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
<li class="md-nav__item">
|
|
<a href="../heltec_v4_wifi_partition_migration/" class="md-nav__link">
|
|
|
|
|
|
|
|
<span class="md-ellipsis">
|
|
|
|
|
|
Heltec v4 wifi partition migration
|
|
|
|
|
|
|
|
</span>
|
|
|
|
|
|
|
|
</a>
|
|
</li>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
<li class="md-nav__item">
|
|
<a href="../host_cli_service/" class="md-nav__link">
|
|
|
|
|
|
|
|
<span class="md-ellipsis">
|
|
|
|
|
|
Host cli service
|
|
|
|
|
|
|
|
</span>
|
|
|
|
|
|
|
|
</a>
|
|
</li>
|
|
|
|
|
|
|
|
|
|
</ul>
|
|
</nav>
|
|
|
|
</li>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
<li class="md-nav__item md-nav__item--nested">
|
|
|
|
|
|
|
|
<input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_3_3" >
|
|
|
|
|
|
<label class="md-nav__link" for="__nav_3_3" id="__nav_3_3_label" tabindex="0">
|
|
|
|
|
|
|
|
<span class="md-ellipsis">
|
|
|
|
|
|
Radio, networking, and power
|
|
|
|
|
|
|
|
</span>
|
|
|
|
|
|
|
|
<span class="md-nav__icon md-icon"></span>
|
|
</label>
|
|
|
|
<nav class="md-nav" data-md-level="2" aria-labelledby="__nav_3_3_label" aria-expanded="false">
|
|
<label class="md-nav__title" for="__nav_3_3">
|
|
<span class="md-nav__icon md-icon"></span>
|
|
|
|
|
|
Radio, networking, and power
|
|
|
|
|
|
</label>
|
|
<ul class="md-nav__list" data-md-scrollfix>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
<li class="md-nav__item">
|
|
<a href="../radio_profiles/" class="md-nav__link">
|
|
|
|
|
|
|
|
<span class="md-ellipsis">
|
|
|
|
|
|
Radio profiles
|
|
|
|
|
|
|
|
</span>
|
|
|
|
|
|
|
|
</a>
|
|
</li>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
<li class="md-nav__item">
|
|
<a href="../fleet_management/" class="md-nav__link">
|
|
|
|
|
|
|
|
<span class="md-ellipsis">
|
|
|
|
|
|
Private fleet management
|
|
|
|
|
|
|
|
</span>
|
|
|
|
|
|
|
|
</a>
|
|
</li>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
<li class="md-nav__item">
|
|
<a href="../room_services/" class="md-nav__link">
|
|
|
|
|
|
|
|
<span class="md-ellipsis">
|
|
|
|
|
|
Room services
|
|
|
|
|
|
|
|
</span>
|
|
|
|
|
|
|
|
</a>
|
|
</li>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
<li class="md-nav__item">
|
|
<a href="../carrier_wave/" class="md-nav__link">
|
|
|
|
|
|
|
|
<span class="md-ellipsis">
|
|
|
|
|
|
Carrier wave
|
|
|
|
|
|
|
|
</span>
|
|
|
|
|
|
|
|
</a>
|
|
</li>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
<li class="md-nav__item">
|
|
<a href="../espnow_bridge_setup/" class="md-nav__link">
|
|
|
|
|
|
|
|
<span class="md-ellipsis">
|
|
|
|
|
|
Espnow bridge setup
|
|
|
|
|
|
|
|
</span>
|
|
|
|
|
|
|
|
</a>
|
|
</li>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
<li class="md-nav__item">
|
|
<a href="../WiFi/" class="md-nav__link">
|
|
|
|
|
|
|
|
<span class="md-ellipsis">
|
|
|
|
|
|
WiFi
|
|
|
|
|
|
|
|
</span>
|
|
|
|
|
|
|
|
</a>
|
|
</li>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
<li class="md-nav__item">
|
|
<a href="../flood_filtering/" class="md-nav__link">
|
|
|
|
|
|
|
|
<span class="md-ellipsis">
|
|
|
|
|
|
Flood filtering
|
|
|
|
|
|
|
|
</span>
|
|
|
|
|
|
|
|
</a>
|
|
</li>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
<li class="md-nav__item">
|
|
<a href="../gps_tracking/" class="md-nav__link">
|
|
|
|
|
|
|
|
<span class="md-ellipsis">
|
|
|
|
|
|
Gps tracking
|
|
|
|
|
|
|
|
</span>
|
|
|
|
|
|
|
|
</a>
|
|
</li>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
<li class="md-nav__item">
|
|
<a href="../nrf52_power_management/" class="md-nav__link">
|
|
|
|
|
|
|
|
<span class="md-ellipsis">
|
|
|
|
|
|
Nrf52 power management
|
|
|
|
|
|
|
|
</span>
|
|
|
|
|
|
|
|
</a>
|
|
</li>
|
|
|
|
|
|
|
|
|
|
</ul>
|
|
</nav>
|
|
|
|
</li>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
<li class="md-nav__item md-nav__item--active md-nav__item--nested">
|
|
|
|
|
|
|
|
<input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_3_4" checked>
|
|
|
|
|
|
<label class="md-nav__link" for="__nav_3_4" id="__nav_3_4_label" tabindex="0">
|
|
|
|
|
|
|
|
<span class="md-ellipsis">
|
|
|
|
|
|
CLI and protocol reference
|
|
|
|
|
|
|
|
</span>
|
|
|
|
|
|
|
|
<span class="md-nav__icon md-icon"></span>
|
|
</label>
|
|
|
|
<nav class="md-nav" data-md-level="2" aria-labelledby="__nav_3_4_label" aria-expanded="true">
|
|
<label class="md-nav__title" for="__nav_3_4">
|
|
<span class="md-nav__icon md-icon"></span>
|
|
|
|
|
|
CLI and protocol reference
|
|
|
|
|
|
</label>
|
|
<ul class="md-nav__list" data-md-scrollfix>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
<li class="md-nav__item">
|
|
<a href="../cli_commands/" class="md-nav__link">
|
|
|
|
|
|
|
|
<span class="md-ellipsis">
|
|
|
|
|
|
Cli commands
|
|
|
|
|
|
|
|
</span>
|
|
|
|
|
|
|
|
</a>
|
|
</li>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
<li class="md-nav__item">
|
|
<a href="../cli_build_matrix/" class="md-nav__link">
|
|
|
|
|
|
|
|
<span class="md-ellipsis">
|
|
|
|
|
|
Cli build matrix
|
|
|
|
|
|
|
|
</span>
|
|
|
|
|
|
|
|
</a>
|
|
</li>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
<li class="md-nav__item">
|
|
<a href="../cli_command_availability/" class="md-nav__link">
|
|
|
|
|
|
|
|
<span class="md-ellipsis">
|
|
|
|
|
|
Cli command availability
|
|
|
|
|
|
|
|
</span>
|
|
|
|
|
|
|
|
</a>
|
|
</li>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
<li class="md-nav__item">
|
|
<a href="../terminal_chat_cli/" class="md-nav__link">
|
|
|
|
|
|
|
|
<span class="md-ellipsis">
|
|
|
|
|
|
Terminal chat cli
|
|
|
|
|
|
|
|
</span>
|
|
|
|
|
|
|
|
</a>
|
|
</li>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
<li class="md-nav__item">
|
|
<a href="../companion_protocol/" class="md-nav__link">
|
|
|
|
|
|
|
|
<span class="md-ellipsis">
|
|
|
|
|
|
Companion protocol
|
|
|
|
|
|
|
|
</span>
|
|
|
|
|
|
|
|
</a>
|
|
</li>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
<li class="md-nav__item">
|
|
<a href="../kiss_modem_protocol/" class="md-nav__link">
|
|
|
|
|
|
|
|
<span class="md-ellipsis">
|
|
|
|
|
|
Kiss modem protocol
|
|
|
|
|
|
|
|
</span>
|
|
|
|
|
|
|
|
</a>
|
|
</li>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
<li class="md-nav__item">
|
|
<a href="../packet_format/" class="md-nav__link">
|
|
|
|
|
|
|
|
<span class="md-ellipsis">
|
|
|
|
|
|
Packet format
|
|
|
|
|
|
|
|
</span>
|
|
|
|
|
|
|
|
</a>
|
|
</li>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
<li class="md-nav__item">
|
|
<a href="../payloads/" class="md-nav__link">
|
|
|
|
|
|
|
|
<span class="md-ellipsis">
|
|
|
|
|
|
Payloads
|
|
|
|
|
|
|
|
</span>
|
|
|
|
|
|
|
|
</a>
|
|
</li>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
<li class="md-nav__item">
|
|
<a href="../ota_protocol/" class="md-nav__link">
|
|
|
|
|
|
|
|
<span class="md-ellipsis">
|
|
|
|
|
|
Ota protocol
|
|
|
|
|
|
|
|
</span>
|
|
|
|
|
|
|
|
</a>
|
|
</li>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
<li class="md-nav__item md-nav__item--active">
|
|
|
|
<input class="md-nav__toggle md-toggle" type="checkbox" id="__toc">
|
|
|
|
|
|
|
|
|
|
|
|
<label class="md-nav__link md-nav__link--active" for="__toc">
|
|
|
|
|
|
|
|
<span class="md-ellipsis">
|
|
|
|
|
|
Management reports
|
|
|
|
|
|
|
|
</span>
|
|
|
|
|
|
|
|
<span class="md-nav__icon md-icon"></span>
|
|
</label>
|
|
|
|
<a href="./" class="md-nav__link md-nav__link--active">
|
|
|
|
|
|
|
|
<span class="md-ellipsis">
|
|
|
|
|
|
Management reports
|
|
|
|
|
|
|
|
</span>
|
|
|
|
|
|
|
|
</a>
|
|
|
|
|
|
|
|
<nav class="md-nav md-nav--secondary" aria-label="Table of contents">
|
|
|
|
|
|
|
|
|
|
|
|
|
|
<label class="md-nav__title" for="__toc">
|
|
<span class="md-nav__icon md-icon"></span>
|
|
Table of contents
|
|
</label>
|
|
<ul class="md-nav__list" data-md-component="toc" data-md-scrollfix>
|
|
|
|
<li class="md-nav__item">
|
|
<a href="#cli" class="md-nav__link">
|
|
<span class="md-ellipsis">
|
|
|
|
CLI
|
|
|
|
</span>
|
|
</a>
|
|
|
|
</li>
|
|
|
|
<li class="md-nav__item">
|
|
<a href="#routing-and-mqtt" class="md-nav__link">
|
|
<span class="md-ellipsis">
|
|
|
|
Routing and MQTT
|
|
|
|
</span>
|
|
</a>
|
|
|
|
</li>
|
|
|
|
<li class="md-nav__item">
|
|
<a href="#canonical-mgr2-payload-little-endian" class="md-nav__link">
|
|
<span class="md-ellipsis">
|
|
|
|
Canonical MGR2 payload (little endian)
|
|
|
|
</span>
|
|
</a>
|
|
|
|
</li>
|
|
|
|
<li class="md-nav__item">
|
|
<a href="#cryptography" class="md-nav__link">
|
|
<span class="md-ellipsis">
|
|
|
|
Cryptography
|
|
|
|
</span>
|
|
</a>
|
|
|
|
</li>
|
|
|
|
</ul>
|
|
|
|
</nav>
|
|
|
|
</li>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
<li class="md-nav__item">
|
|
<a href="../stats_binary_frames/" class="md-nav__link">
|
|
|
|
|
|
|
|
<span class="md-ellipsis">
|
|
|
|
|
|
Stats binary frames
|
|
|
|
|
|
|
|
</span>
|
|
|
|
|
|
|
|
</a>
|
|
</li>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
<li class="md-nav__item">
|
|
<a href="../number_allocations/" class="md-nav__link">
|
|
|
|
|
|
|
|
<span class="md-ellipsis">
|
|
|
|
|
|
Number allocations
|
|
|
|
|
|
|
|
</span>
|
|
|
|
|
|
|
|
</a>
|
|
</li>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
<li class="md-nav__item">
|
|
<a href="../qr_codes/" class="md-nav__link">
|
|
|
|
|
|
|
|
<span class="md-ellipsis">
|
|
|
|
|
|
Qr codes
|
|
|
|
|
|
|
|
</span>
|
|
|
|
|
|
|
|
</a>
|
|
</li>
|
|
|
|
|
|
|
|
|
|
</ul>
|
|
</nav>
|
|
|
|
</li>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
<li class="md-nav__item">
|
|
<a href="../docs/" class="md-nav__link">
|
|
|
|
|
|
|
|
<span class="md-ellipsis">
|
|
|
|
|
|
Docs
|
|
|
|
|
|
|
|
</span>
|
|
|
|
|
|
|
|
</a>
|
|
</li>
|
|
|
|
|
|
|
|
|
|
</ul>
|
|
</nav>
|
|
|
|
</li>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
<li class="md-nav__item">
|
|
<a href="../research/" class="md-nav__link">
|
|
|
|
|
|
|
|
<span class="md-ellipsis">
|
|
|
|
|
|
Research
|
|
|
|
|
|
|
|
</span>
|
|
|
|
|
|
|
|
</a>
|
|
</li>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
<li class="md-nav__item md-nav__item--nested">
|
|
|
|
|
|
|
|
<input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5" >
|
|
|
|
|
|
<label class="md-nav__link" for="__nav_5" id="__nav_5_label" tabindex="0">
|
|
|
|
|
|
|
|
<span class="md-ellipsis">
|
|
|
|
|
|
Releases
|
|
|
|
|
|
|
|
</span>
|
|
|
|
|
|
|
|
<span class="md-nav__icon md-icon"></span>
|
|
</label>
|
|
|
|
<nav class="md-nav" data-md-level="1" aria-labelledby="__nav_5_label" aria-expanded="false">
|
|
<label class="md-nav__title" for="__nav_5">
|
|
<span class="md-nav__icon md-icon"></span>
|
|
|
|
|
|
Releases
|
|
|
|
|
|
</label>
|
|
<ul class="md-nav__list" data-md-scrollfix>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
<li class="md-nav__item md-nav__item--nested">
|
|
|
|
|
|
|
|
<input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_1" >
|
|
|
|
|
|
<label class="md-nav__link" for="__nav_5_1" id="__nav_5_1_label" tabindex="0">
|
|
|
|
|
|
|
|
<span class="md-ellipsis">
|
|
|
|
|
|
Current release
|
|
|
|
|
|
|
|
</span>
|
|
|
|
|
|
|
|
<span class="md-nav__icon md-icon"></span>
|
|
</label>
|
|
|
|
<nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_1_label" aria-expanded="false">
|
|
<label class="md-nav__title" for="__nav_5_1">
|
|
<span class="md-nav__icon md-icon"></span>
|
|
|
|
|
|
Current release
|
|
|
|
|
|
</label>
|
|
<ul class="md-nav__list" data-md-scrollfix>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
<li class="md-nav__item">
|
|
<a href="../releases/1.17.1.9/" class="md-nav__link">
|
|
|
|
|
|
|
|
<span class="md-ellipsis">
|
|
|
|
|
|
1.17.1.9 USA Cascade
|
|
|
|
|
|
|
|
</span>
|
|
|
|
|
|
|
|
</a>
|
|
</li>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
<li class="md-nav__item">
|
|
<a href="../releases/1.17.1.8/" class="md-nav__link">
|
|
|
|
|
|
|
|
<span class="md-ellipsis">
|
|
|
|
|
|
1.17.1.8 USA Cascade
|
|
|
|
|
|
|
|
</span>
|
|
|
|
|
|
|
|
</a>
|
|
</li>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
<li class="md-nav__item">
|
|
<a href="../test-results/" class="md-nav__link">
|
|
|
|
|
|
|
|
<span class="md-ellipsis">
|
|
|
|
|
|
Test Results
|
|
|
|
|
|
|
|
</span>
|
|
|
|
|
|
|
|
</a>
|
|
</li>
|
|
|
|
|
|
|
|
|
|
</ul>
|
|
</nav>
|
|
|
|
</li>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
<li class="md-nav__item">
|
|
<a href="../old-releases/" class="md-nav__link">
|
|
|
|
|
|
|
|
<span class="md-ellipsis">
|
|
|
|
|
|
Old Releases
|
|
|
|
|
|
|
|
</span>
|
|
|
|
|
|
|
|
</a>
|
|
</li>
|
|
|
|
|
|
|
|
|
|
</ul>
|
|
</nav>
|
|
|
|
</li>
|
|
|
|
|
|
|
|
</ul>
|
|
</nav>
|
|
</div>
|
|
</div>
|
|
</div>
|
|
|
|
|
|
|
|
<div class="md-sidebar md-sidebar--secondary" data-md-component="sidebar" data-md-type="toc" >
|
|
<div class="md-sidebar__scrollwrap">
|
|
<div class="md-sidebar__inner">
|
|
|
|
|
|
<nav class="md-nav md-nav--secondary" aria-label="Table of contents">
|
|
|
|
|
|
|
|
|
|
|
|
|
|
<label class="md-nav__title" for="__toc">
|
|
<span class="md-nav__icon md-icon"></span>
|
|
Table of contents
|
|
</label>
|
|
<ul class="md-nav__list" data-md-component="toc" data-md-scrollfix>
|
|
|
|
<li class="md-nav__item">
|
|
<a href="#cli" class="md-nav__link">
|
|
<span class="md-ellipsis">
|
|
|
|
CLI
|
|
|
|
</span>
|
|
</a>
|
|
|
|
</li>
|
|
|
|
<li class="md-nav__item">
|
|
<a href="#routing-and-mqtt" class="md-nav__link">
|
|
<span class="md-ellipsis">
|
|
|
|
Routing and MQTT
|
|
|
|
</span>
|
|
</a>
|
|
|
|
</li>
|
|
|
|
<li class="md-nav__item">
|
|
<a href="#canonical-mgr2-payload-little-endian" class="md-nav__link">
|
|
<span class="md-ellipsis">
|
|
|
|
Canonical MGR2 payload (little endian)
|
|
|
|
</span>
|
|
</a>
|
|
|
|
</li>
|
|
|
|
<li class="md-nav__item">
|
|
<a href="#cryptography" class="md-nav__link">
|
|
<span class="md-ellipsis">
|
|
|
|
Cryptography
|
|
|
|
</span>
|
|
</a>
|
|
|
|
</li>
|
|
|
|
</ul>
|
|
|
|
</nav>
|
|
</div>
|
|
</div>
|
|
</div>
|
|
|
|
|
|
|
|
<div class="md-content" data-md-component="content">
|
|
|
|
<article class="md-content__inner md-typeset">
|
|
|
|
|
|
|
|
|
|
|
|
<a href="https://github.com/mikecarper/MeshCore/edit/keymindCascade/docs/management_reports.md" title="Edit this page" class="md-content__button md-icon" rel="edit">
|
|
|
|
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M10 20H6V4h7v5h5v3.1l2-2V8l-6-6H6c-1.1 0-2 .9-2 2v16c0 1.1.9 2 2 2h4zm10.2-7c.1 0 .3.1.4.2l1.3 1.3c.2.2.2.6 0 .8l-1 1-2.1-2.1 1-1c.1-.1.2-.2.4-.2m0 3.9L14.1 23H12v-2.1l6.1-6.1z"/></svg>
|
|
</a>
|
|
|
|
|
|
|
|
|
|
<!-- meshcore-hosted-doc-link:start -->
|
|
<p class="meshcore-hosted-doc-link"><a href="https://mikecarper.github.io/MeshCore/management_reports/">View this page on MeshCore Docs</a>.</p>
|
|
<!-- meshcore-hosted-doc-link:end -->
|
|
|
|
<h1 id="management-reports-mgr1mgr2">Management reports (MGR1/MGR2)</h1>
|
|
<p>Available on repeater (including observer), room-server and sensor firmware.
|
|
Companions/terminal-chat nodes and KISS modems do not originate these reports.
|
|
Off by default. A management password and explicit enable are both required.
|
|
No radio settings, existing preferences layout, or OTA authorization policy is
|
|
changed by enabling reporting. This protocol does <strong>not</strong> authorize updates.</p>
|
|
<p>Current firmware emits <code>MGR2</code>, including a public USB logging/recovery snapshot
|
|
and its latest watchdog event. Updated decoders still accept released <code>MGR1</code>;
|
|
older decoder copies need an update to read MGR2. The earlier USB-only MGR2
|
|
development layout was never released and was replaced before release.
|
|
Reporting USB status does not enable logging or change retry policy.</p>
|
|
<h2 id="cli">CLI</h2>
|
|
<p>Run through the existing local CLI or an authenticated administrator session:</p>
|
|
<pre><code>get data.tx
|
|
set data.tx path 1:12ab77
|
|
set data.tx region auto
|
|
set mgmt.password <12-to-96-byte password>
|
|
set mgmt.direct 5
|
|
set mgmt.flood 21
|
|
set mgmt.enabled on
|
|
get mgmt
|
|
set mgmt.enabled off
|
|
</code></pre>
|
|
<p>Use a long randomly generated password. There is no password getter. Firmware
|
|
stores the derived 32-byte key, not the plaintext password. That stored key is
|
|
equivalent authority to decrypt reports and must also be protected. Passwords
|
|
entered into terminal programs may still be recorded by those programs.
|
|
The recognized firmware password command wipes its value from the input buffer
|
|
on success and error, including unavailable management or allocation failure.</p>
|
|
<p><code>data.tx</code> is the single shared route for management reports, telemetry history,
|
|
and future scheduled data producers. Its fresh-install defaults are <code>path=direct</code>
|
|
(zero hops) and <code>region=auto</code>; configuring it never enables a producer. Paths
|
|
use <code>1:</code>, <code>2:</code> or <code>3:</code> followed by complete hop hashes without separators, or
|
|
the comma-separated form accepted by <code>set outpath</code>. Empty hops, including a
|
|
trailing comma, are rejected. <code>none</code> removes the path.
|
|
<code>get/set mgmt.path</code> remain compatibility aliases for <code>get/set data.tx path</code>.
|
|
Alias expansion that exceeds the command buffer is rejected, not truncated.</p>
|
|
<p><code>region=auto</code> uses the radio's configured default region when it is usable;
|
|
otherwise it resolves the unique deepest flood-enabled entry in the region
|
|
hierarchy. If equally deep candidates make that choice ambiguous, it resolves
|
|
to nothing and no fallback is transmitted. <code>default</code> requires and follows
|
|
<code>region default</code>; a region name pins that named scope. <code>none</code> disables scoped fallback. The
|
|
resolved transport key is looked up when a report starts, so edits to the region
|
|
definition take effect without rewriting <code>/data_tx</code>.</p>
|
|
<p>The direct path leads to the receiver/uplink's vicinity; this broadcast-radio
|
|
datagram has no private destination identity. The radio ID in the payload
|
|
identifies the reporter.</p>
|
|
<p>Direct and flood schedules are independently configurable and may each be
|
|
turned off. Fresh settings are <code>direct=5d</code> and <code>flood=21d</code>; global reporting is
|
|
still off until <code>mgmt.enabled on</code>. Direct accepts 5-90 days and requires the
|
|
shared path. Flood accepts 21-90 days and requires a resolvable shared region.
|
|
At least one route must remain active while reporting is enabled. The legacy
|
|
<code>set mgmt.interval N</code> shorthand enables both, setting direct to <code>N</code> and flood to
|
|
<code>max(21,N)</code>. No transmission is sent merely by configuring a password. Initial
|
|
reporting waits for the configured schedules. Invalid settings leave saved
|
|
configuration, countdowns, and any report pages already in progress unchanged.
|
|
Day counts must be unsigned decimal integers; signs and trailing text are rejected.
|
|
Reports have deterministic
|
|
per-radio/per-sequence jitter of up to an hour; pages are spaced at least a
|
|
minute apart. Watchdog events appear in the next scheduled snapshot, not as
|
|
immediate radio alerts. Multiple events between snapshots can replace the
|
|
latest-event record; this is not a complete off-node event history.</p>
|
|
<p>The radio cannot know that an observer uploaded a packet to MQTT, so the flood
|
|
schedule is deliberately independent of direct transmission. A region-scoped
|
|
<code>TRANSPORT_FLOOD</code> is sent at its independently configured interval. An
|
|
unresolved or ambiguous data region blocks that transmission
|
|
rather than sending an unscoped flood. If direct and flood become due together,
|
|
the flood is sent and replaces the redundant direct copy.
|
|
Ordinary reports are never retried in a tight loop; a partial report gives up
|
|
after an hour. Existing relay filters, hop limits and duty constraints still apply.</p>
|
|
<p>Schedule state is atomically reserved <strong>before</strong> transmission, and checkpointed
|
|
hourly. Timers use elapsed powered-on time rather than the RTC: clock corrections
|
|
cannot create floods, and reboot does not clear the budget. Downtime is not
|
|
credited; each reboot can delay a report by up to an additional hour. This is a
|
|
deliberately conservative tradeoff for nodes with unreliable clocks. Off/on and
|
|
password changes do not reset the flood limit. Corrupt/unreadable state or failed
|
|
writes stop reporting; <code>get mgmt</code> shows <code>FAULT(no TX)</code> until storage is repaired
|
|
and the radio restarted. <code>/management</code> and the shared <code>/data_tx</code> are versioned,
|
|
CRC-protected, and replaced transactionally.</p>
|
|
<p>On upgrade, an existing saved <code>data.tx</code> route takes precedence over the legacy
|
|
management-only path. Otherwise that path must be saved successfully to
|
|
<code>/data_tx</code> before reporting resumes. A failed migration leaves the old
|
|
<code>/management</code> file intact for retry after storage is repaired and the radio
|
|
restarted.</p>
|
|
<p>Weekly history is collected once a minute while enabled. Hour-bucket extrema
|
|
cover 7 days to 7 days + 1 hour (conservative boundary bucket). The first report
|
|
after enable/reboot is marked partial where appropriate. Since-report extrema
|
|
reset after all pages have been queued, retaining readings taken since the
|
|
snapshot for the next report. These statistics are not durable;
|
|
reboot loses the history, not the flood countdown. Temperature is MCU temperature,
|
|
not ambient. Reporting does not wake GPS, start Wi-Fi, or initialize external OTA
|
|
media. Unknown capabilities/readiness are explicitly distinguishable from false.
|
|
History/snapshot working memory is allocated only when reporting is enabled and
|
|
is bounded to 1.5 KiB, plus a small configuration object and temporary stack use.</p>
|
|
<h2 id="routing-and-mqtt">Routing and MQTT</h2>
|
|
<p>Both direct/path and flood reports use <strong><code>PAYLOAD_TYPE_GRP_DATA</code> (<code>0x06</code>)</strong>.
|
|
The route bits independently select direct or flood. <code>MGR1</code>/<code>MGR2</code> are application
|
|
extensions with <strong>literally plaintext public fields</strong>, not a call to the ordinary
|
|
encrypted <code>createGroupDatagram()</code> builder. A fixed public marker is not an owner
|
|
or password-derived channel ID. There is no outer channel encryption.</p>
|
|
<p>The body is padded with zeroes to a group-compatible length <code>3 + 16*n</code> (maximum
|
|
179 bytes). Existing repeaters in the checked upstream implementation route group
|
|
data without requiring a successful channel decryption. This fork recognizes the
|
|
management envelope before ordinary channel processing. Reception of a management
|
|
packet never exempts it from forwarding policy. Some third-party firmware may
|
|
apply additional channel/layout policies; interoperability with every fork is
|
|
not guaranteed. Packet logging/uplinks can capture it without the password.</p>
|
|
<p><code>RAW_CUSTOM</code> (<code>0x0F</code>) is <strong>not used for reports</strong> because stock upstream does
|
|
not flood-route it.</p>
|
|
<p>The observer's existing MQTT <code>PACKET</code> JSON supplies the complete frame in <code>raw</code>.
|
|
No broker configuration or password changes are necessary to capture a report.
|
|
The decoder understands all four route forms, 1-3-byte hashes, scope transport
|
|
codes, and duplicate copies heard by several uplinks:</p>
|
|
<pre><code>python -m pip install -r tools/management/requirements.txt
|
|
python tools/management/report.py --mqtt capture.jsonl
|
|
</code></pre>
|
|
<p>The password is prompted, not supplied as a process argument. Input may be JSONL
|
|
or a JSON array of MQTT messages. Alternatively omit <code>--mqtt</code> for a JSON array
|
|
of canonical payload hex strings. <code>--match-admin FULL_PUBLIC_KEY</code> matches a known
|
|
administrator against the encrypted fingerprints in either input mode. MQTT
|
|
captures match each radio's fingerprints separately. Invalid files or keys are
|
|
rejected before the password prompt; an unavailable password input gives a
|
|
command-line error instead of a traceback.
|
|
This is an offline capture decoder, not a broker subscriber or downlink service.</p>
|
|
<p>For a browser-local decoder that also decrypts and authenticates ACL entries,
|
|
use the <a href="../management_decoder/">Management report decoder</a>. It does not upload
|
|
the captured packet or password.</p>
|
|
<h2 id="canonical-mgr2-payload-little-endian">Canonical MGR2 payload (little endian)</h2>
|
|
<table>
|
|
<thead>
|
|
<tr>
|
|
<th style="text-align: right;">Offset</th>
|
|
<th style="text-align: right;">Bytes</th>
|
|
<th>Field</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody>
|
|
<tr>
|
|
<td style="text-align: right;">0</td>
|
|
<td style="text-align: right;">4</td>
|
|
<td><code>MGR2</code></td>
|
|
</tr>
|
|
<tr>
|
|
<td style="text-align: right;">4</td>
|
|
<td style="text-align: right;">16</td>
|
|
<td>First 16 bytes of reporter public key</td>
|
|
</tr>
|
|
<tr>
|
|
<td style="text-align: right;">20</td>
|
|
<td style="text-align: right;">4</td>
|
|
<td>Persisted report sequence (never wraps; exhaustion stops TX)</td>
|
|
</tr>
|
|
<tr>
|
|
<td style="text-align: right;">24</td>
|
|
<td style="text-align: right;">4</td>
|
|
<td>RTC Unix timestamp; advisory, may be wrong</td>
|
|
</tr>
|
|
<tr>
|
|
<td style="text-align: right;">28</td>
|
|
<td style="text-align: right;">4</td>
|
|
<td>Firmware major/minor/patch/pre packed as mOTA version</td>
|
|
</tr>
|
|
<tr>
|
|
<td style="text-align: right;">32</td>
|
|
<td style="text-align: right;">4</td>
|
|
<td>Bootloader packed version, or unknown</td>
|
|
</tr>
|
|
<tr>
|
|
<td style="text-align: right;">36</td>
|
|
<td style="text-align: right;">4</td>
|
|
<td>EndF target ID</td>
|
|
</tr>
|
|
<tr>
|
|
<td style="text-align: right;">40</td>
|
|
<td style="text-align: right;">8</td>
|
|
<td>Complete mOTA delta-base body hash</td>
|
|
</tr>
|
|
<tr>
|
|
<td style="text-align: right;">48</td>
|
|
<td style="text-align: right;">4</td>
|
|
<td>EndF image length</td>
|
|
</tr>
|
|
<tr>
|
|
<td style="text-align: right;">52</td>
|
|
<td style="text-align: right;">4</td>
|
|
<td>Staging capacity; planning still checks actual package geometry</td>
|
|
</tr>
|
|
<tr>
|
|
<td style="text-align: right;">56</td>
|
|
<td style="text-align: right;">4</td>
|
|
<td>OTA capability bits</td>
|
|
</tr>
|
|
<tr>
|
|
<td style="text-align: right;">60</td>
|
|
<td style="text-align: right;">2</td>
|
|
<td>Uptime hours, saturated at 65535</td>
|
|
</tr>
|
|
<tr>
|
|
<td style="text-align: right;">62</td>
|
|
<td style="text-align: right;">4</td>
|
|
<td>Weekly minimum mV, minimum C, maximum C</td>
|
|
</tr>
|
|
<tr>
|
|
<td style="text-align: right;">66</td>
|
|
<td style="text-align: right;">4</td>
|
|
<td>Since-report extrema in the same format</td>
|
|
</tr>
|
|
<tr>
|
|
<td style="text-align: right;">70</td>
|
|
<td style="text-align: right;">1</td>
|
|
<td>History coverage hours, capped at 168</td>
|
|
</tr>
|
|
<tr>
|
|
<td style="text-align: right;">71</td>
|
|
<td style="text-align: right;">1</td>
|
|
<td>Interval days for this report's direct or flood schedule</td>
|
|
</tr>
|
|
<tr>
|
|
<td style="text-align: right;">72</td>
|
|
<td style="text-align: right;">1</td>
|
|
<td>Role: 1 repeater, 2 room server, 3 sensor</td>
|
|
</tr>
|
|
<tr>
|
|
<td style="text-align: right;">73</td>
|
|
<td style="text-align: right;">1</td>
|
|
<td>Compiled/detected capability bits</td>
|
|
</tr>
|
|
<tr>
|
|
<td style="text-align: right;">74</td>
|
|
<td style="text-align: right;">1</td>
|
|
<td>Active status bits</td>
|
|
</tr>
|
|
<tr>
|
|
<td style="text-align: right;">75</td>
|
|
<td style="text-align: right;">1</td>
|
|
<td>Mask of status bits whose state is known</td>
|
|
</tr>
|
|
<tr>
|
|
<td style="text-align: right;">76</td>
|
|
<td style="text-align: right;">2</td>
|
|
<td>Validity/partial-history flags</td>
|
|
</tr>
|
|
<tr>
|
|
<td style="text-align: right;">78</td>
|
|
<td style="text-align: right;">1</td>
|
|
<td>Zero-based page index</td>
|
|
</tr>
|
|
<tr>
|
|
<td style="text-align: right;">79</td>
|
|
<td style="text-align: right;">1</td>
|
|
<td>Total pages (1-9)</td>
|
|
</tr>
|
|
<tr>
|
|
<td style="text-align: right;">80</td>
|
|
<td style="text-align: right;">1</td>
|
|
<td>Unique ACL count (0-36)</td>
|
|
</tr>
|
|
<tr>
|
|
<td style="text-align: right;">81</td>
|
|
<td style="text-align: right;">1</td>
|
|
<td>First ACL index in this page</td>
|
|
</tr>
|
|
<tr>
|
|
<td style="text-align: right;">82</td>
|
|
<td style="text-align: right;">1</td>
|
|
<td>ACL entries on this page (0-4)</td>
|
|
</tr>
|
|
<tr>
|
|
<td style="text-align: right;">83</td>
|
|
<td style="text-align: right;">2</td>
|
|
<td>USB status flags</td>
|
|
</tr>
|
|
<tr>
|
|
<td style="text-align: right;">85</td>
|
|
<td style="text-align: right;">1</td>
|
|
<td>Packed USB recovery stage and retry backoff step</td>
|
|
</tr>
|
|
<tr>
|
|
<td style="text-align: right;">86</td>
|
|
<td style="text-align: right;">4</td>
|
|
<td>USB full-reboot retry interval seconds</td>
|
|
</tr>
|
|
<tr>
|
|
<td style="text-align: right;">90</td>
|
|
<td style="text-align: right;">4</td>
|
|
<td>USB inactive seconds</td>
|
|
</tr>
|
|
<tr>
|
|
<td style="text-align: right;">94</td>
|
|
<td style="text-align: right;">4</td>
|
|
<td>USB continuous Auto qualification seconds</td>
|
|
</tr>
|
|
<tr>
|
|
<td style="text-align: right;">98</td>
|
|
<td style="text-align: right;">1</td>
|
|
<td>Latest watchdog reason/action/durability code</td>
|
|
</tr>
|
|
<tr>
|
|
<td style="text-align: right;">99</td>
|
|
<td style="text-align: right;">4</td>
|
|
<td>Latest watchdog event RTC Unix epoch; advisory, zero if unavailable</td>
|
|
</tr>
|
|
<tr>
|
|
<td style="text-align: right;">103</td>
|
|
<td style="text-align: right;">4</td>
|
|
<td>Uptime seconds at that event's boot</td>
|
|
</tr>
|
|
<tr>
|
|
<td style="text-align: right;">107</td>
|
|
<td style="text-align: right;">4</td>
|
|
<td>Latest watchdog event sequence, saturated at 4294967295</td>
|
|
</tr>
|
|
<tr>
|
|
<td style="text-align: right;">111</td>
|
|
<td style="text-align: right;">13 * count</td>
|
|
<td>AES-SIV encrypted ACL entries</td>
|
|
</tr>
|
|
<tr>
|
|
<td style="text-align: right;">after ACL</td>
|
|
<td style="text-align: right;">16</td>
|
|
<td>Full AES-SIV authentication tag</td>
|
|
</tr>
|
|
<tr>
|
|
<td style="text-align: right;">after tag</td>
|
|
<td style="text-align: right;">0-15</td>
|
|
<td>Zero padding to group-compatible length; not part of canonical payload</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
<p>MGR2 retains all 36 ACL entries, using four per page and up to nine pages. The
|
|
largest canonical page is 179 bytes and already group-compatible;
|
|
the radio payload budget is unchanged. The USB snapshot is frozen with the
|
|
other public fields at report start and repeated on each page. It is not a
|
|
live host-health monitor.</p>
|
|
<p>USB flag bits 0-10 are, in order: supported, logging enabled, watchdog enabled,
|
|
host connected, reader connected, stalled, recovering, recovery deferred,
|
|
persistence ready, watchdog Auto, and logger active. Bits 11-15 must be zero.
|
|
Byte 85 bits 0-1 hold stage: 0 idle, 1 soft-recovery wait, 2 re-enumeration
|
|
wait, and 3 reboot pending. Bits 2-5 hold the saved backoff step; bits 6-7
|
|
must be zero. Backoff is not a count of successful recoveries. The three
|
|
timers are unsigned seconds; local recovery/reboot counters are not sent.
|
|
The retry field is the saved backoff interval, not a countdown to an action;
|
|
inactive age is reported separately. USB-only cleanup can precede that interval.
|
|
Unsupported USB observation/recovery is explicitly represented by a false
|
|
supported bit, not omitted or mistaken for a connected healthy reader.
|
|
USB status describes the radio's observed transport and policy, not proof
|
|
that the host process, MQTT uplink, SSH service, or Pi is healthy.
|
|
Host/reader connection alone does not mean a logging client is running.
|
|
The logger-active bit means recent USB stats polling within a 15-minute lease
|
|
while logging is enabled and the observed USB host/reader link is not stalled,
|
|
separate from USB attachment or an open reader. The existing five-minute stats
|
|
polls renew this lease; no new client-registration or heartbeat command is
|
|
required. This does not identify the client, prove logs reached MQTT or disk,
|
|
or show that the Pi remains otherwise healthy.</p>
|
|
<p>Missing watchdog state on new or upgraded installations defaults to Auto.
|
|
Auto promotes to saved On after 14 continuous healthy logging-USB days with
|
|
renewed stats polling; its qualification age resets on reboot, detach, stall,
|
|
stats-lease expiry, or USB logging off.
|
|
Explicit On and Off remain available. Nonlogging/no-reader nodes remain
|
|
Auto without watchdog board reboots. The Auto flag and age report this
|
|
qualification separately from an enabled On policy.
|
|
Use the node's <code>get usb.watchdog</code> and <code>set usb.watchdog off|on|auto</code> CLI to
|
|
inspect or change policy; receiving a management snapshot changes nothing.</p>
|
|
<p>The 13-byte latest-event block is all zero when no event is available. Otherwise
|
|
byte 98 bits 0-3 are the reason mask: host absent, reader absent, TX stalled,
|
|
and confirmed stats client inactive. Bits 4-6 hold the action: 1 software
|
|
recovery attempted, 2 re-enumeration attempted, 3 reboot requested, or 4 reboot
|
|
cancelled after a final health/ownership check. Bit 7 means the event was saved
|
|
and verified on durable storage. Sequence is nonzero for a present event.
|
|
Physical faults may combine reason bits; stats-only expiry cannot authorize a
|
|
board reboot. Epoch zero is allowed when the clock source is unavailable.</p>
|
|
<p>Event time is the node's advisory clock, not verified UTC. Default clocks can
|
|
start at a plausible fixed date. Clock corrections do not rewrite old events;
|
|
recorded uptime and sequence help review them independently. A saved reboot
|
|
request is intent, not proof of a completed reset. The latest event survives
|
|
normal reboot and mode changes, but is not a log of hardware hangs or sudden
|
|
power failures. See <a href="../usb_logging_watchdog/">USB logging watchdog</a> for storage
|
|
failure, cancellation, and review limitations.</p>
|
|
<p>Legacy MGR1 retains the same offsets through byte 82, followed immediately
|
|
by encrypted ACL entries at byte 83 and the authentication tag. It carries
|
|
six entries per page and up to six pages, with no USB block. Its absent USB
|
|
status is decoded as unavailable, not as all switches off.</p>
|
|
<p>Each private entry is a per-radio 12-byte keyed fingerprint followed by flags:
|
|
bit 0 administrator, bit 1 trusted OTA signer. The firmware combines permissions
|
|
for the same fingerprint before paging, so every transmitted entry is unique.
|
|
Decoders reject authenticated duplicate fingerprints within or across pages;
|
|
repeated identical packet copies from multiple uplinks are still deduplicated.
|
|
An oversized ACL fails closed rather than silently truncating. The reported
|
|
allowlist includes all current full administrators and all four possible trusted
|
|
OTA signing keys; region/filter managers and ordinary clients are excluded.</p>
|
|
<p>Feature bits: 0 Wi-Fi, 1 GPS, 2 NTP, 3 USB data, 4 LoRa OTA. Wi-Fi active means
|
|
connected, GPS means receiver enabled (not necessarily a fix), NTP means an
|
|
actual accepted NTP response this boot, USB means observable native USB data
|
|
connection (not power or an unobservable external UART bridge). OTA capability
|
|
means compiled support; active means an established usable apply/store path.</p>
|
|
<p>Validity bits: 0 firmware version, 1 bootloader version, 2 EndF/base identity,
|
|
3 staging capacity, 4 partial week, 5 partial since-report period, 6 MCU temperature.
|
|
Voltage is unsigned millivolts, zero missing. Temperatures: zero missing,
|
|
1-251 represent -50..200 C, 252 below range, 253 above range, 254-255 reserved.
|
|
OTA bits: 0 protocol compiled, 1 transfer DEFLATE, 2 2-KiB app transfer blocks;
|
|
bits 8-23 are apply codec bits (full/sequential/in-place). Transfer DEFLATE is
|
|
not compressed bootloader apply. There is <strong>no manifest ID</strong>. Exact old binaries
|
|
are still needed on the computer to generate a differential update; a hash alone
|
|
cannot reconstruct them. Unknown metadata must not be treated as OTA readiness.</p>
|
|
<h2 id="cryptography">Cryptography</h2>
|
|
<p>Password root: <code>SHA256("#" || literal UTF-8 password)</code> (hashtag-style derivation).
|
|
Subkeys: <code>HMAC-SHA256(root, ASCII_domain || radio_id16)</code>.
|
|
Domains: <code>MeshCore-MGR1-SIV</code>, <code>MeshCore-MGR1-ACL</code>.
|
|
Fingerprint: <code>HMAC-SHA256(ACL_subkey, radio_id16 || full_admin_key32)[0:12]</code>.
|
|
The same owner has different fingerprints on different radios. A collector
|
|
needs a candidate administrator's full key to identify a fingerprint.</p>
|
|
<p>Encryption is <a href="https://www.rfc-editor.org/rfc/rfc5297">RFC 5297 AES-SIV-CMAC-256</a>,
|
|
using the existing rweather AES primitive. The single associated-data string is
|
|
the complete clear header: 111 bytes for MGR2, including USB status and its event,
|
|
or 83 bytes for MGR1. Both retain the existing derivation domains; the authenticated
|
|
magic and layout distinguish their wire versions. Ciphertext is exactly the ACL byte length.
|
|
Full 16-byte tag, no truncation. This deterministic misuse-resistant mode avoids
|
|
reliance on the firmware's noncryptographic general-purpose RNG or RTC nonces.
|
|
An identical restored snapshot may repeat ciphertext, but does not expose XORs
|
|
of different ACL plaintexts as nonce-reused stream encryption would.</p>
|
|
<p>All public fields are readable without a password but are authenticated only to
|
|
password holders. A shared password authenticates knowledge of that password,
|
|
<strong>not</strong> a unique individual radio identity; another holder can forge reports.
|
|
There is no per-device signature. Collectors must enforce their own persisted
|
|
sequence/replay policy and explicitly handle factory resets/restored backups.
|
|
The decoder verifies snapshot consistency but does not maintain a database.
|
|
This fast password derivation permits offline guessing, so twelve characters
|
|
is only a minimum length, not a guarantee of password strength. Packet timing,
|
|
public metadata and entry/page counts remain visible.</p>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
</article>
|
|
</div>
|
|
|
|
|
|
<script>var target=document.getElementById(location.hash.slice(1));target&&target.name&&(target.checked=target.name.startsWith("__tabbed_"))</script>
|
|
</div>
|
|
|
|
</main>
|
|
|
|
<footer class="md-footer">
|
|
|
|
<div class="md-footer-meta md-typeset">
|
|
<div class="md-footer-meta__inner md-grid">
|
|
<div class="md-copyright">
|
|
|
|
|
|
Made with
|
|
<a href="https://squidfunk.github.io/mkdocs-material/" target="_blank" rel="noopener">
|
|
Material for MkDocs
|
|
</a>
|
|
|
|
</div>
|
|
|
|
</div>
|
|
</div>
|
|
</footer>
|
|
|
|
</div>
|
|
<div class="md-dialog" data-md-component="dialog">
|
|
<div class="md-dialog__inner md-typeset"></div>
|
|
</div>
|
|
|
|
|
|
|
|
|
|
|
|
<script id="__config" type="application/json">{"annotate": null, "base": "..", "features": ["content.action.edit", "content.code.copy", "search.highlight", "search.suggest"], "search": "../assets/javascripts/workers/search.2c215733.min.js", "tags": null, "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}, "version": null}</script>
|
|
|
|
|
|
<script src="../assets/javascripts/bundle.d7400e89.min.js"></script>
|
|
|
|
<script src="../_javascript/hosted_doc_links.js?v=20261007-1"></script>
|
|
|
|
<script src="../_javascript/notification_builder.js?v=20261006-channel9"></script>
|
|
|
|
<script src="https://unpkg.com/leaflet@1.9.4/dist/leaflet.js"></script>
|
|
|
|
<script src="../_javascript/firmware_picker.js?v=20261008-rak-uart2-1"></script>
|
|
|
|
<script src="../_javascript/telemetry_decoder.js?v=20261007-hosted-form"></script>
|
|
|
|
<script src="../_javascript/management_decoder.js"></script>
|
|
|
|
<script src="../_javascript/filter_tool.js?v=20261002-hashbytes-2plus"></script>
|
|
|
|
<script src="../_javascript/preset_test.js?v=20260923-2"></script>
|
|
|
|
<script src="../_javascript/esp32_partition_catalog.js?v=20261001-1"></script>
|
|
|
|
|
|
</body>
|
|
</html> |