zBusNet/src/relay/cbf.h

/*
 * Directional contention forwarding, per "Relay Transport and Directional
 * Forwarding" / *Directional contention forwarding*. This milestone only
 * exercises the downstream, DST=0xFF flood case (Beacon traffic), on a
 * single line with one phantom leaf - see topology.h.
 */
#ifndef CBF_H_
#define CBF_H_

#include <stddef.h>
#include <stdint.h>

#include "frame/frame.h"

/* Must be called once at boot. CBF no longer touches the radio directly
 * (see tx_queue.h) - it only restamps TX and submits to the TX queue.
 */
void cbf_init(uint8_t self_id);

/* Feed every received, MAC-verified frame to the CBF engine. hdr is the
 * already-decoded header; raw/raw_len are the full on-air bytes
 * (header+payload+MAC) as received, needed so a scheduled forward can
 * restamp TX and retransmit the same bytes.
 */
void cbf_on_rx(const struct frame_hdr *hdr, const uint8_t *raw, size_t raw_len);

#endif /* CBF_H_ */