1.3.5.1.8 MAC_RF_PIB_ATTRIBUTE Enum
C
typedef enum
{
MAC_PIB_DSN_RF = 0x00000200,
MAC_PIB_MAX_BE_RF = 0x00000201,
MAC_PIB_MAX_CSMA_BACKOFFS_RF = 0x00000202,
MAC_PIB_MAX_FRAME_RETRIES_RF = 0x00000203,
MAC_PIB_MIN_BE_RF = 0x00000204,
MAC_PIB_TIMESTAMP_SUPPORTED_RF = 0x00000205,
MAC_PIB_DEVICE_TABLE_RF = 0x00000206,
MAC_PIB_FRAME_COUNTER_RF = 0x00000207,
MAC_PIB_DUPLICATE_DETECTION_TTL_RF = 0x00000208,
MAC_PIB_COUNTER_OCTETS_RF = 0x00000209,
MAC_PIB_RETRY_COUNT_RF = 0x0000020A,
MAC_PIB_MULTIPLE_RETRY_COUNT_RF = 0x0000020B,
MAC_PIB_TX_FAIL_COUNT_RF = 0x0000020C,
MAC_PIB_TX_SUCCESS_COUNT_RF = 0x0000020D,
MAC_PIB_FCS_ERROR_COUNT_RF = 0x0000020E,
MAC_PIB_SECURITY_FAILURE_COUNT_RF = 0x0000020F,
MAC_PIB_DUPLICATE_FRAME_COUNT_RF = 0x00000210,
MAC_PIB_RX_SUCCESS_COUNT_RF = 0x00000211,
MAC_PIB_NACK_COUNT_RF = 0x00000212,
MAC_PIB_USE_ENHANCED_BEACON_RF = 0x00000213,
MAC_PIB_EB_HEADER_IE_LIST_RF = 0x00000214,
MAC_PIB_EB_PAYLOAD_IE_LIST_RF = 0x00000215,
MAC_PIB_EB_FILTERING_ENABLED_RF = 0x00000216,
MAC_PIB_EBSN_RF = 0x00000217,
MAC_PIB_EB_AUTO_SA_RF = 0x00000218,
MAC_PIB_SEC_SECURITY_LEVEL_LIST_RF = 0x0000021A,
MAC_PIB_POS_TABLE_RF = 0x0000021D,
MAC_PIB_OPERATING_MODE_RF = 0x0000021E,
MAC_PIB_CHANNEL_NUMBER_RF = 0x0000021F,
MAC_PIB_DUTY_CYCLE_USAGE_RF = 0x00000220,
MAC_PIB_DUTY_CYCLE_PERIOD_RF = 0x00000221,
MAC_PIB_DUTY_CYCLE_LIMIT_RF = 0x00000222,
MAC_PIB_DUTY_CYCLE_THRESHOLD_RF = 0x00000223,
MAC_PIB_DISABLE_PHY_RF = 0x00000224,
MAC_PIB_FREQUENCY_BAND_RF = 0x00000225,
MAC_PIB_TRANSMIT_ATTEN_RF = 0x00000226,
MAC_PIB_ADAPTIVE_POWER_STEP_RF = 0x00000227,
MAC_PIB_ADAPTIVE_POWER_HIGH_BOUND_RF = 0x00000228,
MAC_PIB_ADAPTIVE_POWER_LOW_BOUND_RF = 0x00000229,
MAC_PIB_POS_RECENT_ENTRIES_RF = 0x0000022A,
// Manufacturer specific
// Resets the device table upon a GMK activation.
MAC_PIB_MANUF_SECURITY_RESET_RF = 0x08000203,
// Indicates whether an LBP frame for other destination has been received
MAC_PIB_MANUF_LBP_FRAME_RECEIVED_RF = 0x08000204,
// Indicates whether an LBP frame for other destination has been received
MAC_PIB_MANUF_LNG_FRAME_RECEIVED_RF = 0x08000205,
// Indicates whether an Beacon frame from other nodes has been received
MAC_PIB_MANUF_BCN_FRAME_RECEIVED_RF = 0x08000206,
// Gets number of discarded packets due to Other Destination
MAC_PIB_MANUF_RX_OTHER_DESTINATION_COUNT_RF = 0x08000207,
// Gets number of discarded packets due to Invalid Frame Lenght
MAC_PIB_MANUF_RX_INVALID_FRAME_LENGTH_COUNT_RF = 0x08000208,
// Gets number of discarded packets due to Wrong Addressing Mode
MAC_PIB_MANUF_RX_WRONG_ADDR_MODE_COUNT_RF = 0x08000209,
// Gets number of discarded packets due to Unsupported Security
MAC_PIB_MANUF_RX_UNSUPPORTED_SECURITY_COUNT_RF = 0x0800020A,
// Gets number of discarded packets due to Wrong Key Id
MAC_PIB_MANUF_RX_WRONG_KEY_ID_COUNT_RF = 0x0800020B,
// Gets number of discarded packets due to Invalid Key
MAC_PIB_MANUF_RX_INVALID_KEY_COUNT_RF = 0x0800020C,
// Gets number of discarded packets due to Wrong Frame Counter
MAC_PIB_MANUF_RX_WRONG_FC_COUNT_RF = 0x0800020D,
// Gets number of discarded packets due to Decryption Error
MAC_PIB_MANUF_RX_DECRYPTION_ERROR_COUNT_RF = 0x0800020E,
// Gets number of transmitted Data packets
MAC_PIB_MANUF_TX_DATA_PACKET_COUNT_RF = 0x0800020F,
// Gets number of received Data packets
MAC_PIB_MANUF_RX_DATA_PACKET_COUNT_RF = 0x08000210,
// Gets number of transmitted Command packets
MAC_PIB_MANUF_TX_CMD_PACKET_COUNT_RF = 0x08000211,
// Gets number of received Command packets
MAC_PIB_MANUF_RX_CMD_PACKET_COUNT_RF = 0x08000212,
// Gets number of Channel Access failures
MAC_PIB_MANUF_CSMA_FAIL_COUNT_RF = 0x08000213,
// Gets number of received broadcast packets
MAC_PIB_MANUF_RX_DATA_BROADCAST_COUNT_RF = 0x08000214,
// Gets number of transmitted broadcast packets
MAC_PIB_MANUF_TX_DATA_BROADCAST_COUNT_RF = 0x08000215,
// Gets number of received packets with wrong CRC
MAC_PIB_MANUF_BAD_CRC_COUNT_RF = 0x08000216,
// Enables MAC Sniffer
MAC_PIB_MANUF_ENABLE_MAC_SNIFFER_RF = 0x08000217,
// Gets number of valid elements in the POS Table
MAC_PIB_MANUF_POS_TABLE_COUNT_RF = 0x08000218,
// Gets internal MAC version
MAC_PIB_MANUF_MAC_INTERNAL_VERSION_RF = 0x08000219,
// Resets MAC statistics
MAC_PIB_MANUF_RESET_MAC_STATS_RF = 0x0800021A,
// Provides access to POS table by short address (referenced as index)
MAC_PIB_MANUF_POS_TABLE_ELEMENT_RF = 0x0800021B,
// Configures time between a received frame and the transmission of its ACK
MAC_PIB_MANUF_ACK_TX_DELAY_RF = 0x0800021C,
// Configures time to wait for a requested ACK before timing out
MAC_PIB_MANUF_ACK_RX_WAIT_TIME_RF = 0x0800021D,
// Configures time to wait for an ACK Confirm before timing out
MAC_PIB_MANUF_ACK_CONFIRM_WAIT_TIME_RF = 0x0800021E,
// Configures time to wait for a Data Confirm before timing out
MAC_PIB_MANUF_DATA_CONFIRM_WAIT_TIME_RF = 0x0800021F,
// RF Interface availability. 8 bits (bool).
MAC_PIB_MANUF_RF_IFACE_AVAILABLE = 0x08000221,
// Last PLC frame duration in ms. 16 bits.
MAC_PIB_MANUF_LAST_FRAME_DURATION_RF = 0x08000222,
// Minimum LQI to consider a neighbour for Trickle
MAC_PIB_MANUF_TRICKLE_MIN_LQI_RF = 0x08000223,
// Gets or sets a parameter in Phy layer. Index will be used to contain PHY parameter ID
MAC_PIB_MANUF_PHY_PARAM_RF = 0x08000220
} MAC_RF_PIB_ATTRIBUTE;Summary
Lists the available objects in the MAC RF Parameter Information Base (PIB).
Description
MAC PIB is a collection of objects that can be read/written in order to retrieve information and/or configure the MAC layer.
| Attribute | Size | Default Value | Description |
|---|---|---|---|
| MAC_PIB_DSN_RF | 8 bits | Random | Data or command frame sequence number |
| MAC_PIB_MAX_BE_RF | 8 bits | 8 | Maximum value of back-off exponent. It should always be greater or equal than macMinBE. |
| MAC_PIB_MAX_CSMA_BACKOFFS_RF | 8 bits | 50 | Maximum number of back-off attempts |
| MAC_PIB_MAX_FRAME_RETRIES_RF | 8 bits | 5 | Maximum number of retransmission |
| MAC_PIB_MIN_BE_RF | 8 bits | 3 | Minimum value of back-off exponent |
| MAC_PIB_TIMESTAMP_SUPPORTED_RF | 8 bits (bool) | False | MAC frame time stamp support enable (read only) |
| MAC_PIB_DEVICE_TABLE_RF | 6 Byte entries. | Empty | The Device table as defined in |
| MAC_PIB_FRAME_COUNTER_RF | 32 bits | 0 | The outgoing frame counter for this device |
| MAC_PIB_DUPLICATE_DETECTION_TTL_RF | 8 bits | 3 | Time a received tuple is retained for duplicate frame detection, in seconds |
| MAC_PIB_COUNTER_OCTETS_RF | 8 bits | 4 | Size of MAC Counters (read only) |
| MAC_PIB_RETRY_COUNT_RF | 32 bits | 0 | Statistics Counter as defined in |
| MAC_PIB_MULTIPLE_RETRY_COUNT_RF | 32 bits | 0 | Statistics Counter as defined in |
| MAC_PIB_TX_FAIL_COUNT_RF | 32 bits | 0 | Statistics Counter as defined in |
| MAC_PIB_TX_SUCCESS_COUNT_RF | 32 bits | 0 | Statistics Counter as defined in |
| MAC_PIB_FCS_ERROR_COUNT_RF | 32 bits | 0 | Statistics Counter as defined in |
| MAC_PIB_SECURITY_FAILURE_COUNT_RF | 32 bits | 0 | Statistics Counter as defined in |
| MAC_PIB_DUPLICATE_FRAME_COUNT_RF | 32 bits | 0 | Statistics Counter as defined in |
| MAC_PIB_RX_SUCCESS_COUNT_RF | 32 bits | 0 | Statistics Counter as defined in |
| MAC_PIB_USE_ENHANCED_BEACON_RF | 8 bits (bool) | True | Usage of Enhanced Beacon (read only) |
| MAC_PIB_EB_HEADER_IE_LIST_RF | Array of 8 bit elements | N/A | Currently supported Header IEs |
| MAC_PIB_EB_PAYLOAD_IE_LIST_RF | Array of 8 bit elements | Empty | Currently supported Payload IEs, is always empty |
| MAC_PIB_EB_FILTERING_ENABLED_RF | 8 bits (bool) | False | Always false as no filtering is supported |
| MAC_PIB_EBSN_RF | 8 bits | Random | Enahnced Beacon frame sequence number |
| MAC_PIB_EB_AUTO_SA_RF | 8 bits | 2 | Always set to MAC_ADDRESS_MODE_SHORT (2) |
| MAC_PIB_SEC_SECURITY_LEVEL_LIST_RF | 4 Byte entries. | N/A | Fixed list describing expected Security behaviour, see G3 Spec for details |
| MAC_PIB_POS_TABLE_RF | 9 Byte entries. | Empty | The RF MAC POS Table |
| MAC_PIB_OPERATING_MODE_RF | 8 bits | 1 | The RF operating mode as defined in clause 19.3 of |
| MAC_PIB_CHANNEL_NUMBER_RF | 16 bits | 29 | The channel number as defined in clause 10.1.3.9 of to be used for channel scanning and data transmission |
| MAC_PIB_DUTY_CYCLE_USAGE_RF | 8 bits | 0 | Current usage of maximum allowed duty cycle in percent over the current sliding-window measurement period |
| MAC_PIB_DUTY_CYCLE_PERIOD_RF | 16 bits | 3600 | Duration of the measurement period in seconds, e.g., 3600 seconds as default for |
| MAC_PIB_DUTY_CYCLE_LIMIT_RF | 16 bits | 90 | Duration of the allowed transmission time in seconds, e.g., 2.5% of 3600 seconds as default for |
| MAC_PIB_DUTY_CYCLE_THRESHOLD_RF | 8 bits | 90 | Duty cycle threshold for stopping RF transmissions |
| MAC_PIB_DISABLE_PHY_RF | 8 bits (bool) | False | Disable RF PHY Tx and Rx |
| MAC_PIB_FREQUENCY_BAND_RF | 8 bits | 4 | Current operating frequency band identifier value as specified in tables 7.21 and 7.22 |
| MAC_PIB_TRANSMIT_ATTEN_RF | 8 bits | 0 | Attenuation of the RF transmit power in dB. The attenuation shall be applied to all transmissions |
| MAC_PIB_ADAPTIVE_POWER_STEP_RF | 8 bits | 3 | Maximum change (in dB) during one step when adapting transmission power |
| MAC_PIB_ADAPTIVE_POWER_HIGH_BOUND_RF | 8 bits | 104 | Reverse LQI threshold above which Tx Power shall be reduced. Set to 255 to disable. This value shall be greater than macAdaptivePowerLowBound_RF by at least 20 dB. Default value is configured according to test for adaptive power control |
| MAC_PIB_ADAPTIVE_POWER_LOW_BOUND_RF | 8 bits | 0 | Reverse LQI threshold below which Tx Power shall be increased. Set to 0 to disable. This value shall be lower than macAdaptivePowerHighBound_RF by at least 20 dB |
| MAC_PIB_POS_RECENT_ENTRIES_RF | 16 bits | 1 | Number of POS table entries having been refreshed recently and which LQI is above adpTrickleLQIThresholdLow |
| MAC_PIB_MANUF_SECURITY_RESET_RF | 8 bits (bool) | N/A | Resets the Device table upon a GMK activation |
| MAC_PIB_MANUF_LBP_FRAME_RECEIVED_RF | 8 bits (bool) | 0 | Indicates whether an LBP frame for other destination has been received since IB was set to 0 |
| MAC_PIB_MANUF_LNG_FRAME_RECEIVED_RF | 8 bits (bool) | 0 | Indicates whether an LBP frame for other destination has been received since IB was set to 0 |
| MAC_PIB_MANUF_BCN_FRAME_RECEIVED_RF | 8 bits (bool) | 0 | Indicates whether an Beacon frame from other nodes has been received since IB was set to 0 |
| MAC_PIB_MANUF_RX_OTHER_DESTINATION_COUNT_RF | 32 bits | 0 | Gets number of discarded packets due to Other Destination |
| MAC_PIB_MANUF_RX_INVALID_FRAME_LENGTH_COUNT_RF | 32 bits | 0 | Gets number of discarded packets due to Invalid Frame Lenght |
| MAC_PIB_MANUF_RX_WRONG_ADDR_MODE_COUNT_RF | 32 bits | 0 | Gets number of discarded packets due to Wrong Addressing Mode |
| MAC_PIB_MANUF_RX_UNSUPPORTED_SECURITY_COUNT_RF | 32 bits | 0 | Gets number of discarded packets due to Unsupported Security |
| MAC_PIB_MANUF_RX_WRONG_KEY_ID_COUNT_RF | 32 bits | 0 | Gets number of discarded packets due to Wrong Key Id |
| MAC_PIB_MANUF_RX_INVALID_KEY_COUNT_RF | 32 bits | 0 | Gets number of discarded packets due to Invalid Key |
| MAC_PIB_MANUF_RX_WRONG_FC_COUNT_RF | 32 bits | 0 | Gets number of discarded packets due to Wrong Frame Counter |
| MAC_PIB_MANUF_RX_DECRYPTION_ERROR_COUNT_RF | 32 bits | 0 | Gets number of discarded packets due to Decryption Error |
| MAC_PIB_MANUF_TX_DATA_PACKET_COUNT_RF | 32 bits | 0 | Gets number of transmitted Data packets |
| MAC_PIB_MANUF_RX_DATA_PACKET_COUNT_RF | 32 bits | 0 | Gets number of received Data packets |
| MAC_PIB_MANUF_TX_CMD_PACKET_COUNT_RF | 32 bits | 0 | Gets number of transmitted Command packets |
| MAC_PIB_MANUF_RX_CMD_PACKET_COUNT_RF | 32 bits | 0 | Gets number of received Command packets |
| MAC_PIB_MANUF_CSMA_FAIL_COUNT_RF | 32 bits | 0 | Gets number of Channel Access failures |
| MAC_PIB_MANUF_RX_DATA_BROADCAST_COUNT_RF | 32 bits | 0 | Gets number of received broadcast packets |
| MAC_PIB_MANUF_TX_DATA_BROADCAST_COUNT_RF | 32 bits | 0 | Gets number of transmitted broadcast packets |
| MAC_PIB_MANUF_BAD_CRC_COUNT_RF | 32 bits | 0 | Gets number of received packets with wrong CRC |
| MAC_PIB_MANUF_ENABLE_MAC_SNIFFER_RF | 8 bits (bool) | 0 | Enables MAC Sniffer |
| MAC_PIB_MANUF_POS_TABLE_COUNT_RF | 16 bits | N/A | Gets number of valid elements in the POS Table |
| MAC_PIB_MANUF_MAC_INTERNAL_VERSION_RF | 6 Byte struct | Current Version | Gets internal MAC version |
| MAC_PIB_MANUF_RESET_MAC_STATS_RF | 8 bits (bool) | N/A | Resets MAC statistics |
| MAC_PIB_MANUF_POS_TABLE_ELEMENT_RF | 9 Byte entries | N/A | Provides access to POS table using short address as index |
| MAC_PIB_MANUF_ACK_TX_DELAY_RF | 32 bits | 2000 | Configures time between a received frame and the transmission of its ACK, in microseconds |
| MAC_PIB_MANUF_ACK_RX_WAIT_TIME_RF | 32 bits | 30000 | Configures time to wait for a requested ACK before timing out, in microseconds |
| MAC_PIB_MANUF_ACK_CONFIRM_WAIT_TIME_RF | 32 bits | 30000 | Configures time to wait for an ACK Confirm before timing out, in microseconds |
| MAC_PIB_MANUF_DATA_CONFIRM_WAIT_TIME_RF | 32 bits | 90000 | Configures time to wait for a Data Confirm before timing out, in microseconds |
| MAC_PIB_MANUF_RF_IFACE_AVAILABLE | 8 bits (bool) | N/A | RF Interface availability |
| MAC_PIB_MANUF_LAST_FRAME_DURATION_RF | 16 bits | N/A | Last PLC frame duration in ms |
| MAC_PIB_MANUF_TRICKLE_MIN_LQI_RF | 8 bits | 85 | Minimum LQI to consider a neighbour for Trickle |
| MAC_PIB_MANUF_PHY_PARAM_RF | Variable | N/A | Gets or sets a parameter in Phy layer. Index will be used to contain PHY parameter ID. See MAC_WRP_PHY_PARAM_RF |
Remarks
None.
