root/net/ethtool/cmis_cdb.c
// SPDX-License-Identifier: GPL-2.0-only

#include <linux/ethtool.h>
#include <linux/jiffies.h>

#include "common.h"
#include "module_fw.h"
#include "cmis.h"

/* For accessing the LPL field on page 9Fh, the allowable length extension is
 * min(i, 15) byte octets where i specifies the allowable additional number of
 * byte octets in a READ or a WRITE.
 */
u32 ethtool_cmis_get_max_lpl_size(u8 num_of_byte_octs)
{
        return 8 * (1 + min_t(u8, num_of_byte_octs, 15));
}

void ethtool_cmis_cdb_compose_args(struct ethtool_cmis_cdb_cmd_args *args,
                                   enum ethtool_cmis_cdb_cmd_id cmd, u8 *lpl,
                                   u8 lpl_len, u8 *epl, u16 epl_len,
                                   u16 max_duration, u8 read_write_len_ext,
                                   u16 msleep_pre_rpl, u8 rpl_exp_len, u8 flags)
{
        args->req.id = cpu_to_be16(cmd);
        args->req.lpl_len = lpl_len;
        if (lpl)
                memcpy(args->req.payload, lpl, args->req.lpl_len);
        if (epl) {
                args->req.epl_len = cpu_to_be16(epl_len);
                args->req.epl = epl;
        }

        args->max_duration = max_duration;
        args->read_write_len_ext =
                ethtool_cmis_get_max_lpl_size(read_write_len_ext);
        args->msleep_pre_rpl = msleep_pre_rpl;
        args->rpl_exp_len = rpl_exp_len;
        args->flags = flags;
        args->err_msg = NULL;
}

void ethtool_cmis_page_init(struct ethtool_module_eeprom *page_data,
                            u8 page, u32 offset, u32 length)
{
        page_data->page = page;
        page_data->offset = offset;
        page_data->length = length;
        page_data->i2c_address = ETHTOOL_CMIS_CDB_PAGE_I2C_ADDR;
}

#define CMIS_REVISION_PAGE      0x00
#define CMIS_REVISION_OFFSET    0x01

struct cmis_rev_rpl {
        u8 rev;
};

static u8 cmis_rev_rpl_major(struct cmis_rev_rpl *rpl)
{
        return rpl->rev >> 4;
}

static int cmis_rev_major_get(struct net_device *dev, u8 *rev_major)
{
        const struct ethtool_ops *ops = dev->ethtool_ops;
        struct ethtool_module_eeprom page_data = {0};
        struct netlink_ext_ack extack = {};
        struct cmis_rev_rpl rpl = {};
        int err;

        ethtool_cmis_page_init(&page_data, CMIS_REVISION_PAGE,
                               CMIS_REVISION_OFFSET, sizeof(rpl));
        page_data.data = (u8 *)&rpl;

        err = ops->get_module_eeprom_by_page(dev, &page_data, &extack);
        if (err < 0) {
                if (extack._msg)
                        netdev_err(dev, "%s\n", extack._msg);
                return err;
        }

        *rev_major = cmis_rev_rpl_major(&rpl);

        return 0;
}

#define CMIS_CDB_ADVERTISEMENT_PAGE     0x01
#define CMIS_CDB_ADVERTISEMENT_OFFSET   0xA3

/* Based on section 8.4.11 "CDB Messaging Support Advertisement" in CMIS
 * standard revision 5.2.
 */
struct cmis_cdb_advert_rpl {
        u8      inst_supported;
        u8      read_write_len_ext;
        u8      resv1;
        u8      resv2;
};

static u8 cmis_cdb_advert_rpl_inst_supported(struct cmis_cdb_advert_rpl *rpl)
{
        return rpl->inst_supported >> 6;
}

static int cmis_cdb_advertisement_get(struct ethtool_cmis_cdb *cdb,
                                      struct net_device *dev,
                                      struct ethnl_module_fw_flash_ntf_params *ntf_params)
{
        const struct ethtool_ops *ops = dev->ethtool_ops;
        struct ethtool_module_eeprom page_data = {};
        struct cmis_cdb_advert_rpl rpl = {};
        struct netlink_ext_ack extack = {};
        int err;

        ethtool_cmis_page_init(&page_data, CMIS_CDB_ADVERTISEMENT_PAGE,
                               CMIS_CDB_ADVERTISEMENT_OFFSET, sizeof(rpl));
        page_data.data = (u8 *)&rpl;

        err = ops->get_module_eeprom_by_page(dev, &page_data, &extack);
        if (err < 0) {
                if (extack._msg)
                        netdev_err(dev, "%s\n", extack._msg);
                return err;
        }

        if (!cmis_cdb_advert_rpl_inst_supported(&rpl)) {
                ethnl_module_fw_flash_ntf_err(dev, ntf_params,
                                              "CDB functionality is not supported",
                                              NULL);
                return -EOPNOTSUPP;
        }

        cdb->read_write_len_ext = rpl.read_write_len_ext;

        return 0;
}

#define CMIS_PASSWORD_ENTRY_PAGE        0x00
#define CMIS_PASSWORD_ENTRY_OFFSET      0x7A

struct cmis_password_entry_pl {
        __be32 password;
};

/* See section 9.3.1 "CMD 0000h: Query Status" in CMIS standard revision 5.2.
 * struct cmis_cdb_query_status_pl and struct cmis_cdb_query_status_rpl are
 * structured layouts of the flat arrays,
 * struct ethtool_cmis_cdb_request::payload and
 * struct ethtool_cmis_cdb_rpl::payload respectively.
 */
struct cmis_cdb_query_status_pl {
        u16 response_delay;
};

struct cmis_cdb_query_status_rpl {
        u8 length;
        u8 status;
};

static int
cmis_cdb_validate_password(struct ethtool_cmis_cdb *cdb,
                           struct net_device *dev,
                           const struct ethtool_module_fw_flash_params *params,
                           struct ethnl_module_fw_flash_ntf_params *ntf_params)
{
        const struct ethtool_ops *ops = dev->ethtool_ops;
        struct cmis_cdb_query_status_pl qs_pl = {0};
        struct ethtool_module_eeprom page_data = {};
        struct ethtool_cmis_cdb_cmd_args args = {};
        struct cmis_password_entry_pl pe_pl = {};
        struct cmis_cdb_query_status_rpl *rpl;
        struct netlink_ext_ack extack = {};
        int err;

        ethtool_cmis_page_init(&page_data, CMIS_PASSWORD_ENTRY_PAGE,
                               CMIS_PASSWORD_ENTRY_OFFSET, sizeof(pe_pl));
        page_data.data = (u8 *)&pe_pl;

        pe_pl = *((struct cmis_password_entry_pl *)page_data.data);
        pe_pl.password = params->password;
        err = ops->set_module_eeprom_by_page(dev, &page_data, &extack);
        if (err < 0) {
                if (extack._msg)
                        netdev_err(dev, "%s\n", extack._msg);
                return err;
        }

        ethtool_cmis_cdb_compose_args(&args, ETHTOOL_CMIS_CDB_CMD_QUERY_STATUS,
                                      (u8 *)&qs_pl, sizeof(qs_pl), NULL, 0, 0,
                                      cdb->read_write_len_ext, 1000,
                                      sizeof(*rpl),
                                      CDB_F_COMPLETION_VALID | CDB_F_STATUS_VALID);

        err = ethtool_cmis_cdb_execute_cmd(dev, &args);
        if (err < 0) {
                ethnl_module_fw_flash_ntf_err(dev, ntf_params,
                                              "Query Status command failed",
                                              args.err_msg);
                return err;
        }

        rpl = (struct cmis_cdb_query_status_rpl *)args.req.payload;
        if (!rpl->length || !rpl->status) {
                ethnl_module_fw_flash_ntf_err(dev, ntf_params,
                                              "Password was not accepted",
                                              NULL);
                return -EINVAL;
        }

        return 0;
}

/* Some CDB commands asserts the CDB completion flag only from CMIS
 * revision 5. Therefore, check the relevant validity flag only when
 * the revision supports it.
 */
void ethtool_cmis_cdb_check_completion_flag(u8 cmis_rev, u8 *flags)
{
        *flags |= cmis_rev >= 5 ? CDB_F_COMPLETION_VALID : 0;
}

#define CMIS_CDB_MODULE_FEATURES_RESV_DATA      34

/* See section 9.4.1 "CMD 0040h: Module Features" in CMIS standard revision 5.2.
 * struct cmis_cdb_module_features_rpl is structured layout of the flat
 * array, ethtool_cmis_cdb_rpl::payload.
 */
struct cmis_cdb_module_features_rpl {
        u8      resv1[CMIS_CDB_MODULE_FEATURES_RESV_DATA];
        __be16  max_completion_time;
};

static u16
cmis_cdb_module_features_completion_time(struct cmis_cdb_module_features_rpl *rpl)
{
        return be16_to_cpu(rpl->max_completion_time);
}

static int cmis_cdb_module_features_get(struct ethtool_cmis_cdb *cdb,
                                        struct net_device *dev,
                                        struct ethnl_module_fw_flash_ntf_params *ntf_params)
{
        struct ethtool_cmis_cdb_cmd_args args = {};
        struct cmis_cdb_module_features_rpl *rpl;
        u8 flags = CDB_F_STATUS_VALID;
        int err;

        ethtool_cmis_cdb_check_completion_flag(cdb->cmis_rev, &flags);
        ethtool_cmis_cdb_compose_args(&args,
                                      ETHTOOL_CMIS_CDB_CMD_MODULE_FEATURES,
                                      NULL, 0, NULL, 0, 0,
                                      cdb->read_write_len_ext, 1000,
                                      sizeof(*rpl), flags);

        err = ethtool_cmis_cdb_execute_cmd(dev, &args);
        if (err < 0) {
                ethnl_module_fw_flash_ntf_err(dev, ntf_params,
                                              "Module Features command failed",
                                              args.err_msg);
                return err;
        }

        rpl = (struct cmis_cdb_module_features_rpl *)args.req.payload;
        cdb->max_completion_time =
                cmis_cdb_module_features_completion_time(rpl);

        return 0;
}

struct ethtool_cmis_cdb *
ethtool_cmis_cdb_init(struct net_device *dev,
                      const struct ethtool_module_fw_flash_params *params,
                      struct ethnl_module_fw_flash_ntf_params *ntf_params)
{
        struct ethtool_cmis_cdb *cdb;
        int err;

        cdb = kzalloc_obj(*cdb);
        if (!cdb)
                return ERR_PTR(-ENOMEM);

        err = cmis_rev_major_get(dev, &cdb->cmis_rev);
        if (err < 0)
                goto err;

        if (cdb->cmis_rev < 4) {
                ethnl_module_fw_flash_ntf_err(dev, ntf_params,
                                              "CMIS revision doesn't support module firmware flashing",
                                              NULL);
                err = -EOPNOTSUPP;
                goto err;
        }

        err = cmis_cdb_advertisement_get(cdb, dev, ntf_params);
        if (err < 0)
                goto err;

        if (params->password_valid) {
                err = cmis_cdb_validate_password(cdb, dev, params, ntf_params);
                if (err < 0)
                        goto err;
        }

        err = cmis_cdb_module_features_get(cdb, dev, ntf_params);
        if (err < 0)
                goto err;

        return cdb;

err:
        ethtool_cmis_cdb_fini(cdb);
        return ERR_PTR(err);
}

void ethtool_cmis_cdb_fini(struct ethtool_cmis_cdb *cdb)
{
        kfree(cdb);
}

static bool is_completed(u8 data)
{
        return !!(data & 0x40);
}

#define CMIS_CDB_STATUS_SUCCESS 0x01

static bool status_success(u8 data)
{
        return data == CMIS_CDB_STATUS_SUCCESS;
}

#define CMIS_CDB_STATUS_FAIL    0x40

static bool status_fail(u8 data)
{
        return data & CMIS_CDB_STATUS_FAIL;
}

struct cmis_wait_for_cond_rpl {
        u8 state;
};

static int
ethtool_cmis_module_poll(struct net_device *dev,
                         struct cmis_wait_for_cond_rpl *rpl, u32 offset,
                         bool (*cond_success)(u8), bool (*cond_fail)(u8))
{
        const struct ethtool_ops *ops = dev->ethtool_ops;
        struct ethtool_module_eeprom page_data = {0};
        struct netlink_ext_ack extack = {};
        int err;

        ethtool_cmis_page_init(&page_data, 0, offset, sizeof(*rpl));
        page_data.data = (u8 *)rpl;

        err = ops->get_module_eeprom_by_page(dev, &page_data, &extack);
        if (err < 0) {
                if (extack._msg)
                        netdev_err_once(dev, "%s\n", extack._msg);
                return -EBUSY;
        }

        if ((*cond_success)(rpl->state))
                return 0;

        if (*cond_fail && (*cond_fail)(rpl->state))
                return -EIO;

        return -EBUSY;
}

int ethtool_cmis_wait_for_cond(struct net_device *dev, u8 flags, u8 flag,
                               u16 max_duration, u32 offset,
                               bool (*cond_success)(u8), bool (*cond_fail)(u8),
                               u8 *state)
{
        struct cmis_wait_for_cond_rpl rpl = {};
        unsigned long end;
        int err;

        if (!(flags & flag))
                return 0;

        if (max_duration == 0)
                max_duration = U16_MAX;

        end = jiffies + msecs_to_jiffies(max_duration);
        do {
                err = ethtool_cmis_module_poll(dev, &rpl, offset, cond_success,
                                               cond_fail);
                if (err != -EBUSY)
                        goto out;

                msleep(20);
        } while (time_before(jiffies, end));

        err = ethtool_cmis_module_poll(dev, &rpl, offset, cond_success,
                                       cond_fail);
        if (err == -EBUSY)
                err = -ETIMEDOUT;

out:
        *state = rpl.state;
        return err;
}

#define CMIS_CDB_COMPLETION_FLAG_OFFSET 0x08

static int cmis_cdb_wait_for_completion(struct net_device *dev,
                                        struct ethtool_cmis_cdb_cmd_args *args)
{
        u8 flag;
        int err;

        /* Some vendors demand waiting time before checking completion flag
         * in some CDB commands.
         */
        msleep(args->msleep_pre_rpl);

        err = ethtool_cmis_wait_for_cond(dev, args->flags,
                                         CDB_F_COMPLETION_VALID,
                                         args->max_duration,
                                         CMIS_CDB_COMPLETION_FLAG_OFFSET,
                                         is_completed, NULL, &flag);
        if (err < 0)
                args->err_msg = "Completion Flag did not set on time";

        return err;
}

#define CMIS_CDB_STATUS_OFFSET  0x25

static void cmis_cdb_status_fail_msg_get(u8 status, char **err_msg)
{
        switch (status) {
        case 0b10000001:
                *err_msg = "CDB Status is in progress: Busy capturing command";
                break;
        case 0b10000010:
                *err_msg =
                        "CDB Status is in progress: Busy checking/validating command";
                break;
        case 0b10000011:
                *err_msg = "CDB Status is in progress: Busy executing";
                break;
        case 0b01000000:
                *err_msg = "CDB status failed: no specific failure";
                break;
        case 0b01000010:
                *err_msg =
                        "CDB status failed: Parameter range error or parameter not supported";
                break;
        case 0b01000101:
                *err_msg = "CDB status failed: CdbChkCode error";
                break;
        case 0b01000110:
                *err_msg = "CDB status failed: Password error";
                break;
        default:
                *err_msg = "Unknown failure reason";
        }
};

static int cmis_cdb_wait_for_status(struct net_device *dev,
                                    struct ethtool_cmis_cdb_cmd_args *args)
{
        u8 status;
        int err;

        /* Some vendors demand waiting time before checking status in some
         * CDB commands.
         */
        msleep(args->msleep_pre_rpl);

        err = ethtool_cmis_wait_for_cond(dev, args->flags, CDB_F_STATUS_VALID,
                                         args->max_duration,
                                         CMIS_CDB_STATUS_OFFSET,
                                         status_success, status_fail, &status);
        if (err < 0 && !args->err_msg)
                cmis_cdb_status_fail_msg_get(status, &args->err_msg);

        return err;
}

#define CMIS_CDB_REPLY_OFFSET   0x86

static int cmis_cdb_process_reply(struct net_device *dev,
                                  struct ethtool_module_eeprom *page_data,
                                  struct ethtool_cmis_cdb_cmd_args *args)
{
        u8 rpl_hdr_len = sizeof(struct ethtool_cmis_cdb_rpl_hdr);
        u8 rpl_exp_len = args->rpl_exp_len + rpl_hdr_len;
        const struct ethtool_ops *ops = dev->ethtool_ops;
        struct netlink_ext_ack extack = {};
        struct ethtool_cmis_cdb_rpl *rpl;
        int err;

        if (!args->rpl_exp_len)
                return 0;

        ethtool_cmis_page_init(page_data, ETHTOOL_CMIS_CDB_CMD_PAGE,
                               CMIS_CDB_REPLY_OFFSET, rpl_exp_len);
        page_data->data = kmalloc(page_data->length, GFP_KERNEL);
        if (!page_data->data)
                return -ENOMEM;

        err = ops->get_module_eeprom_by_page(dev, page_data, &extack);
        if (err < 0) {
                if (extack._msg)
                        netdev_err(dev, "%s\n", extack._msg);
                goto out;
        }

        rpl = (struct ethtool_cmis_cdb_rpl *)page_data->data;
        if ((args->rpl_exp_len > rpl->hdr.rpl_len + rpl_hdr_len) ||
            !rpl->hdr.rpl_chk_code) {
                err = -EIO;
                goto out;
        }

        args->req.lpl_len = rpl->hdr.rpl_len;
        memcpy(args->req.payload, rpl->payload, args->req.lpl_len);

out:
        kfree(page_data->data);
        return err;
}

static int
__ethtool_cmis_cdb_execute_cmd(struct net_device *dev,
                               struct ethtool_module_eeprom *page_data,
                               u8 page, u32 offset, u32 length, void *data)
{
        const struct ethtool_ops *ops = dev->ethtool_ops;
        struct netlink_ext_ack extack = {};
        int err;

        ethtool_cmis_page_init(page_data, page, offset, length);
        page_data->data = kmemdup(data, page_data->length, GFP_KERNEL);
        if (!page_data->data)
                return -ENOMEM;

        err = ops->set_module_eeprom_by_page(dev, page_data, &extack);
        if (err < 0) {
                if (extack._msg)
                        netdev_err(dev, "%s\n", extack._msg);
        }

        kfree(page_data->data);
        return err;
}

#define CMIS_CDB_EPL_PAGE_START                 0xA0
#define CMIS_CDB_EPL_PAGE_END                   0xAF
#define CMIS_CDB_EPL_FW_BLOCK_OFFSET_START      128
#define CMIS_CDB_EPL_FW_BLOCK_OFFSET_END        255

static int
ethtool_cmis_cdb_execute_epl_cmd(struct net_device *dev,
                                 struct ethtool_cmis_cdb_cmd_args *args,
                                 struct ethtool_module_eeprom *page_data)
{
        u16 epl_len = be16_to_cpu(args->req.epl_len);
        u32 bytes_written = 0;
        u8 page;
        int err;

        for (page = CMIS_CDB_EPL_PAGE_START;
             page <= CMIS_CDB_EPL_PAGE_END && bytes_written < epl_len; page++) {
                u16 offset = CMIS_CDB_EPL_FW_BLOCK_OFFSET_START;

                while (offset <= CMIS_CDB_EPL_FW_BLOCK_OFFSET_END &&
                       bytes_written < epl_len) {
                        u32 bytes_left = epl_len - bytes_written;
                        u16 space_left, bytes_to_write;

                        space_left = CMIS_CDB_EPL_FW_BLOCK_OFFSET_END - offset + 1;
                        bytes_to_write = min_t(u16, bytes_left,
                                               min_t(u16, space_left,
                                                     args->read_write_len_ext));

                        err = __ethtool_cmis_cdb_execute_cmd(dev, page_data,
                                                             page, offset,
                                                             bytes_to_write,
                                                             args->req.epl + bytes_written);
                        if (err < 0)
                                return err;

                        offset += bytes_to_write;
                        bytes_written += bytes_to_write;
                }
        }
        return 0;
}

static u8 cmis_cdb_calc_checksum(const void *data, size_t size)
{
        const u8 *bytes = (const u8 *)data;
        u8 checksum = 0;

        for (size_t i = 0; i < size; i++)
                checksum += bytes[i];

        return ~checksum;
}

#define CMIS_CDB_CMD_ID_OFFSET  0x80

int ethtool_cmis_cdb_execute_cmd(struct net_device *dev,
                                 struct ethtool_cmis_cdb_cmd_args *args)
{
        struct ethtool_module_eeprom page_data = {};
        u32 offset;
        int err;

        args->req.chk_code =
                cmis_cdb_calc_checksum(&args->req,
                                       offsetof(struct ethtool_cmis_cdb_request,
                                                epl));

        if (args->req.lpl_len > args->read_write_len_ext) {
                args->err_msg = "LPL length is longer than CDB read write length extension allows";
                return -EINVAL;
        }

        /* According to the CMIS standard, there are two options to trigger the
         * CDB commands. The default option is triggering the command by writing
         * the CMDID bytes. Therefore, the command will be split to 2 calls:
         * First, with everything except the CMDID field and then the CMDID
         * field.
         */
        offset = CMIS_CDB_CMD_ID_OFFSET +
                offsetof(struct ethtool_cmis_cdb_request, body);
        err = __ethtool_cmis_cdb_execute_cmd(dev, &page_data,
                                             ETHTOOL_CMIS_CDB_CMD_PAGE, offset,
                                             sizeof(args->req.body),
                                             &args->req.body);
        if (err < 0)
                return err;

        if (args->req.epl_len) {
                err = ethtool_cmis_cdb_execute_epl_cmd(dev, args, &page_data);
                if (err < 0)
                        return err;
        }

        offset = CMIS_CDB_CMD_ID_OFFSET +
                offsetof(struct ethtool_cmis_cdb_request, id);
        err = __ethtool_cmis_cdb_execute_cmd(dev, &page_data,
                                             ETHTOOL_CMIS_CDB_CMD_PAGE, offset,
                                             sizeof(args->req.id),
                                             &args->req.id);
        if (err < 0)
                return err;

        err = cmis_cdb_wait_for_completion(dev, args);
        if (err < 0)
                return err;

        err = cmis_cdb_wait_for_status(dev, args);
        if (err < 0)
                return err;

        return cmis_cdb_process_reply(dev, &page_data, args);
}