root/src/add-ons/kernel/drivers/network/wlan/realtekwifi/dev/rtwn/rtl8192c/r92c_calib.c
/*      $OpenBSD: if_urtwn.c,v 1.16 2011/02/10 17:26:40 jakemsr Exp $   */

/*-
 * Copyright (c) 2010 Damien Bergamini <damien.bergamini@free.fr>
 * Copyright (c) 2014 Kevin Lo <kevlo@FreeBSD.org>
 * Copyright (c) 2016 Andriy Voskoboinyk <avos@FreeBSD.org>
 *
 * Permission to use, copy, modify, and distribute this software for any
 * purpose with or without fee is hereby granted, provided that the above
 * copyright notice and this permission notice appear in all copies.
 *
 * THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
 * WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
 * MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
 * ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
 * WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
 * ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
 * OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
 */

#include <sys/cdefs.h>
#include "opt_wlan.h"

#include <sys/param.h>
#include <sys/lock.h>
#include <sys/mutex.h>
#include <sys/mbuf.h>
#include <sys/kernel.h>
#include <sys/socket.h>
#include <sys/systm.h>
#include <sys/malloc.h>
#include <sys/queue.h>
#include <sys/taskqueue.h>
#include <sys/bus.h>
#include <sys/endian.h>
#include <sys/linker.h>

#include <net/if.h>
#include <net/ethernet.h>
#include <net/if_media.h>

#include <net80211/ieee80211_var.h>
#include <net80211/ieee80211_radiotap.h>

#include <dev/rtwn/if_rtwnreg.h>
#include <dev/rtwn/if_rtwnvar.h>
#include <dev/rtwn/if_rtwn_debug.h>

#include <dev/rtwn/rtl8192c/r92c.h>
#include <dev/rtwn/rtl8192c/r92c_reg.h>

/* Registers to save and restore during IQ calibration. */
struct r92c_iq_cal_reg_vals {
        uint32_t        adda[16];
        uint8_t         txpause;
        uint8_t         bcn_ctrl[2];
        uint32_t        gpio_muxcfg;
        uint32_t        cck0_afesetting;
        uint32_t        ofdm0_trxpathena;
        uint32_t        ofdm0_trmuxpar;
        uint32_t        fpga0_rfifacesw0;
        uint32_t        fpga0_rfifacesw1;
        uint32_t        fpga0_rfifaceoe0;
        uint32_t        fpga0_rfifaceoe1;
        uint32_t        config_ant0;
        uint32_t        config_ant1;
};

/* XXX TODO: merge */
static int
r92c_iq_calib_chain(struct rtwn_softc *sc, int chain, uint16_t tx[2],
    uint16_t rx[2])
{
        uint32_t status;

        if (chain == 0) {       /* IQ calibration for chain 0. */
                /* IQ calibration settings for chain 0. */
                rtwn_bb_write(sc, R92C_TX_IQK_TONE(0), 0x10008c1f);
                rtwn_bb_write(sc, R92C_RX_IQK_TONE(0), 0x10008c1f);
                rtwn_bb_write(sc, R92C_TX_IQK_PI(0), 0x82140102);

                if (sc->ntxchains > 1) {
                        rtwn_bb_write(sc, R92C_RX_IQK_PI(0), 0x28160202);
                        /* IQ calibration settings for chain 1. */
                        rtwn_bb_write(sc, R92C_TX_IQK_TONE(1), 0x10008c22);
                        rtwn_bb_write(sc, R92C_RX_IQK_TONE(1), 0x10008c22);
                        rtwn_bb_write(sc, R92C_TX_IQK_PI(1), 0x82140102);
                        rtwn_bb_write(sc, R92C_RX_IQK_PI(1), 0x28160202);
                } else
                        rtwn_bb_write(sc, R92C_RX_IQK_PI(0), 0x28160502);

                /* LO calibration settings. */
                rtwn_bb_write(sc, R92C_IQK_AGC_RSP, 0x001028d1);
                /* We're doing LO and IQ calibration in one shot. */
                rtwn_bb_write(sc, R92C_IQK_AGC_PTS, 0xf9000000);
                rtwn_bb_write(sc, R92C_IQK_AGC_PTS, 0xf8000000);

        } else {                /* IQ calibration for chain 1. */
                /* We're doing LO and IQ calibration in one shot. */
                rtwn_bb_write(sc, R92C_IQK_AGC_CONT, 2);
                rtwn_bb_write(sc, R92C_IQK_AGC_CONT, 0);
        }

        /* Give LO and IQ calibrations the time to complete. */
        rtwn_delay(sc, 10000);

        /* Read IQ calibration status. */
        status = rtwn_bb_read(sc, R92C_RX_POWER_IQK_AFTER(0));

        if (status & (1 << (28 + chain * 3)))
                return (0);     /* Tx failed. */
        /* Read Tx IQ calibration results. */
        tx[0] = MS(rtwn_bb_read(sc, R92C_TX_POWER_IQK_BEFORE(chain)),
            R92C_POWER_IQK_RESULT);
        tx[1] = MS(rtwn_bb_read(sc, R92C_TX_POWER_IQK_AFTER(chain)),
            R92C_POWER_IQK_RESULT);
        if (tx[0] == 0x142 || tx[1] == 0x042)
                return (0);     /* Tx failed. */

        if (status & (1 << (27 + chain * 3)))
                return (1);     /* Rx failed. */
        /* Read Rx IQ calibration results. */
        rx[0] = MS(rtwn_bb_read(sc, R92C_RX_POWER_IQK_BEFORE(chain)),
            R92C_POWER_IQK_RESULT);
        rx[1] = MS(rtwn_bb_read(sc, R92C_RX_POWER_IQK_AFTER(chain)),
            R92C_POWER_IQK_RESULT);
        if (rx[0] == 0x132 || rx[1] == 0x036)
                return (1);     /* Rx failed. */

        return (3);     /* Both Tx and Rx succeeded. */
}

static void
r92c_iq_calib_run(struct rtwn_softc *sc, int n, uint16_t tx[2][2],
    uint16_t rx[2][2], struct r92c_iq_cal_reg_vals *vals)
{
        /* Registers to save and restore during IQ calibration. */
        static const uint16_t reg_adda[16] = {
                0x85c, 0xe6c, 0xe70, 0xe74,
                0xe78, 0xe7c, 0xe80, 0xe84,
                0xe88, 0xe8c, 0xed0, 0xed4,
                0xed8, 0xedc, 0xee0, 0xeec
        };
        int i, chain;
        uint32_t hssi_param1;

        if (n == 0) {
                for (i = 0; i < nitems(reg_adda); i++)
                        vals->adda[i] = rtwn_bb_read(sc, reg_adda[i]);

                vals->txpause = rtwn_read_1(sc, R92C_TXPAUSE);
                vals->bcn_ctrl[0] = rtwn_read_1(sc, R92C_BCN_CTRL(0));
                vals->bcn_ctrl[1] = rtwn_read_1(sc, R92C_BCN_CTRL(1));
                vals->gpio_muxcfg = rtwn_read_4(sc, R92C_GPIO_MUXCFG);
        }

        if (sc->ntxchains == 1) {
                rtwn_bb_write(sc, reg_adda[0], 0x0b1b25a0);
                for (i = 1; i < nitems(reg_adda); i++)
                        rtwn_bb_write(sc, reg_adda[i], 0x0bdb25a0);
        } else {
                for (i = 0; i < nitems(reg_adda); i++)
                        rtwn_bb_write(sc, reg_adda[i], 0x04db25a4);
        }

        hssi_param1 = rtwn_bb_read(sc, R92C_HSSI_PARAM1(0));
        if (!(hssi_param1 & R92C_HSSI_PARAM1_PI)) {
                rtwn_bb_write(sc, R92C_HSSI_PARAM1(0),
                    hssi_param1 | R92C_HSSI_PARAM1_PI);
                rtwn_bb_write(sc, R92C_HSSI_PARAM1(1),
                    hssi_param1 | R92C_HSSI_PARAM1_PI);
        }

        if (n == 0) {
                vals->cck0_afesetting = rtwn_bb_read(sc, R92C_CCK0_AFESETTING);
                vals->ofdm0_trxpathena =
                    rtwn_bb_read(sc, R92C_OFDM0_TRXPATHENA);
                vals->ofdm0_trmuxpar = rtwn_bb_read(sc, R92C_OFDM0_TRMUXPAR);
                vals->fpga0_rfifacesw0 =
                    rtwn_bb_read(sc, R92C_FPGA0_RFIFACESW(0));
                vals->fpga0_rfifacesw1 =
                    rtwn_bb_read(sc, R92C_FPGA0_RFIFACESW(1));
                vals->fpga0_rfifaceoe0 =
                    rtwn_bb_read(sc, R92C_FPGA0_RFIFACEOE(0));
                vals->fpga0_rfifaceoe1 =
                    rtwn_bb_read(sc, R92C_FPGA0_RFIFACEOE(1));
                vals->config_ant0 = rtwn_bb_read(sc, R92C_CONFIG_ANT(0));
                vals->config_ant1 = rtwn_bb_read(sc, R92C_CONFIG_ANT(1));
        }

        rtwn_bb_setbits(sc, R92C_CCK0_AFESETTING, 0, 0x0f000000);
        rtwn_bb_write(sc, R92C_OFDM0_TRXPATHENA, 0x03a05600);
        rtwn_bb_write(sc, R92C_OFDM0_TRMUXPAR, 0x000800e4);
        rtwn_bb_write(sc, R92C_FPGA0_RFIFACESW(1), 0x22204000);
        rtwn_bb_setbits(sc, R92C_FPGA0_RFIFACESW(0), 0, 0x04000400);
        rtwn_bb_setbits(sc, R92C_FPGA0_RFIFACEOE(0), 0x400, 0);
        rtwn_bb_setbits(sc, R92C_FPGA0_RFIFACEOE(1), 0x400, 0);

        if (sc->ntxchains > 1) {
                rtwn_bb_write(sc, R92C_LSSI_PARAM(0), 0x00010000);
                rtwn_bb_write(sc, R92C_LSSI_PARAM(1), 0x00010000);
        }

        rtwn_write_1(sc, R92C_TXPAUSE,
            R92C_TX_QUEUE_AC | R92C_TX_QUEUE_MGT | R92C_TX_QUEUE_HIGH);
        rtwn_write_1(sc, R92C_BCN_CTRL(0),
            vals->bcn_ctrl[0] & ~R92C_BCN_CTRL_EN_BCN);
        rtwn_write_1(sc, R92C_BCN_CTRL(1),
            vals->bcn_ctrl[1] & ~R92C_BCN_CTRL_EN_BCN);
        rtwn_write_1(sc, R92C_GPIO_MUXCFG,
            vals->gpio_muxcfg & ~R92C_GPIO_MUXCFG_ENBT);

        rtwn_bb_write(sc, R92C_CONFIG_ANT(0), 0x00080000);
        if (sc->ntxchains > 1)
                rtwn_bb_write(sc, R92C_CONFIG_ANT(1), 0x00080000);

        rtwn_bb_write(sc, R92C_FPGA0_IQK, 0x80800000);
        rtwn_bb_write(sc, R92C_TX_IQK, 0x01007c00);
        rtwn_bb_write(sc, R92C_RX_IQK, 0x01004800);

        for (chain = 0; chain < sc->ntxchains; chain++) {
                if (chain > 0) {
                        /* Put chain 0 on standby. */
                        rtwn_bb_write(sc, R92C_FPGA0_IQK, 0);
                        rtwn_bb_write(sc, R92C_LSSI_PARAM(0), 0x00010000);
                        rtwn_bb_write(sc, R92C_FPGA0_IQK, 0x80800000);

                        /* Enable chain 1. */
                        for (i = 0; i < nitems(reg_adda); i++)
                                rtwn_bb_write(sc, reg_adda[i], 0x0b1b25a4);
                }

                /* Run IQ calibration twice. */
                for (i = 0; i < 2; i++) {
                        int ret;

                        ret = r92c_iq_calib_chain(sc, chain,
                            tx[chain], rx[chain]);
                        if (ret == 0) {
                                RTWN_DPRINTF(sc, RTWN_DEBUG_CALIB,
                                    "%s: chain %d: Tx failed.\n",
                                    __func__, chain);
                                tx[chain][0] = 0xff;
                                tx[chain][1] = 0xff;
                                rx[chain][0] = 0xff;
                                rx[chain][1] = 0xff;
                        } else if (ret == 1) {
                                RTWN_DPRINTF(sc, RTWN_DEBUG_CALIB,
                                    "%s: chain %d: Rx failed.\n",
                                    __func__, chain);
                                rx[chain][0] = 0xff;
                                rx[chain][1] = 0xff;
                        } else if (ret == 3) {
                                RTWN_DPRINTF(sc, RTWN_DEBUG_CALIB,
                                    "%s: chain %d: Both Tx and Rx "
                                    "succeeded.\n", __func__, chain);
                        }
                }

                RTWN_DPRINTF(sc, RTWN_DEBUG_CALIB,
                    "%s: results for run %d chain %d: tx[0] 0x%x, "
                    "tx[1] 0x%x, rx[0] 0x%x, rx[1] 0x%x\n", __func__, n, chain,
                    tx[chain][0], tx[chain][1], rx[chain][0], rx[chain][1]);
        }

        rtwn_bb_write(sc, R92C_CCK0_AFESETTING, vals->cck0_afesetting);
        rtwn_bb_write(sc, R92C_OFDM0_TRXPATHENA, vals->ofdm0_trxpathena);
        rtwn_bb_write(sc, R92C_FPGA0_RFIFACESW(0), vals->fpga0_rfifacesw0);
        rtwn_bb_write(sc, R92C_FPGA0_RFIFACESW(1), vals->fpga0_rfifacesw1);
        rtwn_bb_write(sc, R92C_OFDM0_TRMUXPAR, vals->ofdm0_trmuxpar);
        rtwn_bb_write(sc, R92C_FPGA0_RFIFACEOE(0), vals->fpga0_rfifaceoe0);
        rtwn_bb_write(sc, R92C_FPGA0_RFIFACEOE(1), vals->fpga0_rfifaceoe1);
        rtwn_bb_write(sc, R92C_CONFIG_ANT(0), vals->config_ant0);
        rtwn_bb_write(sc, R92C_CONFIG_ANT(1), vals->config_ant1);

        rtwn_bb_write(sc, R92C_FPGA0_IQK, 0);
        rtwn_bb_write(sc, R92C_LSSI_PARAM(0), 0x00032ed3);
        if (sc->ntxchains > 1)
                rtwn_bb_write(sc, R92C_LSSI_PARAM(1), 0x00032ed3);

        if (n != 0) {
                if (!(hssi_param1 & R92C_HSSI_PARAM1_PI)) {
                        rtwn_bb_write(sc, R92C_HSSI_PARAM1(0), hssi_param1);
                        rtwn_bb_write(sc, R92C_HSSI_PARAM1(1), hssi_param1);
                }

                for (i = 0; i < nitems(reg_adda); i++)
                        rtwn_bb_write(sc, reg_adda[i], vals->adda[i]);

                rtwn_write_1(sc, R92C_TXPAUSE, vals->txpause);
                rtwn_write_1(sc, R92C_BCN_CTRL(0), vals->bcn_ctrl[0]);
                rtwn_write_1(sc, R92C_BCN_CTRL(1), vals->bcn_ctrl[1]);
                rtwn_write_4(sc, R92C_GPIO_MUXCFG, vals->gpio_muxcfg);

                rtwn_bb_write(sc, R92C_TX_IQK_TONE(0), 0x01008c00);
                rtwn_bb_write(sc, R92C_RX_IQK_TONE(0), 0x01008c00);
        }
}

#define RTWN_IQ_CAL_MAX_TOLERANCE 5
static int
r92c_iq_calib_compare_results(struct rtwn_softc *sc, uint16_t tx1[2][2],
    uint16_t rx1[2][2], uint16_t tx2[2][2], uint16_t rx2[2][2])
{
        int chain, i, tx_ok[2], rx_ok[2];

        tx_ok[0] = tx_ok[1] = rx_ok[0] = rx_ok[1] = 0;
        for (chain = 0; chain < sc->ntxchains; chain++) {
                for (i = 0; i < 2; i++) {
                        if (tx1[chain][i] == 0xff || tx2[chain][i] == 0xff ||
                            rx1[chain][i] == 0xff || rx2[chain][i] == 0xff)
                                continue;

                        tx_ok[chain] = (abs(tx1[chain][i] - tx2[chain][i]) <=
                            RTWN_IQ_CAL_MAX_TOLERANCE);

                        rx_ok[chain] = (abs(rx1[chain][i] - rx2[chain][i]) <=
                            RTWN_IQ_CAL_MAX_TOLERANCE);
                }
        }

        if (sc->ntxchains > 1)
                return (tx_ok[0] && tx_ok[1] && rx_ok[0] && rx_ok[1]);
        else
                return (tx_ok[0] && rx_ok[0]);
}
#undef RTWN_IQ_CAL_MAX_TOLERANCE

static void
r92c_iq_calib_write_results(struct rtwn_softc *sc, uint16_t tx[2],
    uint16_t rx[2], int chain)
{
        uint32_t reg, val, x;
        long y, tx_c;

        if (tx[0] == 0xff || tx[1] == 0xff)
                return;

        reg = rtwn_bb_read(sc, R92C_OFDM0_TXIQIMBALANCE(chain));
        val = ((reg >> 22) & 0x3ff);
        x = tx[0];
        if (x & 0x00000200)
                x |= 0xfffffc00;
        reg = (((x * val) >> 8) & 0x3ff);
        rtwn_bb_setbits(sc, R92C_OFDM0_TXIQIMBALANCE(chain), 0x3ff, reg);
        rtwn_bb_setbits(sc, R92C_OFDM0_ECCATHRESHOLD, 0x80000000,
            ((x * val) & 0x80) << 24);

        y = tx[1];
        if (y & 0x00000200)
                y |= 0xfffffc00;
        tx_c = (y * val) >> 8;
        rtwn_bb_setbits(sc, R92C_OFDM0_TXAFE(chain), 0xf0000000,
            (tx_c & 0x3c0) << 22);
        rtwn_bb_setbits(sc, R92C_OFDM0_TXIQIMBALANCE(chain), 0x003f0000,
            (tx_c & 0x3f) << 16);
        rtwn_bb_setbits(sc, R92C_OFDM0_ECCATHRESHOLD, 0x20000000,
            ((y * val) & 0x80) << 22);

        if (rx[0] == 0xff || rx[1] == 0xff)
                return;

        rtwn_bb_setbits(sc, R92C_OFDM0_RXIQIMBALANCE(chain), 0x3ff,
            rx[0] & 0x3ff);
        rtwn_bb_setbits(sc, R92C_OFDM0_RXIQIMBALANCE(chain), 0xfc00,
            (rx[1] & 0x3f) << 10);

        if (chain == 0) {
                rtwn_bb_setbits(sc, R92C_OFDM0_RXIQEXTANTA, 0xf0000000,
                    (rx[1] & 0x3c0) << 22);
        } else {
                rtwn_bb_setbits(sc, R92C_OFDM0_AGCRSSITABLE, 0xf000,
                    (rx[1] & 0x3c0) << 6);
        }
}

#define RTWN_IQ_CAL_NRUN        3
void
r92c_iq_calib(struct rtwn_softc *sc)
{
        struct r92c_iq_cal_reg_vals vals;
        uint16_t tx[RTWN_IQ_CAL_NRUN][2][2], rx[RTWN_IQ_CAL_NRUN][2][2];
        int n, valid;

        valid = 0;
        for (n = 0; n < RTWN_IQ_CAL_NRUN; n++) {
                r92c_iq_calib_run(sc, n, tx[n], rx[n], &vals);

                if (n == 0)
                        continue;

                /* Valid results remain stable after consecutive runs. */
                valid = r92c_iq_calib_compare_results(sc, tx[n - 1],
                    rx[n - 1], tx[n], rx[n]);
                if (valid)
                        break;
        }

        if (valid) {
                r92c_iq_calib_write_results(sc, tx[n][0], rx[n][0], 0);
                if (sc->ntxchains > 1)
                        r92c_iq_calib_write_results(sc, tx[n][1], rx[n][1], 1);
        }
}
#undef RTWN_IQ_CAL_NRUN

void
r92c_lc_calib(struct rtwn_softc *sc)
{
        uint32_t rf_ac[2];
        uint8_t txmode;
        int i;

        txmode = rtwn_read_1(sc, R92C_OFDM1_LSTF + 3);
        if ((txmode & 0x70) != 0) {
                /* Disable all continuous Tx. */
                rtwn_write_1(sc, R92C_OFDM1_LSTF + 3, txmode & ~0x70);

                /* Set RF mode to standby mode. */
                for (i = 0; i < sc->nrxchains; i++) {
                        rf_ac[i] = rtwn_rf_read(sc, i, R92C_RF_AC);
                        rtwn_rf_write(sc, i, R92C_RF_AC,
                            RW(rf_ac[i], R92C_RF_AC_MODE,
                                R92C_RF_AC_MODE_STANDBY));
                }
        } else {
                /* Block all Tx queues. */
                rtwn_write_1(sc, R92C_TXPAUSE, R92C_TX_QUEUE_ALL);
        }
        /* Start calibration. */
        rtwn_rf_setbits(sc, 0, R92C_RF_CHNLBW, 0, R92C_RF_CHNLBW_LCSTART);

        /* Give calibration the time to complete. */
        rtwn_delay(sc, 100000); /* 100ms */

        /* Restore configuration. */
        if ((txmode & 0x70) != 0) {
                /* Restore Tx mode. */
                rtwn_write_1(sc, R92C_OFDM1_LSTF + 3, txmode);
                /* Restore RF mode. */
                for (i = 0; i < sc->nrxchains; i++)
                        rtwn_rf_write(sc, i, R92C_RF_AC, rf_ac[i]);
        } else {
                /* Unblock all Tx queues. */
                rtwn_write_1(sc, R92C_TXPAUSE, 0x00);
        }
}

void
r92c_temp_measure(struct rtwn_softc *sc)
{
        rtwn_rf_write(sc, 0, R92C_RF_T_METER, R92C_RF_T_METER_START);
}

uint8_t
r92c_temp_read(struct rtwn_softc *sc)
{
        return (MS(rtwn_rf_read(sc, 0, R92C_RF_T_METER),
            R92C_RF_T_METER_VAL));
}