/* Here goes the MAC user code. Note there can be multiple implementations of
confirm/indication primitives depending on the expected behavior, and these functions are
included in the mac descriptor (mac->mlme_confirm, mac->mcps_confirm and mac->mcps_indication */

int main(void)
{
    /* Request the mac layer to scan */
    sap_request_t request;
    request.type = MLME_SCAN;

    /* struct to hold confirm information */
    sap_confirm_t confirm;
    mac->mlme_request(&request, &confirm);
    /* confirm->status will be SAP_DEFERRED, since the result of the scan command is asynchronous */
    
    request.type = MLME_GET;
    request.param.get.netopt = NETOPT_FOO;
    /* ... */
    mac->mlme_request(&request, &confirm);
    /* confirm->status will be SAP_SUCCESS, since getting a variable is synchronous.
       confirm->param.get.data contains the value */

    request.type = MCPS_DATA;
    request.param.data_req.channel = my_channel;
    request.param.data_req.iolist = my_iolist;
    request.param.data_req.ack_requested = true;
    mac->mcps_request(&request, &confirm);
    /* confirm->status will be SAP_DEFERRED if everything went OK */
}

/* main.c mlme_confirm implementation */
void mlme_confirm(sap_confirm_t *confirm)
{
    switch(confirm->type) {
        case MLME_SCAN:
            if(confirm->status == SAP_SUCCESS) {
                puts("Scan went successfully!");
            }
            break;
    }
}
/* main.c mcps_confirm implementation */
void mcps_confirm(sap_confirm_t *confirm)
{
    switch(confirm->type) {
        case MCPS_DATA:
            if(confirm->status == SAP_SUCCESS) {
                puts("ACK was received successfully. Transmission was OK");
            }
            break;
    }
}

/* main.c mcps_indication implementation */
void mcps_indication(sap_indication_t *indication)
{
    switch(confirm->type) {
        case MCPS_DATA:
            puts("Received packet with payload:");
            print_packet(indication.msdu);
            break;
    }
}

/* Here goes the MAC code */
/* associated to a descriptor (e.g mac->mlme_request) */
void mlme_request(sap_request_t *request, sap_confirm_t *confirm)
{
    switch(sap->type) {
        case MLME_GET:
            /* Get a MAC internal variable. This is synchronous */
            netdev->driver->get(netdev, request->param.get.netopt, request->param.get.data, request->param.get.data_len);
            confirm->status = SAP_SUCCESS;
            break;
        case MLME_SCAN:
            /* Scan is asynchronous. Set confirm status to DEFERRED in order to indicate the user the MAC will call the Confirm callback when ready */
           start_scan();
           confirm->status = SAP_DEFERRED;
           break;
    }
}
/* Called when scan finishes */
void _isr_scan_finished(void *arg)
{
    sap_mac_t *mac = arg;
    sap_confirm_t confirm;
    /* Populate confirm with scan data */
    confirm.data = get_scan_data();
    if(scan_status == 0) {
        confirm.status = SAP_SUCCESS;
    }
    else {
        confirm.status = SAP_FAIL;
    }
        mac->mlme_confirm(&confirm);
}

/* associated to a descriptor (e.g mac->mcps_request) */
void mcps_request(sap_request_t *request, sap_confirm_t *confirm)
{
    switch(sap->type) {
        case MCPS_DATA:
            /* Ask the MLME whether the MAC is connected or not */
            if(mlme_mac_is_disconnected()) {
                /* MAC is disconnected from medium. Confirm with error */
                confirm->status = SAP_FAIL;
                return;
            }
            netdev->driver->send(netdev, request->param.data_req.iolist, ...);
            /* When an ACK is received, the MAC layer will call the Confirm callback */
            confirm->status = SAP_DEFERRED;
            break;
    }
}

/* Called by the radio when received an ACK */
_isr_received_ack(void *arg)
{
    sap_mac_t *mac = arg;
    sap_confirm_t confirm;
    confirm.type = MCPS_DATA;
    confirm.status = SAP_SUCCESS;
     mac->mcps_confirm(&confirm);
}

/* Called when received a packet */
_isr_packet_received(void *arg)
{
    sap_mac_t *mac = arg;
    sap_indication_t indication;
    /* ... */
    indication.msdu = get_packet();
    indication.rssi = get_rssi();
    indication.channel = get_rx_channel();

    /* Indicate the upper layer we just received a packet */
    mac->mcps_indication(&indication)
}