// SPDX-License-Identifier: GPL-2.0-only
/*
* hid - ft260 . c - FTDI FT260 USB HID to I2C host bridge
*
* Copyright ( c ) 2021 , Michael Zaidman < michaelz @ xsightlabs . com >
*
* Data Sheet :
* https : //www.ftdichip.com/Support/Documents/DataSheets/ICs/DS_FT260.pdf
*/
#include "hid-ids.h"
#include <linux/hidraw.h>
#include <linux/i2c.h>
#include <linux/module.h>
#include <linux/usb.h>
#ifdef DEBUG
static int ft260_debug = 1 ;
#else
static int ft260_debug;
#endif
module_param_named(debug, ft260_debug, int , 0600 );
MODULE_PARM_DESC(debug, "Toggle FT260 debugging messages" );
#define ft260_dbg(format, arg...) \
do { \
if (ft260_debug) \
pr_info("%s: " format, __func__, ## arg); \
} while (0 )
#define FT260_REPORT_MAX_LENGTH (64 )
#define FT260_I2C_DATA_REPORT_ID(len) (FT260_I2C_REPORT_MIN + (len - 1 ) / 4 )
#define FT260_WAKEUP_NEEDED_AFTER_MS (4800 ) /* 5s minus 200ms margin */
/*
* The ft260 input report format defines 62 bytes for the data payload , but
* when requested 62 bytes , the controller returns 60 and 2 in separate input
* reports . To achieve better performance with the multi - report read data
* transfers , we set the maximum read payload length to a multiple of 60 .
* With a 100 kHz I2C clock , one 240 bytes read takes about 1 / 27 second ,
* which is excessive ; On the other hand , some higher layer drivers like at24
* or optoe limit the i2c reads to 128 bytes . To not block other drivers out
* of I2C for potentially troublesome amounts of time , we select the maximum
* read payload length to be 180 bytes .
*/
#define FT260_RD_DATA_MAX (180 )
#define FT260_WR_DATA_MAX (60 )
/*
* Device interface configuration .
* The FT260 has 2 interfaces that are controlled by DCNF0 and DCNF1 pins .
* First implementes USB HID to I2C bridge function and
* second - USB HID to UART bridge function .
*/
enum {
FT260_MODE_ALL = 0 x00,
FT260_MODE_I2C = 0 x01,
FT260_MODE_UART = 0 x02,
FT260_MODE_BOTH = 0 x03,
};
/* Control pipe */
enum {
FT260_GET_RQST_TYPE = 0 xA1,
FT260_GET_REPORT = 0 x01,
FT260_SET_RQST_TYPE = 0 x21,
FT260_SET_REPORT = 0 x09,
FT260_FEATURE = 0 x03,
};
/* Report IDs / Feature In */
enum {
FT260_CHIP_VERSION = 0 xA0,
FT260_SYSTEM_SETTINGS = 0 xA1,
FT260_I2C_STATUS = 0 xC0,
FT260_I2C_READ_REQ = 0 xC2,
FT260_I2C_REPORT_MIN = 0 xD0,
FT260_I2C_REPORT_MAX = 0 xDE,
FT260_GPIO = 0 xB0,
FT260_UART_INTERRUPT_STATUS = 0 xB1,
FT260_UART_STATUS = 0 xE0,
FT260_UART_RI_DCD_STATUS = 0 xE1,
FT260_UART_REPORT = 0 xF0,
};
/* Feature Out */
enum {
FT260_SET_CLOCK = 0 x01,
FT260_SET_I2C_MODE = 0 x02,
FT260_SET_UART_MODE = 0 x03,
FT260_ENABLE_INTERRUPT = 0 x05,
FT260_SELECT_GPIO2_FUNC = 0 x06,
FT260_ENABLE_UART_DCD_RI = 0 x07,
FT260_SELECT_GPIOA_FUNC = 0 x08,
FT260_SELECT_GPIOG_FUNC = 0 x09,
FT260_SET_INTERRUPT_TRIGGER = 0 x0A,
FT260_SET_SUSPEND_OUT_POLAR = 0 x0B,
FT260_ENABLE_UART_RI_WAKEUP = 0 x0C,
FT260_SET_UART_RI_WAKEUP_CFG = 0 x0D,
FT260_SET_I2C_RESET = 0 x20,
FT260_SET_I2C_CLOCK_SPEED = 0 x22,
FT260_SET_UART_RESET = 0 x40,
FT260_SET_UART_CONFIG = 0 x41,
FT260_SET_UART_BAUD_RATE = 0 x42,
FT260_SET_UART_DATA_BIT = 0 x43,
FT260_SET_UART_PARITY = 0 x44,
FT260_SET_UART_STOP_BIT = 0 x45,
FT260_SET_UART_BREAKING = 0 x46,
FT260_SET_UART_XON_XOFF = 0 x49,
};
/* Response codes in I2C status report */
enum {
FT260_I2C_STATUS_SUCCESS = 0 x00,
FT260_I2C_STATUS_CTRL_BUSY = 0 x01,
FT260_I2C_STATUS_ERROR = 0 x02,
FT260_I2C_STATUS_ADDR_NO_ACK = 0 x04,
FT260_I2C_STATUS_DATA_NO_ACK = 0 x08,
FT260_I2C_STATUS_ARBITR_LOST = 0 x10,
FT260_I2C_STATUS_CTRL_IDLE = 0 x20,
FT260_I2C_STATUS_BUS_BUSY = 0 x40,
};
/* I2C Conditions flags */
enum {
FT260_FLAG_NONE = 0 x00,
FT260_FLAG_START = 0 x02,
FT260_FLAG_START_REPEATED = 0 x03,
FT260_FLAG_STOP = 0 x04,
FT260_FLAG_START_STOP = 0 x06,
FT260_FLAG_START_STOP_REPEATED = 0 x07,
};
#define FT260_SET_REQUEST_VALUE(report_id) ((FT260_FEATURE << 8 ) | report_id)
/* Feature In reports */
struct ft260_get_chip_version_report {
u8 report; /* FT260_CHIP_VERSION */
u8 chip_code[4 ]; /* FTDI chip identification code */
u8 reserved[8 ];
} __packed;
struct ft260_get_system_status_report {
u8 report; /* FT260_SYSTEM_SETTINGS */
u8 chip_mode; /* DCNF0 and DCNF1 status, bits 0-1 */
u8 clock_ctl; /* 0 - 12MHz, 1 - 24MHz, 2 - 48MHz */
u8 suspend_status; /* 0 - not suspended, 1 - suspended */
u8 pwren_status; /* 0 - FT260 is not ready, 1 - ready */
u8 i2c_enable; /* 0 - disabled, 1 - enabled */
u8 uart_mode; /* 0 - OFF; 1 - RTS_CTS, 2 - DTR_DSR, */
/* 3 - XON_XOFF, 4 - No flow control */
u8 hid_over_i2c_en; /* 0 - disabled, 1 - enabled */
u8 gpio2_function; /* 0 - GPIO, 1 - SUSPOUT, */
/* 2 - PWREN, 4 - TX_LED */
u8 gpioA_function; /* 0 - GPIO, 3 - TX_ACTIVE, 4 - TX_LED */
u8 gpioG_function; /* 0 - GPIO, 2 - PWREN, */
/* 5 - RX_LED, 6 - BCD_DET */
u8 suspend_out_pol; /* 0 - active-high, 1 - active-low */
u8 enable_wakeup_int; /* 0 - disabled, 1 - enabled */
u8 intr_cond; /* Interrupt trigger conditions */
u8 power_saving_en; /* 0 - disabled, 1 - enabled */
u8 reserved[10 ];
} __packed;
struct ft260_get_i2c_status_report {
u8 report; /* FT260_I2C_STATUS */
u8 bus_status; /* I2C bus status */
__le16 clock; /* I2C bus clock in range 60-3400 KHz */
u8 reserved;
} __packed;
/* Feature Out reports */
struct ft260_set_system_clock_report {
u8 report; /* FT260_SYSTEM_SETTINGS */
u8 request; /* FT260_SET_CLOCK */
u8 clock_ctl; /* 0 - 12MHz, 1 - 24MHz, 2 - 48MHz */
} __packed;
struct ft260_set_i2c_mode_report {
u8 report; /* FT260_SYSTEM_SETTINGS */
u8 request; /* FT260_SET_I2C_MODE */
u8 i2c_enable; /* 0 - disabled, 1 - enabled */
} __packed;
struct ft260_set_uart_mode_report {
u8 report; /* FT260_SYSTEM_SETTINGS */
u8 request; /* FT260_SET_UART_MODE */
u8 uart_mode; /* 0 - OFF; 1 - RTS_CTS, 2 - DTR_DSR, */
/* 3 - XON_XOFF, 4 - No flow control */
} __packed;
struct ft260_set_i2c_reset_report {
u8 report; /* FT260_SYSTEM_SETTINGS */
u8 request; /* FT260_SET_I2C_RESET */
} __packed;
struct ft260_set_i2c_speed_report {
u8 report; /* FT260_SYSTEM_SETTINGS */
u8 request; /* FT260_SET_I2C_CLOCK_SPEED */
__le16 clock; /* I2C bus clock in range 60-3400 KHz */
} __packed;
/* Data transfer reports */
struct ft260_i2c_write_request_report {
u8 report; /* FT260_I2C_REPORT */
u8 address; /* 7-bit I2C address */
u8 flag; /* I2C transaction condition */
u8 length; /* data payload length */
u8 data[FT260_WR_DATA_MAX]; /* data payload */
} __packed;
struct ft260_i2c_read_request_report {
u8 report; /* FT260_I2C_READ_REQ */
u8 address; /* 7-bit I2C address */
u8 flag; /* I2C transaction condition */
__le16 length; /* data payload length */
} __packed;
struct ft260_i2c_input_report {
u8 report; /* FT260_I2C_REPORT */
u8 length; /* data payload length */
u8 data[2 ]; /* data payload */
} __packed;
static const struct hid_device_id ft260_devices[] = {
{ HID_USB_DEVICE(USB_VENDOR_ID_FUTURE_TECHNOLOGY,
USB_DEVICE_ID_FT260) },
{ /* END OF LIST */ }
};
MODULE_DEVICE_TABLE(hid, ft260_devices);
struct ft260_device {
struct i2c_adapter adap;
struct hid_device *hdev;
struct completion wait;
struct mutex lock;
u8 write_buf[FT260_REPORT_MAX_LENGTH];
unsigned long need_wakeup_at;
u8 *read_buf;
u16 read_idx;
u16 read_len;
u16 clock;
};
static int ft260_hid_feature_report_get(struct hid_device *hdev,
unsigned char report_id, u8 *data,
size_t len)
{
u8 *buf;
int ret;
buf = kmalloc(len, GFP_KERNEL);
if (!buf)
return -ENOMEM;
ret = hid_hw_raw_request(hdev, report_id, buf, len, HID_FEATURE_REPORT,
HID_REQ_GET_REPORT);
if (likely(ret == len))
memcpy(data, buf, len);
else if (ret >= 0 )
ret = -EIO;
kfree(buf);
return ret;
}
static int ft260_hid_feature_report_set(struct hid_device *hdev, u8 *data,
size_t len)
{
u8 *buf;
int ret;
buf = kmemdup(data, len, GFP_KERNEL);
if (!buf)
return -ENOMEM;
buf[0 ] = FT260_SYSTEM_SETTINGS;
ret = hid_hw_raw_request(hdev, buf[0 ], buf, len, HID_FEATURE_REPORT,
HID_REQ_SET_REPORT);
kfree(buf);
return ret;
}
static int ft260_i2c_reset(struct hid_device *hdev)
{
struct ft260_set_i2c_reset_report report;
int ret;
report.request = FT260_SET_I2C_RESET;
ret = ft260_hid_feature_report_set(hdev, (u8 *)&report, sizeof (report));
if (ret < 0 ) {
hid_err(hdev, "failed to reset I2C controller: %d\n" , ret);
return ret;
}
ft260_dbg("done\n" );
return ret;
}
static int ft260_xfer_status(struct ft260_device *dev, u8 bus_busy)
{
struct hid_device *hdev = dev->hdev;
struct ft260_get_i2c_status_report report;
int ret;
if (time_is_before_jiffies(dev->need_wakeup_at)) {
ret = ft260_hid_feature_report_get(hdev, FT260_I2C_STATUS,
(u8 *)&report, sizeof (report));
if (unlikely(ret < 0 )) {
hid_err(hdev, "failed to retrieve status: %d, no wakeup\n" ,
ret);
} else {
dev->need_wakeup_at = jiffies +
msecs_to_jiffies(FT260_WAKEUP_NEEDED_AFTER_MS);
ft260_dbg("bus_status %#02x, wakeup\n" ,
report.bus_status);
}
}
ret = ft260_hid_feature_report_get(hdev, FT260_I2C_STATUS,
(u8 *)&report, sizeof (report));
if (unlikely(ret < 0 )) {
hid_err(hdev, "failed to retrieve status: %d\n" , ret);
return ret;
}
dev->clock = le16_to_cpu(report.clock);
ft260_dbg("bus_status %#02x, clock %u\n" , report.bus_status,
dev->clock);
if (report.bus_status & (FT260_I2C_STATUS_CTRL_BUSY | bus_busy))
return -EAGAIN;
/*
* The error condition ( bit 1 ) is a status bit reflecting any
* error conditions . When any of the bits 2 , 3 , or 4 are raised
* to 1 , bit 1 is also set to 1 .
*/
if (report.bus_status & FT260_I2C_STATUS_ERROR) {
hid_err(hdev, "i2c bus error: %#02x\n" , report.bus_status);
return -EIO;
}
return 0 ;
}
static int ft260_hid_output_report(struct hid_device *hdev, u8 *data,
size_t len)
{
u8 *buf;
int ret;
buf = kmemdup(data, len, GFP_KERNEL);
if (!buf)
return -ENOMEM;
ret = hid_hw_output_report(hdev, buf, len);
kfree(buf);
return ret;
}
static int ft260_hid_output_report_check_status(struct ft260_device *dev,
u8 *data, int len)
{
u8 bus_busy;
int ret, usec, try = 100 ;
struct hid_device *hdev = dev->hdev;
struct ft260_i2c_write_request_report *rep =
(struct ft260_i2c_write_request_report *)data;
ret = ft260_hid_output_report(hdev, data, len);
if (ret < 0 ) {
hid_err(hdev, "%s: failed to start transfer, ret %d\n" ,
__func__, ret);
ft260_i2c_reset(hdev);
return ret;
}
/* transfer time = 1 / clock(KHz) * 9 bits * bytes */
usec = len * 9000 / dev->clock;
if (usec > 2000 ) {
usec -= 1500 ;
usleep_range(usec, usec + 100 );
ft260_dbg("wait %d usec, len %d\n" , usec, len);
}
/*
* Do not check the busy bit for combined transactions
* since the controller keeps the bus busy between writing
* and reading IOs to ensure an atomic operation .
*/
if (rep->flag == FT260_FLAG_START)
bus_busy = 0 ;
else
bus_busy = FT260_I2C_STATUS_BUS_BUSY;
do {
ret = ft260_xfer_status(dev, bus_busy);
if (ret != -EAGAIN)
break ;
} while (--try );
if (ret == 0 )
return 0 ;
ft260_i2c_reset(hdev);
return -EIO;
}
static int ft260_i2c_write(struct ft260_device *dev, u8 addr, u8 *data,
int len, u8 flag)
{
int ret, wr_len, idx = 0 ;
struct hid_device *hdev = dev->hdev;
struct ft260_i2c_write_request_report *rep =
(struct ft260_i2c_write_request_report *)dev->write_buf;
if (len < 1 )
return -EINVAL;
rep->flag = FT260_FLAG_START;
do {
if (len <= FT260_WR_DATA_MAX) {
wr_len = len;
if (flag == FT260_FLAG_START_STOP)
rep->flag |= FT260_FLAG_STOP;
} else {
wr_len = FT260_WR_DATA_MAX;
}
rep->report = FT260_I2C_DATA_REPORT_ID(wr_len);
rep->address = addr;
rep->length = wr_len;
memcpy(rep->data, &data[idx], wr_len);
ft260_dbg("rep %#02x addr %#02x off %d len %d wlen %d flag %#x d[0] %#02x\n" ,
rep->report, addr, idx, len, wr_len,
rep->flag, data[0 ]);
ret = ft260_hid_output_report_check_status(dev, (u8 *)rep,
wr_len + 4 );
if (ret < 0 ) {
hid_err(hdev, "%s: failed with %d\n" , __func__, ret);
return ret;
}
len -= wr_len;
idx += wr_len;
rep->flag = 0 ;
} while (len > 0 );
return 0 ;
}
static int ft260_smbus_write(struct ft260_device *dev, u8 addr, u8 cmd,
u8 *data, u8 data_len, u8 flag)
{
int ret = 0 ;
int len = 4 ;
struct ft260_i2c_write_request_report *rep =
(struct ft260_i2c_write_request_report *)dev->write_buf;
if (data_len >= sizeof (rep->data))
return -EINVAL;
rep->address = addr;
rep->data[0 ] = cmd;
rep->length = data_len + 1 ;
rep->flag = flag;
len += rep->length;
rep->report = FT260_I2C_DATA_REPORT_ID(len);
if (data_len > 0 )
memcpy(&rep->data[1 ], data, data_len);
ft260_dbg("rep %#02x addr %#02x cmd %#02x datlen %d replen %d\n" ,
rep->report, addr, cmd, rep->length, len);
ret = ft260_hid_output_report_check_status(dev, (u8 *)rep, len);
return ret;
}
static int ft260_i2c_read(struct ft260_device *dev, u8 addr, u8 *data,
u16 len, u8 flag)
{
u16 rd_len;
u16 rd_data_max = 60 ;
int timeout, ret = 0 ;
struct ft260_i2c_read_request_report rep;
struct hid_device *hdev = dev->hdev;
u8 bus_busy = 0 ;
if ((flag & FT260_FLAG_START_REPEATED) == FT260_FLAG_START_REPEATED)
flag = FT260_FLAG_START_REPEATED;
else
flag = FT260_FLAG_START;
do {
if (len <= rd_data_max) {
rd_len = len;
flag |= FT260_FLAG_STOP;
} else {
rd_len = rd_data_max;
}
rd_data_max = FT260_RD_DATA_MAX;
rep.report = FT260_I2C_READ_REQ;
rep.length = cpu_to_le16(rd_len);
rep.address = addr;
rep.flag = flag;
ft260_dbg("rep %#02x addr %#02x len %d rlen %d flag %#x\n" ,
rep.report, rep.address, len, rd_len, flag);
reinit_completion(&dev->wait);
dev->read_idx = 0 ;
dev->read_buf = data;
dev->read_len = rd_len;
ret = ft260_hid_output_report(hdev, (u8 *)&rep, sizeof (rep));
if (ret < 0 ) {
hid_err(hdev, "%s: failed with %d\n" , __func__, ret);
goto ft260_i2c_read_exit;
}
timeout = msecs_to_jiffies(5000 );
if (!wait_for_completion_timeout(&dev->wait, timeout)) {
ret = -ETIMEDOUT;
ft260_i2c_reset(hdev);
goto ft260_i2c_read_exit;
}
dev->read_buf = NULL;
if (flag & FT260_FLAG_STOP)
bus_busy = FT260_I2C_STATUS_BUS_BUSY;
ret = ft260_xfer_status(dev, bus_busy);
if (ret < 0 ) {
ret = -EIO;
ft260_i2c_reset(hdev);
goto ft260_i2c_read_exit;
}
len -= rd_len;
data += rd_len;
flag = 0 ;
} while (len > 0 );
ft260_i2c_read_exit:
dev->read_buf = NULL;
return ret;
}
/*
* A random read operation is implemented as a dummy write operation , followed
* by a current address read operation . The dummy write operation is used to
* load the target byte address into the current byte address counter , from
* which the subsequent current address read operation then reads .
*/
static int ft260_i2c_write_read(struct ft260_device *dev, struct i2c_msg *msgs)
{
int ret;
int wr_len = msgs[0 ].len;
int rd_len = msgs[1 ].len;
struct hid_device *hdev = dev->hdev;
u8 addr = msgs[0 ].addr;
u16 read_off = 0 ;
if (wr_len > 2 ) {
hid_err(hdev, "%s: invalid wr_len: %d\n" , __func__, wr_len);
return -EOPNOTSUPP;
}
if (ft260_debug) {
if (wr_len == 2 )
read_off = be16_to_cpu(*(__be16 *)msgs[0 ].buf);
else
read_off = *msgs[0 ].buf;
pr_info("%s: off %#x rlen %d wlen %d\n" , __func__,
read_off, rd_len, wr_len);
}
ret = ft260_i2c_write(dev, addr, msgs[0 ].buf, wr_len,
FT260_FLAG_START);
if (ret < 0 )
return ret;
ret = ft260_i2c_read(dev, addr, msgs[1 ].buf, rd_len,
FT260_FLAG_START_STOP_REPEATED);
if (ret < 0 )
return ret;
return 0 ;
}
static int ft260_i2c_xfer(struct i2c_adapter *adapter, struct i2c_msg *msgs,
int num)
{
int ret;
struct ft260_device *dev = i2c_get_adapdata(adapter);
struct hid_device *hdev = dev->hdev;
mutex_lock(&dev->lock);
ret = hid_hw_power(hdev, PM_HINT_FULLON);
if (ret < 0 ) {
hid_err(hdev, "failed to enter FULLON power mode: %d\n" , ret);
mutex_unlock(&dev->lock);
return ret;
}
if (num == 1 ) {
if (msgs->flags & I2C_M_RD)
ret = ft260_i2c_read(dev, msgs->addr, msgs->buf,
msgs->len, FT260_FLAG_START_STOP);
else
ret = ft260_i2c_write(dev, msgs->addr, msgs->buf,
msgs->len, FT260_FLAG_START_STOP);
if (ret < 0 )
goto i2c_exit;
} else {
/* Combined write then read message */
ret = ft260_i2c_write_read(dev, msgs);
if (ret < 0 )
goto i2c_exit;
}
ret = num;
i2c_exit:
hid_hw_power(hdev, PM_HINT_NORMAL);
mutex_unlock(&dev->lock);
return ret;
}
static int ft260_smbus_xfer(struct i2c_adapter *adapter, u16 addr, u16 flags,
char read_write, u8 cmd, int size,
union i2c_smbus_data *data)
{
int ret;
struct ft260_device *dev = i2c_get_adapdata(adapter);
struct hid_device *hdev = dev->hdev;
ft260_dbg("smbus size %d\n" , size);
mutex_lock(&dev->lock);
ret = hid_hw_power(hdev, PM_HINT_FULLON);
if (ret < 0 ) {
hid_err(hdev, "power management error: %d\n" , ret);
mutex_unlock(&dev->lock);
return ret;
}
switch (size) {
case I2C_SMBUS_BYTE:
if (read_write == I2C_SMBUS_READ)
ret = ft260_i2c_read(dev, addr, &data->byte, 1 ,
FT260_FLAG_START_STOP);
else
ret = ft260_smbus_write(dev, addr, cmd, NULL, 0 ,
FT260_FLAG_START_STOP);
break ;
case I2C_SMBUS_BYTE_DATA:
if (read_write == I2C_SMBUS_READ) {
ret = ft260_smbus_write(dev, addr, cmd, NULL, 0 ,
FT260_FLAG_START);
if (ret)
goto smbus_exit;
ret = ft260_i2c_read(dev, addr, &data->byte, 1 ,
FT260_FLAG_START_STOP_REPEATED);
} else {
ret = ft260_smbus_write(dev, addr, cmd, &data->byte, 1 ,
FT260_FLAG_START_STOP);
}
break ;
case I2C_SMBUS_WORD_DATA:
if (read_write == I2C_SMBUS_READ) {
ret = ft260_smbus_write(dev, addr, cmd, NULL, 0 ,
FT260_FLAG_START);
if (ret)
goto smbus_exit;
ret = ft260_i2c_read(dev, addr, (u8 *)&data->word, 2 ,
FT260_FLAG_START_STOP_REPEATED);
} else {
ret = ft260_smbus_write(dev, addr, cmd,
(u8 *)&data->word, 2 ,
FT260_FLAG_START_STOP);
}
break ;
case I2C_SMBUS_BLOCK_DATA:
if (read_write == I2C_SMBUS_READ) {
ret = ft260_smbus_write(dev, addr, cmd, NULL, 0 ,
FT260_FLAG_START);
if (ret)
goto smbus_exit;
ret = ft260_i2c_read(dev, addr, data->block,
data->block[0 ] + 1 ,
FT260_FLAG_START_STOP_REPEATED);
} else {
ret = ft260_smbus_write(dev, addr, cmd, data->block,
data->block[0 ] + 1 ,
FT260_FLAG_START_STOP);
}
break ;
case I2C_SMBUS_I2C_BLOCK_DATA:
if (read_write == I2C_SMBUS_READ) {
ret = ft260_smbus_write(dev, addr, cmd, NULL, 0 ,
FT260_FLAG_START);
if (ret)
goto smbus_exit;
ret = ft260_i2c_read(dev, addr, data->block + 1 ,
data->block[0 ],
FT260_FLAG_START_STOP_REPEATED);
} else {
ret = ft260_smbus_write(dev, addr, cmd, data->block + 1 ,
data->block[0 ],
FT260_FLAG_START_STOP);
}
break ;
default :
hid_err(hdev, "unsupported smbus transaction size %d\n" , size);
ret = -EOPNOTSUPP;
}
smbus_exit:
hid_hw_power(hdev, PM_HINT_NORMAL);
mutex_unlock(&dev->lock);
return ret;
}
static u32 ft260_functionality(struct i2c_adapter *adap)
{
return I2C_FUNC_I2C | I2C_FUNC_SMBUS_BYTE |
I2C_FUNC_SMBUS_BYTE_DATA | I2C_FUNC_SMBUS_WORD_DATA |
I2C_FUNC_SMBUS_BLOCK_DATA | I2C_FUNC_SMBUS_I2C_BLOCK;
}
static const struct i2c_adapter_quirks ft260_i2c_quirks = {
.flags = I2C_AQ_COMB_WRITE_THEN_READ,
.max_comb_1st_msg_len = 2 ,
};
static const struct i2c_algorithm ft260_i2c_algo = {
.master_xfer = ft260_i2c_xfer,
.smbus_xfer = ft260_smbus_xfer,
.functionality = ft260_functionality,
};
static int ft260_get_system_config(struct hid_device *hdev,
struct ft260_get_system_status_report *cfg)
{
int ret;
int len = sizeof (struct ft260_get_system_status_report);
ret = ft260_hid_feature_report_get(hdev, FT260_SYSTEM_SETTINGS,
(u8 *)cfg, len);
if (ret < 0 ) {
hid_err(hdev, "failed to retrieve system status\n" );
return ret;
}
return 0 ;
}
static int ft260_is_interface_enabled(struct hid_device *hdev)
{
struct ft260_get_system_status_report cfg;
struct usb_interface *usbif = to_usb_interface(hdev->dev.parent);
int interface = usbif->cur_altsetting->desc.bInterfaceNumber;
int ret;
ret = ft260_get_system_config(hdev, &cfg);
if (ret < 0 )
return ret;
ft260_dbg("interface: 0x%02x\n" , interface);
ft260_dbg("chip mode: 0x%02x\n" , cfg.chip_mode);
ft260_dbg("clock_ctl: 0x%02x\n" , cfg.clock_ctl);
ft260_dbg("i2c_enable: 0x%02x\n" , cfg.i2c_enable);
ft260_dbg("uart_mode: 0x%02x\n" , cfg.uart_mode);
switch (cfg.chip_mode) {
case FT260_MODE_ALL:
case FT260_MODE_BOTH:
if (interface == 1 )
hid_info(hdev, "uart interface is not supported\n" );
else
ret = 1 ;
break ;
case FT260_MODE_UART:
hid_info(hdev, "uart interface is not supported\n" );
break ;
case FT260_MODE_I2C:
ret = 1 ;
break ;
}
return ret;
}
static int ft260_byte_show(struct hid_device *hdev, int id, u8 *cfg, int len,
u8 *field, u8 *buf)
{
int ret;
ret = ft260_hid_feature_report_get(hdev, id, cfg, len);
if (ret < 0 )
return ret;
return scnprintf(buf, PAGE_SIZE, "%d\n" , *field);
}
static int ft260_word_show(struct hid_device *hdev, int id, u8 *cfg, int len,
__le16 *field, u8 *buf)
{
int ret;
ret = ft260_hid_feature_report_get(hdev, id, cfg, len);
if (ret < 0 )
return ret;
return scnprintf(buf, PAGE_SIZE, "%d\n" , le16_to_cpu(*field));
}
#define FT260_ATTR_SHOW(name, reptype, id, type, func) \
static ssize_t name## _show(struct device *kdev, \
struct device_attribute *attr, char *buf) \
{ \
struct reptype rep; \
struct hid_device *hdev = to_hid_device(kdev); \
type *field = &rep.name; \
int len = sizeof (rep); \
\
return func(hdev, id, (u8 *)&rep, len, field, buf); \
}
#define FT260_SSTAT_ATTR_SHOW(name) \
FT260_ATTR_SHOW(name, ft260_get_system_status_report, \
FT260_SYSTEM_SETTINGS, u8, ft260_byte_show)
#define FT260_I2CST_ATTR_SHOW(name) \
FT260_ATTR_SHOW(name, ft260_get_i2c_status_report, \
FT260_I2C_STATUS, __le16, ft260_word_show)
#define FT260_ATTR_STORE(name, reptype, id, req, type, ctype, func) \
static ssize_t name## _store(struct device *kdev, \
struct device_attribute *attr, \
const char *buf, size_t count) \
{ \
struct reptype rep; \
struct hid_device *hdev = to_hid_device(kdev); \
type name; \
int ret; \
\
if (!func(buf, 10 , (ctype *)&name)) { \
rep.name = name; \
rep.report = id; \
rep.request = req; \
ret = ft260_hid_feature_report_set(hdev, (u8 *)&rep, \
sizeof (rep)); \
if (!ret) \
ret = count; \
} else { \
ret = -EINVAL; \
} \
return ret; \
}
#define FT260_BYTE_ATTR_STORE(name, reptype, req) \
FT260_ATTR_STORE(name, reptype, FT260_SYSTEM_SETTINGS, req, \
u8, u8, kstrtou8)
#define FT260_WORD_ATTR_STORE(name, reptype, req) \
FT260_ATTR_STORE(name, reptype, FT260_SYSTEM_SETTINGS, req, \
__le16, u16, kstrtou16)
FT260_SSTAT_ATTR_SHOW(chip_mode);
static DEVICE_ATTR_RO(chip_mode);
FT260_SSTAT_ATTR_SHOW(pwren_status);
static DEVICE_ATTR_RO(pwren_status);
FT260_SSTAT_ATTR_SHOW(suspend_status);
static DEVICE_ATTR_RO(suspend_status);
FT260_SSTAT_ATTR_SHOW(hid_over_i2c_en);
static DEVICE_ATTR_RO(hid_over_i2c_en);
FT260_SSTAT_ATTR_SHOW(power_saving_en);
static DEVICE_ATTR_RO(power_saving_en);
FT260_SSTAT_ATTR_SHOW(i2c_enable);
FT260_BYTE_ATTR_STORE(i2c_enable, ft260_set_i2c_mode_report,
FT260_SET_I2C_MODE);
static DEVICE_ATTR_RW(i2c_enable);
FT260_SSTAT_ATTR_SHOW(uart_mode);
FT260_BYTE_ATTR_STORE(uart_mode, ft260_set_uart_mode_report,
FT260_SET_UART_MODE);
static DEVICE_ATTR_RW(uart_mode);
FT260_SSTAT_ATTR_SHOW(clock_ctl);
FT260_BYTE_ATTR_STORE(clock_ctl, ft260_set_system_clock_report,
FT260_SET_CLOCK);
static DEVICE_ATTR_RW(clock_ctl);
FT260_I2CST_ATTR_SHOW(clock);
FT260_WORD_ATTR_STORE(clock, ft260_set_i2c_speed_report,
FT260_SET_I2C_CLOCK_SPEED);
static DEVICE_ATTR_RW(clock);
static ssize_t i2c_reset_store(struct device *kdev,
struct device_attribute *attr, const char *buf,
size_t count)
{
struct hid_device *hdev = to_hid_device(kdev);
int ret = ft260_i2c_reset(hdev);
if (ret)
return ret;
return count;
}
static DEVICE_ATTR_WO(i2c_reset);
static const struct attribute_group ft260_attr_group = {
.attrs = (struct attribute *[]) {
&dev_attr_chip_mode.attr,
&dev_attr_pwren_status.attr,
&dev_attr_suspend_status.attr,
&dev_attr_hid_over_i2c_en.attr,
&dev_attr_power_saving_en.attr,
&dev_attr_i2c_enable.attr,
&dev_attr_uart_mode.attr,
&dev_attr_clock_ctl.attr,
&dev_attr_i2c_reset.attr,
&dev_attr_clock.attr,
NULL
}
};
static int ft260_probe(struct hid_device *hdev, const struct hid_device_id *id)
{
struct ft260_device *dev;
struct ft260_get_chip_version_report version;
int ret;
if (!hid_is_usb(hdev))
return -EINVAL;
dev = devm_kzalloc(&hdev->dev, sizeof (*dev), GFP_KERNEL);
if (!dev)
return -ENOMEM;
ret = hid_parse(hdev);
if (ret) {
hid_err(hdev, "failed to parse HID\n" );
return ret;
}
ret = hid_hw_start(hdev, 0 );
if (ret) {
hid_err(hdev, "failed to start HID HW\n" );
return ret;
}
ret = hid_hw_open(hdev);
if (ret) {
hid_err(hdev, "failed to open HID HW\n" );
goto err_hid_stop;
}
ret = ft260_hid_feature_report_get(hdev, FT260_CHIP_VERSION,
(u8 *)&version, sizeof (version));
if (ret < 0 ) {
hid_err(hdev, "failed to retrieve chip version\n" );
goto err_hid_close;
}
hid_info(hdev, "chip code: %02x%02x %02x%02x\n" ,
version.chip_code[0 ], version.chip_code[1 ],
version.chip_code[2 ], version.chip_code[3 ]);
ret = ft260_is_interface_enabled(hdev);
if (ret <= 0 )
goto err_hid_close;
hid_info(hdev, "USB HID v%x.%02x Device [%s] on %s\n" ,
hdev->version >> 8 , hdev->version & 0 xff, hdev->name,
hdev->phys);
hid_set_drvdata(hdev, dev);
dev->hdev = hdev;
dev->adap.owner = THIS_MODULE;
dev->adap.class = I2C_CLASS_HWMON;
dev->adap.algo = &ft260_i2c_algo;
dev->adap.quirks = &ft260_i2c_quirks;
dev->adap.dev.parent = &hdev->dev;
snprintf(dev->adap.name, sizeof (dev->adap.name),
"FT260 usb-i2c bridge" );
mutex_init(&dev->lock);
init_completion(&dev->wait);
ret = ft260_xfer_status(dev, FT260_I2C_STATUS_BUS_BUSY);
if (ret)
ft260_i2c_reset(hdev);
i2c_set_adapdata(&dev->adap, dev);
ret = i2c_add_adapter(&dev->adap);
if (ret) {
hid_err(hdev, "failed to add i2c adapter\n" );
goto err_hid_close;
}
ret = sysfs_create_group(&hdev->dev.kobj, &ft260_attr_group);
if (ret < 0 ) {
hid_err(hdev, "failed to create sysfs attrs\n" );
goto err_i2c_free;
}
return 0 ;
err_i2c_free:
i2c_del_adapter(&dev->adap);
err_hid_close:
hid_hw_close(hdev);
err_hid_stop:
hid_hw_stop(hdev);
return ret;
}
static void ft260_remove(struct hid_device *hdev)
{
struct ft260_device *dev = hid_get_drvdata(hdev);
if (!dev)
return ;
sysfs_remove_group(&hdev->dev.kobj, &ft260_attr_group);
i2c_del_adapter(&dev->adap);
hid_hw_close(hdev);
hid_hw_stop(hdev);
}
static int ft260_raw_event(struct hid_device *hdev, struct hid_report *report,
u8 *data, int size)
{
struct ft260_device *dev = hid_get_drvdata(hdev);
struct ft260_i2c_input_report *xfer = (void *)data;
if (xfer->report >= FT260_I2C_REPORT_MIN &&
xfer->report <= FT260_I2C_REPORT_MAX) {
ft260_dbg("i2c resp: rep %#02x len %d\n" , xfer->report,
xfer->length);
if ((dev->read_buf == NULL) ||
(xfer->length > dev->read_len - dev->read_idx)) {
hid_err(hdev, "unexpected report %#02x, length %d\n" ,
xfer->report, xfer->length);
return -1 ;
}
memcpy(&dev->read_buf[dev->read_idx], &xfer->data,
xfer->length);
dev->read_idx += xfer->length;
if (dev->read_idx == dev->read_len)
complete(&dev->wait);
} else {
hid_err(hdev, "unhandled report %#02x\n" , xfer->report);
}
return 0 ;
}
static struct hid_driver ft260_driver = {
.name = "ft260" ,
.id_table = ft260_devices,
.probe = ft260_probe,
.remove = ft260_remove,
.raw_event = ft260_raw_event,
};
module_hid_driver(ft260_driver);
MODULE_DESCRIPTION("FTDI FT260 USB HID to I2C host bridge" );
MODULE_AUTHOR("Michael Zaidman <michael.zaidman@gmail.com>" );
MODULE_LICENSE("GPL v2" );
Messung V0.5 in Prozent C=94 H=89 G=91
¤ Dauer der Verarbeitung: 0.16 Sekunden
(vorverarbeitet am 2026-09-29)
¤
*© Formatika GbR, Deutschland