mirror of
https://github.com/cesanta/mongoose.git
synced 2026-11-17 19:30:36 +00:00
81 lines
3.4 KiB
C
81 lines
3.4 KiB
C
// Copyright (c) 2026 Cesanta Software Limited
|
|
// All rights reserved
|
|
//
|
|
// Ethernet over radio, through a mesh. Mongoose sees an Ethernet interface,
|
|
// the mesh splits Ethernet frames into radio frames. Two parts plug in:
|
|
// - struct mg_radio: a radio standard, e.g. mg_radio_802154
|
|
// - struct mg_mesh: how the mesh is built and routed
|
|
|
|
#pragma once
|
|
|
|
#include "net_builtin.h"
|
|
|
|
#if MG_ENABLE_TCPIP
|
|
|
|
// Monotonic time in microseconds.
|
|
uint64_t mg_micros(void);
|
|
|
|
// A radio standard
|
|
struct mg_radio {
|
|
const char *name; // For logs
|
|
size_t max_frame_size; // Largest radio frame, bytes
|
|
uint32_t bitrate; // Bits per second on air
|
|
size_t overhead; // Bytes on air besides the frame: preamble, FCS
|
|
uint32_t slot_us; // Random backoff slot duration, us
|
|
uint32_t cca_us; // Channel sensing duration, us
|
|
uint32_t turnaround_us; // Idle check to transmission start, us
|
|
uint32_t ifs_us; // Inter-frame spacing in us: gap between transmits
|
|
uint8_t backoff_min; // Initial backoff exponent
|
|
uint8_t backoff_max; // Maximum backoff exponent
|
|
bool csma; // Use channel sensing and backoff before TX
|
|
size_t header_len; // Radio hardware header length
|
|
// Write the radio header, with 0xffff as the broadcast address.
|
|
void (*print_hdr)(const struct mg_radio *radio, uint8_t *buf, uint16_t dst,
|
|
uint16_t src);
|
|
// Return the parsed header length, or zero for an invalid header.
|
|
size_t (*parse_hdr)(const struct mg_radio *radio, const uint8_t *buf,
|
|
size_t len, uint16_t *dst, uint16_t *src);
|
|
};
|
|
|
|
#define MG_802154_HEADER_LEN 9 // MAC header, short addresses
|
|
#define MG_802154_PAN_ID 0xabcd // Our network's PAN ID
|
|
|
|
#ifndef MG_802154_CHANNEL
|
|
#define MG_802154_CHANNEL 15
|
|
#endif
|
|
|
|
extern const struct mg_radio mg_radio_802154;
|
|
|
|
struct mg_mesh_node {
|
|
struct mg_tcpip_if *radio; // Owning radio driver interface
|
|
struct mg_tcpip_if *lan; // Bridge LAN interface, NULL for a client
|
|
const struct mg_mesh *strategy; // Selected strategy
|
|
size_t (*tx)(struct mg_tcpip_if *, const void *, size_t); // Radio frame TX
|
|
size_t rx_len; // Complete Ethernet frame in the interface RX buffer
|
|
uint64_t now; // Current driver poll time, us
|
|
uint64_t tx_at; // Earliest next transmission, us
|
|
void *data; // Private state owned by the strategy
|
|
size_t ram_used; // Live mesh state bytes
|
|
size_t ram_peak; // Peak live mesh state bytes
|
|
uint64_t next_tick; // Next deadline in us, or UINT64_MAX
|
|
uint16_t radio_address; // Local address supplied by the radio
|
|
bool joined; // Client is a member of the mesh
|
|
};
|
|
|
|
struct mg_mesh {
|
|
const char *name;
|
|
bool (*init)(struct mg_mesh_node *node, struct mg_tcpip_if *radio,
|
|
struct mg_tcpip_if *lan, uint16_t radio_address);
|
|
void (*tick)(struct mg_mesh_node *node, uint64_t now_microseconds);
|
|
void (*free)(struct mg_mesh_node *node);
|
|
size_t (*tx)(struct mg_mesh_node *, const void *, size_t); // ETH frame TX
|
|
void (*rx)(struct mg_mesh_node *, void *, size_t); // Radio frame RX
|
|
bool single_bridge; // Require exactly one bridge
|
|
bool scheduled_tx; // The mesh schedules transmission turns
|
|
const struct mg_radio *radio; // Radio configuration for this strategy
|
|
};
|
|
|
|
extern const struct mg_mesh mg_mesh_default;
|
|
|
|
#endif
|