wifi-assoc-manager.h

Go to the documentation of this file.

/*
 * Copyright (c) 2022 Universita' degli Studi di Napoli Federico II
 *
 * This program is free software; you can redistribute it and/or modify
 * it under the terms of the GNU General Public License version 2 as
 * published by the Free Software Foundation;
 *
 * This program is distributed in the hope that it will be useful,
 * but WITHOUT ANY WARRANTY; without even the implied warranty of
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
 * GNU General Public License for more details.
 *
 * You should have received a copy of the GNU General Public License
 * along with this program; if not, write to the Free Software
 * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
 *
 * Author: Stefano Avallone <stavallo@unina.it>
 */
 
#ifndef WIFI_ASSOC_MANAGER_H
#define WIFI_ASSOC_MANAGER_H
 
#include "qos-utils.h"
#include "sta-wifi-mac.h"
 
#include <set>
#include <unordered_map>
 
namespace ns3
{
 
class WifiAssocManager : public Object
{
    struct ApInfoCompare
    {
        ApInfoCompare(const WifiAssocManager& manager);
        bool operator()(const StaWifiMac::ApInfo& lhs, const StaWifiMac::ApInfo& rhs) const;
 
      private:
        const WifiAssocManager& m_manager; 
    };
 
  public:
    struct RnrLinkInfo
    {
        std::size_t m_nbrApInfoId;     
        std::size_t m_tbttInfoFieldId; 
    };
 
    static TypeId GetTypeId();
 
    ~WifiAssocManager() override;
 
    void SetStaWifiMac(Ptr<StaWifiMac> mac);
 
    void StartScanning(WifiScanParams&& scanParams);
 
    virtual void NotifyApInfo(const StaWifiMac::ApInfo&& apInfo);
 
    virtual void NotifyChannelSwitched(uint8_t linkId) = 0;
 
    virtual bool Compare(const StaWifiMac::ApInfo& lhs, const StaWifiMac::ApInfo& rhs) const = 0;
 
    static std::optional<WifiAssocManager::RnrLinkInfo> GetNextAffiliatedAp(
        const ReducedNeighborReport& rnr,
        std::size_t nbrApInfoId);
 
    static std::list<WifiAssocManager::RnrLinkInfo> GetAllAffiliatedAps(
        const ReducedNeighborReport& rnr);
 
  protected:
    WifiAssocManager();
    void DoDispose() override;
 
    using SortedList = std::set<StaWifiMac::ApInfo, ApInfoCompare>;
 
    const SortedList& GetSortedList() const;
 
    std::list<std::pair<std::uint8_t, uint8_t>>& GetSetupLinks(const StaWifiMac::ApInfo& apInfo);
 
    const WifiScanParams& GetScanParams() const;
 
    bool MatchScanParams(const StaWifiMac::ApInfo& apInfo) const;
 
    virtual bool CanBeInserted(const StaWifiMac::ApInfo& apInfo) const = 0;
    virtual bool CanBeReturned(const StaWifiMac::ApInfo& apInfo) const = 0;
 
    void ScanningTimeout();
 
    using OptRnrConstRef = std::optional<std::reference_wrapper<const ReducedNeighborReport>>;
    using OptMleConstRef = std::optional<std::reference_wrapper<const MultiLinkElement>>;
 
    bool CanSetupMultiLink(OptMleConstRef& mle, OptRnrConstRef& rnr);
 
    Ptr<StaWifiMac> m_mac; 
 
  private:
    virtual void DoStartScanning() = 0;
 
    WifiScanParams m_scanParams; 
    SortedList m_apList;         
    std::unordered_map<Mac48Address, SortedList::const_iterator, WifiAddressHash> m_apListIt;
};
 
} // namespace ns3
 
#endif /* WIFI_ASSOC_MANAGER_H */