igb_nvm.h File Reference

Go to the source code of this file.

Defines
#define	E1000_STM_OPCODE   0xDB00
Functions
	FILE_LICENCE (GPL2_ONLY)
void	igb_init_nvm_ops_generic (struct e1000_hw *hw)
	igb_init_nvm_ops_generic - Initialize NVM function pointers : pointer to the HW structure
s32	igb_acquire_nvm_generic (struct e1000_hw *hw)
	igb_acquire_nvm_generic - Generic request for access to EEPROM : pointer to the HW structure
s32	igb_poll_eerd_eewr_done (struct e1000_hw *hw, int ee_reg)
	igb_poll_eerd_eewr_done - Poll for EEPROM read/write completion : pointer to the HW structure : EEPROM flag for polling
s32	igb_read_mac_addr_generic (struct e1000_hw *hw)
	igb_read_mac_addr_generic - Read device MAC address : pointer to the HW structure
s32	igb_read_pba_num_generic (struct e1000_hw *hw, u32 *pba_num)
	igb_read_pba_num_generic - Read device part number : pointer to the HW structure : pointer to device part number
s32	igb_read_nvm_eerd (struct e1000_hw *hw, u16 offset, u16 words, u16 *data)
	igb_read_nvm_eerd - Reads EEPROM using EERD register : pointer to the HW structure : offset of word in the EEPROM to read : number of words to read : word read from the EEPROM
s32	igb_valid_led_default_generic (struct e1000_hw *hw, u16 *data)
	igb_valid_led_default_generic - Verify a valid default LED config : pointer to the HW structure : pointer to the NVM (EEPROM)
s32	igb_validate_nvm_checksum_generic (struct e1000_hw *hw)
	igb_validate_nvm_checksum_generic - Validate EEPROM checksum : pointer to the HW structure
s32	igb_write_nvm_eewr (struct e1000_hw *hw, u16 offset, u16 words, u16 *data)
s32	igb_write_nvm_spi (struct e1000_hw *hw, u16 offset, u16 words, u16 *data)
	igb_write_nvm_spi - Write to EEPROM using SPI : pointer to the HW structure : offset within the EEPROM to be written to : number of words to write : 16 bit word(s) to be written to the EEPROM
s32	igb_update_nvm_checksum_generic (struct e1000_hw *hw)
	igb_update_nvm_checksum_generic - Update EEPROM checksum : pointer to the HW structure
void	igb_release_nvm_generic (struct e1000_hw *hw)
	igb_release_nvm_generic - Release exclusive access to EEPROM : pointer to the HW structure

---

Define Documentation

#define E1000_STM_OPCODE   0xDB00

Definition at line 50 of file igb_nvm.h.

---

Function Documentation

FILE_LICENCE

(

GPL2_ONLY

)

void igb_init_nvm_ops_generic

(

struct e1000_hw *

hw

)

igb_init_nvm_ops_generic - Initialize NVM function pointers : pointer to the HW structure

Setups up the function pointers to no-op functions

Definition at line 41 of file igb_nvm.c.

References DEBUGFUNC, igb_reload_nvm_generic(), e1000_hw::nvm, e1000_nvm_info::ops, and e1000_nvm_operations::reload.

Referenced by igb_setup_init_funcs().

{
        struct e1000_nvm_info *nvm = &hw->nvm;
        DEBUGFUNC("igb_init_nvm_ops_generic");

        /* Initialize function pointers */
        nvm->ops.reload = igb_reload_nvm_generic;
}

s32 igb_acquire_nvm_generic

(

struct e1000_hw *

hw

)

igb_acquire_nvm_generic - Generic request for access to EEPROM : pointer to the HW structure

Set the EEPROM access request bit and wait for EEPROM access grant bit. Return successful if access grant bit set, else clear the request for EEPROM access and return -E1000_ERR_NVM (-1).

Definition at line 204 of file igb_nvm.c.

References DEBUGFUNC, DEBUGOUT, E1000_EECD, E1000_EECD_GNT, E1000_EECD_REQ, E1000_ERR_NVM, E1000_NVM_GRANT_ATTEMPTS, E1000_READ_REG, E1000_SUCCESS, E1000_WRITE_REG, timeout(), u32, and usec_delay.

Referenced by igb_acquire_nvm_82575().

{
        u32 eecd = E1000_READ_REG(hw, E1000_EECD);
        s32 timeout = E1000_NVM_GRANT_ATTEMPTS;
        s32 ret_val = E1000_SUCCESS;

        DEBUGFUNC("igb_acquire_nvm_generic");

        E1000_WRITE_REG(hw, E1000_EECD, eecd | E1000_EECD_REQ);
        eecd = E1000_READ_REG(hw, E1000_EECD);

        while (timeout) {
                if (eecd & E1000_EECD_GNT)
                        break;
                usec_delay(5);
                eecd = E1000_READ_REG(hw, E1000_EECD);
                timeout--;
        }

        if (!timeout) {
                eecd &= ~E1000_EECD_REQ;
                E1000_WRITE_REG(hw, E1000_EECD, eecd);
                DEBUGOUT("Could not acquire NVM grant\n");
                ret_val = -E1000_ERR_NVM;
        }

        return ret_val;
}

s32 igb_poll_eerd_eewr_done	(	struct e1000_hw *	hw,
		int	ee_reg
	)

igb_poll_eerd_eewr_done - Poll for EEPROM read/write completion : pointer to the HW structure : EEPROM flag for polling

Polls the EEPROM status bit for either read or write completion based upon the value of 'ee_reg'.

Definition at line 171 of file igb_nvm.c.

References DEBUGFUNC, E1000_EERD, E1000_EEWR, E1000_ERR_NVM, E1000_NVM_POLL_READ, E1000_NVM_RW_REG_DONE, E1000_READ_REG, E1000_SUCCESS, u32, and usec_delay.

Referenced by igb_read_nvm_eerd().

{
        u32 attempts = 100000;
        u32 i, reg = 0;
        s32 ret_val = -E1000_ERR_NVM;

        DEBUGFUNC("igb_poll_eerd_eewr_done");

        for (i = 0; i < attempts; i++) {
                if (ee_reg == E1000_NVM_POLL_READ)
                        reg = E1000_READ_REG(hw, E1000_EERD);
                else
                        reg = E1000_READ_REG(hw, E1000_EEWR);

                if (reg & E1000_NVM_RW_REG_DONE) {
                        ret_val = E1000_SUCCESS;
                        break;
                }

                usec_delay(5);
        }

        return ret_val;
}

s32 igb_read_mac_addr_generic

(

struct e1000_hw *

hw

)

igb_read_mac_addr_generic - Read device MAC address : pointer to the HW structure

Reads the device MAC address from the EEPROM and stores the value. Since devices with two ports use the same EEPROM, we increment the last bit in the MAC address for the second port.

Definition at line 520 of file igb_nvm.c.

References e1000_mac_info::addr, E1000_RAH, E1000_RAH_MAC_ADDR_LEN, E1000_RAL, E1000_RAL_MAC_ADDR_LEN, E1000_READ_REG, E1000_SUCCESS, ETH_ADDR_LEN, e1000_hw::mac, e1000_mac_info::perm_addr, u16, u32, and u8.

Referenced by igb_init_mac_ops_generic(), igb_read_mac_addr(), and igb_read_mac_addr_82575().

{
        u32 rar_high;
        u32 rar_low;
        u16 i;

        rar_high = E1000_READ_REG(hw, E1000_RAH(0));
        rar_low = E1000_READ_REG(hw, E1000_RAL(0));

        for (i = 0; i < E1000_RAL_MAC_ADDR_LEN; i++)
                hw->mac.perm_addr[i] = (u8)(rar_low >> (i*8));

        for (i = 0; i < E1000_RAH_MAC_ADDR_LEN; i++)
                hw->mac.perm_addr[i+4] = (u8)(rar_high >> (i*8));

        for (i = 0; i < ETH_ADDR_LEN; i++)
                hw->mac.addr[i] = hw->mac.perm_addr[i];

        return E1000_SUCCESS;
}

s32 igb_read_pba_num_generic	(	struct e1000_hw *	hw,
		u32 *	pba_num
	)

igb_read_pba_num_generic - Read device part number : pointer to the HW structure : pointer to device part number

Reads the product board assembly (PBA) number from the EEPROM and stores the value in pba_num.

Definition at line 487 of file igb_nvm.c.

References DEBUGFUNC, DEBUGOUT, e1000_hw::nvm, NVM_PBA_OFFSET_0, NVM_PBA_OFFSET_1, e1000_nvm_info::ops, e1000_nvm_operations::read, u16, and u32.

Referenced by igb_read_pba_num().

{
        s32  ret_val;
        u16 nvm_data;

        DEBUGFUNC("igb_read_pba_num_generic");

        ret_val = hw->nvm.ops.read(hw, NVM_PBA_OFFSET_0, 1, &nvm_data);
        if (ret_val) {
                DEBUGOUT("NVM Read Error\n");
                goto out;
        }
        *pba_num = (u32)(nvm_data << 16);

        ret_val = hw->nvm.ops.read(hw, NVM_PBA_OFFSET_1, 1, &nvm_data);
        if (ret_val) {
                DEBUGOUT("NVM Read Error\n");
                goto out;
        }
        *pba_num |= nvm_data;

out:
        return ret_val;
}

s32 igb_read_nvm_eerd	(	struct e1000_hw *	hw,
		u16	offset,
		u16	words,
		u16 *	data
	)

igb_read_nvm_eerd - Reads EEPROM using EERD register : pointer to the HW structure : offset of word in the EEPROM to read : number of words to read : word read from the EEPROM

Reads a 16 bit word from the EEPROM using the EERD register.

Definition at line 359 of file igb_nvm.c.

References DEBUGFUNC, DEBUGOUT, E1000_EERD, E1000_ERR_NVM, E1000_NVM_POLL_READ, E1000_NVM_RW_ADDR_SHIFT, E1000_NVM_RW_REG_DATA, E1000_NVM_RW_REG_START, E1000_READ_REG, E1000_SUCCESS, E1000_WRITE_REG, igb_poll_eerd_eewr_done(), e1000_hw::nvm, u32, and e1000_nvm_info::word_size.

Referenced by igb_init_nvm_params_82575().

{
        struct e1000_nvm_info *nvm = &hw->nvm;
        u32 i, eerd = 0;
        s32 ret_val = E1000_SUCCESS;

        DEBUGFUNC("igb_read_nvm_eerd");

        /*
         * A check for invalid values:  offset too large, too many words,
         * too many words for the offset, and not enough words.
         */
        if ((offset >= nvm->word_size) || (words > (nvm->word_size - offset)) ||
            (words == 0)) {
                DEBUGOUT("nvm parameter(s) out of bounds\n");
                ret_val = -E1000_ERR_NVM;
                goto out;
        }

        for (i = 0; i < words; i++) {
                eerd = ((offset+i) << E1000_NVM_RW_ADDR_SHIFT) +
                       E1000_NVM_RW_REG_START;

                E1000_WRITE_REG(hw, E1000_EERD, eerd);
                ret_val = igb_poll_eerd_eewr_done(hw, E1000_NVM_POLL_READ);
                if (ret_val)
                        break;

                data[i] = (E1000_READ_REG(hw, E1000_EERD) >>
                           E1000_NVM_RW_REG_DATA);
        }

out:
        return ret_val;
}

s32 igb_valid_led_default_generic	(	struct e1000_hw *	hw,
		u16 *	data
	)

igb_valid_led_default_generic - Verify a valid default LED config : pointer to the HW structure : pointer to the NVM (EEPROM)

Read the EEPROM for the current default LED configuration. If the LED configuration is not valid, set to a valid LED configuration.

Definition at line 1546 of file igb_mac.c.

References DEBUGFUNC, DEBUGOUT, ID_LED_DEFAULT, ID_LED_RESERVED_0000, ID_LED_RESERVED_FFFF, e1000_hw::nvm, NVM_ID_LED_SETTINGS, e1000_nvm_info::ops, and e1000_nvm_operations::read.

{
        s32 ret_val;

        DEBUGFUNC("igb_valid_led_default_generic");

        ret_val = hw->nvm.ops.read(hw, NVM_ID_LED_SETTINGS, 1, data);
        if (ret_val) {
                DEBUGOUT("NVM Read Error\n");
                goto out;
        }

        if (*data == ID_LED_RESERVED_0000 || *data == ID_LED_RESERVED_FFFF)
                *data = ID_LED_DEFAULT;

out:
        return ret_val;
}

s32 igb_validate_nvm_checksum_generic

(

struct e1000_hw *

hw

)

igb_validate_nvm_checksum_generic - Validate EEPROM checksum : pointer to the HW structure

Calculates the EEPROM checksum by reading/adding each word of the EEPROM and then verifies that the sum of the EEPROM is equal to 0xBABA.

Definition at line 548 of file igb_nvm.c.

References DEBUGFUNC, DEBUGOUT, E1000_ERR_NVM, E1000_SUCCESS, e1000_hw::nvm, NVM_CHECKSUM_REG, NVM_SUM, e1000_nvm_info::ops, e1000_nvm_operations::read, and u16.

Referenced by igb_init_nvm_params_82575().

{
        s32 ret_val = E1000_SUCCESS;
        u16 checksum = 0;
        u16 i, nvm_data;

        DEBUGFUNC("igb_validate_nvm_checksum_generic");

        for (i = 0; i < (NVM_CHECKSUM_REG + 1); i++) {
                ret_val = hw->nvm.ops.read(hw, i, 1, &nvm_data);
                if (ret_val) {
                        DEBUGOUT("NVM Read Error\n");
                        goto out;
                }
                checksum += nvm_data;
        }

        if (checksum != (u16) NVM_SUM) {
                DEBUGOUT("NVM Checksum Invalid\n");
                ret_val = -E1000_ERR_NVM;
                goto out;
        }

out:
        return ret_val;
}

s32 igb_write_nvm_eewr	(	struct e1000_hw *	hw,
		u16	offset,
		u16	words,
		u16 *	data
	)

s32 igb_write_nvm_spi	(	struct e1000_hw *	hw,
		u16	offset,
		u16	words,
		u16 *	data
	)

igb_write_nvm_spi - Write to EEPROM using SPI : pointer to the HW structure : offset within the EEPROM to be written to : number of words to write : 16 bit word(s) to be written to the EEPROM

Writes data to EEPROM at offset using SPI interface.

If e1000_update_nvm_checksum is not called after this function , the EEPROM will most likely contain an invalid checksum.

Definition at line 407 of file igb_nvm.c.

References e1000_nvm_operations::acquire, e1000_nvm_info::address_bits, DEBUGFUNC, DEBUGOUT, E1000_ERR_NVM, igb_ready_nvm_eeprom(), igb_shift_out_eec_bits(), igb_standby_nvm(), msec_delay, e1000_hw::nvm, NVM_A8_OPCODE_SPI, NVM_WREN_OPCODE_SPI, NVM_WRITE_OPCODE_SPI, e1000_nvm_info::opcode_bits, e1000_nvm_info::ops, e1000_nvm_info::page_size, e1000_nvm_operations::release, u16, u8, and e1000_nvm_info::word_size.

Referenced by igb_init_nvm_params_82575().

{
        struct e1000_nvm_info *nvm = &hw->nvm;
        s32 ret_val;
        u16 widx = 0;

        DEBUGFUNC("igb_write_nvm_spi");

        /*
         * A check for invalid values:  offset too large, too many words,
         * and not enough words.
         */
        if ((offset >= nvm->word_size) || (words > (nvm->word_size - offset)) ||
            (words == 0)) {
                DEBUGOUT("nvm parameter(s) out of bounds\n");
                ret_val = -E1000_ERR_NVM;
                goto out;
        }

        ret_val = nvm->ops.acquire(hw);
        if (ret_val)
                goto out;

        while (widx < words) {
                u8 write_opcode = NVM_WRITE_OPCODE_SPI;

                ret_val = igb_ready_nvm_eeprom(hw);
                if (ret_val)
                        goto release;

                igb_standby_nvm(hw);

                /* Send the WRITE ENABLE command (8 bit opcode) */
                igb_shift_out_eec_bits(hw, NVM_WREN_OPCODE_SPI,
                                         nvm->opcode_bits);

                igb_standby_nvm(hw);

                /*
                 * Some SPI eeproms use the 8th address bit embedded in the
                 * opcode
                 */
                if ((nvm->address_bits == 8) && (offset >= 128))
                        write_opcode |= NVM_A8_OPCODE_SPI;

                /* Send the Write command (8-bit opcode + addr) */
                igb_shift_out_eec_bits(hw, write_opcode, nvm->opcode_bits);
                igb_shift_out_eec_bits(hw, (u16)((offset + widx) * 2),
                                         nvm->address_bits);

                /* Loop to allow for up to whole page write of eeprom */
                while (widx < words) {
                        u16 word_out = data[widx];
                        word_out = (word_out >> 8) | (word_out << 8);
                        igb_shift_out_eec_bits(hw, word_out, 16);
                        widx++;

                        if ((((offset + widx) * 2) % nvm->page_size) == 0) {
                                igb_standby_nvm(hw);
                                break;
                        }
                }
        }

        msec_delay(10);
release:
        nvm->ops.release(hw);

out:
        return ret_val;
}

s32 igb_update_nvm_checksum_generic

(

struct e1000_hw *

hw

)

igb_update_nvm_checksum_generic - Update EEPROM checksum : pointer to the HW structure

Updates the EEPROM checksum by reading/adding each word of the EEPROM up to the checksum. Then calculates the EEPROM checksum and writes the value to the EEPROM.

Definition at line 583 of file igb_nvm.c.

References DEBUGFUNC, DEBUGOUT, e1000_hw::nvm, NVM_CHECKSUM_REG, NVM_SUM, e1000_nvm_info::ops, e1000_nvm_operations::read, u16, and e1000_nvm_operations::write.

Referenced by igb_init_nvm_params_82575().

{
        s32  ret_val;
        u16 checksum = 0;
        u16 i, nvm_data;

        DEBUGFUNC("igb_update_nvm_checksum");

        for (i = 0; i < NVM_CHECKSUM_REG; i++) {
                ret_val = hw->nvm.ops.read(hw, i, 1, &nvm_data);
                if (ret_val) {
                        DEBUGOUT("NVM Read Error while updating checksum.\n");
                        goto out;
                }
                checksum += nvm_data;
        }
        checksum = (u16) NVM_SUM - checksum;
        ret_val = hw->nvm.ops.write(hw, NVM_CHECKSUM_REG, 1, &checksum);
        if (ret_val) {
                DEBUGOUT("NVM Write Error while updating checksum.\n");
        }
out:
        return ret_val;
}

void igb_release_nvm_generic

(

struct e1000_hw *

hw

)

igb_release_nvm_generic - Release exclusive access to EEPROM : pointer to the HW structure

Stop any current commands to the EEPROM and clear the EEPROM request bit.

Definition at line 285 of file igb_nvm.c.

References DEBUGFUNC, E1000_EECD, E1000_EECD_REQ, E1000_READ_REG, E1000_WRITE_REG, igb_stop_nvm(), and u32.

Referenced by igb_release_nvm_82575().

{
        u32 eecd;

        DEBUGFUNC("igb_release_nvm_generic");

        igb_stop_nvm(hw);

        eecd = E1000_READ_REG(hw, E1000_EECD);
        eecd &= ~E1000_EECD_REQ;
        E1000_WRITE_REG(hw, E1000_EECD, eecd);
}