MAC Core Layer(MCL)

The MAC Core Layer (MCL) abstracts and implements IEEE 802.15.4-2006 compliant behavior for non-beacon enabled and beacon-enabled network support.

Macros
#define	MAKE_MAC_BUSY()
	This macro sets the MAC to busy. More...
#define	MAKE_MAC_NOT_BUSY()
	This macro sets the MAC to not busy. More...

Functions
void	dispatch_event (uint8_t *event)
	Obtains the message type from the buffer and calls the respective handler. More...
void	mac_build_and_tx_beacon (bool beacon_enabled, buffer_t *beacon_buffer_header)
	Builds and transmits the beacon frame. More...
bool	mac_build_and_tx_data_req (bool expl_poll, bool force_own_long_addr, uint8_t expl_dest_addr_mode, address_field_t *expl_dest_addr, uint16_t expl_dest_pan_id)
	Build and transmits data request command frame. More...
static void	mac_check_persistence_timer (void)
void	mac_coord_realignment_command_tx_success (uint8_t tx_status, buffer_t *buf_ptr)
	Continues handling of MLME_START.request (Coordinator realignment) command. More...
void	mac_gen_mcps_data_conf (buffer_t *buf_ptr, uint8_t status, uint8_t handle, uint32_t timestamp)
void	mac_gen_mlme_associate_conf (buffer_t *buf_ptr, uint8_t status, uint16_t assoc_short_addr)
void	mac_handle_tx_null_data_frame (void)
void	mac_idle_trans (void)
	Resets the MAC helper variables and transition to idle state. More...
void	mac_mlme_comm_status (uint8_t status, buffer_t *buf_ptr)
	Creates a Communication Status Indication message to the upper layer. More...
void	mac_prep_disassoc_conf (buffer_t *buf_ptr, uint8_t status)
	Prepares a disassociation confirm message with device address information. More...
void	mac_process_associate_request (buffer_t *buf_ptr)
	Processes a received association request command frame. More...
void	mac_process_associate_response (buffer_t *buf_ptr)
	Processing of an associaton reponse command frame. More...
void	mac_process_beacon_frame (buffer_t *msg)
	Processes received beacon frame. More...
void	mac_process_beacon_request (buffer_t *buf_ptr)
	Processes a beacon request. More...
void	mac_process_coord_realign (buffer_t *buf_ptr)
	Processing a coordinator realignment command frame. More...
void	mac_process_data_frame (buffer_t *buf_ptr)
	Processes data frames. More...
void	mac_process_data_request (buffer_t *buf_ptr)
	Processes a received data request command frame. More...
void	mac_process_data_response (void)
	Processes a data response to an MLME-POLL.request. More...
void	mac_process_disassociate_notification (buffer_t *buf_ptr)
	Process a disassociation notification command. More...
void	mac_process_orphan_notification (buffer_t *buf_ptr)
	Handles an orphan notification. More...
void	mac_process_orphan_realign (buffer_t *buf_ptr)
	Processing a coordinator realignment command frame during Orphan scan. More...
void	mac_process_tal_data_ind (uint8_t *msg)
	Depending on received frame the appropriate function is called. More...
void	mac_scan_send_complete (retval_t status)
	Continue scanning after the completion of frame transmission. More...
void	mac_sleep_trans (void)
	Puts the radio to sleep if this is allowed. More...
void	mac_start_persistence_timer (void)
void	mac_sync_loss (uint8_t loss_reason)
	Function to initiate MLME-SYNC-LOSS.indication to NHLE. More...
void	mac_t_assocresponsetime_cb (void *callback_parameter)
void	mac_t_poll_wait_time_cb (void *callback_parameter)
	T_Poll_Wait_Time timer callback. More...
void	mac_t_response_wait_cb (void *callback_parameter)
	Handle T_Poll_Wait_Time timer after successful transmission of an association request frame and before sending out the subsequent data request frame. More...
void	mac_trx_init_sleep (void)
	MAC function to put the radio to sleep mode. More...
void	mac_trx_wakeup (void)
	MAC function to wake-up the radio from sleep state. More...
bool	mac_tx_coord_realignment_command (frame_msgtype_t cmd_type, buffer_t *buf_ptr, uint16_t new_panid, uint8_t new_channel, uint8_t new_page)
	Sends a coordinator realignment command frame. More...
retval_t	set_tal_pib_internal (uint8_t attribute, pib_value_t *attribute_value)
	Wakes-up the radio and sets the corresponding TAL PIB attribute. More...

#define MAKE_MAC_BUSY

(

)

Value:

do { \
		mac_busy = true; \
} \
    while (0)

This macro sets the MAC to busy.

Referenced by mac_awake_disassociate(), mac_build_and_tx_beacon(), mac_build_and_tx_data_req(), mac_handle_tx_null_data_frame(), mac_process_data_request(), mac_process_tal_tx_status(), mac_tx_coord_realignment_command(), mcps_data_request(), mlme_associate_request(), scan_set_complete(), send_scan_cmd(), and tx_pan_id_conf_notif().

#define MAKE_MAC_NOT_BUSY

(

)

Value:

do { \
		mac_busy = false; \
} \
    while (0)

This macro sets the MAC to not busy.

Referenced by mac_process_data_response(), mac_t_poll_wait_time_cb(), tal_ed_end_cb(), and tal_tx_frame_done_cb().

void dispatch_event

(

uint8_t *

event

)

Obtains the message type from the buffer and calls the respective handler.

This function decodes all events/messages and calls the appropriate handler.

Parameters

event

Pointer to the buffer header whose body part holds the message type and message elemnets

References Assert, bmm_buffer_free(), BMM_BUFFER_POINTER, CMD_ID_OCTET, LAST_MESSAGE, and PGM_READ_WORD.

Referenced by mac_task(), and wpan_task().

void mac_build_and_tx_beacon	(	bool	beacon_enabled,
		buffer_t *	beacon_buffer_header
	)

Builds and transmits the beacon frame.

This function is called to build a beacon frame. For beaconless network this function also transmits the generated beacon frame.

Parameters

beacon_enabled	Flag indicating the mode of beacon transmission
beacon_buffer_header	For build without beacon support only: Pointer to buffer of beacon frame to be transmitted in nonbeacon network.

References ASSOC_PERMIT_BIT_POS, BATT_LIFE_EXT_BIT_POS, BEACON_MESSAGE, BEACON_PAYLOAD_LEN, BMM_BUFFER_POINTER, frame_info_tag::buffer_header, CCPU_ENDIAN_TO_LE16, convert_16_bit_to_byte_array(), convert_64_bit_to_byte_array(), convert_spec_16_bit_to_byte_array(), CSMA_UNSLOTTED, mcps_data_req_tag::DstPANId, FCF_FRAME_PENDING, FCF_FRAME_VERSION_2006, FCF_FRAMETYPE_BEACON, FCF_LONG_ADDR, FCF_SECURITY_ENABLED, FCF_SET_FRAMETYPE, FCF_SET_SOURCE_ADDR_MODE, FCF_SHORT_ADDR, FINAL_CAP_SLOT_DEFAULT, indirect_data_q, LARGE_BUFFER_SIZE, mac_pib_tag::mac_AssociationPermit, mac_beacon_payload, mac_pib_tag::mac_BeaconPayloadLength, mac_pib_tag::mac_BSN, mac_buffer_add_pending(), MAC_COORDINATOR, MAC_NO_SHORT_ADDR_VALUE, MAC_PAN_COORD_STARTED, mac_pib, mac_state, MAC_SUCCESS, MAKE_MAC_BUSY, frame_info_tag::mpdu, mcps_data_req_tag::msduLength, frame_info_tag::msg_type, NON_BEACON_NWK, PAN_COORD_BIT_POS, mac_pib_tag::privateVirtualPANs, queue_tag::size, mcps_data_req_tag::SrcAddrMode, tal_pib, tal_tx_frame(), and vpan_no.

Referenced by mac_process_beacon_request().

bool mac_build_and_tx_data_req	(	bool	expl_poll,
		bool	force_own_long_addr,
		uint8_t	expl_dest_addr_mode,
		address_field_t *	expl_dest_addr,
		uint16_t	expl_dest_pan_id
	)

Build and transmits data request command frame.

This function builds and transmits a data request command frame.

Parameters

expl_poll	Data request due to explicit MLME poll request
force_own_long_addr	Forces the usage of the Extended Address as Source Address. This a allows for implicitly poll for pending data at the coordinator if the Extended Address was used in the Beacon frame.
expl_dest_addr_mode	Mode of subsequent destination address to be used explicitly (0/2/3). 0: No explicit destination address attached, use either macCoordShortAddress or macCoordExtendedAddress 2: Use explicitly attached address in parameter expl_dest_addr as destination address as short address 3: Use explicitly attached address in parameter expl_dest_addr as destination address as extended address
expl_dest_addr	Explicitly attached destination address for data request frame. This is to be treated as either not present, short or extended address, depending on parameter expl_dest_addr_mode.
expl_dest_pan_id	Explicitly attached destination PAN-Id (Coordinator PAN-Id) for data request frame. This is to be treated only as present, depending on parameter expl_dest_addr_mode.

Returns

True if data request command frame was created and sent to the TAL successfully, false otherwise.

References bmm_buffer_alloc(), bmm_buffer_free(), BMM_BUFFER_POINTER, BROADCAST, frame_info_tag::buffer_header, CCPU_ENDIAN_TO_LE16, convert_16_bit_to_byte_array(), convert_64_bit_to_byte_array(), convert_spec_16_bit_to_byte_array(), CSMA_SLOTTED, CSMA_UNSLOTTED, DATA_REQ_PAYLOAD_LEN, DATAREQUEST, DATAREQUEST_IMPL_POLL, FCF_ACK_REQUEST, FCF_FRAMETYPE_MAC_CMD, FCF_LONG_ADDR, FCF_NO_ADDR, FCF_PAN_ID_COMPRESSION, FCF_SET_DEST_ADDR_MODE, FCF_SET_FRAMETYPE, FCF_SET_SOURCE_ADDR_MODE, FCF_SHORT_ADDR, LARGE_BUFFER_SIZE, address_field_t::long_address, MAC_ASSOCIATED, mac_pib_tag::mac_CoordExtendedAddress, MAC_COORDINATOR, mac_pib_tag::mac_CoordShortAddress, mac_pib_tag::mac_DSN, MAC_IDLE, MAC_NO_SHORT_ADDR_VALUE, mac_pib, MAC_START_REQUEST_CONFIRM, mac_state, MAC_SUCCESS, MAC_SYNC_BEFORE_ASSOC, mac_sync_state, MAKE_MAC_BUSY, frame_info_tag::mpdu, frame_info_tag::msg_type, NON_BEACON_NWK, address_field_t::short_address, tal_pib, and tal_tx_frame().

Referenced by mac_process_beacon_frame(), mac_process_data_frame(), mac_t_response_wait_cb(), and mlme_poll_request().

static void mac_check_persistence_timer ( void  )

inlinestatic

References mac_start_persistence_timer(), pal_is_timer_running(), and T_Data_Persistence.

Referenced by mcps_data_request(), mlme_associate_response(), and mlme_disassociate_request().

void mac_coord_realignment_command_tx_success	(	uint8_t	tx_status,
		buffer_t *	buf_ptr
	)

Continues handling of MLME_START.request (Coordinator realignment) command.

This function is called once the coordinator realignment command is sent out to continue the handling of the MLME_START.request command.

Parameters

tx_status	Status of the coordinator realignment command transmission
buf_ptr	Buffer for start confirmation

References Assert, mlme_start_req_tag::BeaconOrder, mlme_start_req_tag::ChannelPage, gen_mlme_start_conf(), mlme_start_req_tag::LogicalChannel, MAC_INVALID_PARAMETER, mac_sleep_trans(), MAC_SUCCESS, macBattLifeExt, macBeaconOrder, macPANId, macSuperframeOrder, NON_BEACON_NWK, mlme_start_req_tag::PANId, phyCurrentChannel, phyCurrentPage, set_tal_pib_internal(), mlme_start_req_tag::SuperframeOrder, and tal_pib.

Referenced by mac_process_tal_tx_status().

void mac_gen_mcps_data_conf	(	buffer_t *	buf_ptr,
		uint8_t	status,
		uint8_t	handle,
		uint32_t	timestamp
	)

References BMM_BUFFER_POINTER, mcps_data_conf_tag::cmdcode, mac_nhle_q, MCPS_DATA_CONFIRM, mcps_data_conf_tag::msduHandle, qmm_queue_append(), mcps_data_conf_tag::status, and mcps_data_conf_tag::Timestamp.

Referenced by handle_exp_persistence_timer(), mac_process_tal_tx_status(), and mcps_data_request().

void mac_gen_mlme_associate_conf	(	buffer_t *	buf_ptr,
		uint8_t	status,
		uint16_t	assoc_short_addr
	)

References mlme_associate_conf_tag::AssocShortAddress, BMM_BUFFER_POINTER, mlme_associate_conf_tag::cmdcode, mac_nhle_q, MLME_ASSOCIATE_CONFIRM, qmm_queue_append(), and mlme_associate_conf_tag::status.

Referenced by mac_process_associate_response(), mac_process_tal_tx_status(), mac_t_assocresponsetime_cb(), mac_t_response_wait_cb(), and mlme_associate_request().

void mac_handle_tx_null_data_frame

(

void

)

References bmm_buffer_free(), BMM_BUFFER_POINTER, build_null_data_frame(), MAC_SUCCESS, MAKE_MAC_BUSY, NO_CSMA_WITH_IFS, and tal_tx_frame().

Referenced by mac_process_data_request(), mac_process_tal_data_ind(), and process_data_ind_not_transient().

void mac_idle_trans

(

void

)

Resets the MAC helper variables and transition to idle state.

This function sets the MAC to idle state and resets MAC helper variables

References Assert, mac_sleep_trans(), mac_soft_reset(), MAC_SUCCESS, mac_trx_wakeup(), macPANId, macPANId_def, macShortAddress, macShortAddress_def, and set_tal_pib_internal().

Referenced by mac_process_tal_data_ind(), mac_process_tal_tx_status(), and process_data_ind_not_transient().

void mac_mlme_comm_status	(	uint8_t	status,
		buffer_t *	buf_ptr
	)

Creates a Communication Status Indication message to the upper layer.

Parameters

status	Status of the last operation
buf_ptr	Buffer for Communication Status Indication to the NHLE

References BMM_BUFFER_POINTER, mlme_comm_status_ind_tag::cmdcode, mlme_comm_status_ind_tag::DstAddr, mlme_comm_status_ind_tag::DstAddrMode, FCF_LONG_ADDR, mac_nhle_q, MLME_COMM_STATUS_INDICATION, frame_info_tag::mpdu, mlme_comm_status_ind_tag::PANId, PL_POS_DST_ADDR_START, qmm_queue_append(), mlme_comm_status_ind_tag::SrcAddr, mlme_comm_status_ind_tag::SrcAddrMode, mlme_comm_status_ind_tag::status, and tal_pib.

Referenced by handle_exp_persistence_timer(), mac_process_tal_tx_status(), mlme_associate_response(), and mlme_orphan_response().

void mac_prep_disassoc_conf	(	buffer_t *	buf,
		uint8_t	status
	)

Prepares a disassociation confirm message with device address information.

This functions prepares a disassociation confirm message in case the device address information needs to be extracted.

Parameters

buf	Buffer for sending MLME disassociate confirm message to NHLE
status	Status of disassociation

References BMM_BUFFER_POINTER, BROADCAST, CCPU_ENDIAN_TO_LE16, convert_byte_array_to_16_bit(), convert_byte_array_to_64_bit(), FCF_2_DEST_ADDR_OFFSET, FCF_LONG_ADDR, FCF_SHORT_ADDR, mac_pib_tag::mac_CoordExtendedAddress, MAC_COORDINATOR, mac_pib_tag::mac_CoordShortAddress, mac_gen_mlme_disassociate_conf(), MAC_NO_SHORT_ADDR_VALUE, MAC_PAN_COORD_STARTED, mac_pib, mac_state, frame_info_tag::mpdu, PL_POS_DST_ADDR_START, PL_POS_FCF_2, and tal_pib.

Referenced by handle_exp_persistence_timer(), and mac_process_tal_tx_status().

void mac_process_associate_request

(

buffer_t *

assoc_req

)

Processes a received association request command frame.

This function will process a received association request command frame and generates a MLME associate indication to the NHLE.

Parameters

assoc_req

Specifies a pointer to the received association request frame

References ADDR_COPY_DST_SRC_64, frame_payload_t::assoc_req_data, bmm_buffer_free(), BMM_BUFFER_POINTER, mlme_associate_ind_tag::CapabilityInformation, mlme_associate_ind_tag::cmdcode, mlme_associate_ind_tag::DeviceAddress, address_field_t::long_address, mac_pib_tag::mac_AssociationPermit, mac_nhle_q, mac_parse_data, parse_tag::mac_payload_data, mac_pib, MLME_ASSOCIATE_INDICATION, qmm_queue_append(), and parse_tag::src_addr.

Referenced by mac_process_tal_data_ind(), and process_data_ind_not_transient().

void mac_process_associate_response

(

buffer_t *

assoc_resp

)

Processing of an associaton reponse command frame.

This function processes the received association response command frame.

Parameters

assoc_resp

Association response receive buffer

References ADDR_COPY_DST_SRC_64, Assert, frame_payload_t::assoc_response_data, ASSOCIATION_SUCCESSFUL, bmm_buffer_free(), INVALID_SHORT_ADDRESS, address_field_t::long_address, MAC_ASSOCIATED, mac_conf_buf_ptr, mac_pib_tag::mac_CoordExtendedAddress, mac_pib_tag::mac_CoordShortAddress, mac_gen_mlme_associate_conf(), mac_parse_data, parse_tag::mac_payload_data, mac_pib, MAC_POLL_IDLE, mac_poll_state, mac_sleep_trans(), mac_state, MAC_SUCCESS, MAC_SYNC_BEFORE_ASSOC, mac_sync_state, MAC_SYNC_TRACKING_BEACON, macCoordShortAddress_def, macPANId, macPANId_def, macShortAddress, set_tal_pib_internal(), and parse_tag::src_addr.

Referenced by mac_process_tal_data_ind().

void mac_process_beacon_frame

(

buffer_t *

beacon

)

Processes received beacon frame.

This function processes a received beacon frame. When the system is scanning it records PAN descriptor information contained in the beacon. These PAN descriptors will be reported to the next higher layer via MLME_SCAN.confirm. Also this routine constructs the MLME_BEACON_NOTIFY.indication. Additionally when a device is synced with the coordinator, it tracks beacon frames, checks whether the coordinator does have pending data and will initiate the transmission of a data request frame. The routine uses global "parse_data" structure. The PAN descriptors are stored in the mlme_scan_conf_t structure.

Parameters

beacon

Pointer to the buffer in which the beacon was received

References wpan_addr_spec_tag::Addr, ADDR_COPY_DST_SRC_16, ADDR_COPY_DST_SRC_64, mlme_beacon_notify_ind_tag::AddrList, wpan_addr_spec_tag::AddrMode, aMaxSIFSFrameSize, Assert, aUnitBackoffPeriod, frame_payload_t::beacon_data, mac_beacon_payload_tag::beacon_payload_len, bmm_buffer_free(), BMM_BUFFER_POINTER, mlme_beacon_notify_ind_tag::BSN, wpan_pandescriptor_tag::ChannelPage, mlme_beacon_notify_ind_tag::cmdcode, convert_byte_array_to_16_bit(), convert_byte_array_to_64_bit(), wpan_pandescriptor_tag::CoordAddrSpec, parse_tag::fcf, FCF_FRAME_PENDING, FCF_SHORT_ADDR, FUNC_PTR, GET_BEACON_ORDER, GET_FINAL_CAP, GET_GTS_PERMIT, GET_SUPERFRAME_ORDER, mac_beacon_payload_tag::gts_spec, wpan_pandescriptor_tag::GTSPermit, wpan_pandescriptor_tag::LinkQuality, wpan_pandescriptor_tag::LogicalChannel, address_field_t::long_address, mac_pib_tag::mac_AutoRequest, mac_pib_tag::mac_BattLifeExtPeriods, mac_build_and_tx_data_req(), mac_conf_buf_ptr, mac_pib_tag::mac_MaxFrameTotalWaitTime, mac_nhle_q, MAC_NO_DATA, MAC_PAN_COORD_STARTED, mac_parse_data, parse_tag::mac_payload_data, mac_pib, MAC_POLL_IDLE, mac_poll_state, MAC_SCAN_ACTIVE, MAC_SCAN_IDLE, MAC_SCAN_PASSIVE, mac_scan_state, mac_state, MAC_SUCCESS, MAC_SYNC_NEVER, mac_sync_state, macBeaconOrder, macMinLIFSPeriod_def, macMinSIFSPeriod_def, macSuperframeOrder, MAX_PANDESCRIPTORS, MLME_BEACON_NOTIFY_INDICATION, parse_tag::mpdu_length, NON_BEACON_NWK, NUM_LONG_PEND_ADDR, NUM_SHORT_PEND_ADDR, pal_timer_start(), mlme_beacon_notify_ind_tag::PANDescriptor, wpan_addr_spec_tag::PANId, mlme_beacon_notify_ind_tag::PendAddrSpec, mac_beacon_payload_tag::pending_addr_list, mac_beacon_payload_tag::pending_addr_spec, PHY_OVERHEAD, parse_tag::ppdu_link_quality, qmm_queue_append(), mlme_scan_conf_tag::ResultListSize, mlme_scan_conf_tag::scan_result_list, mlme_beacon_notify_ind_tag::sdu, mlme_beacon_notify_ind_tag::sduLength, parse_tag::sequence_number, set_tal_pib_internal(), address_field_t::short_address, parse_tag::src_addr, parse_tag::src_addr_mode, parse_tag::src_panid, mac_beacon_payload_tag::superframe_spec, wpan_pandescriptor_tag::SuperframeSpec, SYMBOLS_PER_OCTET, T_Poll_Wait_Time, TAL_CONVERT_SYMBOLS_TO_US, tal_pib, parse_tag::time_stamp, TIMEOUT_RELATIVE, wpan_pandescriptor_tag::TimeStamp, and WPAN_ADDRMODE_SHORT.

Referenced by process_data_ind_not_transient(), and process_data_ind_scanning().

void mac_process_beacon_request

(

buffer_t *

msg

)

Processes a beacon request.

This function is called in case a beacon request frame has been received by a coordinator. In a nonbeacon-enabled PAN the generation of a beacon frame using CSMA-CA is initiated. In a beacon-enabled PAN no extra beacon frame will be transmitted apart from the standard beacon frames.

Parameters

msg	Pointer to the buffer in which the beaocn request was received

References bmm_buffer_free(), mac_build_and_tx_beacon(), NON_BEACON_NWK, and tal_pib.

Referenced by mac_process_tal_data_ind(), and process_data_ind_not_transient().

void mac_process_coord_realign

(

buffer_t *

ind

)

Processing a coordinator realignment command frame.

This function processes a coordinator realignment command frame received from the coordinator (while NOT being in the middle of an Orphan scan, but rather after initiation of a start request primitive from the coordinator indicating realingment. The PAN ID, coord. short address, logical channel, and the device's new short address will be written to the PIB.

Parameters

ind	Frame reception buffer

References Assert, bmm_buffer_free(), BROADCAST, mac_coord_realign_tag::channel_page, frame_payload_t::coord_realign_data, parse_tag::fcf, FCF_FRAME_VERSION_2006, mac_coord_realign_tag::logical_channel, mac_pib_tag::mac_CoordShortAddress, mac_parse_data, parse_tag::mac_payload_data, mac_pib, MAC_REALIGNMENT, MAC_SUCCESS, mac_sync_loss(), macPANId, macShortAddress, mac_coord_realign_tag::pan_id, phyCurrentChannel, phyCurrentPage, set_tal_pib_internal(), and mac_coord_realign_tag::short_addr.

Referenced by mac_process_tal_data_ind(), and process_data_ind_not_transient().

void mac_process_data_frame

(

buffer_t *

buf_ptr

)

Processes data frames.

This function processes the data frames received and sends mcps_data_indication to the NHLE.

Parameters

buf_ptr

Pointer to receive buffer of the data frame

References ADDR_COPY_DST_SRC_16, ADDR_COPY_DST_SRC_64, bmm_buffer_free(), BMM_BUFFER_POINTER, frame_payload_t::data, parse_tag::dest_addr, parse_tag::dest_addr_mode, parse_tag::dest_panid, parse_tag::fcf, FCF_FRAME_PENDING, FCF_LONG_ADDR, FCF_SHORT_ADDR, address_field_t::long_address, mac_build_and_tx_data_req(), mac_last_dsn, mac_last_src_addr, mac_nhle_q, MAC_PAN_COORD_STARTED, mac_parse_data, parse_tag::mac_payload_data, parse_tag::mac_payload_length, mac_sleep_trans(), mac_state, MCPS_DATA_INDICATION, mac_data_payload_tag::payload, parse_tag::ppdu_link_quality, qmm_queue_append(), parse_tag::sequence_number, address_field_t::short_address, parse_tag::src_addr, parse_tag::src_addr_mode, parse_tag::src_panid, and parse_tag::time_stamp.

Referenced by mac_process_tal_data_ind(), and process_data_ind_not_transient().

void mac_process_data_request

(

buffer_t *

msg

)

Processes a received data request command frame.

This function processes a received data request command frame at the coordinator, searches for pending indirect data frames for the originator and initiates the frame transmission of the data frame with CSMA-CA.

Parameters

msg	Frame reception buffer pointer

References Assert, bmm_buffer_free(), BMM_BUFFER_POINTER, frame_info_tag::buffer_header, convert_byte_array_to_16_bit(), search_t::criteria_func, FCF_FRAME_PENDING, FCF_LONG_ADDR, FCF_SECURITY_ENABLED, FCF_SHORT_ADDR, find_long_buffer(), find_short_buffer(), search_t::handle, indirect_data_q, frame_info_tag::indirect_in_transit, address_field_t::long_address, MAC_ASSOCIATED, mac_handle_tx_null_data_frame(), MAC_IDLE, mac_parse_data, mac_state, MAC_SUCCESS, MAKE_MAC_BUSY, frame_info_tag::mpdu, NO_CSMA_WITH_IFS, PL_POS_DST_PAN_ID_START, PL_POS_FCF_1, qmm_queue_read(), address_field_t::short_address, parse_tag::src_addr, parse_tag::src_addr_mode, parse_tag::src_panid, and tal_tx_frame().

Referenced by mac_process_tal_data_ind(), and process_data_ind_not_transient().

void mac_process_data_response

(

void

)

Processes a data response to an MLME-POLL.request.

This function processes a data response to an MLME-POLL.request. Our coordinator has responded with a data frame. It is checked whether any data has been received, and the appropriate MLME-POLL.confirm message is constructed.

References Assert, FCF_FRAMETYPE_BEACON, FCF_FRAMETYPE_DATA, parse_tag::frame_type, gen_mlme_poll_conf(), mac_conf_buf_ptr, MAC_NO_DATA, mac_parse_data, parse_tag::mac_payload_length, MAC_POLL_EXPLICIT, MAC_POLL_IDLE, mac_poll_state, MAC_SUCCESS, MAKE_MAC_NOT_BUSY, pal_is_timer_running(), pal_timer_stop(), and T_Poll_Wait_Time.

Referenced by mac_process_tal_data_ind().

void mac_process_disassociate_notification

(

buffer_t *

msg

)

Process a disassociation notification command.

This functions processes a received disassociation notification command frame. Actual data are taken from the incoming frame in mac_parse_buffer.

Parameters

msg	Frame buffer to be filled in

References ADDR_COPY_DST_SRC_64, BMM_BUFFER_POINTER, mlme_disassociate_ind_tag::cmdcode, mlme_disassociate_ind_tag::DeviceAddress, frame_payload_t::disassoc_req_data, mlme_disassociate_ind_tag::DisassociateReason, INVALID_SHORT_ADDRESS, address_field_t::long_address, mac_pib_tag::mac_CoordExtendedAddress, mac_pib_tag::mac_CoordShortAddress, mac_nhle_q, mac_parse_data, parse_tag::mac_payload_data, mac_pib, MLME_DISASSOCIATE_INDICATION, qmm_queue_append(), and parse_tag::src_addr.

Referenced by mac_process_tal_data_ind(), and process_data_ind_not_transient().

void mac_process_orphan_notification

(

buffer_t *

msg

)

Handles an orphan notification.

This function processes an incoming orphan notification command. A PAN coordinator gets to this function through a TAL data indication message.

Parameters

msg	Frame reception buffer

References ADDR_COPY_DST_SRC_64, BMM_BUFFER_POINTER, mlme_orphan_ind_tag::cmdcode, address_field_t::long_address, mac_nhle_q, mac_parse_data, MLME_ORPHAN_INDICATION, mlme_orphan_ind_tag::OrphanAddress, qmm_queue_append(), and parse_tag::src_addr.

Referenced by mac_process_tal_data_ind(), and process_data_ind_not_transient().

void mac_process_orphan_realign

(

buffer_t *

buf_ptr

)

Processing a coordinator realignment command frame during Orphan scan.

This function processes a coordinator realignment command frame received as a response to the reception of an orphan notification command frame (i.e. while being in the middle of an orphan scan procedure). The PAN ID, coord. short address, logical channel, and the device's new short address will be written to the PIB.

Parameters

ind	Frame reception buffer

References Assert, bmm_buffer_free(), BMM_BUFFER_POINTER, BROADCAST, mac_coord_realign_tag::channel_page, mlme_scan_conf_tag::cmdcode, frame_payload_t::coord_realign_data, parse_tag::fcf, FCF_FRAME_VERSION_2006, mac_coord_realign_tag::logical_channel, mac_conf_buf_ptr, mac_pib_tag::mac_CoordShortAddress, mac_nhle_q, mac_parse_data, parse_tag::mac_payload_data, mac_pib, mac_scan_cmd_buf_ptr, MAC_SCAN_IDLE, mac_scan_state, mac_sleep_trans(), MAC_SUCCESS, macPANId, macShortAddress, MLME_SCAN_CONFIRM, MLME_SCAN_TYPE_ORPHAN, mac_coord_realign_tag::pan_id, phyCurrentChannel, phyCurrentPage, qmm_queue_append(), mlme_scan_conf_tag::ResultListSize, scan_set_complete(), mlme_scan_conf_tag::ScanType, set_tal_pib_internal(), mac_coord_realign_tag::short_addr, mlme_scan_conf_tag::status, and mlme_scan_conf_tag::UnscannedChannels.

Referenced by process_data_ind_scanning().

void mac_process_tal_data_ind

(

uint8_t *

msg

)

Depending on received frame the appropriate function is called.

Parameters

msg	Pointer to the buffer header.

References Assert, ASSOCIATIONREQUEST, ASSOCIATIONRESPONSE, BEACONREQUEST, bmm_buffer_free(), BMM_BUFFER_POINTER, COORDINATORREALIGNMENT, DATAREQUEST, DISASSOCIATIONNOTIFICATION, FCF_FRAMETYPE_DATA, FCF_FRAMETYPE_MAC_CMD, parse_tag::frame_type, indirect_data_q, LQI_LEN, MAC_AWAIT_ASSOC_RESPONSE, mac_busy, parse_tag::mac_command, MAC_COORDINATOR, mac_handle_tx_null_data_frame(), mac_idle_trans(), mac_parse_data, MAC_POLL_EXPLICIT, MAC_POLL_IDLE, MAC_POLL_IMPLICIT, mac_poll_state, mac_process_associate_request(), mac_process_associate_response(), mac_process_beacon_request(), mac_process_coord_realign(), mac_process_data_frame(), mac_process_data_request(), mac_process_data_response(), mac_process_disassociate_notification(), mac_process_orphan_notification(), MAC_SCAN_IDLE, mac_scan_state, mac_state, frame_info_tag::mpdu, parse_tag::mpdu_length, ORPHANNOTIFICATION, pal_is_timer_running(), pal_timer_stop(), PANIDCONFLICTNOTIFICAION, parse_mpdu(), parse_tag::ppdu_link_quality, process_data_ind_not_transient(), process_data_ind_scanning(), qmm_queue_append(), queue_tag::size, T_Poll_Wait_Time, tal_mac_q, and tal_pib.

void mac_scan_send_complete

(

retval_t

status

)

Continue scanning after the completion of frame transmission.

This functions continues the corresponding scaning depending on status from the transmission of a beacon request or orphan notification frame.

Parameters

status

Status of transmission

References Assert, FUNC_PTR, MAC_CALCULATE_SYMBOL_TIME_SCANDURATION, mac_conf_buf_ptr, mac_pib_tag::mac_DSN, mac_pib, mac_pib_tag::mac_ResponseWaitTime, MAC_SCAN_ACTIVE, mac_scan_state, MAC_SUCCESS, mac_t_scan_duration_cb(), pal_timer_start(), scan_curr_channel, scan_duration, scan_proceed(), scan_type, T_Scan_Duration, TAL_CONVERT_SYMBOLS_TO_US, and TIMEOUT_RELATIVE.

Referenced by tal_tx_frame_done_cb().

void mac_sleep_trans

(

void

)

Puts the radio to sleep if this is allowed.

References MAC_INACTIVE, mac_pib, mac_rx_enabled, mac_pib_tag::mac_RxOnWhenIdle, MAC_SYNC_NEVER, mac_sync_state, mac_trx_init_sleep(), NON_BEACON_NWK, pal_is_timer_running(), and tal_pib.

Referenced by gen_mlme_poll_conf(), mac_awake_scan(), mac_coord_realignment_command_tx_success(), mac_idle_trans(), mac_init(), mac_process_associate_response(), mac_process_data_frame(), mac_process_orphan_realign(), mac_process_tal_tx_status(), mac_sync_loss(), mac_t_assocresponsetime_cb(), mac_t_rx_off_cb(), mcps_data_request(), mlme_associate_request(), mlme_disassociate_request(), mlme_reset_request(), mlme_set(), mlme_start_request(), process_data_ind_not_transient(), scan_clean_up(), scan_proceed(), and set_tal_pib_internal().

void mac_start_persistence_timer

(

void

)

References Assert, BO_USED_FOR_MAC_PERS_TIME, FAILURE, FUNC_PTR, MAC_SUCCESS, mac_t_persistence_cb(), NON_BEACON_NWK, pal_timer_start(), T_Data_Persistence, TAL_CONVERT_SYMBOLS_TO_US, TAL_GET_BEACON_INTERVAL_TIME, tal_pib, and TIMEOUT_RELATIVE.

Referenced by mac_check_persistence_timer(), and mac_t_persistence_cb().

void mac_sync_loss

(

uint8_t

loss_reason

)

Function to initiate MLME-SYNC-LOSS.indication to NHLE.

Parameters

loss_reason

MAC_REALIGNMENT if sync loss is due to receiving coordinator realignment command and MAC_BEACON_LOSS if beacon was lost following a sync request.

References buffer_t::body, mlme_sync_loss_ind_tag::cmdcode, MAC_ASSOCIATED, MAC_IDLE, mac_nhle_q, MAC_POLL_IDLE, mac_poll_state, MAC_SCAN_IDLE, mac_scan_orig_channel, mac_scan_orig_page, mac_scan_orig_panid, mac_scan_state, mac_sleep_trans(), mac_state, MAC_SYNC_NEVER, mac_sync_state, MLME_SYNC_LOSS_INDICATION, qmm_queue_append(), and tal_pib.

Referenced by check_for_pan_id_conflict_as_pc(), mac_process_coord_realign(), mac_process_tal_tx_status(), and process_data_ind_not_transient().

void mac_t_assocresponsetime_cb

(

void *

callback_parameter

)

References Assert, BROADCAST, mac_conf_buf_ptr, mac_pib_tag::mac_CoordExtendedAddress, mac_pib_tag::mac_CoordShortAddress, mac_gen_mlme_associate_conf(), MAC_NO_DATA, mac_pib, MAC_POLL_IDLE, mac_poll_state, mac_sleep_trans(), MAC_SUCCESS, macCoordShortAddress_def, macPANId, macPANId_def, and set_tal_pib_internal().

Referenced by mac_t_response_wait_cb().

void mac_t_poll_wait_time_cb

(

void *

callback_parameter

)

T_Poll_Wait_Time timer callback.

This function implements the T_Poll_Wait_Time timer callback. If a poll request is pending, a mlme-poll-confirm is generated.

Parameters

callback_parameter

Callback parameter

References gen_mlme_poll_conf(), mac_conf_buf_ptr, MAC_NO_DATA, MAC_POLL_EXPLICIT, MAC_POLL_IDLE, mac_poll_state, and MAKE_MAC_NOT_BUSY.

Referenced by mac_process_tal_tx_status().

void mac_t_response_wait_cb

(

void *

callback_parameter

)

Handle T_Poll_Wait_Time timer after successful transmission of an association request frame and before sending out the subsequent data request frame.

Parameters

callback_parameter

Callback parameter.

References Assert, FUNC_PTR, INVALID_SHORT_ADDRESS, mac_build_and_tx_data_req(), MAC_CHANNEL_ACCESS_FAILURE, mac_conf_buf_ptr, mac_gen_mlme_associate_conf(), mac_pib, mac_pib_tag::mac_ResponseWaitTime, MAC_SUCCESS, mac_t_assocresponsetime_cb(), pal_timer_start(), T_Poll_Wait_Time, TAL_CONVERT_SYMBOLS_TO_US, and TIMEOUT_RELATIVE.

Referenced by mac_process_tal_tx_status().

void mac_trx_init_sleep

(

void

)

MAC function to put the radio to sleep mode.

References mac_radio_sleep_state, MAC_SUCCESS, pal_timer_source_select(), RADIO_AWAKE, RADIO_SLEEPING, SLEEP_MODE_1, tal_trx_sleep(), TMR_CLK_SRC_DURING_TRX_AWAKE, and TMR_CLK_SRC_DURING_TRX_SLEEP.

Referenced by mac_sleep_trans().

void mac_trx_wakeup

(

void

)

MAC function to wake-up the radio from sleep state.

References FAILURE, mac_radio_sleep_state, pal_timer_source_select(), RADIO_AWAKE, RADIO_SLEEPING, tal_trx_wakeup(), and TMR_CLK_SRC_DURING_TRX_AWAKE.

Referenced by mac_idle_trans(), mac_rx_enable(), mcps_data_request(), mlme_associate_request(), mlme_disassociate_request(), mlme_poll_request(), mlme_reset_request(), mlme_scan_request(), mlme_set(), mlme_start_request(), process_data_ind_not_transient(), and set_tal_pib_internal().

bool mac_tx_coord_realignment_command	(	frame_msgtype_t	cmd_type,
		buffer_t *	buf_ptr,
		uint16_t	new_panid,
		uint8_t	new_channel,
		uint8_t	new_page
	)

Sends a coordinator realignment command frame.

This function is called either in response to the reception of an orphan notification command from a device (cmd_type = ORPHANREALIGNMENT), or gratuitously whenever the PAN parameters are about to be changed (cmd_type = COORDINATORREALIGNMENT). In the first case, the paramater mor contains a pointer to the respective MLME_ORPHAN.response message, while in the latter case this parameter is unused, and can be passed as NULL.

Parameters

cmd_type	Determines directed or broadcast mode
buf_ptr	Pointer to the buffer, using which coord_realignment_command to be sent
new_panid	Contains the new PAN-ID in case there is a network realignment
new_channel	Contains the new channel in case there is a network realignment
new_page	Contains the new channel page in case there is a network realignment

Returns

True if coord_realignment_command is sent successfully, false otherwise

References BMM_BUFFER_POINTER, BROADCAST, frame_info_tag::buffer_header, convert_16_bit_to_byte_array(), convert_64_bit_to_byte_array(), convert_spec_16_bit_to_byte_array(), COORD_REALIGN_PAYLOAD_LEN, COORDINATORREALIGNMENT, CSMA_SLOTTED, CSMA_UNSLOTTED, FCF_ACK_REQUEST, FCF_FRAME_VERSION_2006, FCF_FRAMETYPE_MAC_CMD, FCF_LONG_ADDR, FCF_SET_DEST_ADDR_MODE, FCF_SET_FRAMETYPE, FCF_SET_SOURCE_ADDR_MODE, FCF_SHORT_ADDR, LARGE_BUFFER_SIZE, mac_pib_tag::mac_DSN, mac_pib, MAC_SUCCESS, MAKE_MAC_BUSY, frame_info_tag::mpdu, frame_info_tag::msg_type, NON_BEACON_NWK, mlme_orphan_resp_tag::OrphanAddress, ORPHANREALIGNMENT, qmm_queue_append(), QUEUE_FULL, mlme_orphan_resp_tag::ShortAddress, tal_pib, and tal_tx_frame().

Referenced by mlme_orphan_response(), and mlme_start_request().

retval_t set_tal_pib_internal	(	uint8_t	attribute,
		pib_value_t *	attribute_value
	)

Wakes-up the radio and sets the corresponding TAL PIB attribute.

Parameters

attribute	PIB attribute to be set
attribute_value	Attribute value to be set

Returns

Status of the attempt to set the TAL PIB attribute

References mac_radio_sleep_state, mac_sleep_trans(), mac_trx_wakeup(), RADIO_SLEEPING, and tal_pib_set().

Referenced by mac_awake_scan(), mac_coord_realignment_command_tx_success(), mac_idle_trans(), mac_process_associate_response(), mac_process_beacon_frame(), mac_process_coord_realign(), mac_process_orphan_realign(), mac_t_assocresponsetime_cb(), mlme_associate_request(), mlme_start_request(), process_data_ind_not_transient(), scan_clean_up(), and scan_proceed().