/**************************************************************************** * wireless/ieee802154/mac802154_poll.c * * Copyright (C) 2016 Sebastien Lorquet. All rights reserved. * Copyright (C) 2017 Gregory Nutt. All rights reserved. * Copyright (C) 2017 Verge Inc. All rights reserved. * * Author: Sebastien Lorquet * Author: Gregory Nutt * Author: Anthony Merlino * * Redistribution and use in source and binary forms, with or without * modification, are permitted provided that the following conditions * are met: * * 1. Redistributions of source code must retain the above copyright * notice, this list of conditions and the following disclaimer. * 2. Redistributions in binary form must reproduce the above copyright * notice, this list of conditions and the following disclaimer in * the documentation and/or other materials provided with the * distribution. * 3. Neither the name NuttX nor the names of its contributors may be * used to endorse or promote products derived from this software * without specific prior written permission. * * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS * FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE * COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, * INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, * BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS * OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED * AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN * ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE * POSSIBILITY OF SUCH DAMAGE. * ****************************************************************************/ /**************************************************************************** * Included Files ****************************************************************************/ #include #include #include #include #include #include #include #include "mac802154.h" #include "mac802154_internal.h" #include #include /**************************************************************************** * Private Function Prototypes ****************************************************************************/ static void mac802154_timeout_poll(FAR struct ieee802154_privmac_s *priv); /**************************************************************************** * Public MAC Functions ****************************************************************************/ /**************************************************************************** * Name: mac802154_req_poll * * Description: * The MLME-POLL.request primitive prompts the device to request data from * the coordinator. Confirmation is returned via the * struct mac802154_maccb_s->conf_poll callback, followed by a * struct mac802154_maccb_s->ind_data callback. * ****************************************************************************/ int mac802154_req_poll(MACHANDLE mac, FAR struct ieee802154_poll_req_s *req) { FAR struct ieee802154_privmac_s *priv = (FAR struct ieee802154_privmac_s *)mac; FAR struct iob_s *iob; FAR struct ieee802154_txdesc_s *txdesc; int ret; /* On receipt of the MLME-POLL.request primitive, the MLME requests data from * the coordinator, as described in 5.1.6.3. If the poll is directed to the * PAN coordinator, the data request command may be generated without any * destination address information present. Otherwise, the data request * command is always generated with the destination address information in the * CoordPANId and CoordAddress parameters. */ /* Get exlusive access to the operation sempaphore. This must happen before * getting exclusive access to the MAC struct or else there could be a lockup * condition. This would occur if another thread is using the cmdtrans but * needs access to the MAC in order to unlock it. */ ret = mac802154_takesem(&priv->op_sem, true); if (ret < 0) { return ret; } /* Get exclusive access to the MAC */ ret = mac802154_takesem(&priv->exclsem, true); if (ret < 0) { mac802154_givesem(&priv->op_sem); return ret; } priv->curr_op = MAC802154_OP_POLL; priv->curr_cmd = IEEE802154_CMD_DATA_REQ; /* Allocate the txdesc, waiting if necessary */ ret = mac802154_txdesc_alloc(priv, &txdesc, true); if (ret < 0) { mac802154_givesem(&priv->exclsem); mac802154_givesem(&priv->op_sem); return ret; } /* The Source Addressing Mode field shall be set according to the value of * macShortAddress. If macShortAddress is less than 0xfffe, short addressing * shall be used. Extended addressing shall be used otherwise. */ if (priv->addr.saddr == IEEE802154_SADDR_BCAST) { mac802154_create_datareq(priv, &req->coordaddr, IEEE802154_ADDRMODE_EXTENDED, txdesc); } else { mac802154_create_datareq(priv, &req->coordaddr, IEEE802154_ADDRMODE_SHORT, txdesc); } /* Save a reference of the tx descriptor */ priv->cmd_desc = txdesc; /* Link the transaction into the CSMA transaction list */ sq_addlast((FAR sq_entry_t *)txdesc, &priv->csma_queue); /* We no longer need to have the MAC layer locked. */ mac802154_givesem(&priv->exclsem); /* Notify the radio driver that there is data available */ priv->radio->txnotify(priv->radio, false); return OK; } /**************************************************************************** * Internal MAC Functions ****************************************************************************/ /**************************************************************************** * Name: mac802154_txdone_datareq_poll * * Description: * Handle the completion (success/failure) of transmitting a data request * command in an effort to extract data from the coordinator triggered by * a POLL.request from the next highest layer * * Assumptions: * Called with the MAC locked. * ****************************************************************************/ void mac802154_txdone_datareq_poll(FAR struct ieee802154_privmac_s *priv, FAR struct ieee802154_txdesc_s *txdesc) { enum ieee802154_status_e status; FAR struct mac802154_notif_s *privnotif = (FAR struct mac802154_notif_s *)txdesc->conf; FAR struct ieee802154_notif_s *notif = &privnotif->pub; /* If the data request failed to be sent, notify the next layer * that the poll has failed. * OR * On receipt of the Ack frame with the Frame Pending field set * to zero, the device shall conclude that there are no data * pending at the coordinator. [1] pg. 43 */ if (notif->u.dataconf.status != IEEE802154_STATUS_SUCCESS || txdesc->framepending == 0) { if (notif->u.dataconf.status != IEEE802154_STATUS_SUCCESS) { status = notif->u.dataconf.status; } else { status = IEEE802154_STATUS_NO_DATA; } notif->notiftype = IEEE802154_NOTIFY_CONF_POLL; notif->u.pollconf.status = status; /* We are now done the operation, and can release the command */ priv->curr_op = MAC802154_OP_NONE; priv->cmd_desc = NULL; mac802154_givesem(&priv->op_sem); /* Release the MAC, call the callback, get exclusive access again */ mac802154_givesem(&priv->exclsem); priv->cb->notify(priv->cb, notif); mac802154_takesem(&priv->exclsem, false); } else { /* On receipt of the acknowledgment frame with the Frame * Pending field set to one, a device shall enable its * receiver for at most macMaxFrameTotalWaitTime to receive * the corresponding data frame from the coordinator. [1] pg.43 */ priv->radio->rxenable(priv->radio, true); /* Start a timer, if we receive the data frame, we will cancel * the timer, otherwise it will expire and we will notify the * next highest layer of the failure. */ mac802154_timerstart(priv, priv->max_frame_waittime, mac802154_timeout_poll); /* We can deallocate the data conf notification as it is no longer * needed. We can't use the public function here since we already * have the MAC locked. */ privnotif->flink = priv->notif_free; priv->notif_free = privnotif; } } /**************************************************************************** * Name: mac802154_timeout_poll * * Description: * Function registered with MAC timer that gets called via the work queue to * handle a timeout for extracting a response from the Coordinator. * ****************************************************************************/ static void mac802154_timeout_poll(FAR struct ieee802154_privmac_s *priv) { FAR struct ieee802154_notif_s *notif; DEBUGASSERT(priv->curr_op == MAC802154_OP_POLL); /* Allocate a notification struct to pass to the next highest layer. * Don't allow EINTR to interrupt. */ mac802154_takesem(&priv->exclsem, false); mac802154_notif_alloc(priv, ¬if, false); /* We are no longer performing the association operation */ priv->curr_op = MAC802154_OP_NONE; priv->cmd_desc = NULL; mac802154_givesem(&priv->op_sem); /* Release the MAC */ mac802154_givesem(&priv->exclsem); notif->notiftype = IEEE802154_NOTIFY_CONF_POLL; notif->u.pollconf.status = IEEE802154_STATUS_NO_DATA; priv->cb->notify(priv->cb, notif); }