GoMacH

A traffic-adaptive multi-channel MAC. More...

Detailed Description

A traffic-adaptive multi-channel MAC.

Deprecated:

This module is deprecated and will be removed after the 2024.10 release.

As an alternative MAC layer for IEEE 802.15.4, you can use openDSME - IEEE 802.15.4 DSME.

GoMacH is, "a General, nearly Optimal MAC protocol for multi-Hop communications", for IEEE 802.15.4 IoT/WSNs networks. It is designed to be a traffic adaptive MAC protocol that provides high traffic adaptability, high energy efficiency and high robustness.

GoMacH's main features

• doesn't rely on global synchronization.
• supports for multi-hop and mesh network.
• adopts a duty-cycle scheme to conserve power.
• provides high traffic adaptation for handling burst or dynamic traffics. It achieves this by dynamically allocating transmission slots to intensive senders (that have pending packets), which enables one (or more) sender(s) to burst transmit all of its (their) buffered packets (for the same destination) to the receiver in one shot (or during a shot notice). The burst slotted-transmissions will be ordered by the receiver device in a TDMA period.
• adopts a multi-channel scheme for avoiding/reducing wireless interference jam.

Modules
	GNRC GoMacH compile configuration

Files
file	gomach.h
	Implementation of GoMacH protocol.
file	hdr.h
	Header definition of GoMacH.
file	timeout.h
	Timeout handling of GoMacH.
file	types.h
	Internal used types of GoMacH.
file	gomach_internal.h
	GoMacH's internal functions.

Functions
int	gnrc_netif_gomach_create (gnrc_netif_t *netif, char *stack, int stacksize, char priority, const char *name, netdev_t *dev)
	Creates an IEEE 802.15.4 GoMacH network interface. More...

Function Documentation

gnrc_netif_gomach_create()

int gnrc_netif_gomach_create	(	gnrc_netif_t *	netif,
		char *	stack,
		int	stacksize,
		char	priority,
		const char *	name,
		netdev_t *	dev
	)

Creates an IEEE 802.15.4 GoMacH network interface.

Parameters

[out]	netif	The interface. May not be NULL.
[in]	stack	The stack for the GoMacH network interface's thread.
[in]	stacksize	Size of stack.
[in]	priority	Priority for the GoMacH network interface's thread.
[in]	name	Name for the GoMacH network interface. May be NULL.
[in]	dev	Device for the interface

See also

gnrc_netif_create()

Returns

0 on success

negative number on error