drivers/w1/slaves/w1_ds28e17.c

   1 // SPDX-License-Identifier: GPL-2.0-only
   2 /*
   3  *      w1_ds28e17.c - w1 family 19 (DS28E17) driver
   4  *
   5  * Copyright (c) 2016 Jan Kandziora <jjj@gmx.de>
   6  */
   7
   8 #include <linux/crc16.h>
   9 #include <linux/delay.h>
  10 #include <linux/device.h>
  11 #include <linux/i2c.h>
  12 #include <linux/kernel.h>
  13 #include <linux/module.h>
  14 #include <linux/moduleparam.h>
  15 #include <linux/slab.h>
  16 #include <linux/types.h>
  17 #include <linux/uaccess.h>
  18
  19 #define CRC16_INIT 0
  20
  21 #include <linux/w1.h>
  22
  23 #define W1_FAMILY_DS28E17 0x19
  24
  25 /* Module setup. */
  26 MODULE_LICENSE("GPL v2");
  27 MODULE_AUTHOR("Jan Kandziora <jjj@gmx.de>");
  28 MODULE_DESCRIPTION("w1 family 19 driver for DS28E17, 1-wire to I2C master bridge");
  29 MODULE_ALIAS("w1-family-" __stringify(W1_FAMILY_DS28E17));
  30
  31
  32 /* Default I2C speed to be set when a DS28E17 is detected. */
  33 static int i2c_speed = 100;
  34 module_param_named(speed, i2c_speed, int, (S_IRUSR | S_IWUSR));
  35 MODULE_PARM_DESC(speed, "Default I2C speed to be set when a DS28E17 is detected");
  36
  37 /* Default I2C stretch value to be set when a DS28E17 is detected. */
  38 static char i2c_stretch = 1;
  39 module_param_named(stretch, i2c_stretch, byte, (S_IRUSR | S_IWUSR));
  40 MODULE_PARM_DESC(stretch, "Default I2C stretch value to be set when a DS28E17 is detected");
  41
  42 /* DS28E17 device command codes. */
  43 #define W1_F19_WRITE_DATA_WITH_STOP      0x4B
  44 #define W1_F19_WRITE_DATA_NO_STOP        0x5A
  45 #define W1_F19_WRITE_DATA_ONLY           0x69
  46 #define W1_F19_WRITE_DATA_ONLY_WITH_STOP 0x78
  47 #define W1_F19_READ_DATA_WITH_STOP       0x87
  48 #define W1_F19_WRITE_READ_DATA_WITH_STOP 0x2D
  49 #define W1_F19_WRITE_CONFIGURATION       0xD2
  50 #define W1_F19_READ_CONFIGURATION        0xE1
  51 #define W1_F19_ENABLE_SLEEP_MODE         0x1E
  52 #define W1_F19_READ_DEVICE_REVISION      0xC4
  53
  54 /* DS28E17 status bits */
  55 #define W1_F19_STATUS_CRC     0x01
  56 #define W1_F19_STATUS_ADDRESS 0x02
  57 #define W1_F19_STATUS_START   0x08
  58
  59 /*
  60  * Maximum number of I2C bytes to transfer within one CRC16 protected onewire
  61  * command.
  62  * */
  63 #define W1_F19_WRITE_DATA_LIMIT 255
  64
  65 /* Maximum number of I2C bytes to read with one onewire command. */
  66 #define W1_F19_READ_DATA_LIMIT 255
  67
  68 /* Constants for calculating the busy sleep. */
  69 #define W1_F19_BUSY_TIMEBASES { 90, 23, 10 }
  70 #define W1_F19_BUSY_GRATUITY  1000
  71
  72 /* Number of checks for the busy flag before timeout. */
  73 #define W1_F19_BUSY_CHECKS 1000
  74
  75
  76 /* Slave specific data. */
  77 struct w1_f19_data {
  78         u8 speed;
  79         u8 stretch;
  80         struct i2c_adapter adapter;
  81 };
  82
  83
  84 /* Wait a while until the busy flag clears. */
  85 static int w1_f19_i2c_busy_wait(struct w1_slave *sl, size_t count)
  86 {
  87         const unsigned long timebases[3] = W1_F19_BUSY_TIMEBASES;
  88         struct w1_f19_data *data = sl->family_data;
  89         unsigned int checks;
  90
  91         /* Check the busy flag first in any case.*/
  92         if (w1_touch_bit(sl->master, 1) == 0)
  93                 return 0;
  94
  95         /*
  96          * Do a generously long sleep in the beginning,
  97          * as we have to wait at least this time for all
  98          * the I2C bytes at the given speed to be transferred.
  99          */
 100         usleep_range(timebases[data->speed] * (data->stretch) * count,
 101                 timebases[data->speed] * (data->stretch) * count
 102                 + W1_F19_BUSY_GRATUITY);
 103
 104         /* Now continusly check the busy flag sent by the DS28E17. */
 105         checks = W1_F19_BUSY_CHECKS;
 106         while ((checks--) > 0) {
 107                 /* Return success if the busy flag is cleared. */
 108                 if (w1_touch_bit(sl->master, 1) == 0)
 109                         return 0;
 110
 111                 /* Wait one non-streched byte timeslot. */
 112                 udelay(timebases[data->speed]);
 113         }
 114
 115         /* Timeout. */
 116         dev_warn(&sl->dev, "busy timeout\n");
 117         return -ETIMEDOUT;
 118 }
 119
 120
 121 /* Utility function: result. */
 122 static size_t w1_f19_error(struct w1_slave *sl, u8 w1_buf[])
 123 {
 124         /* Warnings. */
 125         if (w1_buf[0] & W1_F19_STATUS_CRC)
 126                 dev_warn(&sl->dev, "crc16 mismatch\n");
 127         if (w1_buf[0] & W1_F19_STATUS_ADDRESS)
 128                 dev_warn(&sl->dev, "i2c device not responding\n");
 129         if ((w1_buf[0] & (W1_F19_STATUS_CRC | W1_F19_STATUS_ADDRESS)) == 0
 130                         && w1_buf[1] != 0) {
 131                 dev_warn(&sl->dev, "i2c short write, %d bytes not acknowledged\n",
 132                         w1_buf[1]);
 133         }
 134
 135         /* Check error conditions. */
 136         if (w1_buf[0] & W1_F19_STATUS_ADDRESS)
 137                 return -ENXIO;
 138         if (w1_buf[0] & W1_F19_STATUS_START)
 139                 return -EAGAIN;
 140         if (w1_buf[0] != 0 || w1_buf[1] != 0)
 141                 return -EIO;
 142
 143         /* All ok. */
 144         return 0;
 145 }
 146
 147
 148 /* Utility function: write data to I2C slave, single chunk. */
 149 static int __w1_f19_i2c_write(struct w1_slave *sl,
 150         const u8 *command, size_t command_count,
 151         const u8 *buffer, size_t count)
 152 {
 153         u16 crc;
 154         int error;
 155         u8 w1_buf[2];
 156
 157         /* Send command and I2C data to DS28E17. */
 158         crc = crc16(CRC16_INIT, command, command_count);
 159         w1_write_block(sl->master, command, command_count);
 160
 161         w1_buf[0] = count;
 162         crc = crc16(crc, w1_buf, 1);
 163         w1_write_8(sl->master, w1_buf[0]);
 164
 165         crc = crc16(crc, buffer, count);
 166         w1_write_block(sl->master, buffer, count);
 167
 168         w1_buf[0] = ~(crc & 0xFF);
 169         w1_buf[1] = ~((crc >> 8) & 0xFF);
 170         w1_write_block(sl->master, w1_buf, 2);
 171
 172         /* Wait until busy flag clears (or timeout). */
 173         if (w1_f19_i2c_busy_wait(sl, count + 1) < 0)
 174                 return -ETIMEDOUT;
 175
 176         /* Read status from DS28E17. */
 177         w1_read_block(sl->master, w1_buf, 2);
 178
 179         /* Check error conditions. */
 180         error = w1_f19_error(sl, w1_buf);
 181         if (error < 0)
 182                 return error;
 183
 184         /* Return number of bytes written. */
 185         return count;
 186 }
 187
 188
 189 /* Write data to I2C slave. */
 190 static int w1_f19_i2c_write(struct w1_slave *sl, u16 i2c_address,
 191         const u8 *buffer, size_t count, bool stop)
 192 {
 193         int result;
 194         int remaining = count;
 195         const u8 *p;
 196         u8 command[2];
 197
 198         /* Check input. */
 199         if (count == 0)
 200                 return -EOPNOTSUPP;
 201
 202         /* Check whether we need multiple commands. */
 203         if (count <= W1_F19_WRITE_DATA_LIMIT) {
 204                 /*
 205                  * Small data amount. Data can be sent with
 206                  * a single onewire command.
 207                  */
 208
 209                 /* Send all data to DS28E17. */
 210                 command[0] = (stop ? W1_F19_WRITE_DATA_WITH_STOP
 211                         : W1_F19_WRITE_DATA_NO_STOP);
 212                 command[1] = i2c_address << 1;
 213                 result = __w1_f19_i2c_write(sl, command, 2, buffer, count);
 214         } else {
 215                 /* Large data amount. Data has to be sent in multiple chunks. */
 216
 217                 /* Send first chunk to DS28E17. */
 218                 p = buffer;
 219                 command[0] = W1_F19_WRITE_DATA_NO_STOP;
 220                 command[1] = i2c_address << 1;
 221                 result = __w1_f19_i2c_write(sl, command, 2, p,
 222                         W1_F19_WRITE_DATA_LIMIT);
 223                 if (result < 0)
 224                         return result;
 225
 226                 /* Resume to same DS28E17. */
 227                 if (w1_reset_resume_command(sl->master))
 228                         return -EIO;
 229
 230                 /* Next data chunk. */
 231                 p += W1_F19_WRITE_DATA_LIMIT;
 232                 remaining -= W1_F19_WRITE_DATA_LIMIT;
 233
 234                 while (remaining > W1_F19_WRITE_DATA_LIMIT) {
 235                         /* Send intermediate chunk to DS28E17. */
 236                         command[0] = W1_F19_WRITE_DATA_ONLY;
 237                         result = __w1_f19_i2c_write(sl, command, 1, p,
 238                                         W1_F19_WRITE_DATA_LIMIT);
 239                         if (result < 0)
 240                                 return result;
 241
 242                         /* Resume to same DS28E17. */
 243                         if (w1_reset_resume_command(sl->master))
 244                                 return -EIO;
 245
 246                         /* Next data chunk. */
 247                         p += W1_F19_WRITE_DATA_LIMIT;
 248                         remaining -= W1_F19_WRITE_DATA_LIMIT;
 249                 }
 250
 251                 /* Send final chunk to DS28E17. */
 252                 command[0] = (stop ? W1_F19_WRITE_DATA_ONLY_WITH_STOP
 253                         : W1_F19_WRITE_DATA_ONLY);
 254                 result = __w1_f19_i2c_write(sl, command, 1, p, remaining);
 255         }
 256
 257         return result;
 258 }
 259
 260
 261 /* Read data from I2C slave. */
 262 static int w1_f19_i2c_read(struct w1_slave *sl, u16 i2c_address,
 263         u8 *buffer, size_t count)
 264 {
 265         u16 crc;
 266         int error;
 267         u8 w1_buf[5];
 268
 269         /* Check input. */
 270         if (count == 0)
 271                 return -EOPNOTSUPP;
 272
 273         /* Send command to DS28E17. */
 274         w1_buf[0] = W1_F19_READ_DATA_WITH_STOP;
 275         w1_buf[1] = i2c_address << 1 | 0x01;
 276         w1_buf[2] = count;
 277         crc = crc16(CRC16_INIT, w1_buf, 3);
 278         w1_buf[3] = ~(crc & 0xFF);
 279         w1_buf[4] = ~((crc >> 8) & 0xFF);
 280         w1_write_block(sl->master, w1_buf, 5);
 281
 282         /* Wait until busy flag clears (or timeout). */
 283         if (w1_f19_i2c_busy_wait(sl, count + 1) < 0)
 284                 return -ETIMEDOUT;
 285
 286         /* Read status from DS28E17. */
 287         w1_buf[0] = w1_read_8(sl->master);
 288         w1_buf[1] = 0;
 289
 290         /* Check error conditions. */
 291         error = w1_f19_error(sl, w1_buf);
 292         if (error < 0)
 293                 return error;
 294
 295         /* Read received I2C data from DS28E17. */
 296         return w1_read_block(sl->master, buffer, count);
 297 }
 298
 299
 300 /* Write to, then read data from I2C slave. */
 301 static int w1_f19_i2c_write_read(struct w1_slave *sl, u16 i2c_address,
 302         const u8 *wbuffer, size_t wcount, u8 *rbuffer, size_t rcount)
 303 {
 304         u16 crc;
 305         int error;
 306         u8 w1_buf[3];
 307
 308         /* Check input. */
 309         if (wcount == 0 || rcount == 0)
 310                 return -EOPNOTSUPP;
 311
 312         /* Send command and I2C data to DS28E17. */
 313         w1_buf[0] = W1_F19_WRITE_READ_DATA_WITH_STOP;
 314         w1_buf[1] = i2c_address << 1;
 315         w1_buf[2] = wcount;
 316         crc = crc16(CRC16_INIT, w1_buf, 3);
 317         w1_write_block(sl->master, w1_buf, 3);
 318
 319         crc = crc16(crc, wbuffer, wcount);
 320         w1_write_block(sl->master, wbuffer, wcount);
 321
 322         w1_buf[0] = rcount;
 323         crc = crc16(crc, w1_buf, 1);
 324         w1_buf[1] = ~(crc & 0xFF);
 325         w1_buf[2] = ~((crc >> 8) & 0xFF);
 326         w1_write_block(sl->master, w1_buf, 3);
 327
 328         /* Wait until busy flag clears (or timeout). */
 329         if (w1_f19_i2c_busy_wait(sl, wcount + rcount + 2) < 0)
 330                 return -ETIMEDOUT;
 331
 332         /* Read status from DS28E17. */
 333         w1_read_block(sl->master, w1_buf, 2);
 334
 335         /* Check error conditions. */
 336         error = w1_f19_error(sl, w1_buf);
 337         if (error < 0)
 338                 return error;
 339
 340         /* Read received I2C data from DS28E17. */
 341         return w1_read_block(sl->master, rbuffer, rcount);
 342 }
 343
 344
 345 /* Do an I2C master transfer. */
 346 static int w1_f19_i2c_master_transfer(struct i2c_adapter *adapter,
 347         struct i2c_msg *msgs, int num)
 348 {
 349         struct w1_slave *sl = (struct w1_slave *) adapter->algo_data;
 350         int i = 0;
 351         int result = 0;
 352
 353         /* Start onewire transaction. */
 354         mutex_lock(&sl->master->bus_mutex);
 355
 356         /* Select DS28E17. */
 357         if (w1_reset_select_slave(sl)) {
 358                 i = -EIO;
 359                 goto error;
 360         }
 361
 362         /* Loop while there are still messages to transfer. */
 363         while (i < num) {
 364                 /*
 365                  * Check for special case: Small write followed
 366                  * by read to same I2C device.
 367                  */
 368                 if (i < (num-1)
 369                         && msgs[i].addr == msgs[i+1].addr
 370                         && !(msgs[i].flags & I2C_M_RD)
 371                         && (msgs[i+1].flags & I2C_M_RD)
 372                         && (msgs[i].len <= W1_F19_WRITE_DATA_LIMIT)) {
 373                         /*
 374                          * The DS28E17 has a combined transfer
 375                          * for small write+read.
 376                          */
 377                         result = w1_f19_i2c_write_read(sl, msgs[i].addr,
 378                                 msgs[i].buf, msgs[i].len,
 379                                 msgs[i+1].buf, msgs[i+1].len);
 380                         if (result < 0) {
 381                                 i = result;
 382                                 goto error;
 383                         }
 384
 385                         /*
 386                          * Check if we should interpret the read data
 387                          * as a length byte. The DS28E17 unfortunately
 388                          * has no read without stop, so we can just do
 389                          * another simple read in that case.
 390                          */
 391                         if (msgs[i+1].flags & I2C_M_RECV_LEN) {
 392                                 result = w1_f19_i2c_read(sl, msgs[i+1].addr,
 393                                         &(msgs[i+1].buf[1]), msgs[i+1].buf[0]);
 394                                 if (result < 0) {
 395                                         i = result;
 396                                         goto error;
 397                                 }
 398                         }
 399
 400                         /* Eat up read message, too. */
 401                         i++;
 402                 } else if (msgs[i].flags & I2C_M_RD) {
 403                         /* Read transfer. */
 404                         result = w1_f19_i2c_read(sl, msgs[i].addr,
 405                                 msgs[i].buf, msgs[i].len);
 406                         if (result < 0) {
 407                                 i = result;
 408                                 goto error;
 409                         }
 410
 411                         /*
 412                          * Check if we should interpret the read data
 413                          * as a length byte. The DS28E17 unfortunately
 414                          * has no read without stop, so we can just do
 415                          * another simple read in that case.
 416                          */
 417                         if (msgs[i].flags & I2C_M_RECV_LEN) {
 418                                 result = w1_f19_i2c_read(sl,
 419                                         msgs[i].addr,
 420                                         &(msgs[i].buf[1]),
 421                                         msgs[i].buf[0]);
 422                                 if (result < 0) {
 423                                         i = result;
 424                                         goto error;
 425                                 }
 426                         }
 427                 } else {
 428                         /*
 429                          * Write transfer.
 430                          * Stop condition only for last
 431                          * transfer.
 432                          */
 433                         result = w1_f19_i2c_write(sl,
 434                                 msgs[i].addr,
 435                                 msgs[i].buf,
 436                                 msgs[i].len,
 437                                 i == (num-1));
 438                         if (result < 0) {
 439                                 i = result;
 440                                 goto error;
 441                         }
 442                 }
 443
 444                 /* Next message. */
 445                 i++;
 446
 447                 /* Are there still messages to send/receive? */
 448                 if (i < num) {
 449                         /* Yes. Resume to same DS28E17. */
 450                         if (w1_reset_resume_command(sl->master)) {
 451                                 i = -EIO;
 452                                 goto error;
 453                         }
 454                 }
 455         }
 456
 457 error:
 458         /* End onewire transaction. */
 459         mutex_unlock(&sl->master->bus_mutex);
 460
 461         /* Return number of messages processed or error. */
 462         return i;
 463 }
 464
 465
 466 /* Get I2C adapter functionality. */
 467 static u32 w1_f19_i2c_functionality(struct i2c_adapter *adapter)
 468 {
 469         /*
 470          * Plain I2C functions only.
 471          * SMBus is emulated by the kernel's I2C layer.
 472          * No "I2C_FUNC_SMBUS_QUICK"
 473          * No "I2C_FUNC_SMBUS_READ_BLOCK_DATA"
 474          * No "I2C_FUNC_SMBUS_BLOCK_PROC_CALL"
 475          */
 476         return I2C_FUNC_I2C |
 477                 I2C_FUNC_SMBUS_BYTE |
 478                 I2C_FUNC_SMBUS_BYTE_DATA |
 479                 I2C_FUNC_SMBUS_WORD_DATA |
 480                 I2C_FUNC_SMBUS_PROC_CALL |
 481                 I2C_FUNC_SMBUS_WRITE_BLOCK_DATA |
 482                 I2C_FUNC_SMBUS_I2C_BLOCK |
 483                 I2C_FUNC_SMBUS_PEC;
 484 }
 485
 486
 487 /* I2C adapter quirks. */
 488 static const struct i2c_adapter_quirks w1_f19_i2c_adapter_quirks = {
 489         .max_read_len = W1_F19_READ_DATA_LIMIT,
 490 };
 491
 492 /* I2C algorithm. */
 493 static const struct i2c_algorithm w1_f19_i2c_algorithm = {
 494         .master_xfer    = w1_f19_i2c_master_transfer,
 495         .functionality  = w1_f19_i2c_functionality,
 496 };
 497
 498
 499 /* Read I2C speed from DS28E17. */
 500 static int w1_f19_get_i2c_speed(struct w1_slave *sl)
 501 {
 502         struct w1_f19_data *data = sl->family_data;
 503         int result = -EIO;
 504
 505         /* Start onewire transaction. */
 506         mutex_lock(&sl->master->bus_mutex);
 507
 508         /* Select slave. */
 509         if (w1_reset_select_slave(sl))
 510                 goto error;
 511
 512         /* Read slave configuration byte. */
 513         w1_write_8(sl->master, W1_F19_READ_CONFIGURATION);
 514         result = w1_read_8(sl->master);
 515         if (result < 0 || result > 2) {
 516                 result = -EIO;
 517                 goto error;
 518         }
 519
 520         /* Update speed in slave specific data. */
 521         data->speed = result;
 522
 523 error:
 524         /* End onewire transaction. */
 525         mutex_unlock(&sl->master->bus_mutex);
 526
 527         return result;
 528 }
 529
 530
 531 /* Set I2C speed on DS28E17. */
 532 static int __w1_f19_set_i2c_speed(struct w1_slave *sl, u8 speed)
 533 {
 534         struct w1_f19_data *data = sl->family_data;
 535         const int i2c_speeds[3] = { 100, 400, 900 };
 536         u8 w1_buf[2];
 537
 538         /* Select slave. */
 539         if (w1_reset_select_slave(sl))
 540                 return -EIO;
 541
 542         w1_buf[0] = W1_F19_WRITE_CONFIGURATION;
 543         w1_buf[1] = speed;
 544         w1_write_block(sl->master, w1_buf, 2);
 545
 546         /* Update speed in slave specific data. */
 547         data->speed = speed;
 548
 549         dev_info(&sl->dev, "i2c speed set to %d kBaud\n", i2c_speeds[speed]);
 550
 551         return 0;
 552 }
 553
 554 static int w1_f19_set_i2c_speed(struct w1_slave *sl, u8 speed)
 555 {
 556         int result;
 557
 558         /* Start onewire transaction. */
 559         mutex_lock(&sl->master->bus_mutex);
 560
 561         /* Set I2C speed on DS28E17. */
 562         result = __w1_f19_set_i2c_speed(sl, speed);
 563
 564         /* End onewire transaction. */
 565         mutex_unlock(&sl->master->bus_mutex);
 566
 567         return result;
 568 }
 569
 570
 571 /* Sysfs attributes. */
 572
 573 /* I2C speed attribute for a single chip. */
 574 static ssize_t speed_show(struct device *dev, struct device_attribute *attr,
 575                              char *buf)
 576 {
 577         struct w1_slave *sl = dev_to_w1_slave(dev);
 578         int result;
 579
 580         /* Read current speed from slave. Updates data->speed. */
 581         result = w1_f19_get_i2c_speed(sl);
 582         if (result < 0)
 583                 return result;
 584
 585         /* Return current speed value. */
 586         return sprintf(buf, "%d\n", result);
 587 }
 588
 589 static ssize_t speed_store(struct device *dev, struct device_attribute *attr,
 590                               const char *buf, size_t count)
 591 {
 592         struct w1_slave *sl = dev_to_w1_slave(dev);
 593         int error;
 594
 595         /* Valid values are: "100", "400", "900" */
 596         if (count < 3 || count > 4 || !buf)
 597                 return -EINVAL;
 598         if (count == 4 && buf[3] != '\n')
 599                 return -EINVAL;
 600         if (buf[1] != '0' || buf[2] != '0')
 601                 return -EINVAL;
 602
 603         /* Set speed on slave. */
 604         switch (buf[0]) {
 605         case '1':
 606                 error = w1_f19_set_i2c_speed(sl, 0);
 607                 break;
 608         case '4':
 609                 error = w1_f19_set_i2c_speed(sl, 1);
 610                 break;
 611         case '9':
 612                 error = w1_f19_set_i2c_speed(sl, 2);
 613                 break;
 614         default:
 615                 return -EINVAL;
 616         }
 617
 618         if (error < 0)
 619                 return error;
 620
 621         /* Return bytes written. */
 622         return count;
 623 }
 624
 625 static DEVICE_ATTR_RW(speed);
 626
 627
 628 /* Busy stretch attribute for a single chip. */
 629 static ssize_t stretch_show(struct device *dev, struct device_attribute *attr,
 630                              char *buf)
 631 {
 632         struct w1_slave *sl = dev_to_w1_slave(dev);
 633         struct w1_f19_data *data = sl->family_data;
 634
 635         /* Return current stretch value. */
 636         return sprintf(buf, "%d\n", data->stretch);
 637 }
 638
 639 static ssize_t stretch_store(struct device *dev, struct device_attribute *attr,
 640                               const char *buf, size_t count)
 641 {
 642         struct w1_slave *sl = dev_to_w1_slave(dev);
 643         struct w1_f19_data *data = sl->family_data;
 644
 645         /* Valid values are '1' to '9' */
 646         if (count < 1 || count > 2 || !buf)
 647                 return -EINVAL;
 648         if (count == 2 && buf[1] != '\n')
 649                 return -EINVAL;
 650         if (buf[0] < '1' || buf[0] > '9')
 651                 return -EINVAL;
 652
 653         /* Set busy stretch value. */
 654         data->stretch = buf[0] & 0x0F;
 655
 656         /* Return bytes written. */
 657         return count;
 658 }
 659
 660 static DEVICE_ATTR_RW(stretch);
 661
 662
 663 /* All attributes. */
 664 static struct attribute *w1_f19_attrs[] = {
 665         &dev_attr_speed.attr,
 666         &dev_attr_stretch.attr,
 667         NULL,
 668 };
 669
 670 static const struct attribute_group w1_f19_group = {
 671         .attrs          = w1_f19_attrs,
 672 };
 673
 674 static const struct attribute_group *w1_f19_groups[] = {
 675         &w1_f19_group,
 676         NULL,
 677 };
 678
 679
 680 /* Slave add and remove functions. */
 681 static int w1_f19_add_slave(struct w1_slave *sl)
 682 {
 683         struct w1_f19_data *data = NULL;
 684
 685         /* Allocate memory for slave specific data. */
 686         data = devm_kzalloc(&sl->dev, sizeof(*data), GFP_KERNEL);
 687         if (!data)
 688                 return -ENOMEM;
 689         sl->family_data = data;
 690
 691         /* Setup default I2C speed on slave. */
 692         switch (i2c_speed) {
 693         case 100:
 694                 __w1_f19_set_i2c_speed(sl, 0);
 695                 break;
 696         case 400:
 697                 __w1_f19_set_i2c_speed(sl, 1);
 698                 break;
 699         case 900:
 700                 __w1_f19_set_i2c_speed(sl, 2);
 701                 break;
 702         default:
 703                 /*
 704                  * A i2c_speed module parameter of anything else
 705                  * than 100, 400, 900 means not to touch the
 706                  * speed of the DS28E17.
 707                  * We assume 400kBaud, the power-on value.
 708                  */
 709                 data->speed = 1;
 710         }
 711
 712         /*
 713          * Setup default busy stretch
 714          * configuration for the DS28E17.
 715          */
 716         data->stretch = i2c_stretch;
 717
 718         /* Setup I2C adapter. */
 719         data->adapter.owner      = THIS_MODULE;
 720         data->adapter.algo       = &w1_f19_i2c_algorithm;
 721         data->adapter.algo_data  = sl;
 722         strcpy(data->adapter.name, "w1-");
 723         strcat(data->adapter.name, sl->name);
 724         data->adapter.dev.parent = &sl->dev;
 725         data->adapter.quirks     = &w1_f19_i2c_adapter_quirks;
 726
 727         return i2c_add_adapter(&data->adapter);
 728 }
 729
 730 static void w1_f19_remove_slave(struct w1_slave *sl)
 731 {
 732         struct w1_f19_data *family_data = sl->family_data;
 733
 734         /* Delete I2C adapter. */
 735         i2c_del_adapter(&family_data->adapter);
 736
 737         /* Free slave specific data. */
 738         devm_kfree(&sl->dev, family_data);
 739         sl->family_data = NULL;
 740 }
 741
 742
 743 /* Declarations within the w1 subsystem. */
 744 static struct w1_family_ops w1_f19_fops = {
 745         .add_slave = w1_f19_add_slave,
 746         .remove_slave = w1_f19_remove_slave,
 747         .groups = w1_f19_groups,
 748 };
 749
 750 static struct w1_family w1_family_19 = {
 751         .fid = W1_FAMILY_DS28E17,
 752         .fops = &w1_f19_fops,
 753 };
 754
 755
 756 /* Module init and remove functions. */
 757 static int __init w1_f19_init(void)
 758 {
 759         return w1_register_family(&w1_family_19);
 760 }
 761
 762 static void __exit w1_f19_fini(void)
 763 {
 764         w1_unregister_family(&w1_family_19);
 765 }
 766
 767 module_init(w1_f19_init);
 768 module_exit(w1_f19_fini);
 769