#ifndef _CHIP_H
#define _CHIP_H
/*
 *
 * This file is provided under a dual BSD/GPLv2 license.  When using or
 * redistributing this file, you may do so under either license.
 *
 * GPL LICENSE SUMMARY
 *
 * Copyright(c) 2015 Intel Corporation.
 *
 * This program is free software; you can redistribute it and/or modify
 * it under the terms of version 2 of the GNU General Public License as
 * published by the Free Software Foundation.
 *
 * This program is distributed in the hope that it will be useful, but
 * WITHOUT ANY WARRANTY; without even the implied warranty of
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
 * General Public License for more details.
 *
 * BSD LICENSE
 *
 * Copyright(c) 2015 Intel Corporation.
 *
 * Redistribution and use in source and binary forms, with or without
 * modification, are permitted provided that the following conditions
 * are met:
 *
 *  - Redistributions of source code must retain the above copyright
 *    notice, this list of conditions and the following disclaimer.
 *  - Redistributions in binary form must reproduce the above copyright
 *    notice, this list of conditions and the following disclaimer in
 *    the documentation and/or other materials provided with the
 *    distribution.
 *  - Neither the name of Intel Corporation nor the names of its
 *    contributors may be used to endorse or promote products derived
 *    from this software without specific prior written permission.
 *
 * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
 * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
 * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
 * A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
 * OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
 * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
 * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
 * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
 * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
 * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
 * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
 *
 */

/*
 * This file contains all of the defines that is specific to the HFI chip
 */

/* sizes */
#define CCE_NUM_MSIX_VECTORS 256
#define CCE_NUM_INT_CSRS 12
#define CCE_NUM_INT_MAP_CSRS 96
#define NUM_INTERRUPT_SOURCES 768
#define RXE_NUM_CONTEXTS 160
#define RXE_PER_CONTEXT_SIZE 0x1000     /* 4k */
#define RXE_NUM_TID_FLOWS 32
#define RXE_NUM_DATA_VL 8
#define TXE_NUM_CONTEXTS 160
#define TXE_NUM_SDMA_ENGINES 16
#define NUM_CONTEXTS_PER_SET 8
#define VL_ARB_HIGH_PRIO_TABLE_SIZE 16
#define VL_ARB_LOW_PRIO_TABLE_SIZE 16
#define VL_ARB_TABLE_SIZE 16
#define TXE_NUM_32_BIT_COUNTER 7
#define TXE_NUM_64_BIT_COUNTER 30
#define TXE_NUM_DATA_VL 8
#define TXE_PIO_SIZE (32 * 0x100000)    /* 32 MB */
#define PIO_BLOCK_SIZE 64                       /* bytes */
#define SDMA_BLOCK_SIZE 64                      /* bytes */
#define RCV_BUF_BLOCK_SIZE 64               /* bytes */
#define PIO_CMASK 0x7ff /* counter mask for free and fill counters */
#define MAX_EAGER_ENTRIES    2048       /* max receive eager entries */
#define MAX_TID_PAIR_ENTRIES 1024       /* max receive expected pairs */
/* Virtual? Allocation Unit, defined as AU = 8*2^vAU, 64 bytes, AU is fixed
   at 64 bytes for all generation one devices */
#define CM_VAU 3
/* HFI link credit count, AKA receive buffer depth (RBUF_DEPTH) */
#define CM_GLOBAL_CREDITS 0x940
/* Number of PKey entries in the HW */
#define MAX_PKEY_VALUES 16

#include "chip_registers.h"

#define RXE_PER_CONTEXT_USER   (RXE + RXE_PER_CONTEXT_OFFSET)
#define TXE_PIO_SEND (TXE + TXE_PIO_SEND_OFFSET)

/* PBC flags */
#define PBC_INTR                (1ull << 31)
#define PBC_DC_INFO_SHIFT       (30)
#define PBC_DC_INFO             (1ull << PBC_DC_INFO_SHIFT)
#define PBC_TEST_EBP    (1ull << 29)
#define PBC_PACKET_BYPASS       (1ull << 28)
#define PBC_CREDIT_RETURN       (1ull << 25)
#define PBC_INSERT_BYPASS_ICRC (1ull << 24)
#define PBC_TEST_BAD_ICRC       (1ull << 23)
#define PBC_FECN                (1ull << 22)

/* PbcInsertHcrc field settings */
#define PBC_IHCRC_LKDETH 0x0    /* insert @ local KDETH offset */
#define PBC_IHCRC_GKDETH 0x1    /* insert @ global KDETH offset */
#define PBC_IHCRC_NONE   0x2    /* no HCRC inserted */

/* PBC fields */
#define PBC_STATIC_RATE_CONTROL_COUNT_SHIFT 32
#define PBC_STATIC_RATE_CONTROL_COUNT_MASK 0xffffull
#define PBC_STATIC_RATE_CONTROL_COUNT_SMASK \
        (PBC_STATIC_RATE_CONTROL_COUNT_MASK << \
        PBC_STATIC_RATE_CONTROL_COUNT_SHIFT)

#define PBC_INSERT_HCRC_SHIFT 26
#define PBC_INSERT_HCRC_MASK 0x3ull
#define PBC_INSERT_HCRC_SMASK \
        (PBC_INSERT_HCRC_MASK << PBC_INSERT_HCRC_SHIFT)

#define PBC_VL_SHIFT 12
#define PBC_VL_MASK 0xfull
#define PBC_VL_SMASK (PBC_VL_MASK << PBC_VL_SHIFT)

#define PBC_LENGTH_DWS_SHIFT 0
#define PBC_LENGTH_DWS_MASK 0xfffull
#define PBC_LENGTH_DWS_SMASK \
        (PBC_LENGTH_DWS_MASK << PBC_LENGTH_DWS_SHIFT)

/* Credit Return Fields */
#define CR_COUNTER_SHIFT 0
#define CR_COUNTER_MASK 0x7ffull
#define CR_COUNTER_SMASK (CR_COUNTER_MASK << CR_COUNTER_SHIFT)

#define CR_STATUS_SHIFT 11
#define CR_STATUS_MASK 0x1ull
#define CR_STATUS_SMASK (CR_STATUS_MASK << CR_STATUS_SHIFT)

#define CR_CREDIT_RETURN_DUE_TO_PBC_SHIFT 12
#define CR_CREDIT_RETURN_DUE_TO_PBC_MASK 0x1ull
#define CR_CREDIT_RETURN_DUE_TO_PBC_SMASK \
        (CR_CREDIT_RETURN_DUE_TO_PBC_MASK << \
        CR_CREDIT_RETURN_DUE_TO_PBC_SHIFT)

#define CR_CREDIT_RETURN_DUE_TO_THRESHOLD_SHIFT 13
#define CR_CREDIT_RETURN_DUE_TO_THRESHOLD_MASK 0x1ull
#define CR_CREDIT_RETURN_DUE_TO_THRESHOLD_SMASK \
        (CR_CREDIT_RETURN_DUE_TO_THRESHOLD_MASK << \
        CR_CREDIT_RETURN_DUE_TO_THRESHOLD_SHIFT)

#define CR_CREDIT_RETURN_DUE_TO_ERR_SHIFT 14
#define CR_CREDIT_RETURN_DUE_TO_ERR_MASK 0x1ull
#define CR_CREDIT_RETURN_DUE_TO_ERR_SMASK \
        (CR_CREDIT_RETURN_DUE_TO_ERR_MASK << \
        CR_CREDIT_RETURN_DUE_TO_ERR_SHIFT)

#define CR_CREDIT_RETURN_DUE_TO_FORCE_SHIFT 15
#define CR_CREDIT_RETURN_DUE_TO_FORCE_MASK 0x1ull
#define CR_CREDIT_RETURN_DUE_TO_FORCE_SMASK \
        (CR_CREDIT_RETURN_DUE_TO_FORCE_MASK << \
        CR_CREDIT_RETURN_DUE_TO_FORCE_SHIFT)

/* interrupt source numbers */
#define IS_GENERAL_ERR_START      0
#define IS_SDMAENG_ERR_START     16
#define IS_SENDCTXT_ERR_START    32
#define IS_SDMA_START           192 /* includes SDmaProgress,SDmaIdle */
#define IS_VARIOUS_START                240
#define IS_DC_START                     248
#define IS_RCVAVAIL_START               256
#define IS_RCVURGENT_START              416
#define IS_SENDCREDIT_START             576
#define IS_RESERVED_START               736
#define IS_MAX_SOURCES          768

/* derived interrupt source values */
#define IS_GENERAL_ERR_END              IS_SDMAENG_ERR_START
#define IS_SDMAENG_ERR_END              IS_SENDCTXT_ERR_START
#define IS_SENDCTXT_ERR_END             IS_SDMA_START
#define IS_SDMA_END                     IS_VARIOUS_START
#define IS_VARIOUS_END          IS_DC_START
#define IS_DC_END                       IS_RCVAVAIL_START
#define IS_RCVAVAIL_END         IS_RCVURGENT_START
#define IS_RCVURGENT_END                IS_SENDCREDIT_START
#define IS_SENDCREDIT_END               IS_RESERVED_START
#define IS_RESERVED_END         IS_MAX_SOURCES

/* absolute interrupt numbers for QSFP1Int and QSFP2Int */
#define QSFP1_INT               242
#define QSFP2_INT               243

/* DCC_CFG_PORT_CONFIG logical link states */
#define LSTATE_DOWN    0x1
#define LSTATE_INIT    0x2
#define LSTATE_ARMED   0x3
#define LSTATE_ACTIVE  0x4

/* DC8051_STS_CUR_STATE port values (physical link states) */
#define PLS_DISABLED                       0x30
#define PLS_OFFLINE                                0x90
#define PLS_OFFLINE_QUIET                          0x90
#define PLS_OFFLINE_PLANNED_DOWN_INFORM    0x91
#define PLS_OFFLINE_READY_TO_QUIET_LT      0x92
#define PLS_OFFLINE_REPORT_FAILURE                 0x93
#define PLS_OFFLINE_READY_TO_QUIET_BCC     0x94
#define PLS_POLLING                                0x20
#define PLS_POLLING_QUIET                          0x20
#define PLS_POLLING_ACTIVE                         0x21
#define PLS_CONFIGPHY                      0x40
#define PLS_CONFIGPHY_DEBOUCE              0x40
#define PLS_CONFIGPHY_ESTCOMM              0x41
#define PLS_CONFIGPHY_ESTCOMM_TXRX_HUNT    0x42
#define PLS_CONFIGPHY_ESTcOMM_LOCAL_COMPLETE   0x43
#define PLS_CONFIGPHY_OPTEQ                        0x44
#define PLS_CONFIGPHY_OPTEQ_OPTIMIZING     0x44
#define PLS_CONFIGPHY_OPTEQ_LOCAL_COMPLETE         0x45
#define PLS_CONFIGPHY_VERIFYCAP            0x46
#define PLS_CONFIGPHY_VERIFYCAP_EXCHANGE           0x46
#define PLS_CONFIGPHY_VERIFYCAP_LOCAL_COMPLETE 0x47
#define PLS_CONFIGLT                       0x48
#define PLS_CONFIGLT_CONFIGURE             0x48
#define PLS_CONFIGLT_LINK_TRANSFER_ACTIVE          0x49
#define PLS_LINKUP                                 0x50
#define PLS_PHYTEST                                0xB0
#define PLS_INTERNAL_SERDES_LOOPBACK       0xe1
#define PLS_QUICK_LINKUP                           0xe2

/* DC_DC8051_CFG_HOST_CMD_0.REQ_TYPE - 8051 host commands */
#define HCMD_LOAD_CONFIG_DATA  0x01
#define HCMD_READ_CONFIG_DATA  0x02
#define HCMD_CHANGE_PHY_STATE  0x03
#define HCMD_SEND_LCB_IDLE_MSG 0x04
#define HCMD_MISC                  0x05
#define HCMD_READ_LCB_IDLE_MSG 0x06
#define HCMD_READ_LCB_CSR      0x07
#define HCMD_INTERFACE_TEST        0xff

/* DC_DC8051_CFG_HOST_CMD_1.RETURN_CODE - 8051 host command return */
#define HCMD_SUCCESS 2

/* DC_DC8051_DBG_ERR_INFO_SET_BY_8051.ERROR - error flags */
#define SPICO_ROM_FAILED                    (1 <<  0)
#define UNKNOWN_FRAME               (1 <<  1)
#define TARGET_BER_NOT_MET                  (1 <<  2)
#define FAILED_SERDES_INTERNAL_LOOPBACK (1 <<  3)
#define FAILED_SERDES_INIT                  (1 <<  4)
#define FAILED_LNI_POLLING                  (1 <<  5)
#define FAILED_LNI_DEBOUNCE                 (1 <<  6)
#define FAILED_LNI_ESTBCOMM                 (1 <<  7)
#define FAILED_LNI_OPTEQ                    (1 <<  8)
#define FAILED_LNI_VERIFY_CAP1      (1 <<  9)
#define FAILED_LNI_VERIFY_CAP2      (1 << 10)
#define FAILED_LNI_CONFIGLT                 (1 << 11)

#define FAILED_LNI (FAILED_LNI_POLLING | FAILED_LNI_DEBOUNCE \
                        | FAILED_LNI_ESTBCOMM | FAILED_LNI_OPTEQ \
                        | FAILED_LNI_VERIFY_CAP1 \
                        | FAILED_LNI_VERIFY_CAP2 \
                        | FAILED_LNI_CONFIGLT)

/* DC_DC8051_DBG_ERR_INFO_SET_BY_8051.HOST_MSG - host message flags */
#define HOST_REQ_DONE      (1 << 0)
#define BC_PWR_MGM_MSG     (1 << 1)
#define BC_SMA_MSG                 (1 << 2)
#define BC_BCC_UNKOWN_MSG          (1 << 3)
#define BC_IDLE_UNKNOWN_MSG        (1 << 4)
#define EXT_DEVICE_CFG_REQ         (1 << 5)
#define VERIFY_CAP_FRAME           (1 << 6)
#define LINKUP_ACHIEVED    (1 << 7)
#define LINK_GOING_DOWN    (1 << 8)
#define LINK_WIDTH_DOWNGRADED  (1 << 9)

/* DC_DC8051_CFG_EXT_DEV_1.REQ_TYPE - 8051 host requests */
#define HREQ_LOAD_CONFIG        0x01
#define HREQ_SAVE_CONFIG        0x02
#define HREQ_READ_CONFIG        0x03
#define HREQ_SET_TX_EQ_ABS      0x04
#define HREQ_SET_TX_EQ_REL      0x05
#define HREQ_ENABLE             0x06
#define HREQ_CONFIG_DONE        0xfe
#define HREQ_INTERFACE_TEST     0xff

/* DC_DC8051_CFG_EXT_DEV_0.RETURN_CODE - 8051 host request return codes */
#define HREQ_INVALID            0x01
#define HREQ_SUCCESS            0x02
#define HREQ_NOT_SUPPORTED              0x03
#define HREQ_FEATURE_NOT_SUPPORTED      0x04 /* request specific feature */
#define HREQ_REQUEST_REJECTED   0xfe
#define HREQ_EXECUTION_ONGOING  0xff

/* MISC host command functions */
#define HCMD_MISC_REQUEST_LCB_ACCESS 0x1
#define HCMD_MISC_GRANT_LCB_ACCESS   0x2

/* idle flit message types */
#define IDLE_PHYSICAL_LINK_MGMT 0x1
#define IDLE_CRU                    0x2
#define IDLE_SMA                    0x3
#define IDLE_POWER_MGMT     0x4

/* idle flit message send fields (both send and read) */
#define IDLE_PAYLOAD_MASK 0xffffffffffull /* 40 bits */
#define IDLE_PAYLOAD_SHIFT 8
#define IDLE_MSG_TYPE_MASK 0xf
#define IDLE_MSG_TYPE_SHIFT 0

/* idle flit message read fields */
#define READ_IDLE_MSG_TYPE_MASK 0xf
#define READ_IDLE_MSG_TYPE_SHIFT 0

/* SMA idle flit payload commands */
#define SMA_IDLE_ARM    1
#define SMA_IDLE_ACTIVE 2

/* DC_DC8051_CFG_MODE.GENERAL bits */
#define DISABLE_SELF_GUID_CHECK 0x2

/*
 * Eager buffer minimum and maximum sizes supported by the hardware.
 * All power-of-two sizes in between are supported as well.
 * MAX_EAGER_BUFFER_TOTAL is the maximum size of memory
 * allocatable for Eager buffer to a single context. All others
 * are limits for the RcvArray entries.
 */
#define MIN_EAGER_BUFFER       (4 * 1024)
#define MAX_EAGER_BUFFER       (256 * 1024)
#define MAX_EAGER_BUFFER_TOTAL (64 * (1 << 20)) /* max per ctxt 64MB */
#define MAX_EXPECTED_BUFFER    (2048 * 1024)

/*
 * Receive expected base and count and eager base and count increment -
 * the CSR fields hold multiples of this value.
 */
#define RCV_SHIFT 3
#define RCV_INCREMENT (1 << RCV_SHIFT)

/*
 * Receive header queue entry increment - the CSR holds multiples of
 * this value.
 */
#define HDRQ_SIZE_SHIFT 5
#define HDRQ_INCREMENT (1 << HDRQ_SIZE_SHIFT)

/*
 * Freeze handling flags
 */
#define FREEZE_ABORT     0x01   /* do not do recovery */
#define FREEZE_SELF          0x02       /* initiate the freeze */
#define FREEZE_LINK_DOWN 0x04   /* link is down */

/*
 * Chip implementation codes.
 */
#define ICODE_RTL_SILICON               0x00
#define ICODE_RTL_VCS_SIMULATION        0x01
#define ICODE_FPGA_EMULATION    0x02
#define ICODE_FUNCTIONAL_SIMULATOR      0x03

/*
 * 8051 data memory size.
 */
#define DC8051_DATA_MEM_SIZE 0x1000

/*
 * 8051 firmware registers
 */
#define NUM_GENERAL_FIELDS 0x17
#define NUM_LANE_FIELDS    0x8

/* 8051 general register Field IDs */
#define TX_SETTINGS                  0x06
#define VERIFY_CAP_LOCAL_PHY         0x07
#define VERIFY_CAP_LOCAL_FABRIC      0x08
#define VERIFY_CAP_LOCAL_LINK_WIDTH  0x09
#define LOCAL_DEVICE_ID              0x0a
#define LOCAL_LNI_INFO               0x0c
#define REMOTE_LNI_INFO              0x0d
#define MISC_STATUS                  0x0e
#define VERIFY_CAP_REMOTE_PHY        0x0f
#define VERIFY_CAP_REMOTE_FABRIC     0x10
#define VERIFY_CAP_REMOTE_LINK_WIDTH 0x11
#define LAST_LOCAL_STATE_COMPLETE    0x12
#define LAST_REMOTE_STATE_COMPLETE   0x13
#define LINK_QUALITY_INFO            0x14
#define REMOTE_DEVICE_ID             0x15

/* Lane ID for general configuration registers */
#define GENERAL_CONFIG 4

/* LOAD_DATA 8051 command shifts and fields */
#define LOAD_DATA_FIELD_ID_SHIFT 40
#define LOAD_DATA_FIELD_ID_MASK 0xfull
#define LOAD_DATA_LANE_ID_SHIFT 32
#define LOAD_DATA_LANE_ID_MASK 0xfull
#define LOAD_DATA_DATA_SHIFT   0x0
#define LOAD_DATA_DATA_MASK   0xffffffffull

/* READ_DATA 8051 command shifts and fields */
#define READ_DATA_FIELD_ID_SHIFT 40
#define READ_DATA_FIELD_ID_MASK 0xffull
#define READ_DATA_LANE_ID_SHIFT 32
#define READ_DATA_LANE_ID_MASK 0xffull
#define READ_DATA_DATA_SHIFT   0x0
#define READ_DATA_DATA_MASK   0xffffffffull

/* TX settings fields */
#define ENABLE_LANE_TX_SHIFT            0
#define ENABLE_LANE_TX_MASK             0xff
#define TX_POLARITY_INVERSION_SHIFT     8
#define TX_POLARITY_INVERSION_MASK      0xff
#define RX_POLARITY_INVERSION_SHIFT     16
#define RX_POLARITY_INVERSION_MASK      0xff
#define MAX_RATE_SHIFT                  24
#define MAX_RATE_MASK                   0xff

/* verify capability PHY fields */
#define CONTINIOUS_REMOTE_UPDATE_SUPPORT_SHIFT  0x4
#define CONTINIOUS_REMOTE_UPDATE_SUPPORT_MASK   0x1
#define POWER_MANAGEMENT_SHIFT                  0x0
#define POWER_MANAGEMENT_MASK                   0xf

/* 8051 lane register Field IDs */
#define SPICO_FW_VERSION 0x7    /* SPICO firmware version */

/* SPICO firmware version fields */
#define SPICO_ROM_VERSION_SHIFT 0
#define SPICO_ROM_VERSION_MASK 0xffff
#define SPICO_ROM_PROD_ID_SHIFT 16
#define SPICO_ROM_PROD_ID_MASK 0xffff

/* verify capability fabric fields */
#define VAU_SHIFT       0
#define VAU_MASK        0x0007
#define Z_SHIFT         3
#define Z_MASK          0x0001
#define VCU_SHIFT       4
#define VCU_MASK        0x0007
#define VL15BUF_SHIFT   8
#define VL15BUF_MASK    0x0fff
#define CRC_SIZES_SHIFT 20
#define CRC_SIZES_MASK  0x7

/* verify capability local link width fields */
#define LINK_WIDTH_SHIFT 0              /* also for remote link width */
#define LINK_WIDTH_MASK 0xffff          /* also for remote link width */
#define LOCAL_FLAG_BITS_SHIFT 16
#define LOCAL_FLAG_BITS_MASK 0xff
#define MISC_CONFIG_BITS_SHIFT 24
#define MISC_CONFIG_BITS_MASK 0xff

/* verify capability remote link width fields */
#define REMOTE_TX_RATE_SHIFT 16
#define REMOTE_TX_RATE_MASK 0xff

/* LOCAL_DEVICE_ID fields */
#define LOCAL_DEVICE_REV_SHIFT 0
#define LOCAL_DEVICE_REV_MASK 0xff
#define LOCAL_DEVICE_ID_SHIFT 8
#define LOCAL_DEVICE_ID_MASK 0xffff

/* REMOTE_DEVICE_ID fields */
#define REMOTE_DEVICE_REV_SHIFT 0
#define REMOTE_DEVICE_REV_MASK 0xff
#define REMOTE_DEVICE_ID_SHIFT 8
#define REMOTE_DEVICE_ID_MASK 0xffff

/* local LNI link width fields */
#define ENABLE_LANE_RX_SHIFT 16
#define ENABLE_LANE_RX_MASK  0xff

/* mask, shift for reading 'mgmt_enabled' value from REMOTE_LNI_INFO field */
#define MGMT_ALLOWED_SHIFT 23
#define MGMT_ALLOWED_MASK 0x1

/* mask, shift for 'link_quality' within LINK_QUALITY_INFO field */
#define LINK_QUALITY_SHIFT 24
#define LINK_QUALITY_MASK  0x7

/*
 * mask, shift for reading 'planned_down_remote_reason_code'
 * from LINK_QUALITY_INFO field
 */
#define DOWN_REMOTE_REASON_SHIFT 16
#define DOWN_REMOTE_REASON_MASK  0xff

/* verify capability PHY power management bits */
#define PWRM_BER_CONTROL        0x1
#define PWRM_BANDWIDTH_CONTROL  0x2

/* verify capability fabric CRC size bits */
enum {
        CAP_CRC_14B = (1 << 0), /* 14b CRC */
        CAP_CRC_48B = (1 << 1), /* 48b CRC */
        CAP_CRC_12B_16B_PER_LANE = (1 << 2) /* 12b-16b per lane CRC */
};

#define SUPPORTED_CRCS (CAP_CRC_14B | CAP_CRC_48B)

/* misc status version fields */
#define STS_FM_VERSION_A_SHIFT 16
#define STS_FM_VERSION_A_MASK  0xff
#define STS_FM_VERSION_B_SHIFT 24
#define STS_FM_VERSION_B_MASK  0xff

/* LCB_CFG_CRC_MODE TX_VAL and RX_VAL CRC mode values */
#define LCB_CRC_16B                     0x0     /* 16b CRC */
#define LCB_CRC_14B                     0x1     /* 14b CRC */
#define LCB_CRC_48B                     0x2     /* 48b CRC */
#define LCB_CRC_12B_16B_PER_LANE        0x3     /* 12b-16b per lane CRC */

/* the following enum is (almost) a copy/paste of the definition
 * in the OPA spec, section 20.2.2.6.8 (PortInfo) */
enum {
        PORT_LTP_CRC_MODE_NONE = 0,
        PORT_LTP_CRC_MODE_14 = 1, /* 14-bit LTP CRC mode (optional) */
        PORT_LTP_CRC_MODE_16 = 2, /* 16-bit LTP CRC mode */
        PORT_LTP_CRC_MODE_48 = 4,
                /* 48-bit overlapping LTP CRC mode (optional) */
        PORT_LTP_CRC_MODE_PER_LANE = 8
                /* 12 to 16 bit per lane LTP CRC mode (optional) */
};

/* timeouts */
#define LINK_RESTART_DELAY 1000         /* link restart delay, in ms */
#define TIMEOUT_8051_START 5000         /* 8051 start timeout, in ms */
#define DC8051_COMMAND_TIMEOUT 20000    /* DC8051 command timeout, in ms */
#define FREEZE_STATUS_TIMEOUT 20        /* wait for freeze indicators, in ms */
#define VL_STATUS_CLEAR_TIMEOUT 5000    /* per-VL status clear, in ms */
#define CCE_STATUS_TIMEOUT 10           /* time to clear CCE Status, in ms */

/* cclock tick time, in picoseconds per tick: 1/speed * 10^12  */
#define ASIC_CCLOCK_PS  1242    /* 805 MHz */
#define FPGA_CCLOCK_PS 30300    /*  33 MHz */

/*
 * Mask of enabled MISC errors.  Do not enable the two RSA engine errors -
 * see firmware.c:run_rsa() for details.
 */
#define DRIVER_MISC_MASK \
        (~(MISC_ERR_STATUS_MISC_FW_AUTH_FAILED_ERR_SMASK \
                | MISC_ERR_STATUS_MISC_KEY_MISMATCH_ERR_SMASK))

/* valid values for the loopback module parameter */
#define LOOPBACK_NONE   0       /* no loopback - default */
#define LOOPBACK_SERDES 1
#define LOOPBACK_LCB    2
#define LOOPBACK_CABLE  3       /* external cable */

/* read and write hardware registers */
u64 read_csr(const struct hfi1_devdata *dd, u32 offset);
void write_csr(const struct hfi1_devdata *dd, u32 offset, u64 value);

/*
 * The *_kctxt_* flavor of the CSR read/write functions are for
 * per-context or per-SDMA CSRs that are not mappable to user-space.
 * Their spacing is not a PAGE_SIZE multiple.
 */
static inline u64 read_kctxt_csr(const struct hfi1_devdata *dd, int ctxt,
                                 u32 offset0)
{
        /* kernel per-context CSRs are separated by 0x100 */
        return read_csr(dd, offset0 + (0x100 * ctxt));
}

static inline void write_kctxt_csr(struct hfi1_devdata *dd, int ctxt,
                                   u32 offset0, u64 value)
{
        /* kernel per-context CSRs are separated by 0x100 */
        write_csr(dd, offset0 + (0x100 * ctxt), value);
}

int read_lcb_csr(struct hfi1_devdata *dd, u32 offset, u64 *data);
int write_lcb_csr(struct hfi1_devdata *dd, u32 offset, u64 data);

void __iomem *get_csr_addr(
        struct hfi1_devdata *dd,
        u32 offset);

static inline void __iomem *get_kctxt_csr_addr(
        struct hfi1_devdata *dd,
        int ctxt,
        u32 offset0)
{
        return get_csr_addr(dd, offset0 + (0x100 * ctxt));
}

/*
 * The *_uctxt_* flavor of the CSR read/write functions are for
 * per-context CSRs that are mappable to user space. All these CSRs
 * are spaced by a PAGE_SIZE multiple in order to be mappable to
 * different processes without exposing other contexts' CSRs
 */
static inline u64 read_uctxt_csr(const struct hfi1_devdata *dd, int ctxt,
                                 u32 offset0)
{
        /* user per-context CSRs are separated by 0x1000 */
        return read_csr(dd, offset0 + (0x1000 * ctxt));
}

static inline void write_uctxt_csr(struct hfi1_devdata *dd, int ctxt,
                                   u32 offset0, u64 value)
{
        /* user per-context CSRs are separated by 0x1000 */
        write_csr(dd, offset0 + (0x1000 * ctxt), value);
}

u64 create_pbc(struct hfi1_pportdata *ppd, u64, int, u32, u32);

/* firmware.c */
#define SBUS_MASTER_BROADCAST 0xfd
#define NUM_PCIE_SERDES 16      /* number of PCIe serdes on the SBus */
extern const u8 pcie_serdes_broadcast[];
extern const u8 pcie_pcs_addrs[2][NUM_PCIE_SERDES];
/* SBus commands */
#define RESET_SBUS_RECEIVER 0x20
#define WRITE_SBUS_RECEIVER 0x21
void sbus_request(struct hfi1_devdata *dd,
                  u8 receiver_addr, u8 data_addr, u8 command, u32 data_in);
int sbus_request_slow(struct hfi1_devdata *dd,
                      u8 receiver_addr, u8 data_addr, u8 command, u32 data_in);
void set_sbus_fast_mode(struct hfi1_devdata *dd);
void clear_sbus_fast_mode(struct hfi1_devdata *dd);
int hfi1_firmware_init(struct hfi1_devdata *dd);
int load_pcie_firmware(struct hfi1_devdata *dd);
int load_firmware(struct hfi1_devdata *dd);
void dispose_firmware(void);
int acquire_hw_mutex(struct hfi1_devdata *dd);
void release_hw_mutex(struct hfi1_devdata *dd);
void fabric_serdes_reset(struct hfi1_devdata *dd);
int read_8051_data(struct hfi1_devdata *dd, u32 addr, u32 len, u64 *result);

/* chip.c */
void read_misc_status(struct hfi1_devdata *dd, u8 *ver_a, u8 *ver_b);
void read_guid(struct hfi1_devdata *dd);
int wait_fm_ready(struct hfi1_devdata *dd, u32 mstimeout);
void set_link_down_reason(struct hfi1_pportdata *ppd, u8 lcl_reason,
                          u8 neigh_reason, u8 rem_reason);
int set_link_state(struct hfi1_pportdata *, u32 state);
int port_ltp_to_cap(int port_ltp);
void handle_verify_cap(struct work_struct *work);
void handle_freeze(struct work_struct *work);
void handle_link_up(struct work_struct *work);
void handle_link_down(struct work_struct *work);
void handle_link_downgrade(struct work_struct *work);
void handle_link_bounce(struct work_struct *work);
void handle_sma_message(struct work_struct *work);
void start_freeze_handling(struct hfi1_pportdata *ppd, int flags);
int send_idle_sma(struct hfi1_devdata *dd, u64 message);
int start_link(struct hfi1_pportdata *ppd);
void init_qsfp(struct hfi1_pportdata *ppd);
int bringup_serdes(struct hfi1_pportdata *ppd);
void set_intr_state(struct hfi1_devdata *dd, u32 enable);
void apply_link_downgrade_policy(struct hfi1_pportdata *ppd,
                                 int refresh_widths);
void update_usrhead(struct hfi1_ctxtdata *, u32, u32, u32, u32, u32);
int stop_drain_data_vls(struct hfi1_devdata *dd);
int open_fill_data_vls(struct hfi1_devdata *dd);
u32 ns_to_cclock(struct hfi1_devdata *dd, u32 ns);
u32 cclock_to_ns(struct hfi1_devdata *dd, u32 cclock);
void get_linkup_link_widths(struct hfi1_pportdata *ppd);
void read_ltp_rtt(struct hfi1_devdata *dd);
void clear_linkup_counters(struct hfi1_devdata *dd);
u32 hdrqempty(struct hfi1_ctxtdata *rcd);
int is_a0(struct hfi1_devdata *dd);
int is_ax(struct hfi1_devdata *dd);
int is_bx(struct hfi1_devdata *dd);
u32 read_physical_state(struct hfi1_devdata *dd);
u32 chip_to_opa_pstate(struct hfi1_devdata *dd, u32 chip_pstate);
u32 get_logical_state(struct hfi1_pportdata *ppd);
const char *opa_lstate_name(u32 lstate);
const char *opa_pstate_name(u32 pstate);
u32 driver_physical_state(struct hfi1_pportdata *ppd);
u32 driver_logical_state(struct hfi1_pportdata *ppd);

int acquire_lcb_access(struct hfi1_devdata *dd, int sleep_ok);
int release_lcb_access(struct hfi1_devdata *dd, int sleep_ok);
#define LCB_START DC_LCB_CSRS
#define LCB_END   DC_8051_CSRS /* next block is 8051 */
static inline int is_lcb_offset(u32 offset)
{
        return (offset >= LCB_START && offset < LCB_END);
}

extern uint num_vls;

extern uint disable_integrity;
u64 read_dev_cntr(struct hfi1_devdata *dd, int index, int vl);
u64 write_dev_cntr(struct hfi1_devdata *dd, int index, int vl, u64 data);
u64 read_port_cntr(struct hfi1_pportdata *ppd, int index, int vl);
u64 write_port_cntr(struct hfi1_pportdata *ppd, int index, int vl, u64 data);

/* Per VL indexes */
enum {
        C_VL_0 = 0,
        C_VL_1,
        C_VL_2,
        C_VL_3,
        C_VL_4,
        C_VL_5,
        C_VL_6,
        C_VL_7,
        C_VL_15,
        C_VL_COUNT
};

static inline int vl_from_idx(int idx)
{
        return (idx == C_VL_15 ? 15 : idx);
}

static inline int idx_from_vl(int vl)
{
        return (vl == 15 ? C_VL_15 : vl);
}

/* Per device counter indexes */
enum {
        C_RCV_OVF = 0,
        C_RX_TID_FULL,
        C_RX_TID_INVALID,
        C_RX_TID_FLGMS,
        C_RX_CTX_RHQS,
        C_RX_CTX_EGRS,
        C_RCV_TID_FLSMS,
        C_CCE_PCI_CR_ST,
        C_CCE_PCI_TR_ST,
        C_CCE_PIO_WR_ST,
        C_CCE_ERR_INT,
        C_CCE_SDMA_INT,
        C_CCE_MISC_INT,
        C_CCE_RCV_AV_INT,
        C_CCE_RCV_URG_INT,
        C_CCE_SEND_CR_INT,
        C_DC_UNC_ERR,
        C_DC_RCV_ERR,
        C_DC_FM_CFG_ERR,
        C_DC_RMT_PHY_ERR,
        C_DC_DROPPED_PKT,
        C_DC_MC_XMIT_PKTS,
        C_DC_MC_RCV_PKTS,
        C_DC_XMIT_CERR,
        C_DC_RCV_CERR,
        C_DC_RCV_FCC,
        C_DC_XMIT_FCC,
        C_DC_XMIT_FLITS,
        C_DC_RCV_FLITS,
        C_DC_XMIT_PKTS,
        C_DC_RCV_PKTS,
        C_DC_RX_FLIT_VL,
        C_DC_RX_PKT_VL,
        C_DC_RCV_FCN,
        C_DC_RCV_FCN_VL,
        C_DC_RCV_BCN,
        C_DC_RCV_BCN_VL,
        C_DC_RCV_BBL,
        C_DC_RCV_BBL_VL,
        C_DC_MARK_FECN,
        C_DC_MARK_FECN_VL,
        C_DC_TOTAL_CRC,
        C_DC_CRC_LN0,
        C_DC_CRC_LN1,
        C_DC_CRC_LN2,
        C_DC_CRC_LN3,
        C_DC_CRC_MULT_LN,
        C_DC_TX_REPLAY,
        C_DC_RX_REPLAY,
        C_DC_SEQ_CRC_CNT,
        C_DC_ESC0_ONLY_CNT,
        C_DC_ESC0_PLUS1_CNT,
        C_DC_ESC0_PLUS2_CNT,
        C_DC_REINIT_FROM_PEER_CNT,
        C_DC_SBE_CNT,
        C_DC_MISC_FLG_CNT,
        C_DC_PRF_GOOD_LTP_CNT,
        C_DC_PRF_ACCEPTED_LTP_CNT,
        C_DC_PRF_RX_FLIT_CNT,
        C_DC_PRF_TX_FLIT_CNT,
        C_DC_PRF_CLK_CNTR,
        C_DC_PG_DBG_FLIT_CRDTS_CNT,
        C_DC_PG_STS_PAUSE_COMPLETE_CNT,
        C_DC_PG_STS_TX_SBE_CNT,
        C_DC_PG_STS_TX_MBE_CNT,
        C_SW_CPU_INTR,
        C_SW_CPU_RCV_LIM,
        C_SW_VTX_WAIT,
        C_SW_PIO_WAIT,
        C_SW_KMEM_WAIT,
        C_SW_SEND_SCHED,
        DEV_CNTR_LAST  /* Must be kept last */
};

/* Per port counter indexes */
enum {
        C_TX_UNSUP_VL = 0,
        C_TX_INVAL_LEN,
        C_TX_MM_LEN_ERR,
        C_TX_UNDERRUN,
        C_TX_FLOW_STALL,
        C_TX_DROPPED,
        C_TX_HDR_ERR,
        C_TX_PKT,
        C_TX_WORDS,
        C_TX_WAIT,
        C_TX_FLIT_VL,
        C_TX_PKT_VL,
        C_TX_WAIT_VL,
        C_RX_PKT,
        C_RX_WORDS,
        C_SW_LINK_DOWN,
        C_SW_LINK_UP,
        C_SW_XMIT_DSCD,
        C_SW_XMIT_DSCD_VL,
        C_SW_XMIT_CSTR_ERR,
        C_SW_RCV_CSTR_ERR,
        C_SW_IBP_LOOP_PKTS,
        C_SW_IBP_RC_RESENDS,
        C_SW_IBP_RNR_NAKS,
        C_SW_IBP_OTHER_NAKS,
        C_SW_IBP_RC_TIMEOUTS,
        C_SW_IBP_PKT_DROPS,
        C_SW_IBP_DMA_WAIT,
        C_SW_IBP_RC_SEQNAK,
        C_SW_IBP_RC_DUPREQ,
        C_SW_IBP_RDMA_SEQ,
        C_SW_IBP_UNALIGNED,
        C_SW_IBP_SEQ_NAK,
        C_SW_CPU_RC_ACKS,
        C_SW_CPU_RC_QACKS,
        C_SW_CPU_RC_DELAYED_COMP,
        C_RCV_HDR_OVF_0,
        C_RCV_HDR_OVF_1,
        C_RCV_HDR_OVF_2,
        C_RCV_HDR_OVF_3,
        C_RCV_HDR_OVF_4,
        C_RCV_HDR_OVF_5,
        C_RCV_HDR_OVF_6,
        C_RCV_HDR_OVF_7,
        C_RCV_HDR_OVF_8,
        C_RCV_HDR_OVF_9,
        C_RCV_HDR_OVF_10,
        C_RCV_HDR_OVF_11,
        C_RCV_HDR_OVF_12,
        C_RCV_HDR_OVF_13,
        C_RCV_HDR_OVF_14,
        C_RCV_HDR_OVF_15,
        C_RCV_HDR_OVF_16,
        C_RCV_HDR_OVF_17,
        C_RCV_HDR_OVF_18,
        C_RCV_HDR_OVF_19,
        C_RCV_HDR_OVF_20,
        C_RCV_HDR_OVF_21,
        C_RCV_HDR_OVF_22,
        C_RCV_HDR_OVF_23,
        C_RCV_HDR_OVF_24,
        C_RCV_HDR_OVF_25,
        C_RCV_HDR_OVF_26,
        C_RCV_HDR_OVF_27,
        C_RCV_HDR_OVF_28,
        C_RCV_HDR_OVF_29,
        C_RCV_HDR_OVF_30,
        C_RCV_HDR_OVF_31,
        C_RCV_HDR_OVF_32,
        C_RCV_HDR_OVF_33,
        C_RCV_HDR_OVF_34,
        C_RCV_HDR_OVF_35,
        C_RCV_HDR_OVF_36,
        C_RCV_HDR_OVF_37,
        C_RCV_HDR_OVF_38,
        C_RCV_HDR_OVF_39,
        C_RCV_HDR_OVF_40,
        C_RCV_HDR_OVF_41,
        C_RCV_HDR_OVF_42,
        C_RCV_HDR_OVF_43,
        C_RCV_HDR_OVF_44,
        C_RCV_HDR_OVF_45,
        C_RCV_HDR_OVF_46,
        C_RCV_HDR_OVF_47,
        C_RCV_HDR_OVF_48,
        C_RCV_HDR_OVF_49,
        C_RCV_HDR_OVF_50,
        C_RCV_HDR_OVF_51,
        C_RCV_HDR_OVF_52,
        C_RCV_HDR_OVF_53,
        C_RCV_HDR_OVF_54,
        C_RCV_HDR_OVF_55,
        C_RCV_HDR_OVF_56,
        C_RCV_HDR_OVF_57,
        C_RCV_HDR_OVF_58,
        C_RCV_HDR_OVF_59,
        C_RCV_HDR_OVF_60,
        C_RCV_HDR_OVF_61,
        C_RCV_HDR_OVF_62,
        C_RCV_HDR_OVF_63,
        C_RCV_HDR_OVF_64,
        C_RCV_HDR_OVF_65,
        C_RCV_HDR_OVF_66,
        C_RCV_HDR_OVF_67,
        C_RCV_HDR_OVF_68,
        C_RCV_HDR_OVF_69,
        C_RCV_HDR_OVF_70,
        C_RCV_HDR_OVF_71,
        C_RCV_HDR_OVF_72,
        C_RCV_HDR_OVF_73,
        C_RCV_HDR_OVF_74,
        C_RCV_HDR_OVF_75,
        C_RCV_HDR_OVF_76,
        C_RCV_HDR_OVF_77,
        C_RCV_HDR_OVF_78,
        C_RCV_HDR_OVF_79,
        C_RCV_HDR_OVF_80,
        C_RCV_HDR_OVF_81,
        C_RCV_HDR_OVF_82,
        C_RCV_HDR_OVF_83,
        C_RCV_HDR_OVF_84,
        C_RCV_HDR_OVF_85,
        C_RCV_HDR_OVF_86,
        C_RCV_HDR_OVF_87,
        C_RCV_HDR_OVF_88,
        C_RCV_HDR_OVF_89,
        C_RCV_HDR_OVF_90,
        C_RCV_HDR_OVF_91,
        C_RCV_HDR_OVF_92,
        C_RCV_HDR_OVF_93,
        C_RCV_HDR_OVF_94,
        C_RCV_HDR_OVF_95,
        C_RCV_HDR_OVF_96,
        C_RCV_HDR_OVF_97,
        C_RCV_HDR_OVF_98,
        C_RCV_HDR_OVF_99,
        C_RCV_HDR_OVF_100,
        C_RCV_HDR_OVF_101,
        C_RCV_HDR_OVF_102,
        C_RCV_HDR_OVF_103,
        C_RCV_HDR_OVF_104,
        C_RCV_HDR_OVF_105,
        C_RCV_HDR_OVF_106,
        C_RCV_HDR_OVF_107,
        C_RCV_HDR_OVF_108,
        C_RCV_HDR_OVF_109,
        C_RCV_HDR_OVF_110,
        C_RCV_HDR_OVF_111,
        C_RCV_HDR_OVF_112,
        C_RCV_HDR_OVF_113,
        C_RCV_HDR_OVF_114,
        C_RCV_HDR_OVF_115,
        C_RCV_HDR_OVF_116,
        C_RCV_HDR_OVF_117,
        C_RCV_HDR_OVF_118,
        C_RCV_HDR_OVF_119,
        C_RCV_HDR_OVF_120,
        C_RCV_HDR_OVF_121,
        C_RCV_HDR_OVF_122,
        C_RCV_HDR_OVF_123,
        C_RCV_HDR_OVF_124,
        C_RCV_HDR_OVF_125,
        C_RCV_HDR_OVF_126,
        C_RCV_HDR_OVF_127,
        C_RCV_HDR_OVF_128,
        C_RCV_HDR_OVF_129,
        C_RCV_HDR_OVF_130,
        C_RCV_HDR_OVF_131,
        C_RCV_HDR_OVF_132,
        C_RCV_HDR_OVF_133,
        C_RCV_HDR_OVF_134,
        C_RCV_HDR_OVF_135,
        C_RCV_HDR_OVF_136,
        C_RCV_HDR_OVF_137,
        C_RCV_HDR_OVF_138,
        C_RCV_HDR_OVF_139,
        C_RCV_HDR_OVF_140,
        C_RCV_HDR_OVF_141,
        C_RCV_HDR_OVF_142,
        C_RCV_HDR_OVF_143,
        C_RCV_HDR_OVF_144,
        C_RCV_HDR_OVF_145,
        C_RCV_HDR_OVF_146,
        C_RCV_HDR_OVF_147,
        C_RCV_HDR_OVF_148,
        C_RCV_HDR_OVF_149,
        C_RCV_HDR_OVF_150,
        C_RCV_HDR_OVF_151,
        C_RCV_HDR_OVF_152,
        C_RCV_HDR_OVF_153,
        C_RCV_HDR_OVF_154,
        C_RCV_HDR_OVF_155,
        C_RCV_HDR_OVF_156,
        C_RCV_HDR_OVF_157,
        C_RCV_HDR_OVF_158,
        C_RCV_HDR_OVF_159,
        PORT_CNTR_LAST /* Must be kept last */
};

u64 get_all_cpu_total(u64 __percpu *cntr);
void hfi1_start_cleanup(struct hfi1_devdata *dd);
void hfi1_clear_tids(struct hfi1_ctxtdata *rcd);
struct hfi1_message_header *hfi1_get_msgheader(
                                struct hfi1_devdata *dd, __le32 *rhf_addr);
int hfi1_get_base_kinfo(struct hfi1_ctxtdata *rcd,

                        struct hfi1_ctxt_info *kinfo);
u64 hfi1_gpio_mod(struct hfi1_devdata *dd, u32 target, u32 data, u32 dir,
                  u32 mask);
int hfi1_init_ctxt(struct send_context *sc);
void hfi1_put_tid(struct hfi1_devdata *dd, u32 index,
                  u32 type, unsigned long pa, u16 order);
void hfi1_quiet_serdes(struct hfi1_pportdata *ppd);
void hfi1_rcvctrl(struct hfi1_devdata *dd, unsigned int op, int ctxt);
u32 hfi1_read_cntrs(struct hfi1_devdata *dd, loff_t pos, char **namep,
                    u64 **cntrp);
u32 hfi1_read_portcntrs(struct hfi1_devdata *dd, loff_t pos, u32 port,
                        char **namep, u64 **cntrp);
u8 hfi1_ibphys_portstate(struct hfi1_pportdata *ppd);
int hfi1_get_ib_cfg(struct hfi1_pportdata *ppd, int which);
int hfi1_set_ib_cfg(struct hfi1_pportdata *ppd, int which, u32 val);
int hfi1_set_ctxt_jkey(struct hfi1_devdata *dd, unsigned ctxt, u16 jkey);
int hfi1_clear_ctxt_jkey(struct hfi1_devdata *dd, unsigned ctxt);
int hfi1_set_ctxt_pkey(struct hfi1_devdata *dd, unsigned ctxt, u16 pkey);
int hfi1_clear_ctxt_pkey(struct hfi1_devdata *dd, unsigned ctxt);
void hfi1_read_link_quality(struct hfi1_devdata *dd, u8 *link_quality);

/*
 * Interrupt source table.
 *
 * Each entry is an interrupt source "type".  It is ordered by increasing
 * number.
 */
struct is_table {
        int start;       /* interrupt source type start */
        int end;         /* interrupt source type end */
        /* routine that returns the name of the interrupt source */
        char *(*is_name)(char *name, size_t size, unsigned int source);
        /* routine to call when receiving an interrupt */
        void (*is_int)(struct hfi1_devdata *dd, unsigned int source);
};

#endif /* _CHIP_H */