blob: 5bae5c3d705622279a68d2bb0e3cbc5cc8a5517d (
plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
|
#ifndef HYBBX_MAX25_H
#define HYBBX_MAX25_H
#include "hybbx/config.h"
#include "hybbx/limits.h"
#include "hybbx/types.h"
#ifdef __cplusplus
extern "C" {
#endif
/** Default max25d TCP listen address. */
#define HYBBX_MAX25_DEFAULT_HOST "127.0.0.1"
typedef struct hybbx_max25_config {
int check;
char host[HYBBX_CONFIG_VALUE_MAX];
unsigned port;
unsigned timeout_ms;
} hybbx_max25_config_t;
/** Snapshot from max25d M25/1 STATUS (read-only; HyBBX never overrides). */
typedef struct hybbx_max25_status {
int handshake_ok;
char error[16];
char voice[16];
char stack[32];
char serial[64];
} hybbx_max25_status_t;
void hybbx_max25_config_defaults(hybbx_max25_config_t *cfg);
/** Load `[max25]` from INI. `check` defaults to `yes`. Reporting is MAX25-only. */
void hybbx_max25_config_apply(hybbx_max25_config_t *cfg,
const hybbx_config_t *config);
/** Parse a semicolon key=value chunk (`max25_check=…` keys). */
void hybbx_max25_config_parse_kv(const char *max25_kv,
hybbx_max25_config_t *cfg);
/**
* When @p config starts with a max25 prefix (before
* @ref HYBBX_PACKET_RADIO_INSTANCE_SEP), parse it and return the remainder.
* When no prefix is present, @p cfg->check is cleared.
*/
const char *hybbx_max25_config_skip_prefix(const char *config,
hybbx_max25_config_t *cfg);
void hybbx_max25_status_clear(hybbx_max25_status_t *status);
/**
* TCP connect + M25/1 connect handshake (`OK` + `STATUS …`).
* Returns @ref HYBBX_OK when max25d responds; @p status_out receives
* `error=` / `voice=` / `stack=` / `serial=` as reported by MAX25 (valid or invalid).
* Data-quality rules (3×20s passes, CALLID, min % good) live in max25d only —
* HyBBX accepts STATUS without override; only TCP/handshake failure is fatal.
*/
hybbx_result_t hybbx_max25_probe(const hybbx_max25_config_t *cfg,
hybbx_max25_status_t *status_out);
/**
* When @p cfg->check is set, block until max25d responds or
* @ref HYBBX_MAX25_PROBE_WAIT_MS elapses.
* Returns @ref HYBBX_OK when max25d is reachable; @ref HYBBX_ERR_IO on timeout.
*/
hybbx_result_t hybbx_max25_wait_ready(const hybbx_max25_config_t *cfg);
#ifdef __cplusplus
}
#endif
#endif /* HYBBX_MAX25_H */
|
