You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
73 lines
3.3 KiB
73 lines
3.3 KiB
/////////////////////////////////////////////////////////////////////////////////// |
|
// Copyright (C) 2026 Tom Hensel <code@jitter.eu> // |
|
// // |
|
// This program is free software; you can redistribute it and/or modify // |
|
// it under the terms of the GNU General Public License as published by // |
|
// the Free Software Foundation as version 3 of the License, or // |
|
// (at your option) any later version. // |
|
// // |
|
// MESHCORE: command-line parser. Translates a single line like // |
|
// // |
|
// MESHCORE: type=advert; name=SDRangelTest; lat=53.55; lon=9.99 // |
|
// MESHCORE: type=txt_msg; dest=<hex64>; text=Hello // |
|
// MESHCORE: type=grp_txt; channel=public; text=Hello group // |
|
// MESHCORE: type=ack; dest=<hex64>; msg_hash=<hex8> // |
|
// // |
|
// into a wire packet (via builders::*) and / or a TxRadioSettings override. // |
|
// // |
|
// Tokens are split on ';'. Each token is a key=value pair (key compared // |
|
// case-insensitively). Whitespace around tokens and around '=' is trimmed. // |
|
/////////////////////////////////////////////////////////////////////////////////// |
|
|
|
#ifndef MODEMMESHCORE_MESHCORE_COMMAND_H_ |
|
#define MODEMMESHCORE_MESHCORE_COMMAND_H_ |
|
|
|
#include <QByteArray> |
|
#include <QMap> |
|
#include <QString> |
|
|
|
#include "export.h" |
|
#include "meshcorepacket.h" |
|
|
|
namespace modemmeshcore |
|
{ |
|
namespace command |
|
{ |
|
|
|
// Tokenize a "key1=val1; key2=val2; ..." string into a case-insensitive map. |
|
// Returns true on parse OK, sets error on malformed input. |
|
MODEMMESHCORE_API bool tokenize( |
|
const QString& body, |
|
QMap<QString, QString>& kv, |
|
QString& error); |
|
|
|
// Apply common radio-param keys (sf, bw, cr, sync, route, freq, preamble) to |
|
// the given TxRadioSettings. Unknown keys are ignored (handled by caller). |
|
// Returns true on success, false on invalid value (sets error). |
|
MODEMMESHCORE_API bool applyRadioParams( |
|
const QMap<QString, QString>& kv, |
|
TxRadioSettings& settings, |
|
QString& error); |
|
|
|
// Build a wire packet from a parsed token map. The "type" key must already |
|
// have been validated by the caller. Sets summary on success. |
|
// |
|
// Required tokens by type: |
|
// advert : seed (hex64). Optional: name, lat, lon, ts, route. |
|
// txt_msg : seed, dest (hex64), text. Optional: txt_type, attempt, ts, route. |
|
// anon_req : seed, dest (hex64), data (hex or text:<utf8>). Optional: ts, route. |
|
// grp_txt : channel_psk (hex16/32) OR channel=public, text. Optional ts, route. |
|
// ack : dest (hex64), msg_hash (hex8). Optional route. |
|
// |
|
// Returns true and fills frame on success, false sets error. |
|
MODEMMESHCORE_API bool buildFrameByType( |
|
const QString& typeName, |
|
const QMap<QString, QString>& kv, |
|
QByteArray& frame, |
|
QString& summary, |
|
QString& error); |
|
|
|
} // namespace command |
|
} // namespace modemmeshcore |
|
|
|
#endif // MODEMMESHCORE_MESHCORE_COMMAND_H_
|
|
|