162306a36Sopenharmony_ci// SPDX-License-Identifier: GPL-2.0-or-later 262306a36Sopenharmony_ci/* 362306a36Sopenharmony_ci * Copyright (C) 2016 Maxime Ripard <maxime.ripard@free-electrons.com> 462306a36Sopenharmony_ci * Copyright (C) 2017 Jonathan Liu <net147@gmail.com> 562306a36Sopenharmony_ci */ 662306a36Sopenharmony_ci 762306a36Sopenharmony_ci#include <linux/clk.h> 862306a36Sopenharmony_ci#include <linux/i2c.h> 962306a36Sopenharmony_ci#include <linux/iopoll.h> 1062306a36Sopenharmony_ci 1162306a36Sopenharmony_ci#include "sun4i_hdmi.h" 1262306a36Sopenharmony_ci 1362306a36Sopenharmony_ci#define SUN4I_HDMI_DDC_INT_STATUS_ERROR_MASK ( \ 1462306a36Sopenharmony_ci SUN4I_HDMI_DDC_INT_STATUS_ILLEGAL_FIFO_OPERATION | \ 1562306a36Sopenharmony_ci SUN4I_HDMI_DDC_INT_STATUS_DDC_RX_FIFO_UNDERFLOW | \ 1662306a36Sopenharmony_ci SUN4I_HDMI_DDC_INT_STATUS_DDC_TX_FIFO_OVERFLOW | \ 1762306a36Sopenharmony_ci SUN4I_HDMI_DDC_INT_STATUS_ARBITRATION_ERROR | \ 1862306a36Sopenharmony_ci SUN4I_HDMI_DDC_INT_STATUS_ACK_ERROR | \ 1962306a36Sopenharmony_ci SUN4I_HDMI_DDC_INT_STATUS_BUS_ERROR \ 2062306a36Sopenharmony_ci) 2162306a36Sopenharmony_ci 2262306a36Sopenharmony_ci/* FIFO request bit is set when FIFO level is above RX_THRESHOLD during read */ 2362306a36Sopenharmony_ci#define RX_THRESHOLD SUN4I_HDMI_DDC_FIFO_CTRL_RX_THRES_MAX 2462306a36Sopenharmony_ci 2562306a36Sopenharmony_cistatic int fifo_transfer(struct sun4i_hdmi *hdmi, u8 *buf, int len, bool read) 2662306a36Sopenharmony_ci{ 2762306a36Sopenharmony_ci /* 2862306a36Sopenharmony_ci * 1 byte takes 9 clock cycles (8 bits + 1 ACK) = 90 us for 100 kHz 2962306a36Sopenharmony_ci * clock. As clock rate is fixed, just round it up to 100 us. 3062306a36Sopenharmony_ci */ 3162306a36Sopenharmony_ci const unsigned long byte_time_ns = 100; 3262306a36Sopenharmony_ci const u32 mask = SUN4I_HDMI_DDC_INT_STATUS_ERROR_MASK | 3362306a36Sopenharmony_ci SUN4I_HDMI_DDC_INT_STATUS_FIFO_REQUEST | 3462306a36Sopenharmony_ci SUN4I_HDMI_DDC_INT_STATUS_TRANSFER_COMPLETE; 3562306a36Sopenharmony_ci u32 reg; 3662306a36Sopenharmony_ci /* 3762306a36Sopenharmony_ci * If threshold is inclusive, then the FIFO may only have 3862306a36Sopenharmony_ci * RX_THRESHOLD number of bytes, instead of RX_THRESHOLD + 1. 3962306a36Sopenharmony_ci */ 4062306a36Sopenharmony_ci int read_len = RX_THRESHOLD + 4162306a36Sopenharmony_ci (hdmi->variant->ddc_fifo_thres_incl ? 0 : 1); 4262306a36Sopenharmony_ci 4362306a36Sopenharmony_ci /* 4462306a36Sopenharmony_ci * Limit transfer length by FIFO threshold or FIFO size. 4562306a36Sopenharmony_ci * For TX the threshold is for an empty FIFO. 4662306a36Sopenharmony_ci */ 4762306a36Sopenharmony_ci len = min_t(int, len, read ? read_len : SUN4I_HDMI_DDC_FIFO_SIZE); 4862306a36Sopenharmony_ci 4962306a36Sopenharmony_ci /* Wait until error, FIFO request bit set or transfer complete */ 5062306a36Sopenharmony_ci if (regmap_field_read_poll_timeout(hdmi->field_ddc_int_status, reg, 5162306a36Sopenharmony_ci reg & mask, len * byte_time_ns, 5262306a36Sopenharmony_ci 100000)) 5362306a36Sopenharmony_ci return -ETIMEDOUT; 5462306a36Sopenharmony_ci 5562306a36Sopenharmony_ci if (reg & SUN4I_HDMI_DDC_INT_STATUS_ERROR_MASK) 5662306a36Sopenharmony_ci return -EIO; 5762306a36Sopenharmony_ci 5862306a36Sopenharmony_ci if (read) 5962306a36Sopenharmony_ci ioread8_rep(hdmi->base + hdmi->variant->ddc_fifo_reg, buf, len); 6062306a36Sopenharmony_ci else 6162306a36Sopenharmony_ci iowrite8_rep(hdmi->base + hdmi->variant->ddc_fifo_reg, buf, len); 6262306a36Sopenharmony_ci 6362306a36Sopenharmony_ci /* Clear FIFO request bit by forcing a write to that bit */ 6462306a36Sopenharmony_ci regmap_field_force_write(hdmi->field_ddc_int_status, 6562306a36Sopenharmony_ci SUN4I_HDMI_DDC_INT_STATUS_FIFO_REQUEST); 6662306a36Sopenharmony_ci 6762306a36Sopenharmony_ci return len; 6862306a36Sopenharmony_ci} 6962306a36Sopenharmony_ci 7062306a36Sopenharmony_cistatic int xfer_msg(struct sun4i_hdmi *hdmi, struct i2c_msg *msg) 7162306a36Sopenharmony_ci{ 7262306a36Sopenharmony_ci int i, len; 7362306a36Sopenharmony_ci u32 reg; 7462306a36Sopenharmony_ci 7562306a36Sopenharmony_ci /* Set FIFO direction */ 7662306a36Sopenharmony_ci if (hdmi->variant->ddc_fifo_has_dir) { 7762306a36Sopenharmony_ci reg = readl(hdmi->base + SUN4I_HDMI_DDC_CTRL_REG); 7862306a36Sopenharmony_ci reg &= ~SUN4I_HDMI_DDC_CTRL_FIFO_DIR_MASK; 7962306a36Sopenharmony_ci reg |= (msg->flags & I2C_M_RD) ? 8062306a36Sopenharmony_ci SUN4I_HDMI_DDC_CTRL_FIFO_DIR_READ : 8162306a36Sopenharmony_ci SUN4I_HDMI_DDC_CTRL_FIFO_DIR_WRITE; 8262306a36Sopenharmony_ci writel(reg, hdmi->base + SUN4I_HDMI_DDC_CTRL_REG); 8362306a36Sopenharmony_ci } 8462306a36Sopenharmony_ci 8562306a36Sopenharmony_ci /* Clear address register (not cleared by soft reset) */ 8662306a36Sopenharmony_ci regmap_field_write(hdmi->field_ddc_addr_reg, 0); 8762306a36Sopenharmony_ci 8862306a36Sopenharmony_ci /* Set I2C address */ 8962306a36Sopenharmony_ci regmap_field_write(hdmi->field_ddc_slave_addr, msg->addr); 9062306a36Sopenharmony_ci 9162306a36Sopenharmony_ci /* 9262306a36Sopenharmony_ci * Set FIFO RX/TX thresholds and clear FIFO 9362306a36Sopenharmony_ci * 9462306a36Sopenharmony_ci * If threshold is inclusive, we can set the TX threshold to 9562306a36Sopenharmony_ci * 0 instead of 1. 9662306a36Sopenharmony_ci */ 9762306a36Sopenharmony_ci regmap_field_write(hdmi->field_ddc_fifo_tx_thres, 9862306a36Sopenharmony_ci hdmi->variant->ddc_fifo_thres_incl ? 0 : 1); 9962306a36Sopenharmony_ci regmap_field_write(hdmi->field_ddc_fifo_rx_thres, RX_THRESHOLD); 10062306a36Sopenharmony_ci regmap_field_write(hdmi->field_ddc_fifo_clear, 1); 10162306a36Sopenharmony_ci if (regmap_field_read_poll_timeout(hdmi->field_ddc_fifo_clear, 10262306a36Sopenharmony_ci reg, !reg, 100, 2000)) 10362306a36Sopenharmony_ci return -EIO; 10462306a36Sopenharmony_ci 10562306a36Sopenharmony_ci /* Set transfer length */ 10662306a36Sopenharmony_ci regmap_field_write(hdmi->field_ddc_byte_count, msg->len); 10762306a36Sopenharmony_ci 10862306a36Sopenharmony_ci /* Set command */ 10962306a36Sopenharmony_ci regmap_field_write(hdmi->field_ddc_cmd, 11062306a36Sopenharmony_ci msg->flags & I2C_M_RD ? 11162306a36Sopenharmony_ci SUN4I_HDMI_DDC_CMD_IMPLICIT_READ : 11262306a36Sopenharmony_ci SUN4I_HDMI_DDC_CMD_IMPLICIT_WRITE); 11362306a36Sopenharmony_ci 11462306a36Sopenharmony_ci /* Clear interrupt status bits by forcing a write */ 11562306a36Sopenharmony_ci regmap_field_force_write(hdmi->field_ddc_int_status, 11662306a36Sopenharmony_ci SUN4I_HDMI_DDC_INT_STATUS_ERROR_MASK | 11762306a36Sopenharmony_ci SUN4I_HDMI_DDC_INT_STATUS_FIFO_REQUEST | 11862306a36Sopenharmony_ci SUN4I_HDMI_DDC_INT_STATUS_TRANSFER_COMPLETE); 11962306a36Sopenharmony_ci 12062306a36Sopenharmony_ci /* Start command */ 12162306a36Sopenharmony_ci regmap_field_write(hdmi->field_ddc_start, 1); 12262306a36Sopenharmony_ci 12362306a36Sopenharmony_ci /* Transfer bytes */ 12462306a36Sopenharmony_ci for (i = 0; i < msg->len; i += len) { 12562306a36Sopenharmony_ci len = fifo_transfer(hdmi, msg->buf + i, msg->len - i, 12662306a36Sopenharmony_ci msg->flags & I2C_M_RD); 12762306a36Sopenharmony_ci if (len <= 0) 12862306a36Sopenharmony_ci return len; 12962306a36Sopenharmony_ci } 13062306a36Sopenharmony_ci 13162306a36Sopenharmony_ci /* Wait for command to finish */ 13262306a36Sopenharmony_ci if (regmap_field_read_poll_timeout(hdmi->field_ddc_start, 13362306a36Sopenharmony_ci reg, !reg, 100, 100000)) 13462306a36Sopenharmony_ci return -EIO; 13562306a36Sopenharmony_ci 13662306a36Sopenharmony_ci /* Check for errors */ 13762306a36Sopenharmony_ci regmap_field_read(hdmi->field_ddc_int_status, ®); 13862306a36Sopenharmony_ci if ((reg & SUN4I_HDMI_DDC_INT_STATUS_ERROR_MASK) || 13962306a36Sopenharmony_ci !(reg & SUN4I_HDMI_DDC_INT_STATUS_TRANSFER_COMPLETE)) { 14062306a36Sopenharmony_ci return -EIO; 14162306a36Sopenharmony_ci } 14262306a36Sopenharmony_ci 14362306a36Sopenharmony_ci return 0; 14462306a36Sopenharmony_ci} 14562306a36Sopenharmony_ci 14662306a36Sopenharmony_cistatic int sun4i_hdmi_i2c_xfer(struct i2c_adapter *adap, 14762306a36Sopenharmony_ci struct i2c_msg *msgs, int num) 14862306a36Sopenharmony_ci{ 14962306a36Sopenharmony_ci struct sun4i_hdmi *hdmi = i2c_get_adapdata(adap); 15062306a36Sopenharmony_ci u32 reg; 15162306a36Sopenharmony_ci int err, i, ret = num; 15262306a36Sopenharmony_ci 15362306a36Sopenharmony_ci for (i = 0; i < num; i++) { 15462306a36Sopenharmony_ci if (!msgs[i].len) 15562306a36Sopenharmony_ci return -EINVAL; 15662306a36Sopenharmony_ci if (msgs[i].len > SUN4I_HDMI_DDC_BYTE_COUNT_MAX) 15762306a36Sopenharmony_ci return -EINVAL; 15862306a36Sopenharmony_ci } 15962306a36Sopenharmony_ci 16062306a36Sopenharmony_ci /* DDC clock needs to be enabled for the module to work */ 16162306a36Sopenharmony_ci clk_prepare_enable(hdmi->ddc_clk); 16262306a36Sopenharmony_ci clk_set_rate(hdmi->ddc_clk, 100000); 16362306a36Sopenharmony_ci 16462306a36Sopenharmony_ci /* Reset I2C controller */ 16562306a36Sopenharmony_ci regmap_field_write(hdmi->field_ddc_en, 1); 16662306a36Sopenharmony_ci regmap_field_write(hdmi->field_ddc_reset, 1); 16762306a36Sopenharmony_ci if (regmap_field_read_poll_timeout(hdmi->field_ddc_reset, 16862306a36Sopenharmony_ci reg, !reg, 100, 2000)) { 16962306a36Sopenharmony_ci clk_disable_unprepare(hdmi->ddc_clk); 17062306a36Sopenharmony_ci return -EIO; 17162306a36Sopenharmony_ci } 17262306a36Sopenharmony_ci 17362306a36Sopenharmony_ci regmap_field_write(hdmi->field_ddc_sck_en, 1); 17462306a36Sopenharmony_ci regmap_field_write(hdmi->field_ddc_sda_en, 1); 17562306a36Sopenharmony_ci 17662306a36Sopenharmony_ci for (i = 0; i < num; i++) { 17762306a36Sopenharmony_ci err = xfer_msg(hdmi, &msgs[i]); 17862306a36Sopenharmony_ci if (err) { 17962306a36Sopenharmony_ci ret = err; 18062306a36Sopenharmony_ci break; 18162306a36Sopenharmony_ci } 18262306a36Sopenharmony_ci } 18362306a36Sopenharmony_ci 18462306a36Sopenharmony_ci clk_disable_unprepare(hdmi->ddc_clk); 18562306a36Sopenharmony_ci return ret; 18662306a36Sopenharmony_ci} 18762306a36Sopenharmony_ci 18862306a36Sopenharmony_cistatic u32 sun4i_hdmi_i2c_func(struct i2c_adapter *adap) 18962306a36Sopenharmony_ci{ 19062306a36Sopenharmony_ci return I2C_FUNC_I2C | I2C_FUNC_SMBUS_EMUL; 19162306a36Sopenharmony_ci} 19262306a36Sopenharmony_ci 19362306a36Sopenharmony_cistatic const struct i2c_algorithm sun4i_hdmi_i2c_algorithm = { 19462306a36Sopenharmony_ci .master_xfer = sun4i_hdmi_i2c_xfer, 19562306a36Sopenharmony_ci .functionality = sun4i_hdmi_i2c_func, 19662306a36Sopenharmony_ci}; 19762306a36Sopenharmony_ci 19862306a36Sopenharmony_cistatic int sun4i_hdmi_init_regmap_fields(struct sun4i_hdmi *hdmi) 19962306a36Sopenharmony_ci{ 20062306a36Sopenharmony_ci hdmi->field_ddc_en = 20162306a36Sopenharmony_ci devm_regmap_field_alloc(hdmi->dev, hdmi->regmap, 20262306a36Sopenharmony_ci hdmi->variant->field_ddc_en); 20362306a36Sopenharmony_ci if (IS_ERR(hdmi->field_ddc_en)) 20462306a36Sopenharmony_ci return PTR_ERR(hdmi->field_ddc_en); 20562306a36Sopenharmony_ci 20662306a36Sopenharmony_ci hdmi->field_ddc_start = 20762306a36Sopenharmony_ci devm_regmap_field_alloc(hdmi->dev, hdmi->regmap, 20862306a36Sopenharmony_ci hdmi->variant->field_ddc_start); 20962306a36Sopenharmony_ci if (IS_ERR(hdmi->field_ddc_start)) 21062306a36Sopenharmony_ci return PTR_ERR(hdmi->field_ddc_start); 21162306a36Sopenharmony_ci 21262306a36Sopenharmony_ci hdmi->field_ddc_reset = 21362306a36Sopenharmony_ci devm_regmap_field_alloc(hdmi->dev, hdmi->regmap, 21462306a36Sopenharmony_ci hdmi->variant->field_ddc_reset); 21562306a36Sopenharmony_ci if (IS_ERR(hdmi->field_ddc_reset)) 21662306a36Sopenharmony_ci return PTR_ERR(hdmi->field_ddc_reset); 21762306a36Sopenharmony_ci 21862306a36Sopenharmony_ci hdmi->field_ddc_addr_reg = 21962306a36Sopenharmony_ci devm_regmap_field_alloc(hdmi->dev, hdmi->regmap, 22062306a36Sopenharmony_ci hdmi->variant->field_ddc_addr_reg); 22162306a36Sopenharmony_ci if (IS_ERR(hdmi->field_ddc_addr_reg)) 22262306a36Sopenharmony_ci return PTR_ERR(hdmi->field_ddc_addr_reg); 22362306a36Sopenharmony_ci 22462306a36Sopenharmony_ci hdmi->field_ddc_slave_addr = 22562306a36Sopenharmony_ci devm_regmap_field_alloc(hdmi->dev, hdmi->regmap, 22662306a36Sopenharmony_ci hdmi->variant->field_ddc_slave_addr); 22762306a36Sopenharmony_ci if (IS_ERR(hdmi->field_ddc_slave_addr)) 22862306a36Sopenharmony_ci return PTR_ERR(hdmi->field_ddc_slave_addr); 22962306a36Sopenharmony_ci 23062306a36Sopenharmony_ci hdmi->field_ddc_int_mask = 23162306a36Sopenharmony_ci devm_regmap_field_alloc(hdmi->dev, hdmi->regmap, 23262306a36Sopenharmony_ci hdmi->variant->field_ddc_int_mask); 23362306a36Sopenharmony_ci if (IS_ERR(hdmi->field_ddc_int_mask)) 23462306a36Sopenharmony_ci return PTR_ERR(hdmi->field_ddc_int_mask); 23562306a36Sopenharmony_ci 23662306a36Sopenharmony_ci hdmi->field_ddc_int_status = 23762306a36Sopenharmony_ci devm_regmap_field_alloc(hdmi->dev, hdmi->regmap, 23862306a36Sopenharmony_ci hdmi->variant->field_ddc_int_status); 23962306a36Sopenharmony_ci if (IS_ERR(hdmi->field_ddc_int_status)) 24062306a36Sopenharmony_ci return PTR_ERR(hdmi->field_ddc_int_status); 24162306a36Sopenharmony_ci 24262306a36Sopenharmony_ci hdmi->field_ddc_fifo_clear = 24362306a36Sopenharmony_ci devm_regmap_field_alloc(hdmi->dev, hdmi->regmap, 24462306a36Sopenharmony_ci hdmi->variant->field_ddc_fifo_clear); 24562306a36Sopenharmony_ci if (IS_ERR(hdmi->field_ddc_fifo_clear)) 24662306a36Sopenharmony_ci return PTR_ERR(hdmi->field_ddc_fifo_clear); 24762306a36Sopenharmony_ci 24862306a36Sopenharmony_ci hdmi->field_ddc_fifo_rx_thres = 24962306a36Sopenharmony_ci devm_regmap_field_alloc(hdmi->dev, hdmi->regmap, 25062306a36Sopenharmony_ci hdmi->variant->field_ddc_fifo_rx_thres); 25162306a36Sopenharmony_ci if (IS_ERR(hdmi->field_ddc_fifo_rx_thres)) 25262306a36Sopenharmony_ci return PTR_ERR(hdmi->field_ddc_fifo_rx_thres); 25362306a36Sopenharmony_ci 25462306a36Sopenharmony_ci hdmi->field_ddc_fifo_tx_thres = 25562306a36Sopenharmony_ci devm_regmap_field_alloc(hdmi->dev, hdmi->regmap, 25662306a36Sopenharmony_ci hdmi->variant->field_ddc_fifo_tx_thres); 25762306a36Sopenharmony_ci if (IS_ERR(hdmi->field_ddc_fifo_tx_thres)) 25862306a36Sopenharmony_ci return PTR_ERR(hdmi->field_ddc_fifo_tx_thres); 25962306a36Sopenharmony_ci 26062306a36Sopenharmony_ci hdmi->field_ddc_byte_count = 26162306a36Sopenharmony_ci devm_regmap_field_alloc(hdmi->dev, hdmi->regmap, 26262306a36Sopenharmony_ci hdmi->variant->field_ddc_byte_count); 26362306a36Sopenharmony_ci if (IS_ERR(hdmi->field_ddc_byte_count)) 26462306a36Sopenharmony_ci return PTR_ERR(hdmi->field_ddc_byte_count); 26562306a36Sopenharmony_ci 26662306a36Sopenharmony_ci hdmi->field_ddc_cmd = 26762306a36Sopenharmony_ci devm_regmap_field_alloc(hdmi->dev, hdmi->regmap, 26862306a36Sopenharmony_ci hdmi->variant->field_ddc_cmd); 26962306a36Sopenharmony_ci if (IS_ERR(hdmi->field_ddc_cmd)) 27062306a36Sopenharmony_ci return PTR_ERR(hdmi->field_ddc_cmd); 27162306a36Sopenharmony_ci 27262306a36Sopenharmony_ci hdmi->field_ddc_sda_en = 27362306a36Sopenharmony_ci devm_regmap_field_alloc(hdmi->dev, hdmi->regmap, 27462306a36Sopenharmony_ci hdmi->variant->field_ddc_sda_en); 27562306a36Sopenharmony_ci if (IS_ERR(hdmi->field_ddc_sda_en)) 27662306a36Sopenharmony_ci return PTR_ERR(hdmi->field_ddc_sda_en); 27762306a36Sopenharmony_ci 27862306a36Sopenharmony_ci hdmi->field_ddc_sck_en = 27962306a36Sopenharmony_ci devm_regmap_field_alloc(hdmi->dev, hdmi->regmap, 28062306a36Sopenharmony_ci hdmi->variant->field_ddc_sck_en); 28162306a36Sopenharmony_ci if (IS_ERR(hdmi->field_ddc_sck_en)) 28262306a36Sopenharmony_ci return PTR_ERR(hdmi->field_ddc_sck_en); 28362306a36Sopenharmony_ci 28462306a36Sopenharmony_ci return 0; 28562306a36Sopenharmony_ci} 28662306a36Sopenharmony_ci 28762306a36Sopenharmony_ciint sun4i_hdmi_i2c_create(struct device *dev, struct sun4i_hdmi *hdmi) 28862306a36Sopenharmony_ci{ 28962306a36Sopenharmony_ci struct i2c_adapter *adap; 29062306a36Sopenharmony_ci int ret = 0; 29162306a36Sopenharmony_ci 29262306a36Sopenharmony_ci ret = sun4i_ddc_create(hdmi, hdmi->ddc_parent_clk); 29362306a36Sopenharmony_ci if (ret) 29462306a36Sopenharmony_ci return ret; 29562306a36Sopenharmony_ci 29662306a36Sopenharmony_ci ret = sun4i_hdmi_init_regmap_fields(hdmi); 29762306a36Sopenharmony_ci if (ret) 29862306a36Sopenharmony_ci return ret; 29962306a36Sopenharmony_ci 30062306a36Sopenharmony_ci adap = devm_kzalloc(dev, sizeof(*adap), GFP_KERNEL); 30162306a36Sopenharmony_ci if (!adap) 30262306a36Sopenharmony_ci return -ENOMEM; 30362306a36Sopenharmony_ci 30462306a36Sopenharmony_ci adap->owner = THIS_MODULE; 30562306a36Sopenharmony_ci adap->class = I2C_CLASS_DDC; 30662306a36Sopenharmony_ci adap->algo = &sun4i_hdmi_i2c_algorithm; 30762306a36Sopenharmony_ci strscpy(adap->name, "sun4i_hdmi_i2c adapter", sizeof(adap->name)); 30862306a36Sopenharmony_ci i2c_set_adapdata(adap, hdmi); 30962306a36Sopenharmony_ci 31062306a36Sopenharmony_ci ret = i2c_add_adapter(adap); 31162306a36Sopenharmony_ci if (ret) 31262306a36Sopenharmony_ci return ret; 31362306a36Sopenharmony_ci 31462306a36Sopenharmony_ci hdmi->i2c = adap; 31562306a36Sopenharmony_ci 31662306a36Sopenharmony_ci return ret; 31762306a36Sopenharmony_ci} 318