Changes between Version 10 and Version 11 of 802.11/wlan_exp/log/entry_types


Ignore:
Timestamp:
Apr 16, 2014, 9:12:03 PM (10 years ago)
Author:
murphpo
Comment:

--

Legend:

Unmodified
Added
Removed
Modified

  • 802.11/wlan_exp/log/entry_types

    v10 v11  
    3131    if(type(tid) is int and tid != 0): #only take int type IDs and skip NULL
    3232        print(log_entry_types[tid].generate_entry_doc(fmt='wiki'))
    33 
    34 ##############################
    35 # Copy and Paste Python Output Below
    3633}}}
    37 
    38 
    39 === Entry Type NODE_INFO ===
    40 Details about the node hardware and its configuration. Node info values are static after boot.
    41 
    42 Entry type ID: 1
    43 
    44 ||=  Field Name  =||=  DataType  =||=  Description  =||
    45 || timestamp ||  uint64  || Microsecond timer value at time of log entry creation ||
    46 || node_type ||  uint32  || Node type as 4 byte value: [b0 b1 b2 b3]:[[BR]] b0: Always 0x00[[BR]] b1: Always 0x01 for 802.11 ref design nodes[[BR]] b2: CPU High application: 0x1 = AP, 0x2 = STA[[BR]] b3: CPU Low application: 0x1 = DCF ||
    47 || node_id ||  uint32  || Node ID, as set during wlan_exp init ||
    48 || hw_generation ||  uint32  || WARP hardware generation: 3 for WARP v3 ||
    49 || wn_ver ||  uint32  || WARPnet version, as packed bytes [0 major minor rev] ||
    50 || fpga_dna ||  uint64  || DNA value of node FPGA ||
    51 || serial_num ||  uint32  || Serial number of WARP board ||
    52 || wlan_exp_ver ||  uint32  || wlan_exp version, as packed values [(u8)major (u8)minor (u16)rev] ||
    53 || wlan_max_associations ||  uint32  || Maximum number of wireless associations allowed by node ||
    54 || wlan_log_max_size ||  uint32  || Maximum size in bytes of node's event log ||
    55 || wlan_mac_addr ||  uint64  || Node MAC address, 6 bytes in lower 48-bits of u64 ||
    56 || wlan_max_stats ||  uint32  || Maximum number of statistics structs maintained by node ||
    57 || ltg_resolution ||  uint32  || Minimum interval in microseconds of LTG schedules ||
    5834
    5935----
    6036
    61 
    62 === Entry Type EXP_INFO ===
    63 Header for generic experiment info entries created by the user application. The payload of the EXP_INFO entry is not described by the Python entry type. User code must access the payload in the binary log data directly.
    64 
    65 Entry type ID: 2
    66 
    67 ||=  Field Name  =||=  DataType  =||=  Description  =||
    68 || timestamp ||  uint64  || Microsecond timer value at time of log entry creation ||
    69 || info_type ||  uint16  || Exp info type (arbitrary value supplied by application ||
    70 || length ||  uint16  || Exp info length (describes arbitrary payload supplied by application ||
    71 
    72 ----
    73 
    74 
    75 === Entry Type STATION_INFO ===
    76 Information about an 802.11 association. At the AP one STATION_INFO is created for each associated STA and is logged whenever the STA association state changes. At the STA one STATION_INFO is logged whenever the STA associaiton state changes.
    77 
    78 Entry type ID: 3
    79 
    80 ||=  Field Name  =||=  DataType  =||=  Description  =||
    81 || timestamp ||  uint64  || Microsecond timer value at time of log entry creation ||
    82 || mac_addr ||  6uint8  || MAC address of associated device ||
    83 || aid ||  uint16  || Association ID (AID) of device ||
    84 || host_name ||  20uint8  || String hostname (19 chars max), taken from DHCP DISCOVER packets ||
    85 || flags ||  uint32  || Association state flags: ??? ||
    86 || rx_last_timestamp ||  uint64  || Microsecond timer value at time of last successful Rx from device ||
    87 || rx_last_seq ||  uint16  || Sequence number of last packet received from device ||
    88 || rx_last_power ||  int8  || Rx power in dBm of last packet received from device ||
    89 || rx_last_rate ||  uint8  || PHY rate index in ![1:8] of last packet received from device ||
    90 || tx_phy_rate ||  uint8  || Current PHY rate index in ![1:8] for new transmissions to device ||
    91 || tx_phy_antenna_mode ||  uint8  || Current PHY antenna mode in ![1:4] for new transmissions to device ||
    92 || tx_phy_power ||  int8  || Current Tx power in dBm for new transmissions to device ||
    93 || tx_phy_flags ||  uint8  || Flags for Tx PHY config for new transmissions to deivce ||
    94 || tx_mac_num_tx_max ||  uint8  || Maximum number of transmissions (original Tx + re-Tx) per MPDU to device ||
    95 || tx_mac_flags ||  uint8  || Flags for Tx MAC config for new transmissions to device ||
    96 || padding ||  uint16  ||  ||
    97 
    98 ----
    99 
    100 
    101 === Entry Type NODE_TEMPERATURE ===
    102 Record of the FPGA system monitor die temperature. This entry is only created when directed by a wlan_exp command. Temperature values are stored as 32-bit unsigned integers. To convert to degrees Celcius, apply (((float)temp_u32)/(65536.0*0.00198421639)) - 273.15
    103 
    104 Entry type ID: 4
    105 
    106 ||=  Field Name  =||=  DataType  =||=  Description  =||
    107 || timestamp ||  uint64  || Microsecond timer value at time of log entry creation ||
    108 || node_id ||  uint32  || wlan_exp node ID ||
    109 || serial_num ||  uint32  || Node serial number ||
    110 || temp_current ||  uint32  || Current FPGA die temperature ||
    111 || temp_min ||  uint32  || Minimum FPGA die temperature since FPGA configuration or sysmon reset ||
    112 || temp_max ||  uint32  || Maximum FPGA die temperature since FPGA configuration or sysmon reset ||
    113 
    114 ----
    115 
    116 
    117 === Entry Type WN_CMD_INFO ===
    118 Record of a WARPnet / wlan_exp command received by the node. The full command payload is logged, including any (possibly personal-info-carrying) parameters like MAC addresses.
    119 
    120 Entry type ID: 5
    121 
    122 ||=  Field Name  =||=  DataType  =||=  Description  =||
    123 || timestamp ||  uint64  || Microsecond timer value at time of log entry creation ||
    124 || command ||  uint32  || WARPnet / wlan_exp command ID ||
    125 || src_id ||  uint16  || Node ID of device sending command ||
    126 || num_args ||  uint16  || Number of arguments supplied in command ||
    127 || args ||  10uint32  || Command arguments ||
    128 
    129 ----
    130 
    131 
    132 === Entry Type TIME_INFO ===
    133 Record of a time base event at the node. This log entry is used to enable parsing of log data recored before and after changes to the node's microsecond timer. This entry also allows a wlan_exp controler to write the current absolute time to the node log without affecting the node's timer value. This enables adjustment of log entry timestamps to real timestamps in post-proessing.
    134 
    135 Entry type ID: 6
    136 
    137 ||=  Field Name  =||=  DataType  =||=  Description  =||
    138 || timestamp ||  uint64  || Microsecond timer value at time of log entry creation ||
    139 || time_id ||  uint32  || Random ID value included in wlan_exp TIME_INFO command; used to find common entries across nodes ||
    140 || reason ||  uint32  || Reason code for TIME_INFO log entry creation ||
    141 || new_time ||  uint64  || New value of microsecond timer value; 0xFFFFFFFFFFFFFFFF if timer was not changed ||
    142 || abs_time ||  uint64  || Absolute time in microseconds-since-epoch; 0xFFFFFFFFFFFFFFFF if unknown ||
    143 
    144 ----
    145 
    146 
    147 === Entry Type RX_DSSS ===
    148 
    149 
    150 Entry type ID: 11
    151 
    152 ||=  Field Name  =||=  DataType  =||=  Description  =||
    153 || timestamp ||  uint64  || Microsecond timer value at PHY Rx start ||
    154 || length ||  uint16  || Length of payload in bytes ||
    155 || rate ||  uint8  || PHY rate index, in ![1:8] ||
    156 || power ||  int8  || Rx power in dBm ||
    157 || fcs_result ||  uint8  || Checksum status, 0 = no errors ||
    158 || pkt_type ||  uint8  || Packet type: 1 = other data, 2 = encapsulated Ethernet, 3 = LTG, 11 = management, 21 = control ||
    159 || chan_num ||  uint8  || Channel (center frequency) index ||
    160 || ant_mode ||  uint8  || Antenna mode: ![1,2,3,4] for SISO Rx on RF [A,B,C,D] ||
    161 || rf_gain ||  uint8  || AGC RF gain setting: ![1,2,3] for ![0,15,30]dB gain ||
    162 || bb_gain ||  uint8  || AGC BB gain setting: ![0:31] for approx ![0:63]dB gain ||
    163 || flags ||  uint16  || Bit OR'd flags: 0x1 = Rx was duplicate of previous Rx ||
    164 || mac_payload_len ||  uint32  || Length in bytes of MAC payload recorded in log for this packet ||
    165 || mac_payload ||  24uint8  || First 24 bytes of MAC payload, typically the 802.11 MAC header ||
    166 
    167 ----
    168 
    169 
    170 === Entry Type TX ===
    171 Tx events in CPU High, logged for each MPDU frame created and enqueued in CPU High. See TX_LOW for log entries of actual Tx events, including re-transmissions. The time values in this log entry can be used to determine time in queue (time_to_accept), time taken by CPU Low for all Tx attempts (time_to_done) and total time from creation to completion (time_to_accept+time_to_done).
    172 
    173 Entry type ID: 20
    174 
    175 ||=  Field Name  =||=  DataType  =||=  Description  =||
    176 || timestamp ||  uint64  || Microsecond timer value at time packet was created, immediately before it was enqueued ||
    177 || time_to_accept ||  uint32  || Time duration in microseconds between packet creation and packet acceptance by CPU Low ||
    178 || time_to_done ||  uint32  || Time duration in microseconds between packet acceptance by CPU Low and Tx completion in CPU Low ||
    179 || uniq_seq ||  uint64  || Unique sequence number for Tx packet; 12 LSB of this used for 802.11 MAC header sequence number ||
    180 || num_tx ||  uint8  || Number of actual PHY Tx events which were used to transmit the MPDU (first Tx + all re-Tx) ||
    181 || tx_power ||  int8  || Tx power in dBm of final Tx attempt ||
    182 || chan_num ||  uint8  || Channel (center frequency) index of transmission ||
    183 || rate ||  uint8  || PHY rate index in ![1:8] of final Tx attempt ||
    184 || length ||  uint16  || Length in bytes of MPDU; includes MAC header, payload and FCS ||
    185 || result ||  uint8  || Tx result; 0 = ACK received or not required ||
    186 || pkt_type ||  uint8  || Packet type: 1 = other data, 2 = encapsulated Ethernet, 3 = LTG, 11 = management, 21 = control ||
    187 || ant_mode ||  uint8  || PHY antenna mode of final Tx attempt ||
    188 || queue_id ||  uint8  || Tx queue ID from which the packet was retrieved ||
    189 || padding ||  2uint8  ||  ||
    190 || mac_payload_len ||  uint32  || Length in bytes of MAC payload recorded in log for this packet ||
    191 || mac_payload ||  24uint8  || First 24 bytes of MAC payload, typically the 802.11 MAC header ||
    192 
    193 ----
    194 
    195 
    196 === Entry Type TX_LOW ===
    197 Record of actual PHY transmission. At least one TX_LOW will be logged for every TX entry. Multiple TX_LOW entries may be created for the same TX entry if the low-level MAC re-transmitted the frame. The uniq_seq fields can be match between TX and TX_LOW entries to find records common to the same MPUD.
    198 
    199 Entry type ID: 21
    200 
    201 ||=  Field Name  =||=  DataType  =||=  Description  =||
    202 || timestamp ||  uint64  || Microsecond timer value at time packet transmission actually started (PHY TX_START time) ||
    203 || uniq_seq ||  uint64  || Unique sequence number of original MPDU ||
    204 || rate ||  uint8  || PHY rate index in ![1:8] ||
    205 || ant_mode ||  uint8  || PHY antenna mode in ![1:4] ||
    206 || tx_power ||  int8  || Tx power in dBm ||
    207 || flags ||  uint8  || Tx PHY flags ||
    208 || tx_count ||  uint8  || Transmission index for this attempt; 0 = initial Tx, 1+ = subsequent re-transmissions ||
    209 || chan_num ||  uint8  || Channel (center frequency) index ||
    210 || length ||  uint16  || Length in bytes of MPDU; includes MAC header, payload and FCS ||
    211 || num_slots ||  uint16  || Number of backoff slots allotted prior to this transmission; may not have been used for initial Tx (tx_count==0) ||
    212 || cw ||  uint16  || Contention window value at time of this Tx ||
    213 || pkt_type ||  uint8  || Packet type: 1 = other data, 2 = encapsulated Ethernet, 3 = LTG, 11 = management, 21 = control ||
    214 || padding ||  3uint8  ||  ||
    215 || mac_payload_len ||  uint32  || Length in bytes of MAC payload recorded in log for this packet ||
    216 || mac_payload ||  24uint8  || First 24 bytes of MAC payload, typically the 802.11 MAC header ||
    217 
    218 ----
    219 
    220 
    221 === Entry Type TXRX_STATS ===
    222 Copy of the Tx/Rx statistics struct maintained by CPU High. If promiscuous statistics mode is Tx/Rx stats structs will be maintained for every unique source MAC address, up to the max_stats value. Otherwise statistics are maintaind only associated nodes.
    223 
    224 Entry type ID: 30
    225 
    226 ||=  Field Name  =||=  DataType  =||=  Description  =||
    227 || timestamp ||  uint64  || Microsecond timer value at time of log entry creation ||
    228 || last_timestamp ||  uint64  || Microsecond timer value at time of last Tx or Rx event to node with address mac_addr ||
    229 || mac_addr ||  6uint8  || MAC address of remote node whose statics are recorded here ||
    230 || associated ||  uint8  || Boolean indicating whether remote node is currently associated with this node ||
    231 || padding ||  uint8  ||  ||
    232 || data_num_rx_bytes ||  uint64  || Total number of bytes received in DATA packets from remote node ||
    233 || data_num_tx_bytes_success ||  uint64  || Total number of bytes successfully transmitted in DATA packets to remote node ||
    234 || data_num_tx_bytes_total ||  uint64  || Total number of bytes transmitted (successfully or not) in DATA packets to remote node ||
    235 || data_num_rx_packets ||  uint32  || Total number of DATA packets received from remote node ||
    236 || data_num_tx_packets_success ||  uint32  || Total number of DATA packets successfully transmitted to remote node ||
    237 || data_num_tx_packets_total ||  uint32  || Total number of DATA packets transmitted (successfully or not) to remote node ||
    238 || data_num_tx_packets_low ||  uint32  || Total number of PHY transmissions of DATA packets to remote node (includes re-transmissions) ||
    239 || mgmt_num_rx_bytes ||  uint64  || Total number of bytes received in management packets from remote node ||
    240 || mgmt_num_tx_bytes_success ||  uint64  || Total number of bytes successfully transmitted in management packets to remote node ||
    241 || mgmt_num_tx_bytes_total ||  uint64  || Total number of bytes transmitted (successfully or not) in management packets to remote node ||
    242 || mgmt_num_rx_packets ||  uint32  || Total number of management packets received from remote node ||
    243 || mgmt_num_tx_packets_success ||  uint32  || Total number of management packets successfully transmitted to remote node ||
    244 || mgmt_num_tx_packets_total ||  uint32  || Total number of management packets transmitted (successfully or not) to remote node ||
    245 || mgmt_num_tx_packets_low ||  uint32  || Total number of PHY transmissions of management packets to remote node (includes re-transmissions) ||
    246 
    247 ----
    248 
    249 
    250 === Entry Type RX_OFDM ===
    251 
    252 
    253 Entry type ID: 10
    254 
    255 ||=  Field Name  =||=  DataType  =||=  Description  =||
    256 || timestamp ||  uint64  || Microsecond timer value at PHY Rx start ||
    257 || length ||  uint16  || Length of payload in bytes ||
    258 || rate ||  uint8  || PHY rate index, in ![1:8] ||
    259 || power ||  int8  || Rx power in dBm ||
    260 || fcs_result ||  uint8  || Checksum status, 0 = no errors ||
    261 || pkt_type ||  uint8  || Packet type: 1 = other data, 2 = encapsulated Ethernet, 3 = LTG, 11 = management, 21 = control ||
    262 || chan_num ||  uint8  || Channel (center frequency) index ||
    263 || ant_mode ||  uint8  || Antenna mode: ![1,2,3,4] for SISO Rx on RF [A,B,C,D] ||
    264 || rf_gain ||  uint8  || AGC RF gain setting: ![1,2,3] for ![0,15,30]dB gain ||
    265 || bb_gain ||  uint8  || AGC BB gain setting: ![0:31] for approx ![0:63]dB gain ||
    266 || flags ||  uint16  || Bit OR'd flags: 0x1 = Rx was duplicate of previous Rx ||
    267 || chan_est ||  (64,2)i2  || OFDM Rx channel estimates, packed as [(uint16)I (uint16)Q] values, one per subcarrier ||
    268 || mac_payload_len ||  uint32  || Length in bytes of MAC payload recorded in log for this packet ||
    269 || mac_payload ||  24uint8  || First 24 bytes of MAC payload, typically the 802.11 MAC header ||
    270 
    271 ----
    272 
     37[[Include(source:/ReferenceDesigns/w3_802.11/python/wlan_exp/log/entry_type_wiki_docs.txt,  text/x-trac-wiki)]]