| // SPDX-License-Identifier: GPL-2.0-only |
| /* |
| * Copyright (C) 1999 - 2010 Intel Corporation. |
| * Copyright (C) 2010 OKI SEMICONDUCTOR Co., LTD. |
| * |
| * This code was derived from the Intel e1000e Linux driver. |
| */ |
| |
| #include "pch_gbe.h" |
| #include <linux/module.h> /* for __MODULE_STRING */ |
| |
| #define OPTION_UNSET -1 |
| #define OPTION_DISABLED 0 |
| #define OPTION_ENABLED 1 |
| |
| /* |
| * TxDescriptors - Transmit Descriptor Count |
| * @Valid Range: PCH_GBE_MIN_TXD - PCH_GBE_MAX_TXD |
| * @Default Value: PCH_GBE_DEFAULT_TXD |
| */ |
| static int TxDescriptors = OPTION_UNSET; |
| module_param(TxDescriptors, int, 0); |
| MODULE_PARM_DESC(TxDescriptors, "Number of transmit descriptors"); |
| |
| /* |
| * RxDescriptors -Receive Descriptor Count |
| * @Valid Range: PCH_GBE_MIN_RXD - PCH_GBE_MAX_RXD |
| * @Default Value: PCH_GBE_DEFAULT_RXD |
| */ |
| static int RxDescriptors = OPTION_UNSET; |
| module_param(RxDescriptors, int, 0); |
| MODULE_PARM_DESC(RxDescriptors, "Number of receive descriptors"); |
| |
| /* |
| * Speed - User Specified Speed Override |
| * @Valid Range: 0, 10, 100, 1000 |
| * - 0: auto-negotiate at all supported speeds |
| * - 10: only link at 10 Mbps |
| * - 100: only link at 100 Mbps |
| * - 1000: only link at 1000 Mbps |
| * @Default Value: 0 |
| */ |
| static int Speed = OPTION_UNSET; |
| module_param(Speed, int, 0); |
| MODULE_PARM_DESC(Speed, "Speed setting"); |
| |
| /* |
| * Duplex - User Specified Duplex Override |
| * @Valid Range: 0-2 |
| * - 0: auto-negotiate for duplex |
| * - 1: only link at half duplex |
| * - 2: only link at full duplex |
| * @Default Value: 0 |
| */ |
| static int Duplex = OPTION_UNSET; |
| module_param(Duplex, int, 0); |
| MODULE_PARM_DESC(Duplex, "Duplex setting"); |
| |
| #define HALF_DUPLEX 1 |
| #define FULL_DUPLEX 2 |
| |
| /* |
| * AutoNeg - Auto-negotiation Advertisement Override |
| * @Valid Range: 0x01-0x0F, 0x20-0x2F |
| * |
| * The AutoNeg value is a bit mask describing which speed and duplex |
| * combinations should be advertised during auto-negotiation. |
| * The supported speed and duplex modes are listed below |
| * |
| * Bit 7 6 5 4 3 2 1 0 |
| * Speed (Mbps) N/A N/A 1000 N/A 100 100 10 10 |
| * Duplex Full Full Half Full Half |
| * |
| * @Default Value: 0x2F (copper) |
| */ |
| static int AutoNeg = OPTION_UNSET; |
| module_param(AutoNeg, int, 0); |
| MODULE_PARM_DESC(AutoNeg, "Advertised auto-negotiation setting"); |
| |
| #define PHY_ADVERTISE_10_HALF 0x0001 |
| #define PHY_ADVERTISE_10_FULL 0x0002 |
| #define PHY_ADVERTISE_100_HALF 0x0004 |
| #define PHY_ADVERTISE_100_FULL 0x0008 |
| #define PHY_ADVERTISE_1000_HALF 0x0010 /* Not used, just FYI */ |
| #define PHY_ADVERTISE_1000_FULL 0x0020 |
| #define PCH_AUTONEG_ADVERTISE_DEFAULT 0x2F |
| |
| /* |
| * FlowControl - User Specified Flow Control Override |
| * @Valid Range: 0-3 |
| * - 0: No Flow Control |
| * - 1: Rx only, respond to PAUSE frames but do not generate them |
| * - 2: Tx only, generate PAUSE frames but ignore them on receive |
| * - 3: Full Flow Control Support |
| * @Default Value: Read flow control settings from the EEPROM |
| */ |
| static int FlowControl = OPTION_UNSET; |
| module_param(FlowControl, int, 0); |
| MODULE_PARM_DESC(FlowControl, "Flow Control setting"); |
| |
| /* |
| * XsumRX - Receive Checksum Offload Enable/Disable |
| * @Valid Range: 0, 1 |
| * - 0: disables all checksum offload |
| * - 1: enables receive IP/TCP/UDP checksum offload |
| * @Default Value: PCH_GBE_DEFAULT_RX_CSUM |
| */ |
| static int XsumRX = OPTION_UNSET; |
| module_param(XsumRX, int, 0); |
| MODULE_PARM_DESC(XsumRX, "Disable or enable Receive Checksum offload"); |
| |
| #define PCH_GBE_DEFAULT_RX_CSUM true /* trueorfalse */ |
| |
| /* |
| * XsumTX - Transmit Checksum Offload Enable/Disable |
| * @Valid Range: 0, 1 |
| * - 0: disables all checksum offload |
| * - 1: enables transmit IP/TCP/UDP checksum offload |
| * @Default Value: PCH_GBE_DEFAULT_TX_CSUM |
| */ |
| static int XsumTX = OPTION_UNSET; |
| module_param(XsumTX, int, 0); |
| MODULE_PARM_DESC(XsumTX, "Disable or enable Transmit Checksum offload"); |
| |
| #define PCH_GBE_DEFAULT_TX_CSUM true /* trueorfalse */ |
| |
| /* |
| * pch_gbe_option - Force the MAC's flow control settings |
| * @hw: Pointer to the HW structure |
| * Returns: |
| * 0: Successful. |
| * Negative value: Failed. |
| */ |
| struct pch_gbe_option { |
| enum { enable_option, range_option, list_option } type; |
| char *name; |
| char *err; |
| int def; |
| union { |
| struct { /* range_option info */ |
| int min; |
| int max; |
| } r; |
| struct { /* list_option info */ |
| int nr; |
| const struct pch_gbe_opt_list { int i; char *str; } *p; |
| } l; |
| } arg; |
| }; |
| |
| static const struct pch_gbe_opt_list speed_list[] = { |
| { 0, "" }, |
| { SPEED_10, "" }, |
| { SPEED_100, "" }, |
| { SPEED_1000, "" } |
| }; |
| |
| static const struct pch_gbe_opt_list dplx_list[] = { |
| { 0, "" }, |
| { HALF_DUPLEX, "" }, |
| { FULL_DUPLEX, "" } |
| }; |
| |
| static const struct pch_gbe_opt_list an_list[] = |
| #define AA "AutoNeg advertising " |
| {{ 0x01, AA "10/HD" }, |
| { 0x02, AA "10/FD" }, |
| { 0x03, AA "10/FD, 10/HD" }, |
| { 0x04, AA "100/HD" }, |
| { 0x05, AA "100/HD, 10/HD" }, |
| { 0x06, AA "100/HD, 10/FD" }, |
| { 0x07, AA "100/HD, 10/FD, 10/HD" }, |
| { 0x08, AA "100/FD" }, |
| { 0x09, AA "100/FD, 10/HD" }, |
| { 0x0a, AA "100/FD, 10/FD" }, |
| { 0x0b, AA "100/FD, 10/FD, 10/HD" }, |
| { 0x0c, AA "100/FD, 100/HD" }, |
| { 0x0d, AA "100/FD, 100/HD, 10/HD" }, |
| { 0x0e, AA "100/FD, 100/HD, 10/FD" }, |
| { 0x0f, AA "100/FD, 100/HD, 10/FD, 10/HD" }, |
| { 0x20, AA "1000/FD" }, |
| { 0x21, AA "1000/FD, 10/HD" }, |
| { 0x22, AA "1000/FD, 10/FD" }, |
| { 0x23, AA "1000/FD, 10/FD, 10/HD" }, |
| { 0x24, AA "1000/FD, 100/HD" }, |
| { 0x25, AA "1000/FD, 100/HD, 10/HD" }, |
| { 0x26, AA "1000/FD, 100/HD, 10/FD" }, |
| { 0x27, AA "1000/FD, 100/HD, 10/FD, 10/HD" }, |
| { 0x28, AA "1000/FD, 100/FD" }, |
| { 0x29, AA "1000/FD, 100/FD, 10/HD" }, |
| { 0x2a, AA "1000/FD, 100/FD, 10/FD" }, |
| { 0x2b, AA "1000/FD, 100/FD, 10/FD, 10/HD" }, |
| { 0x2c, AA "1000/FD, 100/FD, 100/HD" }, |
| { 0x2d, AA "1000/FD, 100/FD, 100/HD, 10/HD" }, |
| { 0x2e, AA "1000/FD, 100/FD, 100/HD, 10/FD" }, |
| { 0x2f, AA "1000/FD, 100/FD, 100/HD, 10/FD, 10/HD" } |
| }; |
| |
| static const struct pch_gbe_opt_list fc_list[] = { |
| { PCH_GBE_FC_NONE, "Flow Control Disabled" }, |
| { PCH_GBE_FC_RX_PAUSE, "Flow Control Receive Only" }, |
| { PCH_GBE_FC_TX_PAUSE, "Flow Control Transmit Only" }, |
| { PCH_GBE_FC_FULL, "Flow Control Enabled" } |
| }; |
| |
| /** |
| * pch_gbe_validate_option - Validate option |
| * @value: value |
| * @opt: option |
| * @adapter: Board private structure |
| * Returns: |
| * 0: Successful. |
| * Negative value: Failed. |
| */ |
| static int pch_gbe_validate_option(int *value, |
| const struct pch_gbe_option *opt, |
| struct pch_gbe_adapter *adapter) |
| { |
| if (*value == OPTION_UNSET) { |
| *value = opt->def; |
| return 0; |
| } |
| |
| switch (opt->type) { |
| case enable_option: |
| switch (*value) { |
| case OPTION_ENABLED: |
| netdev_dbg(adapter->netdev, "%s Enabled\n", opt->name); |
| return 0; |
| case OPTION_DISABLED: |
| netdev_dbg(adapter->netdev, "%s Disabled\n", opt->name); |
| return 0; |
| } |
| break; |
| case range_option: |
| if (*value >= opt->arg.r.min && *value <= opt->arg.r.max) { |
| netdev_dbg(adapter->netdev, "%s set to %i\n", |
| opt->name, *value); |
| return 0; |
| } |
| break; |
| case list_option: { |
| int i; |
| const struct pch_gbe_opt_list *ent; |
| |
| for (i = 0; i < opt->arg.l.nr; i++) { |
| ent = &opt->arg.l.p[i]; |
| if (*value == ent->i) { |
| if (ent->str[0] != '\0') |
| netdev_dbg(adapter->netdev, "%s\n", |
| ent->str); |
| return 0; |
| } |
| } |
| } |
| break; |
| default: |
| BUG(); |
| } |
| |
| netdev_dbg(adapter->netdev, "Invalid %s value specified (%i) %s\n", |
| opt->name, *value, opt->err); |
| *value = opt->def; |
| return -1; |
| } |
| |
| /** |
| * pch_gbe_check_copper_options - Range Checking for Link Options, Copper Version |
| * @adapter: Board private structure |
| */ |
| static void pch_gbe_check_copper_options(struct pch_gbe_adapter *adapter) |
| { |
| struct pch_gbe_hw *hw = &adapter->hw; |
| int speed, dplx; |
| |
| { /* Speed */ |
| static const struct pch_gbe_option opt = { |
| .type = list_option, |
| .name = "Speed", |
| .err = "parameter ignored", |
| .def = 0, |
| .arg = { .l = { .nr = (int)ARRAY_SIZE(speed_list), |
| .p = speed_list } } |
| }; |
| speed = Speed; |
| pch_gbe_validate_option(&speed, &opt, adapter); |
| } |
| { /* Duplex */ |
| static const struct pch_gbe_option opt = { |
| .type = list_option, |
| .name = "Duplex", |
| .err = "parameter ignored", |
| .def = 0, |
| .arg = { .l = { .nr = (int)ARRAY_SIZE(dplx_list), |
| .p = dplx_list } } |
| }; |
| dplx = Duplex; |
| pch_gbe_validate_option(&dplx, &opt, adapter); |
| } |
| |
| { /* Autoneg */ |
| static const struct pch_gbe_option opt = { |
| .type = list_option, |
| .name = "AutoNeg", |
| .err = "parameter ignored", |
| .def = PCH_AUTONEG_ADVERTISE_DEFAULT, |
| .arg = { .l = { .nr = (int)ARRAY_SIZE(an_list), |
| .p = an_list} } |
| }; |
| if (speed || dplx) { |
| netdev_dbg(adapter->netdev, |
| "AutoNeg specified along with Speed or Duplex, AutoNeg parameter ignored\n"); |
| hw->phy.autoneg_advertised = opt.def; |
| } else { |
| int tmp = AutoNeg; |
| |
| pch_gbe_validate_option(&tmp, &opt, adapter); |
| hw->phy.autoneg_advertised = tmp; |
| } |
| } |
| |
| switch (speed + dplx) { |
| case 0: |
| hw->mac.autoneg = hw->mac.fc_autoneg = 1; |
| if ((speed || dplx)) |
| netdev_dbg(adapter->netdev, |
| "Speed and duplex autonegotiation enabled\n"); |
| hw->mac.link_speed = SPEED_10; |
| hw->mac.link_duplex = DUPLEX_HALF; |
| break; |
| case HALF_DUPLEX: |
| netdev_dbg(adapter->netdev, |
| "Half Duplex specified without Speed\n"); |
| netdev_dbg(adapter->netdev, |
| "Using Autonegotiation at Half Duplex only\n"); |
| hw->mac.autoneg = hw->mac.fc_autoneg = 1; |
| hw->phy.autoneg_advertised = PHY_ADVERTISE_10_HALF | |
| PHY_ADVERTISE_100_HALF; |
| hw->mac.link_speed = SPEED_10; |
| hw->mac.link_duplex = DUPLEX_HALF; |
| break; |
| case FULL_DUPLEX: |
| netdev_dbg(adapter->netdev, |
| "Full Duplex specified without Speed\n"); |
| netdev_dbg(adapter->netdev, |
| "Using Autonegotiation at Full Duplex only\n"); |
| hw->mac.autoneg = hw->mac.fc_autoneg = 1; |
| hw->phy.autoneg_advertised = PHY_ADVERTISE_10_FULL | |
| PHY_ADVERTISE_100_FULL | |
| PHY_ADVERTISE_1000_FULL; |
| hw->mac.link_speed = SPEED_10; |
| hw->mac.link_duplex = DUPLEX_FULL; |
| break; |
| case SPEED_10: |
| netdev_dbg(adapter->netdev, |
| "10 Mbps Speed specified without Duplex\n"); |
| netdev_dbg(adapter->netdev, |
| "Using Autonegotiation at 10 Mbps only\n"); |
| hw->mac.autoneg = hw->mac.fc_autoneg = 1; |
| hw->phy.autoneg_advertised = PHY_ADVERTISE_10_HALF | |
| PHY_ADVERTISE_10_FULL; |
| hw->mac.link_speed = SPEED_10; |
| hw->mac.link_duplex = DUPLEX_HALF; |
| break; |
| case SPEED_10 + HALF_DUPLEX: |
| netdev_dbg(adapter->netdev, "Forcing to 10 Mbps Half Duplex\n"); |
| hw->mac.autoneg = hw->mac.fc_autoneg = 0; |
| hw->phy.autoneg_advertised = 0; |
| hw->mac.link_speed = SPEED_10; |
| hw->mac.link_duplex = DUPLEX_HALF; |
| break; |
| case SPEED_10 + FULL_DUPLEX: |
| netdev_dbg(adapter->netdev, "Forcing to 10 Mbps Full Duplex\n"); |
| hw->mac.autoneg = hw->mac.fc_autoneg = 0; |
| hw->phy.autoneg_advertised = 0; |
| hw->mac.link_speed = SPEED_10; |
| hw->mac.link_duplex = DUPLEX_FULL; |
| break; |
| case SPEED_100: |
| netdev_dbg(adapter->netdev, |
| "100 Mbps Speed specified without Duplex\n"); |
| netdev_dbg(adapter->netdev, |
| "Using Autonegotiation at 100 Mbps only\n"); |
| hw->mac.autoneg = hw->mac.fc_autoneg = 1; |
| hw->phy.autoneg_advertised = PHY_ADVERTISE_100_HALF | |
| PHY_ADVERTISE_100_FULL; |
| hw->mac.link_speed = SPEED_100; |
| hw->mac.link_duplex = DUPLEX_HALF; |
| break; |
| case SPEED_100 + HALF_DUPLEX: |
| netdev_dbg(adapter->netdev, |
| "Forcing to 100 Mbps Half Duplex\n"); |
| hw->mac.autoneg = hw->mac.fc_autoneg = 0; |
| hw->phy.autoneg_advertised = 0; |
| hw->mac.link_speed = SPEED_100; |
| hw->mac.link_duplex = DUPLEX_HALF; |
| break; |
| case SPEED_100 + FULL_DUPLEX: |
| netdev_dbg(adapter->netdev, |
| "Forcing to 100 Mbps Full Duplex\n"); |
| hw->mac.autoneg = hw->mac.fc_autoneg = 0; |
| hw->phy.autoneg_advertised = 0; |
| hw->mac.link_speed = SPEED_100; |
| hw->mac.link_duplex = DUPLEX_FULL; |
| break; |
| case SPEED_1000: |
| netdev_dbg(adapter->netdev, |
| "1000 Mbps Speed specified without Duplex\n"); |
| goto full_duplex_only; |
| case SPEED_1000 + HALF_DUPLEX: |
| netdev_dbg(adapter->netdev, |
| "Half Duplex is not supported at 1000 Mbps\n"); |
| fallthrough; |
| case SPEED_1000 + FULL_DUPLEX: |
| full_duplex_only: |
| netdev_dbg(adapter->netdev, |
| "Using Autonegotiation at 1000 Mbps Full Duplex only\n"); |
| hw->mac.autoneg = hw->mac.fc_autoneg = 1; |
| hw->phy.autoneg_advertised = PHY_ADVERTISE_1000_FULL; |
| hw->mac.link_speed = SPEED_1000; |
| hw->mac.link_duplex = DUPLEX_FULL; |
| break; |
| default: |
| BUG(); |
| } |
| } |
| |
| /** |
| * pch_gbe_check_options - Range Checking for Command Line Parameters |
| * @adapter: Board private structure |
| */ |
| void pch_gbe_check_options(struct pch_gbe_adapter *adapter) |
| { |
| struct pch_gbe_hw *hw = &adapter->hw; |
| struct net_device *dev = adapter->netdev; |
| int val; |
| |
| { /* Transmit Descriptor Count */ |
| static const struct pch_gbe_option opt = { |
| .type = range_option, |
| .name = "Transmit Descriptors", |
| .err = "using default of " |
| __MODULE_STRING(PCH_GBE_DEFAULT_TXD), |
| .def = PCH_GBE_DEFAULT_TXD, |
| .arg = { .r = { .min = PCH_GBE_MIN_TXD, |
| .max = PCH_GBE_MAX_TXD } } |
| }; |
| struct pch_gbe_tx_ring *tx_ring = adapter->tx_ring; |
| tx_ring->count = TxDescriptors; |
| pch_gbe_validate_option(&tx_ring->count, &opt, adapter); |
| tx_ring->count = roundup(tx_ring->count, |
| PCH_GBE_TX_DESC_MULTIPLE); |
| } |
| { /* Receive Descriptor Count */ |
| static const struct pch_gbe_option opt = { |
| .type = range_option, |
| .name = "Receive Descriptors", |
| .err = "using default of " |
| __MODULE_STRING(PCH_GBE_DEFAULT_RXD), |
| .def = PCH_GBE_DEFAULT_RXD, |
| .arg = { .r = { .min = PCH_GBE_MIN_RXD, |
| .max = PCH_GBE_MAX_RXD } } |
| }; |
| struct pch_gbe_rx_ring *rx_ring = adapter->rx_ring; |
| rx_ring->count = RxDescriptors; |
| pch_gbe_validate_option(&rx_ring->count, &opt, adapter); |
| rx_ring->count = roundup(rx_ring->count, |
| PCH_GBE_RX_DESC_MULTIPLE); |
| } |
| { /* Checksum Offload Enable/Disable */ |
| static const struct pch_gbe_option opt = { |
| .type = enable_option, |
| .name = "Checksum Offload", |
| .err = "defaulting to Enabled", |
| .def = PCH_GBE_DEFAULT_RX_CSUM |
| }; |
| val = XsumRX; |
| pch_gbe_validate_option(&val, &opt, adapter); |
| if (!val) |
| dev->features &= ~NETIF_F_RXCSUM; |
| } |
| { /* Checksum Offload Enable/Disable */ |
| static const struct pch_gbe_option opt = { |
| .type = enable_option, |
| .name = "Checksum Offload", |
| .err = "defaulting to Enabled", |
| .def = PCH_GBE_DEFAULT_TX_CSUM |
| }; |
| val = XsumTX; |
| pch_gbe_validate_option(&val, &opt, adapter); |
| if (!val) |
| dev->features &= ~NETIF_F_CSUM_MASK; |
| } |
| { /* Flow Control */ |
| static const struct pch_gbe_option opt = { |
| .type = list_option, |
| .name = "Flow Control", |
| .err = "reading default settings from EEPROM", |
| .def = PCH_GBE_FC_DEFAULT, |
| .arg = { .l = { .nr = (int)ARRAY_SIZE(fc_list), |
| .p = fc_list } } |
| }; |
| int tmp = FlowControl; |
| |
| pch_gbe_validate_option(&tmp, &opt, adapter); |
| hw->mac.fc = tmp; |
| } |
| |
| pch_gbe_check_copper_options(adapter); |
| } |
