/* SPDX-License-Identifier: GPL-2.0 OR BSD-3-Clause
 * Copyright(c) 2019-2020  Realtek Corporation
 */
#ifndef __RTW89_UTIL_H__
#define __RTW89_UTIL_H__

#include "core.h"

#define rtw89_iterate_vifs_bh(rtwdev, iterator, data)                          \
 ieee80211_iterate_active_interfaces_atomic((rtwdev)->hw,               \
   IEEE80211_IFACE_ITER_NORMAL, iterator, data)

/* call this function with wiphy mutex is held */
#define rtw89_for_each_rtwvif(rtwdev, rtwvif)           \
 list_for_each_entry(rtwvif, &(rtwdev)->rtwvifs_list, list)

/* Before adding rtwvif to list, we need to check if it already exist, beacase
 * in some case such as SER L2 happen during WoWLAN flow, calling reconfig
 * twice cause the list to be added twice.
 */
static inline bool rtw89_rtwvif_in_list(struct rtw89_dev *rtwdev,
     struct rtw89_vif *new)
{
 struct rtw89_vif *rtwvif;

 lockdep_assert_wiphy(rtwdev->hw->wiphy);

 rtw89_for_each_rtwvif(rtwdev, rtwvif)
  if (rtwvif == new)
   return true;

 return false;
}

/* The result of negative dividend and positive divisor is undefined, but it
 * should be one case of round-down or round-up. So, make it round-down if the
 * result is round-up.
 * Note: the maximum value of divisor is 0x7FFF_FFFF, because we cast it to
 *       signed value to make compiler to use signed divide instruction.
 */
static inline s32 s32_div_u32_round_down(s32 dividend, u32 divisor, s32 *remainder)
{
 s32 i_divisor = (s32)divisor;
 s32 i_remainder;
 s32 quotient;

 quotient = dividend / i_divisor;
 i_remainder = dividend % i_divisor;

 if (i_remainder < 0) {
  quotient--;
  i_remainder += i_divisor;
 }

 if (remainder)
  *remainder = i_remainder;
 return quotient;
}

static inline s32 s32_div_u32_round_closest(s32 dividend, u32 divisor)
{
 return s32_div_u32_round_down(dividend + divisor / 2, divisor, NULL);
}

static inline void ether_addr_copy_mask(u8 *dst, const u8 *src, u8 mask)
{
 int i;

 eth_zero_addr(dst);
 for (i = 0; i < ETH_ALEN; i++) {
  if (mask & BIT(i))
   dst[i] = src[i];
 }
}

s32 rtw89_linear_to_db_quarter(u64 val);
s32 rtw89_linear_to_db(u64 val);
u64 rtw89_db_quarter_to_linear(s32 db);
u64 rtw89_db_to_linear(s32 db);
void rtw89_might_trailing_ellipsis(char *buf, size_t size, ssize_t used);

#endif