rtw89: add TDLS and various fixes
Ping-Ke Shih
maintainercover rtw89: add TDLS and various fixes
Patch 1/11 ~ 4/11 are related to TDLS. To support TDLS, we need to create CAM entries like STA in AP mode. Besides, it also needs BSSID CAM by hardware design.
The remaining patches are to fix various issues met in field, so fix them.
Since patches have dependency, I submit them together.
Kuan-Chung Chen (2):
rtw89: fix potential TX stuck
rtw89: enable VO TX AMPDU
Ping-Ke Shih (8):
rtw89: allocate address CAM and MAC ID to TDLS peer
rtw89: separate BSSID CAM operations
rtw89: allocate BSSID CAM per TDLS peer
rtw89: support TDLS
rtw89: add UNEXP debug mask to keep monitor messages unexpected to
happen frequently
rtw89: drop invalid TX rate report of legacy rate
rtw89: fix long RX latency in low power mode
rtw89: pci: fix PCI doesn't reclaim TX BD properly
Po-Hao Huang (1):
rtw89: disable invalid phy reports for all ICs
drivers/net/wireless/realtek/rtw89/cam.c | 29 ++-- drivers/net/wireless/realtek/rtw89/cam.h | 9 +- drivers/net/wireless/realtek/rtw89/core.c | 148 +++++++++++++++--- drivers/net/wireless/realtek/rtw89/core.h | 33 +++- drivers/net/wireless/realtek/rtw89/debug.c | 3 +- drivers/net/wireless/realtek/rtw89/debug.h | 2 + drivers/net/wireless/realtek/rtw89/fw.c | 2 +- drivers/net/wireless/realtek/rtw89/mac80211.c | 2 +- drivers/net/wireless/realtek/rtw89/pci.c | 16 +- drivers/net/wireless/realtek/rtw89/phy.c | 18 ++- drivers/net/wireless/realtek/rtw89/ser.c | 15 +- 11 files changed, 218 insertions(+), 59 deletions(-)
Signature · 1 line
2.25.1
Ping-Ke Shih
maintainerPATCH 1/11 rtw89: allocate address CAM and MAC ID to TDLS peer
Normally, we only allocate an address CAM and single one MAC ID to AP in STA mode. To support TDLS, we handle TDLS peers like AP handles stations.
--- drivers/net/wireless/realtek/rtw89/core.c | 18 +++++++++--------- drivers/net/wireless/realtek/rtw89/core.h | 10 +++++++--- drivers/net/wireless/realtek/rtw89/mac80211.c | 2 +- drivers/net/wireless/realtek/rtw89/ser.c | 13 +++++++------ 4 files changed, 24 insertions(+), 19 deletions(-)
drivers/net/wireless/realtek/rtw89/core.c +9 -9
@@ -2238,13 +2238,13 @@ int rtw89_core_sta_add(struct rtw89_dev *rtwdev,ewma_rssi_init (&rtwsta->avg_rssi); -if (vif->type ==NL80211_IFTYPE_STATION ) { +if (vif->type ==NL80211_IFTYPE_STATION && !sta->tdls) {/* for station mode, assign the mac_id from itself */ rtwsta->mac_id = rtwvif->mac_id;rtw89_btc_ntfy_role_info (rtwdev, rtwvif, rtwsta,BTC_ROLE_MSTS_STA_CONN_START );rtw89_chip_rfk_channel (rtwdev); - }else if (vif->type ==NL80211_IFTYPE_AP ) { + }else if (vif->type ==NL80211_IFTYPE_AP || sta->tdls) { rtwsta->mac_id =rtw89_core_acquire_bit_map (rtwdev->mac_id_map,RTW89_MAX_MAC_ID_NUM ); }
@@ -2275,10 +2275,10 @@ int rtw89_core_sta_disconnect(struct rtw89_dev *rtwdev,rtw89_mac_bf_monitor_calc (rtwdev, sta, true);rtw89_mac_bf_disassoc (rtwdev, vif, sta);rtw89_core_free_sta_pending_ba (rtwdev, sta); -if (vif->type ==NL80211_IFTYPE_AP ) +if (vif->type ==NL80211_IFTYPE_AP || sta->tdls)rtw89_cam_deinit_addr_cam (rtwdev, &rtwsta->addr_cam); -if (vif->type ==NL80211_IFTYPE_STATION ) +if (vif->type ==NL80211_IFTYPE_STATION && !sta->tdls)rtw89_vif_type_mapping (vif, false); ret =rtw89_fw_h2c_assoc_cmac_tbl (rtwdev, vif, sta);
@@ -2293,7 +2293,7 @@ int rtw89_core_sta_disconnect(struct rtw89_dev *rtwdev,return ret; } -if (vif->type ==NL80211_IFTYPE_AP ) { +if (vif->type ==NL80211_IFTYPE_AP || sta->tdls) { ret =rtw89_fw_h2c_role_maintain (rtwdev, rtwvif, rtwsta,RTW89_ROLE_REMOVE );if (ret) {rtw89_warn (rtwdev,"failed to send h2c role info\n" );
@@ -2319,7 +2319,7 @@ int rtw89_core_sta_assoc(struct rtw89_dev *rtwdev,struct rtw89_sta *rtwsta = (struct rtw89_sta *)sta->drv_priv;int ret; -if (vif->type ==NL80211_IFTYPE_AP ) { +if (vif->type ==NL80211_IFTYPE_AP || sta->tdls) { ret =rtw89_mac_set_macid_pause (rtwdev, rtwsta->mac_id, false);if (ret) {rtw89_warn (rtwdev,"failed to send h2c macid pause\n" );
@@ -2369,7 +2369,7 @@ int rtw89_core_sta_assoc(struct rtw89_dev *rtwdev,rtw89_mac_bf_assoc (rtwdev, vif, sta);rtw89_mac_bf_monitor_calc (rtwdev, sta, false); -if (vif->type ==NL80211_IFTYPE_STATION ) { +if (vif->type ==NL80211_IFTYPE_STATION && !sta->tdls) {rtw89_btc_ntfy_role_info (rtwdev, rtwvif, rtwsta,BTC_ROLE_MSTS_STA_CONN_END );rtw89_core_get_no_ul_ofdma_htc (rtwdev, &rtwsta->htc_template);
@@ -2385,10 +2385,10 @@ int rtw89_core_sta_remove(struct rtw89_dev *rtwdev,struct rtw89_vif *rtwvif = (struct rtw89_vif *)vif->drv_priv;struct rtw89_sta *rtwsta = (struct rtw89_sta *)sta->drv_priv; -if (vif->type ==NL80211_IFTYPE_STATION ) +if (vif->type ==NL80211_IFTYPE_STATION && !sta->tdls)rtw89_btc_ntfy_role_info (rtwdev, rtwvif, rtwsta,BTC_ROLE_MSTS_STA_DIS_CONN ); -else if (vif->type ==NL80211_IFTYPE_AP ) +else if (vif->type ==NL80211_IFTYPE_AP || sta->tdls)rtw89_core_release_bit_map (rtwdev->mac_id_map, rtwsta->mac_id);return 0 ;
drivers/net/wireless/realtek/rtw89/core.h +7 -3
@@ -1961,7 +1961,7 @@ struct rtw89_sta {struct ieee80211_rx_status rx_status;u16 rx_hw_rate;__le32 htc_template; -struct rtw89_addr_cam_entry addr_cam;/* AP mode only */ +struct rtw89_addr_cam_entry addr_cam;/* AP mode or TDLS peer only */ bool use_cfg_mask;struct cfg80211_bitrate_mask mask;
@@ -3537,8 +3537,12 @@ static inlinestruct rtw89_addr_cam_entry *rtw89_get_addr_cam_of (struct rtw89_vif *rtwvif,struct rtw89_sta *rtwsta) { -if (rtwvif->net_type ==RTW89_NET_TYPE_AP_MODE && rtwsta) -return &rtwsta->addr_cam; +if (rtwsta) { +struct ieee80211_sta *sta =rtwsta_to_sta (rtwsta); + +if (rtwvif->net_type ==RTW89_NET_TYPE_AP_MODE || sta->tdls) +return &rtwsta->addr_cam; + }return &rtwvif->addr_cam; }
drivers/net/wireless/realtek/rtw89/mac80211.c +1 -1
@@ -454,7 +454,7 @@ static int __rtw89_ops_sta_state(struct ieee80211_hw *hw,if (old_state ==IEEE80211_STA_AUTH && new_state ==IEEE80211_STA_ASSOC ) { -if (vif->type ==NL80211_IFTYPE_STATION ) +if (vif->type ==NL80211_IFTYPE_STATION && !sta->tdls)return 0 ;/* defer to bss_info_changed to have vif info */ return rtw89_core_sta_assoc (rtwdev, vif, sta); }
drivers/net/wireless/realtek/rtw89/ser.c +7 -6
@@ -300,18 +300,19 @@ static void ser_reset_vif(struct rtw89_dev *rtwdev, struct rtw89_vif *rtwvif)static void ser_sta_deinit_addr_cam_iter (void *data,struct ieee80211_sta *sta) { -struct rtw89_dev *rtwdev = (struct rtw89_dev *)data; +struct rtw89_vif *rtwvif = (struct rtw89_vif *)data; +struct rtw89_dev *rtwdev = rtwvif->rtwdev;struct rtw89_sta *rtwsta = (struct rtw89_sta *)sta->drv_priv; -rtw89_cam_deinit_addr_cam (rtwdev, &rtwsta->addr_cam); +if (rtwvif->net_type ==RTW89_NET_TYPE_AP_MODE || sta->tdls) +rtw89_cam_deinit_addr_cam (rtwdev, &rtwsta->addr_cam); }static void ser_deinit_cam (struct rtw89_dev *rtwdev,struct rtw89_vif *rtwvif) { -if (rtwvif->net_type ==RTW89_NET_TYPE_AP_MODE ) -ieee80211_iterate_stations_atomic (rtwdev->hw, - ser_sta_deinit_addr_cam_iter, - rtwdev); +ieee80211_iterate_stations_atomic (rtwdev->hw, + ser_sta_deinit_addr_cam_iter, + rtwvif);rtw89_cam_deinit (rtwdev, rtwvif); }
Signature · 1 line
2.25.1
Re: [01/11] wifi: rtw89: allocate address CAM and MAC ID to TDLS peer
Quoted 4 lines · Ping-Ke Shih
Normally, we only allocate an address CAM and single one MAC ID to AP in STA mode. To support TDLS, we handle TDLS peers like AP handles stations.
Signed-off-by Ping-Ke Shih <[email protected]>
11 patches applied to wireless-next.git, thanks.
7312100d4e64 wifi: rtw89: allocate address CAM and MAC ID to TDLS peer445b6bc362f9 wifi: rtw89: separate BSSID CAM operations39913cc88540 wifi: rtw89: allocate BSSID CAM per TDLS peer6a5a783a71cf wifi: rtw89: support TDLS29363fb666bc wifi: rtw89: fix potential TX stuck679955d54313 wifi: rtw89: enable VO TX AMPDUad663693c1bf wifi: rtw89: add UNEXP debug mask to keep monitor messages unexpected to happen frequently 9a3a593cba9a wifi: rtw89: drop invalid TX rate report of legacy ratec4756d5de72e wifi: rtw89: fix long RX latency in low power mode37c6abc374d1 wifi: rtw89: pci: fix PCI doesn't reclaim TX BD properly47324ab67af7 wifi: rtw89: disable invalid phy reports for all ICs
Signature · 3 lines
https://patchwork.kernel.org/project/linux-wireless/patch/[email protected]/ https://wireless.wiki.kernel.org/en/developers/documentation/submittingpatches
Ping-Ke Shih
maintainerPATCH 2/11 rtw89: separate BSSID CAM operations
In reply to Ping-Ke ShihNormally, we allocate a BSSID CAM to a vif. By hardware design, we must allocate a BSSID CAM to each TDLS peer, so separate BSSID CAM operations that will be used by later patches.
This patch doesn't change logic at all.
--- drivers/net/wireless/realtek/rtw89/cam.c | 24 ++++++++++++++++-------- drivers/net/wireless/realtek/rtw89/cam.h | 6 ++++++ 2 files changed, 22 insertions(+), 8 deletions(-)
drivers/net/wireless/realtek/rtw89/cam.c +16 -8
@@ -445,15 +445,22 @@ void rtw89_cam_deinit_addr_cam(struct rtw89_dev *rtwdev,clear_bit (addr_cam->addr_cam_idx, cam_info->addr_cam_map); } -void rtw89_cam_deinit (struct rtw89_dev *rtwdev,struct rtw89_vif *rtwvif) +void rtw89_cam_deinit_bssid_cam (struct rtw89_dev *rtwdev, +struct rtw89_bssid_cam_entry *bssid_cam) {struct rtw89_cam_info *cam_info = &rtwdev->cam_info; + + bssid_cam->valid = false; +clear_bit (bssid_cam->bssid_cam_idx, cam_info->bssid_cam_map); +} + +void rtw89_cam_deinit (struct rtw89_dev *rtwdev,struct rtw89_vif *rtwvif) +{struct rtw89_addr_cam_entry *addr_cam = &rtwvif->addr_cam;struct rtw89_bssid_cam_entry *bssid_cam = &rtwvif->bssid_cam;rtw89_cam_deinit_addr_cam (rtwdev, addr_cam); - bssid_cam->valid = false; -clear_bit (bssid_cam->bssid_cam_idx, cam_info->bssid_cam_map); +rtw89_cam_deinit_bssid_cam (rtwdev, bssid_cam); }void rtw89_cam_reset_keys (struct rtw89_dev *rtwdev)
@@ -539,10 +546,11 @@ static int rtw89_cam_get_avail_bssid_cam(struct rtw89_dev *rtwdev,return 0 ; } -static int rtw89_cam_init_bssid_cam (struct rtw89_dev *rtwdev, -struct rtw89_vif *rtwvif) +int rtw89_cam_init_bssid_cam (struct rtw89_dev *rtwdev, +struct rtw89_vif *rtwvif, +struct rtw89_bssid_cam_entry *bssid_cam, +const u8 *bssid) { -struct rtw89_bssid_cam_entry *bssid_cam = &rtwvif->bssid_cam;u8 bssid_cam_idx;int ret;
@@ -563,7 +571,7 @@ static int rtw89_cam_init_bssid_cam(struct rtw89_dev *rtwdev, bssid_cam->len =BSSID_CAM_ENT_SIZE ; bssid_cam->offset =0 ; bssid_cam->valid = true; -ether_addr_copy (bssid_cam->bssid, rtwvif->bssid); +ether_addr_copy (bssid_cam->bssid, bssid);return 0 ; }
@@ -581,7 +589,7 @@ int rtw89_cam_init(struct rtw89_dev *rtwdev, struct rtw89_vif *rtwvif)struct rtw89_bssid_cam_entry *bssid_cam = &rtwvif->bssid_cam;int ret; - ret =rtw89_cam_init_bssid_cam (rtwdev, rtwvif); + ret =rtw89_cam_init_bssid_cam (rtwdev, rtwvif, bssid_cam, rtwvif->bssid);if (ret) {rtw89_err (rtwdev,"failed to init bssid cam\n" );return ret;
drivers/net/wireless/realtek/rtw89/cam.h +6 -0
@@ -359,6 +359,12 @@ int rtw89_cam_init_addr_cam(struct rtw89_dev *rtwdev, const struct rtw89_bssid_cam_entry *bssid_cam);void rtw89_cam_deinit_addr_cam (struct rtw89_dev *rtwdev,struct rtw89_addr_cam_entry *addr_cam); +int rtw89_cam_init_bssid_cam (struct rtw89_dev *rtwdev, +struct rtw89_vif *rtwvif, +struct rtw89_bssid_cam_entry *bssid_cam, +const u8 *bssid); +void rtw89_cam_deinit_bssid_cam (struct rtw89_dev *rtwdev, +struct rtw89_bssid_cam_entry *bssid_cam); void rtw89_cam_fill_addr_cam_info(struct rtw89_dev *rtwdev, struct rtw89_vif *vif, struct rtw89_sta *rtwsta,
Signature · 1 line
2.25.1
Ping-Ke Shih
maintainerPATCH 3/11 rtw89: allocate BSSID CAM per TDLS peer
In reply to Ping-Ke ShihIn STA mode, if peer is TDLS. Allocate a BSSID CAM entry with peer's address to match address properly, and then hardware can ACK peer's packets and receive packets to driver.
--- drivers/net/wireless/realtek/rtw89/cam.c | 5 +++-- drivers/net/wireless/realtek/rtw89/cam.h | 3 ++- drivers/net/wireless/realtek/rtw89/core.c | 13 ++++++++++++- drivers/net/wireless/realtek/rtw89/core.h | 14 ++++++++++++++ drivers/net/wireless/realtek/rtw89/debug.c | 3 ++- drivers/net/wireless/realtek/rtw89/fw.c | 2 +- drivers/net/wireless/realtek/rtw89/ser.c | 2 ++ 7 files changed, 36 insertions(+), 6 deletions(-)
drivers/net/wireless/realtek/rtw89/cam.c +3 -2
@@ -605,10 +605,11 @@ int rtw89_cam_init(struct rtw89_dev *rtwdev, struct rtw89_vif *rtwvif) }int rtw89_cam_fill_bssid_cam_info (struct rtw89_dev *rtwdev, -struct rtw89_vif *rtwvif,u8 *cmd) +struct rtw89_vif *rtwvif, +struct rtw89_sta *rtwsta,u8 *cmd) {struct ieee80211_vif *vif =rtwvif_to_vif (rtwvif); -struct rtw89_bssid_cam_entry *bssid_cam = &rtwvif->bssid_cam; +struct rtw89_bssid_cam_entry *bssid_cam =rtw89_get_bssid_cam_of (rtwvif, rtwsta);u8 bss_color = vif->bss_conf.he_bss_color.color;u8 bss_mask;
drivers/net/wireless/realtek/rtw89/cam.h +2 -1
@@ -374,7 +374,8 @@ void rtw89_cam_fill_dctl_sec_cam_info_v1(struct rtw89_dev *rtwdev,struct rtw89_sta *rtwsta, u8 *cmd);int rtw89_cam_fill_bssid_cam_info (struct rtw89_dev *rtwdev, -struct rtw89_vif *vif,u8 *cmd); +struct rtw89_vif *rtwvif, +struct rtw89_sta *rtwsta,u8 *cmd); int rtw89_cam_sec_key_add(struct rtw89_dev *rtwdev, struct ieee80211_vif *vif, struct ieee80211_sta *sta,
drivers/net/wireless/realtek/rtw89/core.c +12 -1
@@ -2277,6 +2277,8 @@ int rtw89_core_sta_disconnect(struct rtw89_dev *rtwdev,rtw89_core_free_sta_pending_ba (rtwdev, sta);if (vif->type ==NL80211_IFTYPE_AP || sta->tdls)rtw89_cam_deinit_addr_cam (rtwdev, &rtwsta->addr_cam); +if (sta->tdls) +rtw89_cam_deinit_bssid_cam (rtwdev, &rtwsta->bssid_cam);if (vif->type ==NL80211_IFTYPE_STATION && !sta->tdls)rtw89_vif_type_mapping (vif, false);
@@ -2317,6 +2319,7 @@ int rtw89_core_sta_assoc(struct rtw89_dev *rtwdev, {struct rtw89_vif *rtwvif = (struct rtw89_vif *)vif->drv_priv;struct rtw89_sta *rtwsta = (struct rtw89_sta *)sta->drv_priv; +struct rtw89_bssid_cam_entry *bssid_cam =rtw89_get_bssid_cam_of (rtwvif, rtwsta);int ret;if (vif->type ==NL80211_IFTYPE_AP || sta->tdls) {
@@ -2332,7 +2335,15 @@ int rtw89_core_sta_assoc(struct rtw89_dev *rtwdev,return ret; } - ret =rtw89_cam_init_addr_cam (rtwdev, &rtwsta->addr_cam, &rtwvif->bssid_cam); +if (sta->tdls) { + ret =rtw89_cam_init_bssid_cam (rtwdev, rtwvif, bssid_cam, sta->addr); +if (ret) { +rtw89_warn (rtwdev,"failed to send h2c init bssid cam for TDLS\n" ); +return ret; + } + } + + ret =rtw89_cam_init_addr_cam (rtwdev, &rtwsta->addr_cam, bssid_cam);if (ret) {rtw89_warn (rtwdev,"failed to send h2c init addr cam\n" );return ret;
drivers/net/wireless/realtek/rtw89/core.h +14 -0
@@ -1962,6 +1962,7 @@ struct rtw89_sta {u16 rx_hw_rate;__le32 htc_template;struct rtw89_addr_cam_entry addr_cam;/* AP mode or TDLS peer only */ +struct rtw89_bssid_cam_entry bssid_cam;/* TDLS peer only */ bool use_cfg_mask;struct cfg80211_bitrate_mask mask;
@@ -3546,6 +3547,19 @@ struct rtw89_addr_cam_entry *rtw89_get_addr_cam_of(struct rtw89_vif *rtwvif,return &rtwvif->addr_cam; } +static inline +struct rtw89_bssid_cam_entry *rtw89_get_bssid_cam_of (struct rtw89_vif *rtwvif, +struct rtw89_sta *rtwsta) +{ +if (rtwsta) { +struct ieee80211_sta *sta =rtwsta_to_sta (rtwsta); + +if (sta->tdls) +return &rtwsta->bssid_cam; + } +return &rtwvif->bssid_cam; +} +static inline void rtw89_chip_set_channel_prepare (struct rtw89_dev *rtwdev,struct rtw89_channel_help_params *p)
drivers/net/wireless/realtek/rtw89/debug.c +2 -1
@@ -2437,7 +2437,8 @@ static void rtw89_sta_ids_get_iter(void *data, struct ieee80211_sta *sta)struct rtw89_sta *rtwsta = (struct rtw89_sta *)sta->drv_priv;struct seq_file *m = (struct seq_file *)data; -seq_printf (m,"STA [%d] %pM\n" , rtwsta->mac_id, sta->addr); +seq_printf (m,"STA [%d] %pM %s\n" , rtwsta->mac_id, sta->addr, + sta->tdls ?"(TDLS)" :"" );rtw89_dump_addr_cam (m, &rtwsta->addr_cam); }
drivers/net/wireless/realtek/rtw89/fw.c +1 -1
@@ -579,7 +579,7 @@ int rtw89_fw_h2c_cam(struct rtw89_dev *rtwdev, struct rtw89_vif *rtwvif, }skb_put (skb,H2C_CAM_LEN );rtw89_cam_fill_addr_cam_info (rtwdev, rtwvif, rtwsta, scan_mac_addr, skb->data); -rtw89_cam_fill_bssid_cam_info (rtwdev, rtwvif, skb->data); +rtw89_cam_fill_bssid_cam_info (rtwdev, rtwvif, rtwsta, skb->data); rtw89_h2c_pkt_set_hdr(rtwdev, skb, FWCMD_TYPE_H2C, H2C_CAT_MAC,
drivers/net/wireless/realtek/rtw89/ser.c +2 -0
@@ -306,6 +306,8 @@ static void ser_sta_deinit_addr_cam_iter(void *data, struct ieee80211_sta *sta)if (rtwvif->net_type ==RTW89_NET_TYPE_AP_MODE || sta->tdls)rtw89_cam_deinit_addr_cam (rtwdev, &rtwsta->addr_cam); +if (sta->tdls) +rtw89_cam_deinit_bssid_cam (rtwdev, &rtwsta->bssid_cam); }static void ser_deinit_cam (struct rtw89_dev *rtwdev,struct rtw89_vif *rtwvif)
Signature · 1 line
2.25.1
Ping-Ke Shih
maintainerPATCH 4/11 rtw89: support TDLS
In reply to Ping-Ke ShihSince we can allocate MAC ID, BSSID and address CAM to TDLS peer, declare we can support TDLS now.
--- drivers/net/wireless/realtek/rtw89/core.c | 2 ++ 1 file changed, 2 insertions(+)
drivers/net/wireless/realtek/rtw89/core.c +2 -0
@@ -3029,6 +3029,8 @@ static int rtw89_core_register_hw(struct rtw89_dev *rtwdev) hw->wiphy->available_antennas_tx =BIT (rtwdev->chip->rf_path_num) -1 ; hw->wiphy->available_antennas_rx =BIT (rtwdev->chip->rf_path_num) -1 ; + hw->wiphy->flags |=WIPHY_FLAG_SUPPORTS_TDLS | +WIPHY_FLAG_TDLS_EXTERNAL_SETUP ; hw->wiphy->features |=NL80211_FEATURE_SCAN_RANDOM_MAC_ADDR ; hw->wiphy->max_scan_ssids =RTW89_SCANOFLD_MAX_SSID ;
Signature · 1 line
2.25.1
Ping-Ke Shih
maintainerPATCH 5/11 rtw89: fix potential TX stuck
In reply to Ping-Ke ShihFrom: Kuan-Chung Chen <[email protected]>
The potential TX stuck occurs when there are lots of packets to be transmitted and the boundary of the tx_resource is hit. Add this patch to avoid the TX stuck when burst traffic.
--- drivers/net/wireless/realtek/rtw89/core.c | 4 ++++ 1 file changed, 4 insertions(+)
drivers/net/wireless/realtek/rtw89/core.c +4 -0
@@ -1945,6 +1945,10 @@ static void rtw89_core_txq_schedule(struct rtw89_dev *rtwdev, u8 ac, bool *reinvieee80211_return_txq (hw, txq, sched_txq);if (frame_cnt !=0 )rtw89_core_tx_kick_off (rtwdev,rtw89_core_get_qsel (rtwdev, txq->tid)); + +/* bound of tx_resource could get stuck due to burst traffic */ +if (frame_cnt == tx_resource) + *reinvoke = true; }ieee80211_txq_schedule_end (hw, ac); }
Signature · 1 line
2.25.1
Ping-Ke Shih
maintainerPATCH 6/11 rtw89: enable VO TX AMPDU
In reply to Ping-Ke ShihFrom: Kuan-Chung Chen <[email protected]>
To improve VO throughput, we enable VO TX AMPDU.
We measure the latency of enable or disable VO TX AMPDU. The experimental results show that the difference between the two is insignificant only 300µs, so the little impact can be ignored for user experience.
Moreover, we found some APs will have a group key handshake timeout issue when the EAPOL's TID is already setup BA session. Therefore, when transmitting EAPOL, if EAPOL's TID BA session is already setup, we need to delete it.
--- drivers/net/wireless/realtek/rtw89/core.c | 92 +++++++++++++++++++++-- drivers/net/wireless/realtek/rtw89/core.h | 7 +- 2 files changed, 92 insertions(+), 7 deletions(-)
drivers/net/wireless/realtek/rtw89/core.c +86 -6
@@ -408,18 +408,30 @@ rtw89_core_get_tx_type(struct rtw89_dev *rtwdev,static void rtw89_core_tx_update_ampdu_info (struct rtw89_dev *rtwdev, -struct rtw89_core_tx_request *tx_req,u8 tid) +struct rtw89_core_tx_request *tx_req, +enum btc_pkt_type pkt_type) {struct ieee80211_sta *sta = tx_req->sta;struct rtw89_tx_desc_info *desc_info = &tx_req->desc_info; +struct sk_buff *skb = tx_req->skb;struct rtw89_sta *rtwsta;u8 ampdu_num; +u8 tid; + +if (pkt_type ==PACKET_EAPOL ) { + desc_info->bk = true; +return ; + } + +if (!(IEEE80211_SKB_CB (skb)->flags &IEEE80211_TX_CTL_AMPDU )) +return ;if (!sta) {rtw89_warn (rtwdev,"cannot set ampdu info without sta\n" );return ; } + tid = skb->priority &IEEE80211_QOS_CTL_TAG1D_MASK ; rtwsta = (struct rtw89_sta *)sta->drv_priv; ampdu_num = (u8)((rtwsta->ampdu_params[tid].agg_num ?
@@ -720,8 +732,6 @@ rtw89_core_tx_update_data_info(struct rtw89_dev *rtwdev,/* enable wd_info for AMPDU */ desc_info->en_wd_info = true; -if (IEEE80211_SKB_CB (skb)->flags &IEEE80211_TX_CTL_AMPDU ) -rtw89_core_tx_update_ampdu_info (rtwdev, tx_req, tid);if (IEEE80211_SKB_CB (skb)->control.hw_key)rtw89_core_tx_update_sec_key (rtwdev, tx_req);
@@ -832,6 +842,7 @@ rtw89_core_tx_update_desc_info(struct rtw89_dev *rtwdev,rtw89_core_tx_update_data_info (rtwdev, tx_req); pkt_type =rtw89_core_tx_btc_spec_pkt_notify (rtwdev, tx_req);rtw89_core_tx_update_he_qos_htc (rtwdev, tx_req, pkt_type); +rtw89_core_tx_update_ampdu_info (rtwdev, tx_req, pkt_type);rtw89_core_tx_update_llc_hdr (rtwdev, desc_info, skb);break ;case RTW89_CORE_TX_TYPE_FWCMD :
@@ -1811,6 +1822,55 @@ static void rtw89_core_free_sta_pending_ba(struct rtw89_dev *rtwdev,spin_unlock_bh (&rtwdev->ba_lock); } +static void rtw89_core_free_sta_pending_forbid_ba (struct rtw89_dev *rtwdev, +struct ieee80211_sta *sta) +{ +struct rtw89_txq *rtwtxq, *tmp; + +spin_lock_bh (&rtwdev->ba_lock); +list_for_each_entry_safe (rtwtxq, tmp, &rtwdev->forbid_ba_list, list) { +struct ieee80211_txq *txq =rtw89_txq_to_txq (rtwtxq); + +if (sta == txq->sta) { +clear_bit (RTW89_TXQ_F_FORBID_BA , &rtwtxq->flags); +list_del_init (&rtwtxq->list); + } + } +spin_unlock_bh (&rtwdev->ba_lock); +} + +static void rtw89_core_stop_tx_ba_session (struct rtw89_dev *rtwdev, +struct rtw89_txq *rtwtxq) +{ +struct ieee80211_txq *txq =rtw89_txq_to_txq (rtwtxq); +struct ieee80211_sta *sta = txq->sta; +struct rtw89_sta *rtwsta =sta_to_rtwsta_safe (sta); + +if (unlikely (!rtwsta) ||unlikely (rtwsta->disassoc)) +return ; + +if (!test_bit (RTW89_TXQ_F_AMPDU , &rtwtxq->flags) || +test_bit (RTW89_TXQ_F_FORBID_BA , &rtwtxq->flags)) +return ; + +spin_lock_bh (&rtwdev->ba_lock); +if (!list_empty (&rtwtxq->list)) { +list_del_init (&rtwtxq->list); + goto out; + } + +set_bit (RTW89_TXQ_F_FORBID_BA , &rtwtxq->flags); + +list_add_tail (&rtwtxq->list, &rtwdev->forbid_ba_list); +ieee80211_stop_tx_ba_session (sta, txq->tid); +cancel_delayed_work (&rtwdev->forbid_ba_work); +ieee80211_queue_delayed_work (rtwdev->hw, &rtwdev->forbid_ba_work, +RTW89_FORBID_BA_TIMER ); + +out: +spin_unlock_bh (&rtwdev->ba_lock); +} +static void rtw89_core_txq_check_agg (struct rtw89_dev *rtwdev,struct rtw89_txq *rtwtxq,struct sk_buff *skb)
@@ -1820,13 +1880,15 @@ static void rtw89_core_txq_check_agg(struct rtw89_dev *rtwdev,struct ieee80211_sta *sta = txq->sta;struct rtw89_sta *rtwsta = sta ? (struct rtw89_sta *)sta->drv_priv :NULL ; -if (unlikely (skb_get_queue_mapping (skb) ==IEEE80211_AC_VO )) +if (unlikely (skb->protocol ==cpu_to_be16 (ETH_P_PAE ))) { +rtw89_core_stop_tx_ba_session (rtwdev, rtwtxq);return ; + } -if (unlikely (skb->protocol ==cpu_to_be16 (ETH_P_PAE ))) +if (unlikely (!sta))return ; -if (unlikely (!sta)) +if (test_bit (RTW89_TXQ_F_FORBID_BA , &rtwtxq->flags))return ;if (unlikely (test_bit (RTW89_TXQ_F_BLOCK_BA , &rtwtxq->flags)))
@@ -1986,6 +2048,20 @@ static void rtw89_core_txq_reinvoke_work(struct work_struct *w)queue_work (rtwdev->txq_wq, &rtwdev->txq_work); } +static void rtw89_forbid_ba_work (struct work_struct *w) +{ + struct rtw89_dev *rtwdev = container_of(w, struct rtw89_dev, + forbid_ba_work.work); +struct rtw89_txq *rtwtxq, *tmp; + +spin_lock_bh (&rtwdev->ba_lock); +list_for_each_entry_safe (rtwtxq, tmp, &rtwdev->forbid_ba_list, list) { +clear_bit (RTW89_TXQ_F_FORBID_BA , &rtwtxq->flags); +list_del_init (&rtwtxq->list); + } +spin_unlock_bh (&rtwdev->ba_lock); +} +static enum rtw89_tfc_lv rtw89_get_traffic_level (struct rtw89_dev *rtwdev,u32 throughput,u64 cnt) {
@@ -2279,6 +2355,7 @@ int rtw89_core_sta_disconnect(struct rtw89_dev *rtwdev,rtw89_mac_bf_monitor_calc (rtwdev, sta, true);rtw89_mac_bf_disassoc (rtwdev, vif, sta);rtw89_core_free_sta_pending_ba (rtwdev, sta); +rtw89_core_free_sta_pending_forbid_ba (rtwdev, sta);if (vif->type ==NL80211_IFTYPE_AP || sta->tdls)rtw89_cam_deinit_addr_cam (rtwdev, &rtwsta->addr_cam);if (sta->tdls)
@@ -2791,6 +2868,7 @@ void rtw89_core_stop(struct rtw89_dev *rtwdev)cancel_delayed_work_sync (&rtwdev->coex_bt_devinfo_work);cancel_delayed_work_sync (&rtwdev->coex_rfk_chk_work);cancel_delayed_work_sync (&rtwdev->cfo_track_work); +cancel_delayed_work_sync (&rtwdev->forbid_ba_work);mutex_lock (&rtwdev->mutex);
@@ -2810,6 +2888,7 @@ int rtw89_core_init(struct rtw89_dev *rtwdev)u8 band;INIT_LIST_HEAD (&rtwdev->ba_list); +INIT_LIST_HEAD (&rtwdev->forbid_ba_list);INIT_LIST_HEAD (&rtwdev->rtwvifs_list);INIT_LIST_HEAD (&rtwdev->early_h2c_list);for (band =NL80211_BAND_2GHZ ; band <NUM_NL80211_BANDS ; band++) {
@@ -2825,6 +2904,7 @@ int rtw89_core_init(struct rtw89_dev *rtwdev)INIT_DELAYED_WORK (&rtwdev->coex_bt_devinfo_work, rtw89_coex_bt_devinfo_work);INIT_DELAYED_WORK (&rtwdev->coex_rfk_chk_work, rtw89_coex_rfk_chk_work);INIT_DELAYED_WORK (&rtwdev->cfo_track_work, rtw89_phy_cfo_track_work); +INIT_DELAYED_WORK (&rtwdev->forbid_ba_work, rtw89_forbid_ba_work); rtwdev->txq_wq =alloc_workqueue ("rtw89_tx_wq" ,WQ_UNBOUND |WQ_HIGHPRI ,0 );spin_lock_init (&rtwdev->ba_lock);spin_lock_init (&rtwdev->rpwm_lock);
drivers/net/wireless/realtek/rtw89/core.h +6 -1
@@ -29,6 +29,7 @@ extern const struct ieee80211_ops rtw89_ops;#define INV_RF_DATA 0xffffffff#define RTW89_TRACK_WORK_PERIOD round_jiffies_relative(HZ * 2) +#define RTW89_FORBID_BA_TIMER round_jiffies_relative(HZ * 4)#define CFO_TRACK_MAX_USER 64#define MAX_RSSI 110#define RSSI_FACTOR 1
@@ -134,6 +135,7 @@ enum rtw89_core_rx_type {enum rtw89_txq_flags {RTW89_TXQ_F_AMPDU =0 ,RTW89_TXQ_F_BLOCK_BA =1 , +RTW89_TXQ_F_FORBID_BA =2 , };enum rtw89_net_type {
@@ -3116,10 +3118,12 @@ struct rtw89_dev {struct workqueue_struct *txq_wq;struct work_struct txq_work;struct delayed_work txq_reinvoke_work; -/* used to protect ba_list */ +/* used to protect ba_list and forbid_ba_list */ spinlock_t ba_lock;/* txqs to setup ba session */ struct list_head ba_list; +/* txqs to forbid ba session */ +struct list_head forbid_ba_list;struct work_struct ba_work;/* used to protect rpwm */ spinlock_t rpwm_lock;
@@ -3166,6 +3170,7 @@ struct rtw89_dev {struct delayed_work coex_bt_devinfo_work;struct delayed_work coex_rfk_chk_work;struct delayed_work cfo_track_work; +struct delayed_work forbid_ba_work;struct rtw89_ppdu_sts_info ppdu_sts;u8 total_sta_assoc;bool scanning;
Signature · 1 line
2.25.1
Ping-Ke Shih
maintainerPATCH 7/11 rtw89: add UNEXP debug mask to keep monitor messages unexpected to happen frequently
In reply to Ping-Ke ShihSome warning messages could bother users. With proper handling, these situations don't really affect usage, but we still need to keep monitor these messages. If they happen frequently, we must review driver or hardware design to clarify.
--- drivers/net/wireless/realtek/rtw89/core.c | 2 +- drivers/net/wireless/realtek/rtw89/debug.h | 2 ++ drivers/net/wireless/realtek/rtw89/pci.c | 7 ++++--- 3 files changed, 7 insertions(+), 4 deletions(-)
drivers/net/wireless/realtek/rtw89/core.c +1 -1
@@ -1243,7 +1243,7 @@ static int rtw89_core_rx_process_phy_ppdu(struct rtw89_dev *rtwdev, struct rtw89_rx_phy_ppdu *phy_ppdu) {if (RTW89_GET_PHY_STS_LEN (phy_ppdu->buf) <<3 != phy_ppdu->len) { -rtw89_warn (rtwdev,"phy ppdu len mismatch\n" ); +rtw89_debug (rtwdev,RTW89_DBG_UNEXP ,"phy ppdu len mismatch\n" );return -EINVAL ; }rtw89_core_update_phy_ppdu (phy_ppdu);
drivers/net/wireless/realtek/rtw89/debug.h +2 -0
@@ -25,6 +25,8 @@ enum rtw89_debug_mask {RTW89_DBG_BF =BIT (14 ),RTW89_DBG_HW_SCAN =BIT (15 ),RTW89_DBG_SAR =BIT (16 ), + + RTW89_DBG_UNEXP = BIT(31), }; enum rtw89_debug_mac_reg_sel {
drivers/net/wireless/realtek/rtw89/pci.c +4 -3
@@ -228,7 +228,8 @@ static u32 rtw89_pci_rxbd_deliver_skbs(struct rtw89_dev *rtwdev,if (fs) {if (new) { -rtw89_err (rtwdev,"skb should not be ready before first segment start\n" ); +rtw89_debug (rtwdev,RTW89_DBG_UNEXP , +"skb should not be ready before first segment start\n" ); goto err_sync_device; }if (desc_info->ready) {
@@ -251,7 +252,7 @@ static u32 rtw89_pci_rxbd_deliver_skbs(struct rtw89_dev *rtwdev, }else { offset =sizeof (struct rtw89_pci_rxbd_info );if (!new) { -rtw89_warn (rtwdev,"no last skb\n" ); +rtw89_debug (rtwdev,RTW89_DBG_UNEXP ,"no last skb\n" ); goto err_sync_device; } }
@@ -605,7 +606,7 @@ static void rtw89_pci_isr_rxd_unavail(struct rtw89_dev *rtwdev, hw_idx_next = (hw_idx +1 ) % bd_ring->len;if (hw_idx_next == host_idx) -rtw89_warn (rtwdev,"%d RXD unavailable\n" , i); +rtw89_debug (rtwdev,RTW89_DBG_UNEXP ,"%d RXD unavailable\n" , i); rtw89_debug(rtwdev, RTW89_DBG_TXRX, "%d RXD unavailable, idx=0x%08x, len=%d\n",
Signature · 1 line
2.25.1
Ping-Ke Shih
maintainerPATCH 8/11 rtw89: drop invalid TX rate report of legacy rate
In reply to Ping-Ke ShihSomehow, firmware could report invalid TX rate, and we consider the invalid rate as 0 that will make a wrong decision. So, drop invalid reports, and also suppress the warning message.
--- drivers/net/wireless/realtek/rtw89/core.c | 9 +++++---- drivers/net/wireless/realtek/rtw89/core.h | 2 +- drivers/net/wireless/realtek/rtw89/phy.c | 14 +++++++++++--- 3 files changed, 17 insertions(+), 8 deletions(-)
drivers/net/wireless/realtek/rtw89/core.c +5 -4
@@ -155,18 +155,19 @@ static struct ieee80211_rate rtw89_bitrates[] = { { .bitrate = 540, .hw_value = 0x0b, }, }; -u16 rtw89_ra_report_to_bitrate (struct rtw89_dev *rtwdev,u8 rpt_rate) +bool rtw89_ra_report_to_bitrate (struct rtw89_dev *rtwdev,u8 rpt_rate,u16 *bitrate) {struct ieee80211_rate rate;if (unlikely (rpt_rate >=ARRAY_SIZE (rtw89_bitrates))) { -rtw89_info (rtwdev,"invalid rpt rate %d\n" , rpt_rate); -return 0 ; +rtw89_debug (rtwdev,RTW89_DBG_UNEXP ,"invalid rpt rate %d\n" , rpt_rate); +return false; } rate = rtw89_bitrates[rpt_rate]; + *bitrate = rate.bitrate; -return rate.bitrate; +return true; }static struct ieee80211_supported_band rtw89_sband_2ghz = {
drivers/net/wireless/realtek/rtw89/core.h +1 -1
@@ -3893,7 +3893,7 @@ int rtw89_core_acquire_sta_ba_entry(struct rtw89_sta *rtwsta, u8 tid, u8 *cam_idint rtw89_core_release_sta_ba_entry (struct rtw89_sta *rtwsta,u8 tid,u8 *cam_idx);void rtw89_vif_type_mapping (struct ieee80211_vif *vif,bool assoc);int rtw89_chip_info_setup (struct rtw89_dev *rtwdev); -u16 rtw89_ra_report_to_bitrate (struct rtw89_dev *rtwdev,u8 rpt_rate); +bool rtw89_ra_report_to_bitrate (struct rtw89_dev *rtwdev,u8 rpt_rate,u16 *bitrate);int rtw89_regd_init (struct rtw89_dev *rtwdev,void (*reg_notifier)(struct wiphy *wiphy,struct regulatory_request *request));void rtw89_regd_notifier (struct wiphy *wiphy,struct regulatory_request *request);
drivers/net/wireless/realtek/rtw89/phy.c +11 -3
@@ -1918,21 +1918,29 @@ static void rtw89_phy_c2h_ra_rpt_iter(void *data, struct ieee80211_sta *sta)struct rtw89_ra_report *ra_report = &rtwsta->ra_report;struct sk_buff *c2h = ra_data->c2h;u8 mode, rate, bw, giltf, mac_id; +u16 legacy_bitrate; +bool valid; mac_id =RTW89_GET_PHY_C2H_RA_RPT_MACID (c2h->data);if (mac_id != rtwsta->mac_id)return ; -memset (ra_report,0 ,sizeof (*ra_report)); - rate =RTW89_GET_PHY_C2H_RA_RPT_MCSNSS (c2h->data); bw =RTW89_GET_PHY_C2H_RA_RPT_BW (c2h->data); giltf =RTW89_GET_PHY_C2H_RA_RPT_GILTF (c2h->data); mode =RTW89_GET_PHY_C2H_RA_RPT_MD_SEL (c2h->data); +if (mode ==RTW89_RA_RPT_MODE_LEGACY ) { + valid =rtw89_ra_report_to_bitrate (rtwdev, rate, &legacy_bitrate); +if (!valid) +return ; + } + +memset (ra_report,0 ,sizeof (*ra_report)); +switch (mode) {case RTW89_RA_RPT_MODE_LEGACY : - ra_report->txrate.legacy =rtw89_ra_report_to_bitrate (rtwdev, rate); + ra_report->txrate.legacy = legacy_bitrate;break ;case RTW89_RA_RPT_MODE_HT : ra_report->txrate.flags |=RATE_INFO_FLAGS_MCS ;
Signature · 1 line
2.25.1
Ping-Ke Shih
maintainerPATCH 9/11 rtw89: fix long RX latency in low power mode
In reply to Ping-Ke ShihIn low power mode, regular IO is power off, so we don't schedule napi to poll RX and TX completion. Therefore, calling ieee80211_rx_napi() with napi instance causes long RX latency. To fix this, use NULL as argument, and then it can use netif_receive_skb_list() to receive.
--- drivers/net/wireless/realtek/rtw89/core.c | 8 +++++++- 1 file changed, 7 insertions(+), 1 deletion(-)
drivers/net/wireless/realtek/rtw89/core.c +7 -1
@@ -1437,11 +1437,17 @@ static void rtw89_core_rx_to_mac80211(struct rtw89_dev *rtwdev,struct sk_buff *skb_ppdu, struct ieee80211_rx_status *rx_status) { + struct napi_struct *napi = &rtwdev->napi; + +/* In low power mode, napi isn't scheduled. Receive it to netif. */ +if (unlikely (!test_bit (NAPI_STATE_SCHED , &napi->state))) + napi =NULL ; +rtw89_core_hw_to_sband_rate (rx_status);rtw89_core_rx_stats (rtwdev, phy_ppdu, desc_info, skb_ppdu);/* In low power mode, it does RX in thread context. */ local_bh_disable (); -ieee80211_rx_napi (rtwdev->hw,NULL , skb_ppdu, &rtwdev->napi); +ieee80211_rx_napi (rtwdev->hw,NULL , skb_ppdu, napi);local_bh_enable (); rtwdev->napi_budget_countdown--; }
Signature · 1 line
2.25.1
Ping-Ke Shih
maintainerPATCH 10/11 rtw89: pci: fix PCI doesn't reclaim TX BD properly
In reply to Ping-Ke ShihTX BD (TX ring index) and TX WD (WiFi descriptor buffer) are freed asynchronously. With burst packets, we free TX WD, but the corresponding TX BD couldn't be freed yet. Then, TX can possibly get stuck due to no more TX BD.
To avoid this, ignore reclaiming TX BD only if TX WD is no free space, because at this moment TX BD must have some spaces. Otherwise, we reclaim TX BD to resolve TX stuck issue.
--- drivers/net/wireless/realtek/rtw89/pci.c | 9 ++++++--- 1 file changed, 6 insertions(+), 3 deletions(-)
drivers/net/wireless/realtek/rtw89/pci.c +6 -3
@@ -952,9 +952,10 @@ static u32 __rtw89_pci_check_and_reclaim_tx_resource(struct rtw89_dev *rtwdev,if (wd_cnt ==0 || bd_cnt ==0 ) { cnt =rtw89_pci_rxbd_recalc (rtwdev, rx_ring); -if (!cnt) +if (cnt) +rtw89_pci_release_tx (rtwdev, rx_ring, cnt); +else if (wd_cnt ==0 ) goto out_unlock; -rtw89_pci_release_tx (rtwdev, rx_ring, cnt); bd_cnt =rtw89_pci_get_avail_txbd_num (tx_ring);if (bd_cnt ==0 )
@@ -965,7 +966,9 @@ static u32 __rtw89_pci_check_and_reclaim_tx_resource(struct rtw89_dev *rtwdev, wd_cnt = wd_ring->curr_num; min_cnt =min (bd_cnt, wd_cnt);if (min_cnt ==0 ) -rtw89_warn (rtwdev,"still no tx resource after reclaim\n" ); +rtw89_debug (rtwdev, rtwpci->low_power ?RTW89_DBG_TXRX :RTW89_DBG_UNEXP , +"still no tx resource after reclaim: wd_cnt=%d bd_cnt=%d\n" , + wd_cnt, bd_cnt); out_unlock:spin_unlock_bh (&rtwpci->trx_lock);
Signature · 1 line
2.25.1
Ping-Ke Shih
maintainerPATCH 11/11 rtw89: disable invalid phy reports for all ICs
In reply to Ping-Ke ShihFrom: Po-Hao Huang <[email protected]>
Previously we only disable invalid reports for 52A, since we plan to support more ICs in the future, enable settings for those as well.
--- drivers/net/wireless/realtek/rtw89/phy.c | 4 +--- 1 file changed, 1 insertion(+), 3 deletions(-)
drivers/net/wireless/realtek/rtw89/phy.c +1 -3
@@ -3107,11 +3107,9 @@ static void rtw89_physts_enable_fail_report(struct rtw89_dev *rtwdev,static void rtw89_physts_parsing_init (struct rtw89_dev *rtwdev) { -const struct rtw89_chip_info *chip = rtwdev->chip;u8 i; -if (chip->chip_id ==RTL8852A && rtwdev->hal.cv ==CHIP_CBV ) -rtw89_physts_enable_fail_report (rtwdev, false,RTW89_PHY_0 ); +rtw89_physts_enable_fail_report (rtwdev, false,RTW89_PHY_0 );for (i =0 ; i <RTW89_PHYSTS_BITMAP_NUM ; i++) {if (i >=RTW89_CCK_PKT )
Signature · 1 line
2.25.1