default-emlsr-manager.h

Go to the documentation of this file.

/*
 * Copyright (c) 2023 Universita' degli Studi di Napoli Federico II
 *
 * SPDX-License-Identifier: GPL-2.0-only
 *
 * Author: Stefano Avallone <stavallo@unina.it>
 */
 
#ifndef DEFAULT_EMLSR_MANAGER_H
#define DEFAULT_EMLSR_MANAGER_H
 
#include "emlsr-manager.h"
 
#include <optional>
 
namespace ns3
{
 
/**
 * @ingroup wifi
 *
 * DefaultEmlsrManager is the default EMLSR manager.
 */
class DefaultEmlsrManager : public EmlsrManager
{
  public:
    /**
     * @brief Get the type ID.
     * @return the object TypeId
     */
    static TypeId GetTypeId();
 
    DefaultEmlsrManager();
    ~DefaultEmlsrManager() override;
 
    void NotifyRtsSent(uint8_t linkId,
                       Ptr<const WifiPsdu> rts,
                       const WifiTxVector& txVector) override;
 
  protected:
    uint8_t GetLinkToSendEmlOmn() override;
    std::optional<uint8_t> ResendNotification(Ptr<const WifiMpdu> mpdu) override;
    std::pair<bool, Time> DoGetDelayUntilAccessRequest(uint8_t linkId) override;
    void SwitchMainPhyIfTxopGainedByAuxPhy(uint8_t linkId, AcIndex aci) override;
    std::pair<bool, Time> GetDelayUnlessMainPhyTakesOverUlTxop(uint8_t linkId) override;
    void NotifyEmlsrModeChanged() override;
 
    /**
     * This function is intended to be called when an aux PHY is about to transmit an RTS on
     * the given link to calculate the time remaining to the end of the CTS reception.
     *
     * @param linkId the ID of the given link
     * @return the time remaining to the end of the CTS reception
     */
    Time GetTimeToCtsEnd(uint8_t linkId) const;
 
    /**
     * This function is intended to be called when an aux PHY is about to transmit an RTS on
     * the given link to calculate the time remaining to the end of the CTS reception.
     *
     * @param linkId the ID of the given link
     * @param rtsTxVector the TXVECTOR used to transmit the RTS
     * @return the time remaining to the end of the CTS reception
     */
    Time GetTimeToCtsEnd(uint8_t linkId, const WifiTxVector& rtsTxVector) const;
 
    /**
     * This method can only be called when aux PHYs do not switch link. Switch the main PHY back
     * to the preferred link and reconnect the aux PHY that was operating on the link left by the
     * main PHY.
     *
     * @param linkId the ID of the link that the main PHY is leaving
     * @param traceInfo information to pass to the main PHY switch traced callback (the fromLinkId
     *                  and toLinkId fields are set by SwitchMainPhy)
     */
    virtual void SwitchMainPhyBackToPreferredLink(uint8_t linkId,
                                                  EmlsrMainPhySwitchTrace&& traceInfo);
 
    bool m_switchAuxPhy; /**< whether Aux PHY should switch channel to operate on the link on which
                              the Main PHY was operating before moving to the link of the Aux PHY */
    Ptr<WifiPhy> m_auxPhyToReconnect; //!< Aux PHY the ChannelAccessManager of the link on which
                                      //!< the main PHY is operating has to connect a listener to
                                      //!< when the main PHY is back operating on its previous link
    EventId m_auxPhySwitchEvent;      //!< event scheduled for an aux PHY to switch link
    std::map<uint8_t, std::pair<Time, bool>>
        m_rtsStartingUlTxop; //!< link ID-indexed map indicating the time when an UL TXOP is going
                             //!< to start and whether it is starting with an RTS
 
  private:
    /**
     * This function shall be called when the main PHY starts switching to a link on which an aux
     * PHY that is capable of switching link is operating. This function schedules the aux PHY
     * switch to occur when the main PHY completes the switch and, in case the connection of the
     * main PHY to the aux PHY link is postponed because the aux PHY is receiving a PPDU, the
     * aux PHY switch is postponed accordingly.
     *
     * @param auxPhy the aux PHY that has to switch link
     * @param currLinkId the link on which the aux PHY is operating
     * @param nextLinkId the link to which the aux PHY will switch
     * @param duration the remaining time until the aux PHY switch starts
     */
    void SwitchAuxPhyAfterMainPhy(Ptr<WifiPhy> auxPhy,
                                  uint8_t currLinkId,
                                  uint8_t nextLinkId,
                                  Time duration);
 
    void DoNotifyMgtFrameReceived(Ptr<const WifiMpdu> mpdu, uint8_t linkId) override;
    void NotifyMainPhySwitch(std::optional<uint8_t> currLinkId,
                             uint8_t nextLinkId,
                             Ptr<WifiPhy> auxPhy,
                             Time duration) override;
    void DoNotifyDlTxopStart(uint8_t linkId) override;
    void DoNotifyUlTxopStart(uint8_t linkId) override;
    void DoNotifyTxopEnd(uint8_t linkId, Ptr<QosTxop> edca) override;
    void DoNotifyProtectionCompleted(uint8_t linkId) override;
};
 
} // namespace ns3
 
#endif /* DEFAULT_EMLSR_MANAGER_H */