drivers/hwmon/pmbus/adm1266.c

   1 // SPDX-License-Identifier: GPL-2.0
   2 /*
   3  * ADM1266 - Cascadable Super Sequencer with Margin
   4  * Control and Fault Recording
   5  *
   6  * Copyright 2020 Analog Devices Inc.
   7  */
   8
   9 #include <linux/bitfield.h>
  10 #include <linux/crc8.h>
  11 #include <linux/debugfs.h>
  12 #include <linux/gpio/driver.h>
  13 #include <linux/i2c.h>
  14 #include <linux/i2c-smbus.h>
  15 #include <linux/init.h>
  16 #include <linux/kernel.h>
  17 #include <linux/module.h>
  18 #include <linux/nvmem-consumer.h>
  19 #include <linux/nvmem-provider.h>
  20 #include "pmbus.h"
  21 #include <linux/slab.h>
  22 #include <linux/timekeeping.h>
  23
  24 #define ADM1266_BLACKBOX_CONFIG 0xD3
  25 #define ADM1266_PDIO_CONFIG     0xD4
  26 #define ADM1266_READ_STATE      0xD9
  27 #define ADM1266_READ_BLACKBOX   0xDE
  28 #define ADM1266_SET_RTC         0xDF
  29 #define ADM1266_GPIO_CONFIG     0xE1
  30 #define ADM1266_BLACKBOX_INFO   0xE6
  31 #define ADM1266_PDIO_STATUS     0xE9
  32 #define ADM1266_GPIO_STATUS     0xEA
  33
  34 /* ADM1266 GPIO defines */
  35 #define ADM1266_GPIO_NR                 9
  36 #define ADM1266_GPIO_FUNCTIONS(x)       FIELD_GET(BIT(0), x)
  37 #define ADM1266_GPIO_INPUT_EN(x)        FIELD_GET(BIT(2), x)
  38 #define ADM1266_GPIO_OUTPUT_EN(x)       FIELD_GET(BIT(3), x)
  39 #define ADM1266_GPIO_OPEN_DRAIN(x)      FIELD_GET(BIT(4), x)
  40
  41 /* ADM1266 PDIO defines */
  42 #define ADM1266_PDIO_NR                 16
  43 #define ADM1266_PDIO_PIN_CFG(x)         FIELD_GET(GENMASK(15, 13), x)
  44 #define ADM1266_PDIO_GLITCH_FILT(x)     FIELD_GET(GENMASK(12, 9), x)
  45 #define ADM1266_PDIO_OUT_CFG(x)         FIELD_GET(GENMASK(2, 0), x)
  46
  47 #define ADM1266_BLACKBOX_OFFSET         0
  48 #define ADM1266_BLACKBOX_SIZE           64
  49
  50 #define ADM1266_PMBUS_BLOCK_MAX         255
  51
  52 struct adm1266_data {
  53         struct pmbus_driver_info info;
  54         struct gpio_chip gc;
  55         const char *gpio_names[ADM1266_GPIO_NR + ADM1266_PDIO_NR];
  56         struct i2c_client *client;
  57         struct dentry *debugfs_dir;
  58         struct nvmem_config nvmem_config;
  59         struct nvmem_device *nvmem;
  60         u8 *dev_mem;
  61         struct mutex buf_mutex;
  62         u8 write_buf[ADM1266_PMBUS_BLOCK_MAX + 1] ____cacheline_aligned;
  63         u8 read_buf[ADM1266_PMBUS_BLOCK_MAX + 1] ____cacheline_aligned;
  64 };
  65
  66 static const struct nvmem_cell_info adm1266_nvmem_cells[] = {
  67         {
  68                 .name           = "blackbox",
  69                 .offset         = ADM1266_BLACKBOX_OFFSET,
  70                 .bytes          = 2048,
  71         },
  72 };
  73
  74 DECLARE_CRC8_TABLE(pmbus_crc_table);
  75
  76 /*
  77  * Different from Block Read as it sends data and waits for the slave to
  78  * return a value dependent on that data. The protocol is simply a Write Block
  79  * followed by a Read Block without the Read-Block command field and the
  80  * Write-Block STOP bit.
  81  */
  82 static int adm1266_pmbus_block_xfer(struct adm1266_data *data, u8 cmd, u8 w_len, u8 *data_w,
  83                                     u8 *data_r)
  84 {
  85         struct i2c_client *client = data->client;
  86         struct i2c_msg msgs[2] = {
  87                 {
  88                         .addr = client->addr,
  89                         .flags = I2C_M_DMA_SAFE,
  90                         .buf = data->write_buf,
  91                         .len = w_len + 2,
  92                 },
  93                 {
  94                         .addr = client->addr,
  95                         .flags = I2C_M_RD | I2C_M_DMA_SAFE,
  96                         .buf = data->read_buf,
  97                         .len = ADM1266_PMBUS_BLOCK_MAX + 2,
  98                 }
  99         };
 100         u8 addr;
 101         u8 crc;
 102         int ret;
 103
 104         mutex_lock(&data->buf_mutex);
 105
 106         msgs[0].buf[0] = cmd;
 107         msgs[0].buf[1] = w_len;
 108         memcpy(&msgs[0].buf[2], data_w, w_len);
 109
 110         ret = i2c_transfer(client->adapter, msgs, 2);
 111         if (ret != 2) {
 112                 if (ret >= 0)
 113                         ret = -EPROTO;
 114
 115                 mutex_unlock(&data->buf_mutex);
 116
 117                 return ret;
 118         }
 119
 120         if (client->flags & I2C_CLIENT_PEC) {
 121                 addr = i2c_8bit_addr_from_msg(&msgs[0]);
 122                 crc = crc8(pmbus_crc_table, &addr, 1, 0);
 123                 crc = crc8(pmbus_crc_table, msgs[0].buf,  msgs[0].len, crc);
 124
 125                 addr = i2c_8bit_addr_from_msg(&msgs[1]);
 126                 crc = crc8(pmbus_crc_table, &addr, 1, crc);
 127                 crc = crc8(pmbus_crc_table, msgs[1].buf,  msgs[1].buf[0] + 1, crc);
 128
 129                 if (crc != msgs[1].buf[msgs[1].buf[0] + 1]) {
 130                         mutex_unlock(&data->buf_mutex);
 131                         return -EBADMSG;
 132                 }
 133         }
 134
 135         memcpy(data_r, &msgs[1].buf[1], msgs[1].buf[0]);
 136
 137         ret = msgs[1].buf[0];
 138         mutex_unlock(&data->buf_mutex);
 139
 140         return ret;
 141 }
 142
 143 static const unsigned int adm1266_gpio_mapping[ADM1266_GPIO_NR][2] = {
 144         {1, 0},
 145         {2, 1},
 146         {3, 2},
 147         {4, 8},
 148         {5, 9},
 149         {6, 10},
 150         {7, 11},
 151         {8, 6},
 152         {9, 7},
 153 };
 154
 155 static const char *adm1266_names[ADM1266_GPIO_NR + ADM1266_PDIO_NR] = {
 156         "GPIO1", "GPIO2", "GPIO3", "GPIO4", "GPIO5", "GPIO6", "GPIO7", "GPIO8",
 157         "GPIO9", "PDIO1", "PDIO2", "PDIO3", "PDIO4", "PDIO5", "PDIO6",
 158         "PDIO7", "PDIO8", "PDIO9", "PDIO10", "PDIO11", "PDIO12", "PDIO13",
 159         "PDIO14", "PDIO15", "PDIO16",
 160 };
 161
 162 static int adm1266_gpio_get(struct gpio_chip *chip, unsigned int offset)
 163 {
 164         struct adm1266_data *data = gpiochip_get_data(chip);
 165         u8 read_buf[I2C_SMBUS_BLOCK_MAX + 1];
 166         unsigned long pins_status;
 167         unsigned int pmbus_cmd;
 168         int ret;
 169
 170         if (offset < ADM1266_GPIO_NR)
 171                 pmbus_cmd = ADM1266_GPIO_STATUS;
 172         else
 173                 pmbus_cmd = ADM1266_PDIO_STATUS;
 174
 175         ret = i2c_smbus_read_block_data(data->client, pmbus_cmd, read_buf);
 176         if (ret < 0)
 177                 return ret;
 178
 179         pins_status = read_buf[0] + (read_buf[1] << 8);
 180         if (offset < ADM1266_GPIO_NR)
 181                 return test_bit(adm1266_gpio_mapping[offset][1], &pins_status);
 182
 183         return test_bit(offset - ADM1266_GPIO_NR, &pins_status);
 184 }
 185
 186 static int adm1266_gpio_get_multiple(struct gpio_chip *chip, unsigned long *mask,
 187                                      unsigned long *bits)
 188 {
 189         struct adm1266_data *data = gpiochip_get_data(chip);
 190         u8 read_buf[ADM1266_PMBUS_BLOCK_MAX + 1];
 191         unsigned long status;
 192         unsigned int gpio_nr;
 193         int ret;
 194
 195         ret = i2c_smbus_read_block_data(data->client, ADM1266_GPIO_STATUS, read_buf);
 196         if (ret < 0)
 197                 return ret;
 198
 199         status = read_buf[0] + (read_buf[1] << 8);
 200
 201         *bits = 0;
 202         for_each_set_bit(gpio_nr, mask, ADM1266_GPIO_NR) {
 203                 if (test_bit(adm1266_gpio_mapping[gpio_nr][1], &status))
 204                         set_bit(gpio_nr, bits);
 205         }
 206
 207         ret = i2c_smbus_read_block_data(data->client, ADM1266_PDIO_STATUS, read_buf);
 208         if (ret < 0)
 209                 return ret;
 210
 211         status = read_buf[0] + (read_buf[1] << 8);
 212
 213         *bits = 0;
 214         for_each_set_bit_from(gpio_nr, mask, ADM1266_GPIO_NR + ADM1266_PDIO_STATUS) {
 215                 if (test_bit(gpio_nr - ADM1266_GPIO_NR, &status))
 216                         set_bit(gpio_nr, bits);
 217         }
 218
 219         return 0;
 220 }
 221
 222 static void adm1266_gpio_dbg_show(struct seq_file *s, struct gpio_chip *chip)
 223 {
 224         struct adm1266_data *data = gpiochip_get_data(chip);
 225         u8 read_buf[ADM1266_PMBUS_BLOCK_MAX + 1];
 226         unsigned long gpio_config;
 227         unsigned long pdio_config;
 228         unsigned long pin_cfg;
 229         u8 write_cmd;
 230         int ret;
 231         int i;
 232
 233         for (i = 0; i < ADM1266_GPIO_NR; i++) {
 234                 write_cmd = adm1266_gpio_mapping[i][1];
 235                 ret = adm1266_pmbus_block_xfer(data, ADM1266_GPIO_CONFIG, 1, &write_cmd, read_buf);
 236                 if (ret != 2)
 237                         return;
 238
 239                 gpio_config = read_buf[0];
 240                 seq_puts(s, adm1266_names[i]);
 241
 242                 seq_puts(s, " ( ");
 243                 if (!ADM1266_GPIO_FUNCTIONS(gpio_config)) {
 244                         seq_puts(s, "high-Z )\n");
 245                         continue;
 246                 }
 247                 if (ADM1266_GPIO_INPUT_EN(gpio_config))
 248                         seq_puts(s, "input ");
 249                 if (ADM1266_GPIO_OUTPUT_EN(gpio_config))
 250                         seq_puts(s, "output ");
 251                 if (ADM1266_GPIO_OPEN_DRAIN(gpio_config))
 252                         seq_puts(s, "open-drain )\n");
 253                 else
 254                         seq_puts(s, "push-pull )\n");
 255         }
 256
 257         write_cmd = 0xFF;
 258         ret = adm1266_pmbus_block_xfer(data, ADM1266_PDIO_CONFIG, 1, &write_cmd, read_buf);
 259         if (ret != 32)
 260                 return;
 261
 262         for (i = 0; i < ADM1266_PDIO_NR; i++) {
 263                 seq_puts(s, adm1266_names[ADM1266_GPIO_NR + i]);
 264
 265                 pdio_config = read_buf[2 * i];
 266                 pdio_config += (read_buf[2 * i + 1] << 8);
 267                 pin_cfg = ADM1266_PDIO_PIN_CFG(pdio_config);
 268
 269                 seq_puts(s, " ( ");
 270                 if (!pin_cfg || pin_cfg > 5) {
 271                         seq_puts(s, "high-Z )\n");
 272                         continue;
 273                 }
 274
 275                 if (pin_cfg & BIT(0))
 276                         seq_puts(s, "output ");
 277
 278                 if (pin_cfg & BIT(1))
 279                         seq_puts(s, "input ");
 280
 281                 seq_puts(s, ")\n");
 282         }
 283 }
 284
 285 static int adm1266_config_gpio(struct adm1266_data *data)
 286 {
 287         const char *name = dev_name(&data->client->dev);
 288         char *gpio_name;
 289         int ret;
 290         int i;
 291
 292         for (i = 0; i < ARRAY_SIZE(data->gpio_names); i++) {
 293                 gpio_name = devm_kasprintf(&data->client->dev, GFP_KERNEL, "adm1266-%x-%s",
 294                                            data->client->addr, adm1266_names[i]);
 295                 if (!gpio_name)
 296                         return -ENOMEM;
 297
 298                 data->gpio_names[i] = gpio_name;
 299         }
 300
 301         data->gc.label = name;
 302         data->gc.parent = &data->client->dev;
 303         data->gc.owner = THIS_MODULE;
 304         data->gc.base = -1;
 305         data->gc.names = data->gpio_names;
 306         data->gc.ngpio = ARRAY_SIZE(data->gpio_names);
 307         data->gc.get = adm1266_gpio_get;
 308         data->gc.get_multiple = adm1266_gpio_get_multiple;
 309         data->gc.dbg_show = adm1266_gpio_dbg_show;
 310
 311         ret = devm_gpiochip_add_data(&data->client->dev, &data->gc, data);
 312         if (ret)
 313                 dev_err(&data->client->dev, "GPIO registering failed (%d)\n", ret);
 314
 315         return ret;
 316 }
 317
 318 static int adm1266_state_read(struct seq_file *s, void *pdata)
 319 {
 320         struct device *dev = s->private;
 321         struct i2c_client *client = to_i2c_client(dev);
 322         int ret;
 323
 324         ret = i2c_smbus_read_word_data(client, ADM1266_READ_STATE);
 325         if (ret < 0)
 326                 return ret;
 327
 328         seq_printf(s, "%d\n", ret);
 329
 330         return 0;
 331 }
 332
 333 static void adm1266_init_debugfs(struct adm1266_data *data)
 334 {
 335         struct dentry *root;
 336
 337         root = pmbus_get_debugfs_dir(data->client);
 338         if (!root)
 339                 return;
 340
 341         data->debugfs_dir = debugfs_create_dir(data->client->name, root);
 342         if (!data->debugfs_dir)
 343                 return;
 344
 345         debugfs_create_devm_seqfile(&data->client->dev, "sequencer_state", data->debugfs_dir,
 346                                     adm1266_state_read);
 347 }
 348
 349 static int adm1266_nvmem_read_blackbox(struct adm1266_data *data, u8 *read_buff)
 350 {
 351         int record_count;
 352         char index;
 353         u8 buf[5];
 354         int ret;
 355
 356         ret = i2c_smbus_read_block_data(data->client, ADM1266_BLACKBOX_INFO, buf);
 357         if (ret < 0)
 358                 return ret;
 359
 360         if (ret != 4)
 361                 return -EIO;
 362
 363         record_count = buf[3];
 364
 365         for (index = 0; index < record_count; index++) {
 366                 ret = adm1266_pmbus_block_xfer(data, ADM1266_READ_BLACKBOX, 1, &index, read_buff);
 367                 if (ret < 0)
 368                         return ret;
 369
 370                 if (ret != ADM1266_BLACKBOX_SIZE)
 371                         return -EIO;
 372
 373                 read_buff += ADM1266_BLACKBOX_SIZE;
 374         }
 375
 376         return 0;
 377 }
 378
 379 static int adm1266_nvmem_read(void *priv, unsigned int offset, void *val, size_t bytes)
 380 {
 381         struct adm1266_data *data = priv;
 382         int ret;
 383
 384         if (offset + bytes > data->nvmem_config.size)
 385                 return -EINVAL;
 386
 387         if (offset == 0) {
 388                 memset(data->dev_mem, 0, data->nvmem_config.size);
 389
 390                 ret = adm1266_nvmem_read_blackbox(data, data->dev_mem);
 391                 if (ret) {
 392                         dev_err(&data->client->dev, "Could not read blackbox!");
 393                         return ret;
 394                 }
 395         }
 396
 397         memcpy(val, data->dev_mem + offset, bytes);
 398
 399         return 0;
 400 }
 401
 402 static int adm1266_config_nvmem(struct adm1266_data *data)
 403 {
 404         data->nvmem_config.name = dev_name(&data->client->dev);
 405         data->nvmem_config.dev = &data->client->dev;
 406         data->nvmem_config.root_only = true;
 407         data->nvmem_config.read_only = true;
 408         data->nvmem_config.owner = THIS_MODULE;
 409         data->nvmem_config.reg_read = adm1266_nvmem_read;
 410         data->nvmem_config.cells = adm1266_nvmem_cells;
 411         data->nvmem_config.ncells = ARRAY_SIZE(adm1266_nvmem_cells);
 412         data->nvmem_config.priv = data;
 413         data->nvmem_config.stride = 1;
 414         data->nvmem_config.word_size = 1;
 415         data->nvmem_config.size = adm1266_nvmem_cells[0].bytes;
 416
 417         data->dev_mem = devm_kzalloc(&data->client->dev, data->nvmem_config.size, GFP_KERNEL);
 418         if (!data->dev_mem)
 419                 return -ENOMEM;
 420
 421         data->nvmem = devm_nvmem_register(&data->client->dev, &data->nvmem_config);
 422         if (IS_ERR(data->nvmem)) {
 423                 dev_err(&data->client->dev, "Could not register nvmem!");
 424                 return PTR_ERR(data->nvmem);
 425         }
 426
 427         return 0;
 428 }
 429
 430 static int adm1266_set_rtc(struct adm1266_data *data)
 431 {
 432         time64_t kt;
 433         char write_buf[6];
 434         int i;
 435
 436         kt = ktime_get_seconds();
 437
 438         memset(write_buf, 0, sizeof(write_buf));
 439
 440         for (i = 0; i < 4; i++)
 441                 write_buf[2 + i] = (kt >> (i * 8)) & 0xFF;
 442
 443         return i2c_smbus_write_block_data(data->client, ADM1266_SET_RTC, sizeof(write_buf),
 444                                           write_buf);
 445 }
 446
 447 static int adm1266_probe(struct i2c_client *client)
 448 {
 449         struct adm1266_data *data;
 450         int ret;
 451         int i;
 452
 453         data = devm_kzalloc(&client->dev, sizeof(struct adm1266_data), GFP_KERNEL);
 454         if (!data)
 455                 return -ENOMEM;
 456
 457         data->client = client;
 458         data->info.pages = 17;
 459         data->info.format[PSC_VOLTAGE_OUT] = linear;
 460         for (i = 0; i < data->info.pages; i++)
 461                 data->info.func[i] = PMBUS_HAVE_VOUT | PMBUS_HAVE_STATUS_VOUT;
 462
 463         crc8_populate_msb(pmbus_crc_table, 0x7);
 464         mutex_init(&data->buf_mutex);
 465
 466         ret = adm1266_config_gpio(data);
 467         if (ret < 0)
 468                 return ret;
 469
 470         ret = adm1266_set_rtc(data);
 471         if (ret < 0)
 472                 return ret;
 473
 474         ret = adm1266_config_nvmem(data);
 475         if (ret < 0)
 476                 return ret;
 477
 478         ret = pmbus_do_probe(client, &data->info);
 479         if (ret)
 480                 return ret;
 481
 482         adm1266_init_debugfs(data);
 483
 484         return 0;
 485 }
 486
 487 static const struct of_device_id adm1266_of_match[] = {
 488         { .compatible = "adi,adm1266" },
 489         { }
 490 };
 491 MODULE_DEVICE_TABLE(of, adm1266_of_match);
 492
 493 static const struct i2c_device_id adm1266_id[] = {
 494         { "adm1266", 0 },
 495         { }
 496 };
 497 MODULE_DEVICE_TABLE(i2c, adm1266_id);
 498
 499 static struct i2c_driver adm1266_driver = {
 500         .driver = {
 501                    .name = "adm1266",
 502                    .of_match_table = adm1266_of_match,
 503                   },
 504         .probe_new = adm1266_probe,
 505         .id_table = adm1266_id,
 506 };
 507
 508 module_i2c_driver(adm1266_driver);
 509
 510 MODULE_AUTHOR("Alexandru Tachici <alexandru.tachici@analog.com>");
 511 MODULE_DESCRIPTION("PMBus driver for Analog Devices ADM1266");
 512 MODULE_LICENSE("GPL v2");