root/include/ufs/unipro.h
/* SPDX-License-Identifier: GPL-2.0-or-later */
/*
 * Copyright (C) 2013 Samsung Electronics Co., Ltd.
 */

#ifndef _UNIPRO_H_
#define _UNIPRO_H_

/*
 * M-TX Configuration Attributes
 */
#define TX_HIBERN8TIME_CAPABILITY               0x000F
#define TX_MODE                                 0x0021
#define TX_HSRATE_SERIES                        0x0022
#define TX_HSGEAR                               0x0023
#define TX_PWMGEAR                              0x0024
#define TX_AMPLITUDE                            0x0025
#define TX_HS_SLEWRATE                          0x0026
#define TX_SYNC_SOURCE                          0x0027
#define TX_HS_SYNC_LENGTH                       0x0028
#define TX_HS_PREPARE_LENGTH                    0x0029
#define TX_LS_PREPARE_LENGTH                    0x002A
#define TX_HIBERN8_CONTROL                      0x002B
#define TX_LCC_ENABLE                           0x002C
#define TX_PWM_BURST_CLOSURE_EXTENSION          0x002D
#define TX_BYPASS_8B10B_ENABLE                  0x002E
#define TX_DRIVER_POLARITY                      0x002F
#define TX_HS_UNTERMINATED_LINE_DRIVE_ENABLE    0x0030
#define TX_LS_TERMINATED_LINE_DRIVE_ENABLE      0x0031
#define TX_LCC_SEQUENCER                        0x0032
#define TX_MIN_ACTIVATETIME                     0x0033
#define TX_PWM_G6_G7_SYNC_LENGTH                0x0034
#define TX_REFCLKFREQ                           0x00EB
#define TX_CFGCLKFREQVAL                        0x00EC
#define CFGEXTRATTR                             0x00F0
#define DITHERCTRL2                             0x00F1

/*
 * M-RX Configuration Attributes
 */
#define RX_HS_G1_SYNC_LENGTH_CAP                0x008B
#define RX_HS_G1_PREP_LENGTH_CAP                0x008C
#define RX_MIN_ACTIVATETIME_CAPABILITY          0x008F
#define RX_HIBERN8TIME_CAPABILITY               0x0092
#define RX_HS_G2_SYNC_LENGTH_CAP                0x0094
#define RX_HS_G3_SYNC_LENGTH_CAP                0x0095
#define RX_HS_G2_PREP_LENGTH_CAP                0x0096
#define RX_HS_G3_PREP_LENGTH_CAP                0x0097
#define RX_ADV_GRANULARITY_CAP                  0x0098
#define RX_HIBERN8TIME_CAP                      0x0092
#define RX_ADV_HIBERN8TIME_CAP                  0x0099
#define RX_ADV_MIN_ACTIVATETIME_CAP             0x009A
#define RX_MODE                                 0x00A1
#define RX_HSRATE_SERIES                        0x00A2
#define RX_HSGEAR                               0x00A3
#define RX_PWMGEAR                              0x00A4
#define RX_LS_TERMINATED_ENABLE                 0x00A5
#define RX_HS_UNTERMINATED_ENABLE               0x00A6
#define RX_ENTER_HIBERN8                        0x00A7
#define RX_BYPASS_8B10B_ENABLE                  0x00A8
#define RX_TERMINATION_FORCE_ENABLE             0x00A9
#define RXCALCTRL                               0x00B4
#define RXSQCTRL                                0x00B5
#define CFGRXCDR8                               0x00BA
#define CFGRXOVR8                               0x00BD
#define CFGRXOVR6                               0x00BF
#define RXDIRECTCTRL2                           0x00C7
#define CFGRXOVR4                               0x00E9
#define RX_REFCLKFREQ                           0x00EB
#define RX_CFGCLKFREQVAL                        0x00EC
#define CFGWIDEINLN                             0x00F0
#define ENARXDIRECTCFG4                         0x00F2
#define ENARXDIRECTCFG3                         0x00F3
#define ENARXDIRECTCFG2                         0x00F4


#define is_mphy_tx_attr(attr)                   (attr < RX_MODE)
#define RX_ADV_FINE_GRAN_STEP(x)                ((((x) & 0x3) << 1) | 0x1)
#define SYNC_LEN_FINE(x)                        ((x) & 0x3F)
#define SYNC_LEN_COARSE(x)                      ((1 << 6) | ((x) & 0x3F))
#define PREP_LEN(x)                             ((x) & 0xF)

#define RX_MIN_ACTIVATETIME_UNIT_US             100
#define HIBERN8TIME_UNIT_US                     100

/*
 * Common Block Attributes
 */
#define TX_GLOBALHIBERNATE                      UNIPRO_CB_OFFSET(0x002B)
#define REFCLKMODE                              UNIPRO_CB_OFFSET(0x00BF)
#define DIRECTCTRL19                            UNIPRO_CB_OFFSET(0x00CD)
#define DIRECTCTRL10                            UNIPRO_CB_OFFSET(0x00E6)
#define CDIRECTCTRL6                            UNIPRO_CB_OFFSET(0x00EA)
#define RTOBSERVESELECT                         UNIPRO_CB_OFFSET(0x00F0)
#define CBDIVFACTOR                             UNIPRO_CB_OFFSET(0x00F1)
#define CBDCOCTRL5                              UNIPRO_CB_OFFSET(0x00F3)
#define CBPRGPLL2                               UNIPRO_CB_OFFSET(0x00F8)
#define CBPRGTUNING                             UNIPRO_CB_OFFSET(0x00FB)

#define UNIPRO_CB_OFFSET(x)                     (0x8000 | x)

/*
 * PHY Adapter attributes
 */
#define PA_PHY_TYPE             0x1500
#define PA_AVAILTXDATALANES     0x1520
#define PA_MAXTXSPEEDFAST       0x1521
#define PA_MAXTXSPEEDSLOW       0x1522
#define PA_MAXRXSPEEDFAST       0x1541
#define PA_MAXRXSPEEDSLOW       0x1542
#define PA_TXLINKSTARTUPHS      0x1544
#define PA_AVAILRXDATALANES     0x1540
#define PA_MINRXTRAILINGCLOCKS  0x1543
#define PA_TXHSG1SYNCLENGTH     0x1552
#define PA_TXHSG2SYNCLENGTH     0x1554
#define PA_TXHSG3SYNCLENGTH     0x1556
#define PA_LOCAL_TX_LCC_ENABLE  0x155E
#define PA_ACTIVETXDATALANES    0x1560
#define PA_CONNECTEDTXDATALANES 0x1561
#define PA_TXFORCECLOCK         0x1562
#define PA_TXPWRMODE            0x1563
#define PA_TXTRAILINGCLOCKS     0x1564
#define PA_TXSPEEDFAST          0x1565
#define PA_TXSPEEDSLOW          0x1566
#define PA_TXPWRSTATUS          0x1567
#define PA_TXGEAR               0x1568
#define PA_TXTERMINATION        0x1569
#define PA_HSSERIES             0x156A
#define PA_LEGACYDPHYESCDL      0x1570
#define PA_PWRMODE              0x1571
#define PA_ACTIVERXDATALANES    0x1580
#define PA_CONNECTEDRXDATALANES 0x1581
#define PA_RXPWRSTATUS          0x1582
#define PA_RXGEAR               0x1583
#define PA_RXTERMINATION        0x1584
#define PA_MAXRXPWMGEAR         0x1586
#define PA_MAXRXHSGEAR          0x1587
#define PA_PACPREQTIMEOUT       0x1590
#define PA_PACPREQEOBTIMEOUT    0x1591
#define PA_REMOTEVERINFO        0x15A0
#define PA_LOGICALLANEMAP       0x15A1
#define PA_SLEEPNOCONFIGTIME    0x15A2
#define PA_STALLNOCONFIGTIME    0x15A3
#define PA_SAVECONFIGTIME       0x15A4
#define PA_RXHSUNTERMCAP        0x15A5
#define PA_RXLSTERMCAP          0x15A6
#define PA_HIBERN8TIME          0x15A7
#define PA_LOCALVERINFO         0x15A9
#define PA_GRANULARITY          0x15AA
#define PA_TACTIVATE            0x15A8
#define PA_PWRMODEUSERDATA0     0x15B0
#define PA_PWRMODEUSERDATA1     0x15B1
#define PA_PWRMODEUSERDATA2     0x15B2
#define PA_PWRMODEUSERDATA3     0x15B3
#define PA_PWRMODEUSERDATA4     0x15B4
#define PA_PWRMODEUSERDATA5     0x15B5
#define PA_PWRMODEUSERDATA6     0x15B6
#define PA_PWRMODEUSERDATA7     0x15B7
#define PA_PWRMODEUSERDATA8     0x15B8
#define PA_PWRMODEUSERDATA9     0x15B9
#define PA_PWRMODEUSERDATA10    0x15BA
#define PA_PWRMODEUSERDATA11    0x15BB
#define PA_PACPFRAMECOUNT       0x15C0
#define PA_PACPERRORCOUNT       0x15C1
#define PA_PHYTESTCONTROL       0x15C2
#define PA_TXHSG4SYNCLENGTH     0x15D0
#define PA_TXHSADAPTTYPE        0x15D4
#define PA_TXHSG5SYNCLENGTH     0x15D6

/* Adpat type for PA_TXHSADAPTTYPE attribute */
#define PA_REFRESH_ADAPT       0x00
#define PA_INITIAL_ADAPT       0x01
#define PA_NO_ADAPT            0x03

#define PA_TACTIVATE_TIME_UNIT_US       10
#define PA_HIBERN8_TIME_UNIT_US         100

/*Other attributes*/
#define VS_POWERSTATE           0xD083
#define VS_MPHYCFGUPDT          0xD085
#define VS_DEBUGOMC             0xD09E
#define VS_MPHYDISABLE          0xD0C1

#define PA_GRANULARITY_MIN_VAL  1
#define PA_GRANULARITY_MAX_VAL  6

/* PHY Adapter Protocol Constants */
#define PA_MAXDATALANES 4

#define DL_FC0ProtectionTimeOutVal_Default      8191
#define DL_TC0ReplayTimeOutVal_Default          65535
#define DL_AFC0ReqTimeOutVal_Default            32767
#define DL_FC1ProtectionTimeOutVal_Default      8191
#define DL_TC1ReplayTimeOutVal_Default          65535
#define DL_AFC1ReqTimeOutVal_Default            32767

#define DME_LocalFC0ProtectionTimeOutVal        0xD041
#define DME_LocalTC0ReplayTimeOutVal            0xD042
#define DME_LocalAFC0ReqTimeOutVal              0xD043

/* PA power modes */
enum ufs_pa_pwr_mode {
        FAST_MODE       = 1,
        SLOW_MODE       = 2,
        FASTAUTO_MODE   = 4,
        SLOWAUTO_MODE   = 5,
        UNCHANGED       = 7,
};

#define PWRMODE_MASK            0xF
#define PWRMODE_RX_OFFSET       4

/* PA TX/RX Frequency Series */
enum ufs_hs_gear_rate {
        PA_HS_MODE_A    = 1,
        PA_HS_MODE_B    = 2,
};

enum ufs_pwm_gear_tag {
        UFS_PWM_DONT_CHANGE,    /* Don't change Gear */
        UFS_PWM_G1,             /* PWM Gear 1 (default for reset) */
        UFS_PWM_G2,             /* PWM Gear 2 */
        UFS_PWM_G3,             /* PWM Gear 3 */
        UFS_PWM_G4,             /* PWM Gear 4 */
        UFS_PWM_G5,             /* PWM Gear 5 */
        UFS_PWM_G6,             /* PWM Gear 6 */
        UFS_PWM_G7,             /* PWM Gear 7 */
};

enum ufs_hs_gear_tag {
        UFS_HS_DONT_CHANGE,     /* Don't change Gear */
        UFS_HS_G1,              /* HS Gear 1 (default for reset) */
        UFS_HS_G2,              /* HS Gear 2 */
        UFS_HS_G3,              /* HS Gear 3 */
        UFS_HS_G4,              /* HS Gear 4 */
        UFS_HS_G5               /* HS Gear 5 */
};

enum ufs_lanes {
        UFS_LANE_DONT_CHANGE,   /* Don't change Lane */
        UFS_LANE_1,             /* Lane 1 (default for reset) */
        UFS_LANE_2,             /* Lane 2 */
};

enum ufs_unipro_ver {
        UFS_UNIPRO_VER_RESERVED = 0,
        UFS_UNIPRO_VER_1_40 = 1, /* UniPro version 1.40 */
        UFS_UNIPRO_VER_1_41 = 2, /* UniPro version 1.41 */
        UFS_UNIPRO_VER_1_6  = 3, /* UniPro version 1.6 */
        UFS_UNIPRO_VER_1_61 = 4, /* UniPro version 1.61 */
        UFS_UNIPRO_VER_1_8  = 5, /* UniPro version 1.8 */
        UFS_UNIPRO_VER_MAX  = 6, /* UniPro unsupported version */
        /* UniPro version field mask in PA_LOCALVERINFO */
        UFS_UNIPRO_VER_MASK = 0xF,
};

/*
 * Data Link Layer Attributes
 */
#define DL_TXPREEMPTIONCAP      0x2000
#define DL_TC0TXMAXSDUSIZE      0x2001
#define DL_TC0RXINITCREDITVAL   0x2002
#define DL_TC1TXMAXSDUSIZE      0x2003
#define DL_TC1RXINITCREDITVAL   0x2004
#define DL_TC0TXBUFFERSIZE      0x2005
#define DL_TC1TXBUFFERSIZE      0x2006
#define DL_TC0TXFCTHRESHOLD     0x2040
#define DL_FC0PROTTIMEOUTVAL    0x2041
#define DL_TC0REPLAYTIMEOUTVAL  0x2042
#define DL_AFC0REQTIMEOUTVAL    0x2043
#define DL_AFC0CREDITTHRESHOLD  0x2044
#define DL_TC0OUTACKTHRESHOLD   0x2045
#define DL_PEERTC0PRESENT       0x2046
#define DL_PEERTC0RXINITCREVAL  0x2047
#define DL_TC1TXFCTHRESHOLD     0x2060
#define DL_FC1PROTTIMEOUTVAL    0x2061
#define DL_TC1REPLAYTIMEOUTVAL  0x2062
#define DL_AFC1REQTIMEOUTVAL    0x2063
#define DL_AFC1CREDITTHRESHOLD  0x2064
#define DL_TC1OUTACKTHRESHOLD   0x2065
#define DL_PEERTC1PRESENT       0x2066
#define DL_PEERTC1RXINITCREVAL  0x2067

/*
 * Network Layer Attributes
 */
#define N_DEVICEID              0x3000
#define N_DEVICEID_VALID        0x3001
#define N_TC0TXMAXSDUSIZE       0x3020
#define N_TC1TXMAXSDUSIZE       0x3021

/*
 * Transport Layer Attributes
 */
#define T_NUMCPORTS             0x4000
#define T_NUMTESTFEATURES       0x4001
#define T_CONNECTIONSTATE       0x4020
#define T_PEERDEVICEID          0x4021
#define T_PEERCPORTID           0x4022
#define T_TRAFFICCLASS          0x4023
#define T_PROTOCOLID            0x4024
#define T_CPORTFLAGS            0x4025
#define T_TXTOKENVALUE          0x4026
#define T_RXTOKENVALUE          0x4027
#define T_LOCALBUFFERSPACE      0x4028
#define T_PEERBUFFERSPACE       0x4029
#define T_CREDITSTOSEND         0x402A
#define T_CPORTMODE             0x402B
#define T_TC0TXMAXSDUSIZE       0x4060
#define T_TC1TXMAXSDUSIZE       0x4061

/* CPort setting */
#define E2EFC_ON        (1 << 0)
#define E2EFC_OFF       (0 << 0)
#define CSD_N_ON        (0 << 1)
#define CSD_N_OFF       (1 << 1)
#define CSV_N_ON        (0 << 2)
#define CSV_N_OFF       (1 << 2)
#define CPORT_DEF_FLAGS (CSV_N_OFF | CSD_N_OFF | E2EFC_OFF)

/* CPort connection state */
enum {
        CPORT_IDLE = 0,
        CPORT_CONNECTED,
};

#endif /* _UNIPRO_H_ */