low_latency.h

/* SPDX-License-Identifier: GPL-2.0 OR BSD-3-Clause */
/*
 * Copyright (C) 2024 Intel Corporation
 */
#ifndef __iwl_mld_low_latency_h__
#define __iwl_mld_low_latency_h__

/**
 * struct iwl_mld_low_latency_packets_counters - Packets counters
 * @lock: synchronize the counting in data path against the worker
 * @vo_vi: per-mac, counts the number of TX and RX voice and video packets
 */
struct iwl_mld_low_latency_packets_counters {
	spinlock_t lock;
	u32 vo_vi[NUM_MAC_INDEX_DRIVER];
} ____cacheline_aligned_in_smp;

/**
 * enum iwl_mld_low_latency_cause - low-latency set causes
 *
 * @LOW_LATENCY_TRAFFIC: indicates low-latency traffic was detected
 * @LOW_LATENCY_DEBUGFS: low-latency mode set from debugfs
 * @LOW_LATENCY_VIF_TYPE: low-latency mode set because of vif type (AP)
 */
enum iwl_mld_low_latency_cause {
	LOW_LATENCY_TRAFFIC	= BIT(0),
	LOW_LATENCY_DEBUGFS	= BIT(1),
	LOW_LATENCY_VIF_TYPE	= BIT(2),
};

/**
 * struct iwl_mld_low_latency - Manage low-latency detection and activation.
 * @work: this work is used to detect low-latency by monitoring the number of
 *	voice and video packets transmitted in a period of time. If the
 *	threshold is reached, low-latency is activated. When active,
 *	it is deactivated if the threshold is not reached within a
 *	10-second period.
 * @timestamp: timestamp of the last update.
 * @window_start: per-mac, timestamp of the start of the current window. when
 *	the window is over, the counters are reset.
 * @pkts_counters: per-queue array voice/video packet counters
 * @result: per-mac latest low-latency result
 * @stopped: if true, ignore the requests to update the counters
 */
struct iwl_mld_low_latency {
	struct wiphy_delayed_work work;
	unsigned long timestamp;
	unsigned long window_start[NUM_MAC_INDEX_DRIVER];
	struct iwl_mld_low_latency_packets_counters *pkts_counters;
	bool result[NUM_MAC_INDEX_DRIVER];
	bool stopped;
};

int iwl_mld_low_latency_init(struct iwl_mld *mld);
void iwl_mld_low_latency_free(struct iwl_mld *mld);
void iwl_mld_low_latency_restart_cleanup(struct iwl_mld *mld);
void iwl_mld_vif_update_low_latency(struct iwl_mld *mld,
				    struct ieee80211_vif *vif,
				    bool low_latency,
				    enum iwl_mld_low_latency_cause cause);
void iwl_mld_low_latency_update_counters(struct iwl_mld *mld,
					 struct ieee80211_hdr *hdr,
					 struct ieee80211_sta *sta,
					 u8 queue);
void iwl_mld_low_latency_stop(struct iwl_mld *mld);
void iwl_mld_low_latency_restart(struct iwl_mld *mld);

#endif /* __iwl_mld_low_latency_h__ */