Changes between Version 2 and Version 3 of 802.11/wlan_exp/log/entry_types


Ignore:
Timestamp:
Apr 16, 2014, 5:13:25 PM (10 years ago)
Author:
murphpo
Comment:

--

Legend:

Unmodified
Added
Removed
Modified

  • 802.11/wlan_exp/log/entry_types

    v2 v3  
    2222
    2323}}}
    24 
    25 === NODE_INFO ===
     24=== Entry Type NODE_INFO ===
    2625Details about the node hardware and its configuration. Node info values are static after boot.
    2726
    28 Fields:
     27Entry type ID: 1
     28
    2929||=  Field Name  =||=  DataType  =||=  Description  =||
    3030|| timestamp ||  uint64  || Microsecond timer value at time of log entry creation ||
    … …  
    4545
    4646
    47 === EXP_INFO ===
     47=== Entry Type EXP_INFO ===
    4848Header 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.
    4949
    50 Fields:
     50Entry type ID: 2
     51
    5152||=  Field Name  =||=  DataType  =||=  Description  =||
    5253|| timestamp ||  uint64  || Microsecond timer value at time of log entry creation ||
    … …  
    5758
    5859
    59 === STATION_INFO ===
     60=== Entry Type STATION_INFO ===
    6061Information 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.
    6162
    62 Fields:
     63Entry type ID: 3
     64
    6365||=  Field Name  =||=  DataType  =||=  Description  =||
    6466|| timestamp ||  uint64  || Microsecond timer value at time of log entry creation ||
    … …  
    8284
    8385
    84 === NODE_TEMPERATURE ===
    85 
    86 
    87 Fields:
    88 ||=  Field Name  =||=  DataType  =||=  Description  =||
    89 || timestamp ||  uint64  ||  ||
    90 || node_id ||  uint32  ||  ||
    91 || serial_num ||  uint32  ||  ||
    92 || temp_current ||  uint32  ||  ||
    93 || temp_min ||  uint32  ||  ||
    94 || temp_max ||  uint32  ||  ||
    95 
    96 ----
    97 
    98 
    99 === WN_CMD_INFO ===
     86=== Entry Type NODE_TEMPERATURE ===
     87Record 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
     88
     89Entry type ID: 4
     90
     91||=  Field Name  =||=  DataType  =||=  Description  =||
     92|| timestamp ||  uint64  || Microsecond timer value at time of log entry creation ||
     93|| node_id ||  uint32  || wlan_exp node ID ||
     94|| serial_num ||  uint32  || Node serial number ||
     95|| temp_current ||  uint32  || Current FPGA die temperature ||
     96|| temp_min ||  uint32  || Minimum FPGA die temperature since FPGA configuration or sysmon reset ||
     97|| temp_max ||  uint32  || Maximum FPGA die temperature since FPGA configuration or sysmon reset ||
     98
     99----
     100
     101
     102=== Entry Type WN_CMD_INFO ===
    100103Record 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.
    101104
    102 Fields:
     105Entry type ID: 5
     106
    103107||=  Field Name  =||=  DataType  =||=  Description  =||
    104108|| timestamp ||  uint64  || Microsecond timer value at time of log entry creation ||
    … …  
    111115
    112116
    113 === TIME_INFO ===
     117=== Entry Type TIME_INFO ===
    114118Record 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.
    115119
    116 Fields:
     120Entry type ID: 6
     121
    117122||=  Field Name  =||=  DataType  =||=  Description  =||
    118123|| timestamp ||  uint64  || Microsecond timer value at time of log entry creation ||
    … …  
    125130
    126131
    127 === RX_DSSS ===
    128 
    129 
    130 Fields:
     132=== Entry Type RX_DSSS ===
     133
     134
     135Entry type ID: 11
     136
    131137||=  Field Name  =||=  DataType  =||=  Description  =||
    132138|| timestamp ||  uint64  || Microsecond timer value at PHY Rx start ||
    … …  
    141147|| bb_gain ||  uint8  || AGC BB gain setting: [0:31] for approx [0:63]dB gain ||
    142148|| flags ||  uint16  || Bit OR'd flags: 0x1 = Rx was duplicate of previous Rx ||
    143 || mac_payload_len ||  uint32  ||  ||
    144 || mac_payload ||  24uint8  ||  ||
    145 
    146 ----
    147 
    148 
    149 === TX ===
    150 
    151 
    152 Fields:
    153 ||=  Field Name  =||=  DataType  =||=  Description  =||
    154 || timestamp ||  uint64  ||  ||
    155 || time_to_accept ||  uint32  ||  ||
    156 || time_to_done ||  uint32  ||  ||
    157 || uniq_seq ||  uint64  ||  ||
    158 || num_tx ||  uint8  ||  ||
    159 || tx_power ||  int8  ||  ||
    160 || chan_num ||  uint8  ||  ||
    161 || rate ||  uint8  ||  ||
    162 || length ||  uint16  ||  ||
    163 || result ||  uint8  ||  ||
    164 || pkt_type ||  uint8  ||  ||
    165 || ant_mode ||  uint8  ||  ||
    166 || queue_id ||  uint8  ||  ||
     149|| mac_payload_len ||  uint32  || Length in bytes of MAC payload recorded in log for this packet ||
     150|| mac_payload ||  24uint8  || First 24 bytes of MAC payload, typically the 802.11 MAC header ||
     151
     152----
     153
     154
     155=== Entry Type TX ===
     156Tx 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).
     157
     158Entry type ID: 20
     159
     160||=  Field Name  =||=  DataType  =||=  Description  =||
     161|| timestamp ||  uint64  || Microsecond timer value at time packet was created, immediately before it was enqueued ||
     162|| time_to_accept ||  uint32  || Time duration in microseconds between packet creation and packet acceptance by CPU Low ||
     163|| time_to_done ||  uint32  || Time duration in microseconds between packet acceptance by CPU Low and Tx completion in CPU Low ||
     164|| uniq_seq ||  uint64  || Unique sequence number for Tx packet; 12 LSB of this used for 802.11 MAC header sequence number ||
     165|| num_tx ||  uint8  || Number of actual PHY Tx events which were used to transmit the MPDU (first Tx + all re-Tx) ||
     166|| tx_power ||  int8  || Tx power in dBm of final Tx attempt ||
     167|| chan_num ||  uint8  || Channel (center frequency) index of transmission ||
     168|| rate ||  uint8  || PHY rate index in [1:8] of final Tx attempt ||
     169|| length ||  uint16  || Length in bytes of MPDU; includes MAC header, payload and FCS ||
     170|| result ||  uint8  || Tx result; 0 = ACK received or not required ||
     171|| pkt_type ||  uint8  || Packet type: 1 = other data, 2 = encapsulated Ethernet, 3 = LTG, 11 = management, 21 = control ||
     172|| ant_mode ||  uint8  || PHY antenna mode of final Tx attempt ||
     173|| queue_id ||  uint8  || Tx queue ID from which the packet was retrieved ||
    167174|| padding ||  2uint8  ||  ||
    168 || mac_payload_len ||  uint32  ||  ||
    169 || mac_payload ||  24uint8  ||  ||
    170 
    171 ----
    172 
    173 
    174 === TX_LOW ===
    175 
    176 
    177 Fields:
    178 ||=  Field Name  =||=  DataType  =||=  Description  =||
    179 || timestamp ||  uint64  ||  ||
    180 || uniq_seq ||  uint64  ||  ||
    181 || rate ||  uint8  ||  ||
    182 || ant_mode ||  uint8  ||  ||
    183 || tx_power ||  int8  ||  ||
    184 || flags ||  uint8  ||  ||
    185 || tx_count ||  uint8  ||  ||
    186 || chan_num ||  uint8  ||  ||
    187 || length ||  uint16  ||  ||
    188 || num_slots ||  uint16  ||  ||
    189 || cw ||  uint16  ||  ||
    190 || pkt_type ||  uint8  ||  ||
     175|| mac_payload_len ||  uint32  || Length in bytes of MAC payload recorded in log for this packet ||
     176|| mac_payload ||  24uint8  || First 24 bytes of MAC payload, typically the 802.11 MAC header ||
     177
     178----
     179
     180
     181=== Entry Type TX_LOW ===
     182Record 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.
     183
     184Entry type ID: 21
     185
     186||=  Field Name  =||=  DataType  =||=  Description  =||
     187|| timestamp ||  uint64  || Microsecond timer value at time packet transmission actually started (PHY TX_START time) ||
     188|| uniq_seq ||  uint64  || Unique sequence number of original MPDU ||
     189|| rate ||  uint8  || PHY rate index in [1:8] ||
     190|| ant_mode ||  uint8  || PHY antenna mode in [1:4] ||
     191|| tx_power ||  int8  || Tx power in dBm ||
     192|| flags ||  uint8  || Tx PHY flags ||
     193|| tx_count ||  uint8  || Transmission index for this attempt; 0 = initial Tx, 1+ = subsequent re-transmissions ||
     194|| chan_num ||  uint8  || Channel (center frequency) index ||
     195|| length ||  uint16  || Length in bytes of MPDU; includes MAC header, payload and FCS ||
     196|| num_slots ||  uint16  || Number of backoff slots allotted prior to this transmission; may not have been used for initial Tx (tx_count==0) ||
     197|| cw ||  uint16  || Contention window value at time of this Tx ||
     198|| pkt_type ||  uint8  || Packet type: 1 = other data, 2 = encapsulated Ethernet, 3 = LTG, 11 = management, 21 = control ||
    191199|| padding ||  3uint8  ||  ||
    192 || mac_payload_len ||  uint32  ||  ||
    193 || mac_payload ||  24uint8  ||  ||
    194 
    195 ----
    196 
    197 
    198 === TXRX_STATS ===
    199 
    200 
    201 Fields:
    202 ||=  Field Name  =||=  DataType  =||=  Description  =||
    203 || timestamp ||  uint64  ||  ||
    204 || last_timestamp ||  uint64  ||  ||
    205 || mac_addr ||  6uint8  ||  ||
    206 || associated ||  uint8  ||  ||
     200|| mac_payload_len ||  uint32  || Length in bytes of MAC payload recorded in log for this packet ||
     201|| mac_payload ||  24uint8  || First 24 bytes of MAC payload, typically the 802.11 MAC header ||
     202
     203----
     204
     205
     206=== Entry Type TXRX_STATS ===
     207Copy 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.
     208
     209Entry type ID: 30
     210
     211||=  Field Name  =||=  DataType  =||=  Description  =||
     212|| timestamp ||  uint64  || Microsecond timer value at time of log entry creation ||
     213|| last_timestamp ||  uint64  || Microsecond timer value at time of last Tx or Rx event to node with address mac_addr ||
     214|| mac_addr ||  6uint8  || MAC address of remote node whose statics are recorded here ||
     215|| associated ||  uint8  || Boolean indicating whether remote node is currently associated with this node ||
    207216|| padding ||  uint8  ||  ||
    208 || data_num_rx_bytes ||  uint64  ||  ||
    209 || data_num_tx_bytes_success ||  uint64  ||  ||
    210 || data_num_tx_bytes_total ||  uint64  ||  ||
    211 || data_num_rx_packets ||  uint32  ||  ||
    212 || data_num_tx_packets_success ||  uint32  ||  ||
    213 || data_num_tx_packets_total ||  uint32  ||  ||
    214 || data_num_tx_packets_low ||  uint32  ||  ||
    215 || mgmt_num_rx_bytes ||  uint64  ||  ||
    216 || mgmt_num_tx_bytes_success ||  uint64  ||  ||
    217 || mgmt_num_tx_bytes_total ||  uint64  ||  ||
    218 || mgmt_num_rx_packets ||  uint32  ||  ||
    219 || mgmt_num_tx_packets_success ||  uint32  ||  ||
    220 || mgmt_num_tx_packets_total ||  uint32  ||  ||
    221 || mgmt_num_tx_packets_low ||  uint32  ||  ||
    222 
    223 ----
    224 
    225 
    226 === RX_OFDM ===
    227 
    228 
    229 Fields:
     217|| data_num_rx_bytes ||  uint64  || Total number of bytes received in DATA packets from remote node ||
     218|| data_num_tx_bytes_success ||  uint64  || Total number of bytes successfully transmitted in DATA packets to remote node ||
     219|| data_num_tx_bytes_total ||  uint64  || Total number of bytes transmitted (successfully or not) in DATA packets to remote node ||
     220|| data_num_rx_packets ||  uint32  || Total number of DATA packets received from remote node ||
     221|| data_num_tx_packets_success ||  uint32  || Total number of DATA packets successfully transmitted to remote node ||
     222|| data_num_tx_packets_total ||  uint32  || Total number of DATA packets transmitted (successfully or not) to remote node ||
     223|| data_num_tx_packets_low ||  uint32  || Total number of PHY transmissions of DATA packets to remote node (includes re-transmissions) ||
     224|| mgmt_num_rx_bytes ||  uint64  || Total number of bytes received in management packets from remote node ||
     225|| mgmt_num_tx_bytes_success ||  uint64  || Total number of bytes successfully transmitted in management packets to remote node ||
     226|| mgmt_num_tx_bytes_total ||  uint64  || Total number of bytes transmitted (successfully or not) in management packets to remote node ||
     227|| mgmt_num_rx_packets ||  uint32  || Total number of management packets received from remote node ||
     228|| mgmt_num_tx_packets_success ||  uint32  || Total number of management packets successfully transmitted to remote node ||
     229|| mgmt_num_tx_packets_total ||  uint32  || Total number of management packets transmitted (successfully or not) to remote node ||
     230|| mgmt_num_tx_packets_low ||  uint32  || Total number of PHY transmissions of management packets to remote node (includes re-transmissions) ||
     231
     232----
     233
     234
     235=== Entry Type RX_OFDM ===
     236
     237
     238Entry type ID: 10
     239
    230240||=  Field Name  =||=  DataType  =||=  Description  =||
    231241|| timestamp ||  uint64  || Microsecond timer value at PHY Rx start ||
    … …  
    240250|| bb_gain ||  uint8  || AGC BB gain setting: [0:31] for approx [0:63]dB gain ||
    241251|| flags ||  uint16  || Bit OR'd flags: 0x1 = Rx was duplicate of previous Rx ||
    242 || chan_est ||  (64,2)i2  || ||
    243 || mac_payload_len ||  uint32  || ||
    244 || mac_payload ||  24uint8  || ||
    245 
    246 ----
     252|| chan_est ||  (64,2)i2  || OFDM Rx channel estimates, packed as [(uint16)I (uint16)Q] values, one per subcarrier ||
     253|| mac_payload_len ||  uint32  || Length in bytes of MAC payload recorded in log for this packet ||
     254|| mac_payload ||  24uint8  || First 24 bytes of MAC payload, typically the 802.11 MAC header ||
     255
     256----