submac.h

/*
 * Copyright (C) 2020 HAW Hamburg
 *
 * This file is subject to the terms and conditions of the GNU Lesser General
 * Public License v2.1. See the file LICENSE in the top level directory for more
 * details.
 */
 
#ifndef NET_IEEE802154_SUBMAC_H
#define NET_IEEE802154_SUBMAC_H
 
#ifdef __cplusplus
extern "C" {
#endif
 
#include <string.h>
 
#include "net/ieee802154.h"
#include "net/ieee802154/radio.h"
 
#define IEEE802154_SUBMAC_MAX_RETRANSMISSIONS (4U)  
typedef struct ieee802154_submac ieee802154_submac_t;
 
typedef enum {
    IEEE802154_STATE_OFF,
 
    IEEE802154_STATE_IDLE,
 
    IEEE802154_STATE_LISTEN,
} ieee802154_submac_state_t;
 
typedef struct {
    void (*rx_done)(ieee802154_submac_t *submac);
    void (*tx_done)(ieee802154_submac_t *submac, int status,
                    ieee802154_tx_info_t *info);
} ieee802154_submac_cb_t;
 
struct ieee802154_submac {
    eui64_t ext_addr;                   
    network_uint16_t short_addr;        
    ieee802154_dev_t *dev;              
    const ieee802154_submac_cb_t *cb;   
    ieee802154_csma_be_t be;            
    bool wait_for_ack;                  
    bool tx;                            
    uint16_t panid;                     
    uint16_t channel_num;               
    uint8_t channel_page;               
    uint8_t retrans;                    
    uint8_t csma_retries_nb;            
    uint8_t backoff_mask;               
    uint8_t csma_retries;               
    int8_t tx_pow;                      
    ieee802154_submac_state_t state;    
};
 
static inline ieee802154_submac_state_t ieee802154_get_state(ieee802154_submac_t *submac)
{
    return submac->state;
}
 
int ieee802154_set_state(ieee802154_submac_t *submac, ieee802154_submac_state_t state);
 
int ieee802154_send(ieee802154_submac_t *submac, const iolist_t *iolist);
 
static inline int ieee802154_set_short_addr(ieee802154_submac_t *submac,
                                            const network_uint16_t *short_addr)
{
    int res = ieee802154_radio_set_hw_addr_filter(submac->dev, short_addr, NULL,
                                                  NULL);
 
    if (res >= 0) {
        memcpy(&submac->short_addr, short_addr, IEEE802154_SHORT_ADDRESS_LEN);
    }
 
    return res;
}
 
static inline int ieee802154_set_ext_addr(ieee802154_submac_t *submac,
                                          const eui64_t *ext_addr)
{
    int res = ieee802154_radio_set_hw_addr_filter(submac->dev, NULL, ext_addr,
                                                  NULL);
 
    if (res >= 0) {
        memcpy(&submac->ext_addr, ext_addr, IEEE802154_LONG_ADDRESS_LEN);
    }
    return res;
}
 
static inline int ieee802154_set_panid(ieee802154_submac_t *submac,
                                       const uint16_t *panid)
{
    int res = ieee802154_radio_set_hw_addr_filter(submac->dev, NULL, NULL,
                                                  panid);
 
    if (res >= 0) {
        submac->panid = *panid;
    }
 
    return res;
}
 
int ieee802154_set_phy_conf(ieee802154_submac_t *submac, uint16_t channel_num,
                            uint8_t channel_page, int8_t tx_pow);
 
static inline int ieee802154_set_channel_number(ieee802154_submac_t *submac,
                                                uint16_t channel_num)
{
    return ieee802154_set_phy_conf(submac, channel_num, submac->channel_page,
                                   submac->tx_pow);
}
 
static inline int ieee802154_set_channel_page(ieee802154_submac_t *submac,
                                              uint16_t channel_page)
{
    return ieee802154_set_phy_conf(submac, submac->channel_num, channel_page,
                                   submac->tx_pow);
}
 
static inline int ieee802154_set_tx_power(ieee802154_submac_t *submac,
                                          int8_t tx_pow)
{
    return ieee802154_set_phy_conf(submac, submac->channel_num,
                                   submac->channel_page, tx_pow);
}
 
static inline int ieee802154_get_frame_length(ieee802154_submac_t *submac)
{
    return ieee802154_radio_len(submac->dev);
}
 
static inline int ieee802154_read_frame(ieee802154_submac_t *submac, void *buf,
                                        size_t len, ieee802154_rx_info_t *info)
{
    return ieee802154_radio_read(submac->dev, buf, len, info);
}
 
int ieee802154_submac_init(ieee802154_submac_t *submac, const network_uint16_t *short_addr,
                           const eui64_t *ext_addr);
 
extern void ieee802154_submac_ack_timer_set(ieee802154_submac_t *submac,
                                            uint16_t us);
 
extern void ieee802154_submac_ack_timer_cancel(ieee802154_submac_t *submac);
 
void ieee802154_submac_ack_timeout_fired(ieee802154_submac_t *submac);
 
void ieee802154_submac_rx_done_cb(ieee802154_submac_t *submac);
 
void ieee802154_submac_tx_done_cb(ieee802154_submac_t *submac);
 
#ifdef __cplusplus
}
#endif
 
#endif /* NET_IEEE802154_SUBMAC_H */