nuttx/wireless/ieee802154/mac802154_internal.h

/****************************************************************************
 * wireless/ieee802154/mac802154_internal.h
 *
 * SPDX-License-Identifier: Apache-2.0
 *
 * Licensed to the Apache Software Foundation (ASF) under one or more
 * contributor license agreements.  See the NOTICE file distributed with
 * this work for additional information regarding copyright ownership.  The
 * ASF licenses this file to you under the Apache License, Version 2.0 (the
 * "License"); you may not use this file except in compliance with the
 * License.  You may obtain a copy of the License at
 *
 *   http://www.apache.org/licenses/LICENSE-2.0
 *
 * Unless required by applicable law or agreed to in writing, software
 * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
 * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.  See the
 * License for the specific language governing permissions and limitations
 * under the License.
 *
 ****************************************************************************/

#ifndef __WIRELESS_IEEE802154__MAC802154_INTERNAL_H
#define __WIRELESS_IEEE802154__MAC802154_INTERNAL_H

/****************************************************************************
 * Included Files
 ****************************************************************************/

#include <nuttx/config.h>

#include <stdlib.h>
#include <assert.h>
#include <errno.h>
#include <debug.h>
#include <string.h>

#include <nuttx/wdog.h>
#include <nuttx/wqueue.h>
#include <nuttx/mutex.h>
#include <nuttx/semaphore.h>

#include <nuttx/wireless/ieee802154/ieee802154_mac.h>
#include <nuttx/wireless/ieee802154/ieee802154_radio.h>

/****************************************************************************
 * Pre-processor Definitions
 ****************************************************************************/

/* Configuration ************************************************************/

/* If processing is not done at the interrupt level, then work queue support
 * is required.
 */

#if !defined(CONFIG_SCHED_HPWORK) || !defined(CONFIG_SCHED_LPWORK)
#  error Both Low and High priority work queues are required for this driver
#endif

#if !defined(CONFIG_MAC802154_NTXDESC) || CONFIG_MAC802154_NTXDESC <= 0
#  undef CONFIG_MAC802154_NTXDESC
#  define CONFIG_MAC802154_NTXDESC 5
#endif

#if !defined(CONFIG_IEEE802154_DEFAULT_EADDR)
#  define CONFIG_IEEE802154_DEFAULT_EADDR 0xFFFFFFFFFFFFFFFF
#endif

/****************************************************************************
 * Public Types
 ****************************************************************************/

struct mac802154_radiocb_s
{
  struct ieee802154_radiocb_s cb;
  FAR struct ieee802154_privmac_s *priv;
};

/* Enumeration for representing what operation the MAC layer is currently
 * doing. There can only be one command being handled at any given time, but
 * certain operations such as association requires more than one command to
 * be sent. Therefore, the need to track not only what command is currently
 * active, but also, what overall operation the command is apart of is
 * necessary.
 */

enum mac802154_operation_e
{
  MAC802154_OP_NONE,
  MAC802154_OP_ASSOC,
  MAC802154_OP_POLL,
  MAC802154_OP_SCAN,
  MAC802154_OP_AUTOEXTRACT,
  MAC802154_OP_RXENABLE,
};

/* The privmac structure holds the internal state of the MAC and is the
 * underlying represention of the opaque MACHANDLE.  It contains storage for
 * the IEEE802.15.4 MIB attributes.
 */

struct ieee802154_privmac_s
{
  /*************************** General Fields *******************************/

  FAR struct ieee802154_radio_s  *radio;    /* Contained IEEE802.15.4 radio dev */
  FAR struct mac802154_maccb_s   *cb;       /* Head of a list of MAC callbacks */
  FAR struct mac802154_radiocb_s radiocb;   /* Interface to bind to radio */

  mutex_t                        lock;      /* Support exclusive access */
  uint8_t                        nclients;  /* Number of notification clients */

  /* Only support a single command at any given time. As of now I see no
   * condition where you need to have more than one command frame
   * simultaneously
   */

  sem_t                          opsem;     /* Exclusive operations */

  /******************* Fields related to MAC operations *********************/

  enum mac802154_operation_e     curr_op;   /* The current overall operation */
  enum ieee802154_cmdid_e        curr_cmd;  /* Type of the current cmd */
  FAR struct ieee802154_txdesc_s *cmd_desc; /* TX descriptor for current cmd */
  uint8_t                        nrxusers;
  struct work_s                  macop_work;

  /******************* Fields related to SCAN operation *********************/

  uint8_t scanindex;
  uint8_t edlist[15];
  uint8_t npandesc;
  struct ieee802154_pandesc_s pandescs[MAC802154_NPANDESC];
  uint8_t panidbeforescan[IEEE802154_PANIDSIZE];
  struct ieee802154_scan_req_s currscan;
  uint32_t scansymdur;

  /******************* Fields related to notifications **********************/

  sq_queue_t primitive_queue;     /* Queue of primitives to pass via notify()
                                   * callback to registered receivers
                                   */
  struct work_s notifwork;        /* For deferring notifications to LPWORK queue */

  /******************* Tx descriptor queues and pools ***********************/

  struct ieee802154_txdesc_s txdesc_pool[CONFIG_MAC802154_NTXDESC];
  sem_t txdesc_sem;
  sq_queue_t txdesc_queue;
  sq_queue_t txdone_queue;

  /* Support a singly linked list of transactions that will be sent using the
   * CSMA algorithm.  On a non-beacon enabled PAN, these transactions will be
   * sent whenever. On a beacon-enabled PAN, these transactions will be sent
   * during the CAP of the Coordinator's superframe.
   */

  sq_queue_t csma_queue;
  sq_queue_t gts_queue;

  /* Support a singly linked list of transactions that will be sent
   * indirectly. This list should only be used by a MAC acting as a
   * coordinator.  These transactions will stay here until the data
   * is extracted by the destination device sending a Data Request
   * MAC command or if too much time passes. This list should also
   * be used to populate the address list of the outgoing beacon
   * frame.
   */

  sq_queue_t indirect_queue;

  /* Support a singly linked list of frames received */

  sq_queue_t dataind_queue;

  /************* Fields related to addressing and coordinator ***************/

  /* Holds all address information (Extended, Short, and PAN ID) for MAC */

  struct ieee802154_addr_s addr;

  struct ieee802154_pandesc_s pandesc;

  /*************** Fields related to beacon-enabled networks ****************/

  /* Holds attributes pertaining to the superframe specification */

  struct ieee802154_superframespec_s sfspec;

  /* We use 2 beacon frame structures so that we can ping-pong between them
   * while updating the beacon
   */

  struct ieee802154_beaconframe_s beaconframe[2];

  /* Contents of beacon payload */

  uint8_t beaconpayload[IEEE802154_MAX_BEACON_PAYLOAD_LEN];
  uint8_t beaconpayloadlength;

  /****************** Fields related to offloading work *********************/

  /* Work structures for offloading aynchronous work */

  struct work_s txdone_work;
  struct work_s rx_work;
  struct work_s purge_work;
  struct work_s timer_work;

  /****************** Uncategorized MAC PIB attributes **********************/

  /* The maximum time to wait either for a frame intended as a response to a
   * data request frame or for a broadcast frame following a beacon with the
   * Frame Pending field set to one. [1] pg. 127
   *
   * NOTE: This may be able to be a 16-bit or even an 8-bit number.  I wasn't
   * sure at the time what the range of reasonable values was.
   */

  uint32_t max_frame_waittime;

  /* The maximum time (in unit periods) that a transaction is stored by a
   * coordinator and indicated in its beacon.
   */

  uint16_t trans_persisttime;

  uint8_t dsn;                      /* Seq. num added to tx data or MAC frame */

  /* The maximum time, in multiples of aBaseSuperframeDuration, a device
   * shall wait for a response command frame to be available following a
   * request command frame. [1] 128.
   */

  uint8_t resp_waittime;

  /* The total transmit duration (including PHY header and FCS) specified in
   * symbols. [1] pg. 129.
   */

  uint32_t tx_totaldur;

  /* Start of 8-bit bitfield */

  uint32_t trackingbeacon     : 1;  /* Are we tracking the beacon */
  uint32_t isassoc            : 1;  /* Are we associated to the PAN */
  uint32_t autoreq            : 1;  /* Automatically send data req. if addr
                                     * addr is in the beacon frame */

  uint32_t gtspermit          : 1;  /* Is PAN Coord. accepting GTS reqs. */
  uint32_t promisc            : 1;  /* Is promiscuous mode on? */
  uint32_t rngsupport         : 1;  /* Does MAC sublayer support ranging */
  uint32_t sec_enabled        : 1;  /* Does MAC sublayer have security en. */
  uint32_t timestamp_support  : 1;  /* Does MAC layer supports timestamping */

  /* End of 8-bit bitfield */

  /* Start of 32-bit bitfield */

  /* The offset, measured is symbols, between the symbol boundary at which
   * MLME captures the timestamp of each transmitted and received frame, and
   * the onset of the first symbol past the SFD, namely the first symbol of
   * the frames [1] pg. 129.
   */

  uint32_t sync_symboffset    : 12;

  uint32_t txctrl_activedur   : 17; /* Duration for which tx is permitted to
                                       * be active */
  uint32_t txctrl_pausedur    : 1;  /* Duration after tx before another tx is
                                     * permitted. 0=2000, 1= 10000 */

  /* What type of device is this node acting as */

  enum ieee802154_devmode_e devmode : 2;

  /* End of 32-bit bitfield */

  /* Start of 32-bit bitfield */

  uint32_t beacon_txtime      : 24; /* Time of last beacon transmit */
  uint32_t minbe              : 4;  /* Min value of backoff exponent (BE) */
  uint32_t maxbe              : 4;  /* Max value of backoff exponent (BE) */

  /* End of 32-bit bitfield */

  /* Start of 8-bit bitfield */

  uint8_t bf_ind              : 1;  /* Ping-pong index for beacon frame */
  uint8_t beaconupdate        : 1;  /* Does the beacon frame need to be updated */
  uint8_t max_csmabackoffs    : 3;  /* Max num backoffs for CSMA algorithm
                                     * before declaring ch access failure */
  uint8_t maxretries          : 3;  /* Max # of retries allowed after tx fail */

  /* End of 8-bit bitfield. */

  /* Start of 8-bit bitfield */

  uint8_t rxonidle            : 1;  /* Receiver on when idle? */

  /* End of 8-bit bitfield. */

  /* TODO: Add Security-related MAC PIB attributes */
};

/****************************************************************************
 * Function Prototypes
 ****************************************************************************/

int  mac802154_txdesc_alloc(FAR struct ieee802154_privmac_s *priv,
                            FAR struct ieee802154_txdesc_s **txdesc);

void mac802154_setupindirect(FAR struct ieee802154_privmac_s *priv,
                             FAR struct ieee802154_txdesc_s *txdesc);

void mac802154_createdatareq(FAR struct ieee802154_privmac_s *priv,
                             FAR struct ieee802154_addr_s *coordaddr,
                             enum ieee802154_addrmode_e srcmode,
                             FAR struct ieee802154_txdesc_s *txdesc);

void mac802154_updatebeacon(FAR struct ieee802154_privmac_s *priv);

void mac802154_notify(FAR struct ieee802154_privmac_s *priv,
                      FAR struct ieee802154_primitive_s *primitive);

/****************************************************************************
 * Helper Macros/Inline Functions
 ****************************************************************************/

#define mac802154_putpanid(iob, panid) \
  do \
    { \
      IEEE802154_PANIDCOPY(&iob->io_data[iob->io_len], panid); \
      iob->io_len += IEEE802154_PANIDSIZE; \
    } \
  while(0)

#define mac802154_putsaddr(iob, saddr) \
  do \
    { \
      IEEE802154_SADDRCOPY(&iob->io_data[iob->io_len], saddr); \
      iob->io_len += IEEE802154_SADDRSIZE; \
    } \
  while(0)

/* The IEEE 802.15.4 Standard is confusing with regards to byte-order for
 * extended address. More research discovers that the extended address should
 * be sent in reverse-canonical form.
 */

#define mac802154_puteaddr(iob, eaddr) \
  do \
    { \
      int index; \
      for (index = IEEE802154_EADDRSIZE - 1; index >= 0; index--) \
        { \
          iob->io_data[iob->io_len++] = eaddr[index]; \
        } \
    } \
  while(0)

#define mac802154_takepanid(iob, panid) \
  do \
    { \
      IEEE802154_PANIDCOPY(panid, &iob->io_data[iob->io_offset]); \
      iob->io_offset += IEEE802154_PANIDSIZE; \
    } \
  while(0)

#define mac802154_takesaddr(iob, saddr) \
  do \
    { \
      IEEE802154_SADDRCOPY(saddr, &iob->io_data[iob->io_offset]); \
      iob->io_offset += IEEE802154_SADDRSIZE; \
    } \
  while(0)

/* The IEEE 802.15.4 Standard is confusing with regards to byte-order for
 * extended address. More research discovers that the extended address should
 * be sent in reverse-canonical form.
 */

#define mac802154_takeeaddr(iob, eaddr) \
  do \
    { \
      int index; \
      for (index = IEEE802154_EADDRSIZE - 1; index >= 0; index--) \
        { \
          eaddr[index] = iob->io_data[iob->io_offset++]; \
        } \
    } \
  while(0)

/* General helper macros ****************************************************/

/* GET 16-bit data:  source in network order, result in host order */

#define GETHOST16(ptr,index) \
  ((((uint16_t)((ptr)[(index) + 1])) << 8) | ((uint16_t)(((ptr)[index]))))

/* GET 16-bit data:  source in network order, result in network order */

#define GETNET16(ptr,index) \
  ((((uint16_t)((ptr)[index])) << 8) | ((uint16_t)(((ptr)[(index) + 1]))))

/* PUT 16-bit data:  source in host order, result in network order */

#define PUTHOST16(ptr,index,value) \
  do \
    { \
      (ptr)[index]      = (uint16_t)(value) & 0xff; \
      (ptr)[index + 1]  = ((uint16_t)(value) >> 8) & 0xff; \
    } \
  while(0)

/* Set bit in 16-bit value:  source in host order, result in network order. */

#define IEEE802154_SETBITS_U16(ptr,index,value) \
  do \
    { \
      (ptr)[index]     |= (uint16_t)(value) & 0xff; \
      (ptr)[index + 1] |= ((uint16_t)(value) >> 8) & 0xff; \
    } \
  while(0)

/* Helper macros for setting/receiving bits for frame control field */

#define IEEE802154_SETFTYPE(ptr, index, ftype) \
  IEEE802154_SETBITS_U16(ptr, index, (ftype << IEEE802154_FRAMECTRL_SHIFT_FTYPE))

#define IEEE802154_SETACKREQ(ptr, index) \
  IEEE802154_SETBITS_U16(ptr, index, IEEE802154_FRAMECTRL_ACKREQ)

#define IEEE802154_SETDADDRMODE(ptr, index, mode) \
  IEEE802154_SETBITS_U16(ptr, index, (mode << IEEE802154_FRAMECTRL_SHIFT_DADDR))

#define IEEE802154_SETSADDRMODE(ptr, index, mode) \
  IEEE802154_SETBITS_U16(ptr, index, (mode << IEEE802154_FRAMECTRL_SHIFT_SADDR))

#define IEEE802154_SETPANIDCOMP(ptr, index) \
  IEEE802154_SETBITS_U16(ptr, index, IEEE802154_FRAMECTRL_PANIDCOMP)

#define IEEE802154_SETVERSION(ptr, index, version) \
  IEEE802154_SETBITS_U16(ptr, index, (version << IEEE802154_FRAMECTRL_SHIFT_VERSION))

/* Helper macros for setting/receiving bits for superframe specification */

#define IEEE802154_SETBEACONORDER(ptr, index, val) \
  IEEE802154_SETBITS_U16(ptr, index, (val << IEEE802154_SFSPEC_SHIFT_BEACONORDER))

#define IEEE802154_SETSFORDER(ptr, index, val) \
  IEEE802154_SETBITS_U16(ptr, index, (val << IEEE802154_SFSPEC_SHIFT_SFORDER))

#define IEEE802154_SETFINCAPSLOT(ptr, index, val) \
  IEEE802154_SETBITS_U16(ptr, index, (val << IEEE802154_SFSPEC_SHIFT_FINCAPSLOT))

#define IEEE802154_SETBLE(ptr, index) \
  IEEE802154_SETBITS_U16(ptr, index, IEEE802154_SFSPEC_BLE)

#define IEEE802154_SETPANCOORD(ptr, index) \
  IEEE802154_SETBITS_U16(ptr, index, IEEE802154_SFSPEC_PANCOORD)

#define IEEE802154_SETASSOCPERMIT(ptr, index) \
  IEEE802154_SETBITS_U16(ptr, index, IEEE802154_SFSPEC_ASSOCPERMIT)

#define IEEE802154_GETBEACONORDER(ptr, index) \
  ((GETHOST16(ptr, index) & IEEE802154_SFSPEC_BEACONORDER) >> \
  IEEE802154_SFSPEC_SHIFT_BEACONORDER)

#define IEEE802154_GETSFORDER(ptr, index) \
  ((GETHOST16(ptr, index) & IEEE802154_SFSPEC_SFORDER) >> \
  IEEE802154_SFSPEC_SHIFT_SFORDER)

#define IEEE802154_GETFINCAPSLOT(ptr, index) \
  ((GETHOST16(ptr, index) & IEEE802154_SFSPEC_FINCAPSLOT) >> \
  IEEE802154_SFSPEC_SHIFT_FINCAPSLOT)

#define IEEE802154_GETBLE(ptr, index) \
  ((GETHOST16(ptr, index) & IEEE802154_SFSPEC_BLE) >> \
  IEEE802154_SFSPEC_SHIFT_BLE)

#define IEEE802154_GETPANCOORD(ptr, index) \
  ((GETHOST16(ptr, index) & IEEE802154_SFSPEC_PANCOORD) >> \
  IEEE802154_SFSPEC_SHIFT_PANCOORD)

#define IEEE802154_GETASSOCPERMIT(ptr, index) \
  ((GETHOST16(ptr, index) & IEEE802154_SFSPEC_ASSOCPERMIT) >> \
  IEEE802154_SFSPEC_SHIFT_ASSOCPERMIT)

/* Helper macros for setting/receiving bits for GTS specification */

#define IEEE802154_GETGTSDESCCOUNT(ptr, index) \
  ((GETHOST16(ptr, index) & IEEE802154_GTSSPEC_DESCCOUNT) >> \
  IEEE802154_GTSSPEC_SHIFT_DESCCOUNT)

#define IEEE802154_GETGTSPERMIT(ptr, index) \
  ((GETHOST16(ptr, index) & IEEE802154_GTSSPEC_PERMIT) >> \
  IEEE802154_GTSSPEC_SHIFT_PERMIT)

/* Helper macros for setting/receiving bits for GTS Directions */

#define IEEE802154_GETGTSDIRMASK(ptr, index) \
  ((GETHOST16(ptr, index) & IEEE802154_GTSDIR_MASK) >> \
  IEEE802154_GTSDIR_SHIFT_MASK)

/* Helper macros for setting/receiving bits for Pending Address */

#define IEEE802154_GETNPENDSADDR(ptr, index) \
  ((GETHOST16(ptr, index) & IEEE802154_PENDADDR_NSADDR) >> \
  IEEE802154_PENDADDR_SHIFT_NSADDR)

#define IEEE802154_GETNPENDEADDR(ptr, index) \
  ((GETHOST16(ptr, index) & IEEE802154_PENDADDR_NEADDR) >> \
  IEEE802154_PENDADDR_SHIFT_NEADDR)

/* General helpers **********************************************************/

static inline void
mac802154_txdesc_free(FAR struct ieee802154_privmac_s *priv,
                      FAR struct ieee802154_txdesc_s *txdesc)
{
  sq_addlast((FAR sq_entry_t *)txdesc, &priv->txdesc_queue);
  nxsem_post(&priv->txdesc_sem);
}

/****************************************************************************
 * Name: mac802154_symtoticks
 *
 * Description:
 *   Helper function for converting symbols to system clock ticks
 *
 * Assumptions:
 *   priv MAC struct is locked when calling.
 *
 ****************************************************************************/

static inline uint32_t
mac802154_symtoticks(FAR struct ieee802154_privmac_s *priv, uint32_t symbols)
{
  union ieee802154_attr_u attrval;
  uint32_t ret;

  /* First, get the symbol duration from the radio layer.  Symbol duration is
   * returned in picoseconds to ensure precision is kept when multiplying to
   * get overall times.
   */

  priv->radio->getattr(priv->radio, IEEE802154_ATTR_PHY_SYMBOL_DURATION,
                       &attrval);

  /* After this step, ret represents microseconds */

  ret = ((uint64_t)attrval.phy.symdur_picosec * symbols) / (1000 * 1000);

  /* This method should only be used for things that can be late. For
   * instance, it's always okay to wait a little longer before disabling
   * your receiver. Therefore, we force the tick count to round up.
   */

  if (ret % USEC_PER_TICK == 0)
    {
      ret /= USEC_PER_TICK;
    }
  else
    {
      ret /= USEC_PER_TICK;
      ret++;
    }

  return ret;
}

/****************************************************************************
 * Name: mac802154_timerstart
 *
 * Description:
 *   Helper function wrapping the watchdog timer interface. Helps isolate
 *   different operations from having to worry about work queues and watchdog
 *   timers.
 *
 * Assumptions:
 *   priv MAC struct is locked when calling.
 *
 ****************************************************************************/

static inline void
mac802154_timerstart(FAR struct ieee802154_privmac_s *priv,
                     uint32_t numsymbols, worker_t worker)
{
  DEBUGASSERT(work_available(&priv->timer_work));

  /* Schedule the work
   * converting the number of symbols to the number of CPU ticks
   */

  work_queue(HPWORK, &priv->timer_work, worker, priv,
             mac802154_symtoticks(priv, numsymbols));
}

/****************************************************************************
 * Name: mac802154_timercancel
 *
 * Description:
 *   Cancel timer and remove reference to callback function
 *
 * Assumptions:
 *   priv MAC struct is locked when calling.
 *
 ****************************************************************************/

static inline int
mac802154_timercancel(FAR struct ieee802154_privmac_s *priv)
{
  work_cancel(HPWORK, &priv->timer_work);
  wlinfo("Timer cancelled\n");
  return OK;
}

static inline void
mac802154_rxenable(FAR struct ieee802154_privmac_s *priv)
{
  priv->nrxusers++;

  /* If this is the first user, actually enable the receiver */

  if (priv->nrxusers == 1)
    {
      wlinfo("Receiver enabled\n");
      priv->radio->rxenable(priv->radio, true);
    }
}

static inline void
mac802154_rxdisable(FAR struct ieee802154_privmac_s *priv)
{
  priv->nrxusers--;

  /* If this is the first user, actually enable the receiver */

  if (priv->nrxusers == 0)
    {
      wlinfo("Receiver disabled\n");
      priv->radio->rxenable(priv->radio, false);
    }
}

static inline void
mac802154_setchannel(FAR struct ieee802154_privmac_s *priv,
                     uint8_t channel)
{
  priv->radio->setattr(priv->radio, IEEE802154_ATTR_PHY_CHAN,
                       (FAR const union ieee802154_attr_u *)&channel);
}

static inline void
mac802154_setchpage(FAR struct ieee802154_privmac_s *priv,
                    uint8_t chpage)
{
  priv->radio->setattr(priv->radio, IEEE802154_ATTR_PHY_CURRENT_PAGE,
                       (FAR const union ieee802154_attr_u *)&chpage);
}

static inline void
mac802154_setpanid(FAR struct ieee802154_privmac_s *priv,
                   FAR const uint8_t *panid)
{
  IEEE802154_PANIDCOPY(priv->addr.panid, panid);
  priv->radio->setattr(priv->radio, IEEE802154_ATTR_MAC_PANID,
                       (FAR const union ieee802154_attr_u *)panid);
}

static inline void
mac802154_setsaddr(FAR struct ieee802154_privmac_s *priv,
                   FAR const uint8_t *saddr)
{
  IEEE802154_SADDRCOPY(priv->addr.saddr, saddr);
  priv->radio->setattr(priv->radio, IEEE802154_ATTR_MAC_SADDR,
                       (FAR const union ieee802154_attr_u *)saddr);
}

static inline void
mac802154_setcoordsaddr(FAR struct ieee802154_privmac_s *priv,
                        FAR const uint8_t *saddr)
{
  IEEE802154_SADDRCOPY(priv->pandesc.coordaddr.saddr, saddr);
  priv->radio->setattr(priv->radio, IEEE802154_ATTR_MAC_COORD_SADDR,
                       (FAR const union ieee802154_attr_u *)saddr);
}

static inline void
mac802154_setcoordeaddr(FAR struct ieee802154_privmac_s *priv,
                        FAR const uint8_t *eaddr)
{
  IEEE802154_EADDRCOPY(priv->pandesc.coordaddr.eaddr, eaddr);
  priv->radio->setattr(priv->radio, IEEE802154_ATTR_MAC_COORD_EADDR,
                       (FAR const union ieee802154_attr_u *)eaddr);
}

static inline void
mac802154_setcoordaddr(FAR struct ieee802154_privmac_s *priv,
                       FAR const struct ieee802154_addr_s *addr)
{
  memcpy(&priv->pandesc.coordaddr, addr, sizeof(struct ieee802154_addr_s));
  priv->radio->setattr(priv->radio, IEEE802154_ATTR_MAC_COORD_EADDR,
                       (FAR const union ieee802154_attr_u *)addr->eaddr);
  priv->radio->setattr(priv->radio, IEEE802154_ATTR_MAC_COORD_SADDR,
                       (FAR const union ieee802154_attr_u *)addr->saddr);
}

static inline void
mac802154_setrxonidle(FAR struct ieee802154_privmac_s *priv, bool rxonidle)
{
  priv->rxonidle = rxonidle;
  if (priv->rxonidle)
    {
      mac802154_rxenable(priv);
    }
  else
    {
      mac802154_rxdisable(priv);
    }

  priv->radio->setattr(priv->radio, IEEE802154_ATTR_MAC_RX_ON_WHEN_IDLE,
                       (FAR const union ieee802154_attr_u *)&rxonidle);
}

static inline void
mac802154_setdevmode(FAR struct ieee802154_privmac_s *priv, uint8_t mode)
{
  priv->devmode = mode;
  priv->radio->setattr(priv->radio, IEEE802154_ATTR_MAC_DEVMODE,
                       (FAR const union ieee802154_attr_u *)&mode);
}

#endif /* __WIRELESS_IEEE802154__MAC802154_INTERNAL_H */