Changes between Version 11 and Version 12 of 802.11/PacketFlow

Timestamp:

Oct 14, 2014, 4:01:00 PM (10 years ago)

Author:

murphpo

Comment:

--

802.11/PacketFlow

@@ -90 +90 @@
 #!c
 typedef struct{
-        u8 state;
-        u8 rate;
-        u16 length;
-        s8 rx_power;
-        u8 rf_gain;
-        u8 bb_gain;
-        u8 channel;
-        u8 flags;
-        u8 ant_mode;
+        u8 state;                       ///< Packet buffer state - RX_MPDU_STATE_EMPTY, RX_MPDU_STATE_RX_PENDING, RX_MPDU_STATE_FCS_GOOD or RX_MPDU_STATE_FCS_BAD
+        u8 rate;                        ///< PHY rate index
+        u16 length;                     ///< Number of bytes in MAC packet, including MAC header and FCS
+        s8 rx_power;            ///< Rx power, in dBm
+        u8 rf_gain;                     ///< Gain setting of radio Rx LNA, in [0,1,2]
+        u8 bb_gain;                     ///< Gain setting of radio Rx VGA, in [0,1,...31]
+        u8 channel;                     ///< Channel index
+        u8 flags;                       ///< Bit flags
+        u8 ant_mode;            ///< Rx antenna selection
         u8 reserved[2];
-        u32 additional_info;
-        u64 timestamp;
-        u32 channel_est[64];
-} rx_frame_info; //280 bytes (24 bytes for scalar fields + 256 bytes for channel estimates)
-}}}
+        u32 additional_info;///< Field to hold MAC-specific info, such as a pointer to a station_info 
+        u64 timestamp;          ///< MAC timestamp at time of reception
+        u32 channel_est[64];///< Rx PHY channel estimates
+} rx_frame_info;
 
 The PHY begins writing received bytes immediately after the {{{rx_frame_info}}}. The received SIGNAL and SERVICE fields are written to the first 5 bytes following the {{{rx_frame_info}}}. The PHY then skips 3 bytes and writes the next received byte (the first byte of the MAC header) to 8 bytes past the rx_frame_info. This convention aligns received payloads to a 64-bit boundary, easing access by the MAC software and DMAs. Generally the MAC software ignores the SIGNAL and SERVICE fields in the Rx packet buffer, instead relying on the rate/length values provided by the MAC core.