mirror of
https://github.com/cesanta/mongoose.git
synced 2026-11-19 19:40:56 +00:00
Add radio simulation
This commit is contained in:
1 parent
9337a78cd0
commit
d39519b92f
66 files changed
+5659
-1000
No files matched your search
@@ -0,0 +1,80 @@
|
||||
// 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
|
||||
Reference in new issue
Block a user