drivers/rtc/rtc-pcf2127.c

   1 /*
   2  * An I2C and SPI driver for the NXP PCF2127/29 RTC
   3  * Copyright 2013 Til-Technologies
   4  *
   5  * Author: Renaud Cerrato <r.cerrato@til-technologies.fr>
   6  *
   7  * based on the other drivers in this same directory.
   8  *
   9  * Datasheet: http://cache.nxp.com/documents/data_sheet/PCF2127.pdf
  10  *
  11  * This program is free software; you can redistribute it and/or modify
  12  * it under the terms of the GNU General Public License version 2 as
  13  * published by the Free Software Foundation.
  14  */
  15
  16 #include <linux/i2c.h>
  17 #include <linux/spi/spi.h>
  18 #include <linux/bcd.h>
  19 #include <linux/rtc.h>
  20 #include <linux/slab.h>
  21 #include <linux/module.h>
  22 #include <linux/of.h>
  23 #include <linux/regmap.h>
  24
  25 #define PCF2127_REG_CTRL1       (0x00)  /* Control Register 1 */
  26 #define PCF2127_REG_CTRL2       (0x01)  /* Control Register 2 */
  27
  28 #define PCF2127_REG_CTRL3       (0x02)  /* Control Register 3 */
  29 #define PCF2127_REG_CTRL3_BLF           BIT(2)
  30
  31 #define PCF2127_REG_SC          (0x03)  /* datetime */
  32 #define PCF2127_REG_MN          (0x04)
  33 #define PCF2127_REG_HR          (0x05)
  34 #define PCF2127_REG_DM          (0x06)
  35 #define PCF2127_REG_DW          (0x07)
  36 #define PCF2127_REG_MO          (0x08)
  37 #define PCF2127_REG_YR          (0x09)
  38
  39 #define PCF2127_OSF             BIT(7)  /* Oscillator Fail flag */
  40
  41 struct pcf2127 {
  42         struct rtc_device *rtc;
  43         struct regmap *regmap;
  44 };
  45
  46 /*
  47  * In the routines that deal directly with the pcf2127 hardware, we use
  48  * rtc_time -- month 0-11, hour 0-23, yr = calendar year-epoch.
  49  */
  50 static int pcf2127_rtc_read_time(struct device *dev, struct rtc_time *tm)
  51 {
  52         struct pcf2127 *pcf2127 = dev_get_drvdata(dev);
  53         unsigned char buf[10];
  54         int ret;
  55         int i;
  56
  57         for (i = 0; i <= PCF2127_REG_CTRL3; i++) {
  58                 ret = regmap_read(pcf2127->regmap, PCF2127_REG_CTRL1 + i,
  59                                   (unsigned int *)(buf + i));
  60                 if (ret) {
  61                         dev_err(dev, "%s: read error\n", __func__);
  62                         return ret;
  63                 }
  64         }
  65
  66         ret = regmap_bulk_read(pcf2127->regmap, PCF2127_REG_SC,
  67                                (buf + PCF2127_REG_SC),
  68                                ARRAY_SIZE(buf) - PCF2127_REG_SC);
  69         if (ret) {
  70                 dev_err(dev, "%s: read error\n", __func__);
  71                 return ret;
  72         }
  73
  74         if (buf[PCF2127_REG_CTRL3] & PCF2127_REG_CTRL3_BLF)
  75                 dev_info(dev,
  76                         "low voltage detected, check/replace RTC battery.\n");
  77
  78         if (buf[PCF2127_REG_SC] & PCF2127_OSF) {
  79                 /*
  80                  * no need clear the flag here,
  81                  * it will be cleared once the new date is saved
  82                  */
  83                 dev_warn(dev,
  84                          "oscillator stop detected, date/time is not reliable\n");
  85                 return -EINVAL;
  86         }
  87
  88         dev_dbg(dev,
  89                 "%s: raw data is cr1=%02x, cr2=%02x, cr3=%02x, "
  90                 "sec=%02x, min=%02x, hr=%02x, "
  91                 "mday=%02x, wday=%02x, mon=%02x, year=%02x\n",
  92                 __func__,
  93                 buf[0], buf[1], buf[2],
  94                 buf[3], buf[4], buf[5],
  95                 buf[6], buf[7], buf[8], buf[9]);
  96
  97
  98         tm->tm_sec = bcd2bin(buf[PCF2127_REG_SC] & 0x7F);
  99         tm->tm_min = bcd2bin(buf[PCF2127_REG_MN] & 0x7F);
 100         tm->tm_hour = bcd2bin(buf[PCF2127_REG_HR] & 0x3F); /* rtc hr 0-23 */
 101         tm->tm_mday = bcd2bin(buf[PCF2127_REG_DM] & 0x3F);
 102         tm->tm_wday = buf[PCF2127_REG_DW] & 0x07;
 103         tm->tm_mon = bcd2bin(buf[PCF2127_REG_MO] & 0x1F) - 1; /* rtc mn 1-12 */
 104         tm->tm_year = bcd2bin(buf[PCF2127_REG_YR]);
 105         if (tm->tm_year < 70)
 106                 tm->tm_year += 100;     /* assume we are in 1970...2069 */
 107
 108         dev_dbg(dev, "%s: tm is secs=%d, mins=%d, hours=%d, "
 109                 "mday=%d, mon=%d, year=%d, wday=%d\n",
 110                 __func__,
 111                 tm->tm_sec, tm->tm_min, tm->tm_hour,
 112                 tm->tm_mday, tm->tm_mon, tm->tm_year, tm->tm_wday);
 113
 114         return rtc_valid_tm(tm);
 115 }
 116
 117 static int pcf2127_rtc_set_time(struct device *dev, struct rtc_time *tm)
 118 {
 119         struct pcf2127 *pcf2127 = dev_get_drvdata(dev);
 120         unsigned char buf[7];
 121         int i = 0, err;
 122
 123         dev_dbg(dev, "%s: secs=%d, mins=%d, hours=%d, "
 124                 "mday=%d, mon=%d, year=%d, wday=%d\n",
 125                 __func__,
 126                 tm->tm_sec, tm->tm_min, tm->tm_hour,
 127                 tm->tm_mday, tm->tm_mon, tm->tm_year, tm->tm_wday);
 128
 129         /* hours, minutes and seconds */
 130         buf[i++] = bin2bcd(tm->tm_sec); /* this will also clear OSF flag */
 131         buf[i++] = bin2bcd(tm->tm_min);
 132         buf[i++] = bin2bcd(tm->tm_hour);
 133         buf[i++] = bin2bcd(tm->tm_mday);
 134         buf[i++] = tm->tm_wday & 0x07;
 135
 136         /* month, 1 - 12 */
 137         buf[i++] = bin2bcd(tm->tm_mon + 1);
 138
 139         /* year */
 140         buf[i++] = bin2bcd(tm->tm_year % 100);
 141
 142         /* write register's data */
 143         err = regmap_bulk_write(pcf2127->regmap, PCF2127_REG_SC, buf, i);
 144         if (err) {
 145                 dev_err(dev,
 146                         "%s: err=%d", __func__, err);
 147                 return err;
 148         }
 149
 150         return 0;
 151 }
 152
 153 #ifdef CONFIG_RTC_INTF_DEV
 154 static int pcf2127_rtc_ioctl(struct device *dev,
 155                                 unsigned int cmd, unsigned long arg)
 156 {
 157         struct pcf2127 *pcf2127 = dev_get_drvdata(dev);
 158         int touser;
 159         int ret;
 160
 161         switch (cmd) {
 162         case RTC_VL_READ:
 163                 ret = regmap_read(pcf2127->regmap, PCF2127_REG_CTRL3, &touser);
 164                 if (ret)
 165                         return ret;
 166
 167                 touser = touser & PCF2127_REG_CTRL3_BLF ? 1 : 0;
 168
 169                 if (copy_to_user((void __user *)arg, &touser, sizeof(int)))
 170                         return -EFAULT;
 171                 return 0;
 172         default:
 173                 return -ENOIOCTLCMD;
 174         }
 175 }
 176 #else
 177 #define pcf2127_rtc_ioctl NULL
 178 #endif
 179
 180 static const struct rtc_class_ops pcf2127_rtc_ops = {
 181         .ioctl          = pcf2127_rtc_ioctl,
 182         .read_time      = pcf2127_rtc_read_time,
 183         .set_time       = pcf2127_rtc_set_time,
 184 };
 185
 186 static int pcf2127_probe(struct device *dev, struct regmap *regmap,
 187                         const char *name)
 188 {
 189         struct pcf2127 *pcf2127;
 190
 191         dev_dbg(dev, "%s\n", __func__);
 192
 193         pcf2127 = devm_kzalloc(dev, sizeof(*pcf2127), GFP_KERNEL);
 194         if (!pcf2127)
 195                 return -ENOMEM;
 196
 197         pcf2127->regmap = regmap;
 198
 199         dev_set_drvdata(dev, pcf2127);
 200
 201         pcf2127->rtc = devm_rtc_device_register(dev, name, &pcf2127_rtc_ops,
 202                                                 THIS_MODULE);
 203
 204         return PTR_ERR_OR_ZERO(pcf2127->rtc);
 205 }
 206
 207 #ifdef CONFIG_OF
 208 static const struct of_device_id pcf2127_of_match[] = {
 209         { .compatible = "nxp,pcf2127" },
 210         { .compatible = "nxp,pcf2129" },
 211         {}
 212 };
 213 MODULE_DEVICE_TABLE(of, pcf2127_of_match);
 214 #endif
 215
 216 #if IS_ENABLED(CONFIG_I2C)
 217
 218 static int pcf2127_i2c_write(void *context, const void *data, size_t count)
 219 {
 220         struct device *dev = context;
 221         struct i2c_client *client = to_i2c_client(dev);
 222         int ret;
 223
 224         ret = i2c_master_send(client, data, count);
 225         if (ret != count)
 226                 return ret < 0 ? ret : -EIO;
 227
 228         return 0;
 229 }
 230
 231 static int pcf2127_i2c_gather_write(void *context,
 232                                 const void *reg, size_t reg_size,
 233                                 const void *val, size_t val_size)
 234 {
 235         struct device *dev = context;
 236         struct i2c_client *client = to_i2c_client(dev);
 237         int ret;
 238         void *buf;
 239
 240         if (WARN_ON(reg_size != 1))
 241                 return -EINVAL;
 242
 243         buf = kmalloc(val_size + 1, GFP_KERNEL);
 244         if (!buf)
 245                 return -ENOMEM;
 246
 247         memcpy(buf, reg, 1);
 248         memcpy(buf + 1, val, val_size);
 249
 250         ret = i2c_master_send(client, buf, val_size + 1);
 251
 252         kfree(buf);
 253
 254         if (ret != val_size + 1)
 255                 return ret < 0 ? ret : -EIO;
 256
 257         return 0;
 258 }
 259
 260 static int pcf2127_i2c_read(void *context, const void *reg, size_t reg_size,
 261                                 void *val, size_t val_size)
 262 {
 263         struct device *dev = context;
 264         struct i2c_client *client = to_i2c_client(dev);
 265         int ret;
 266
 267         if (WARN_ON(reg_size != 1))
 268                 return -EINVAL;
 269
 270         ret = i2c_master_send(client, reg, 1);
 271         if (ret != 1)
 272                 return ret < 0 ? ret : -EIO;
 273
 274         ret = i2c_master_recv(client, val, val_size);
 275         if (ret != val_size)
 276                 return ret < 0 ? ret : -EIO;
 277
 278         return 0;
 279 }
 280
 281 /*
 282  * The reason we need this custom regmap_bus instead of using regmap_init_i2c()
 283  * is that the STOP condition is required between set register address and
 284  * read register data when reading from registers.
 285  */
 286 static const struct regmap_bus pcf2127_i2c_regmap = {
 287         .write = pcf2127_i2c_write,
 288         .gather_write = pcf2127_i2c_gather_write,
 289         .read = pcf2127_i2c_read,
 290 };
 291
 292 static struct i2c_driver pcf2127_i2c_driver;
 293
 294 static int pcf2127_i2c_probe(struct i2c_client *client,
 295                                 const struct i2c_device_id *id)
 296 {
 297         struct regmap *regmap;
 298         static const struct regmap_config config = {
 299                 .reg_bits = 8,
 300                 .val_bits = 8,
 301         };
 302
 303         if (!i2c_check_functionality(client->adapter, I2C_FUNC_I2C))
 304                 return -ENODEV;
 305
 306         regmap = devm_regmap_init(&client->dev, &pcf2127_i2c_regmap,
 307                                         &client->dev, &config);
 308         if (IS_ERR(regmap)) {
 309                 dev_err(&client->dev, "%s: regmap allocation failed: %ld\n",
 310                         __func__, PTR_ERR(regmap));
 311                 return PTR_ERR(regmap);
 312         }
 313
 314         return pcf2127_probe(&client->dev, regmap,
 315                                 pcf2127_i2c_driver.driver.name);
 316 }
 317
 318 static const struct i2c_device_id pcf2127_i2c_id[] = {
 319         { "pcf2127", 0 },
 320         { "pcf2129", 0 },
 321         { }
 322 };
 323 MODULE_DEVICE_TABLE(i2c, pcf2127_i2c_id);
 324
 325 static struct i2c_driver pcf2127_i2c_driver = {
 326         .driver         = {
 327                 .name   = "rtc-pcf2127-i2c",
 328                 .of_match_table = of_match_ptr(pcf2127_of_match),
 329         },
 330         .probe          = pcf2127_i2c_probe,
 331         .id_table       = pcf2127_i2c_id,
 332 };
 333
 334 static int pcf2127_i2c_register_driver(void)
 335 {
 336         return i2c_add_driver(&pcf2127_i2c_driver);
 337 }
 338
 339 static void pcf2127_i2c_unregister_driver(void)
 340 {
 341         i2c_del_driver(&pcf2127_i2c_driver);
 342 }
 343
 344 #else
 345
 346 static int pcf2127_i2c_register_driver(void)
 347 {
 348         return 0;
 349 }
 350
 351 static void pcf2127_i2c_unregister_driver(void)
 352 {
 353 }
 354
 355 #endif
 356
 357 #if IS_ENABLED(CONFIG_SPI_MASTER)
 358
 359 static struct spi_driver pcf2127_spi_driver;
 360
 361 static int pcf2127_spi_probe(struct spi_device *spi)
 362 {
 363         static const struct regmap_config config = {
 364                 .reg_bits = 8,
 365                 .val_bits = 8,
 366                 .read_flag_mask = 0xa0,
 367                 .write_flag_mask = 0x20,
 368         };
 369         struct regmap *regmap;
 370
 371         regmap = devm_regmap_init_spi(spi, &config);
 372         if (IS_ERR(regmap)) {
 373                 dev_err(&spi->dev, "%s: regmap allocation failed: %ld\n",
 374                         __func__, PTR_ERR(regmap));
 375                 return PTR_ERR(regmap);
 376         }
 377
 378         return pcf2127_probe(&spi->dev, regmap, pcf2127_spi_driver.driver.name);
 379 }
 380
 381 static const struct spi_device_id pcf2127_spi_id[] = {
 382         { "pcf2127", 0 },
 383         { "pcf2129", 0 },
 384         { }
 385 };
 386 MODULE_DEVICE_TABLE(spi, pcf2127_spi_id);
 387
 388 static struct spi_driver pcf2127_spi_driver = {
 389         .driver         = {
 390                 .name   = "rtc-pcf2127-spi",
 391                 .of_match_table = of_match_ptr(pcf2127_of_match),
 392         },
 393         .probe          = pcf2127_spi_probe,
 394         .id_table       = pcf2127_spi_id,
 395 };
 396
 397 static int pcf2127_spi_register_driver(void)
 398 {
 399         return spi_register_driver(&pcf2127_spi_driver);
 400 }
 401
 402 static void pcf2127_spi_unregister_driver(void)
 403 {
 404         spi_unregister_driver(&pcf2127_spi_driver);
 405 }
 406
 407 #else
 408
 409 static int pcf2127_spi_register_driver(void)
 410 {
 411         return 0;
 412 }
 413
 414 static void pcf2127_spi_unregister_driver(void)
 415 {
 416 }
 417
 418 #endif
 419
 420 static int __init pcf2127_init(void)
 421 {
 422         int ret;
 423
 424         ret = pcf2127_i2c_register_driver();
 425         if (ret) {
 426                 pr_err("Failed to register pcf2127 i2c driver: %d\n", ret);
 427                 return ret;
 428         }
 429
 430         ret = pcf2127_spi_register_driver();
 431         if (ret) {
 432                 pr_err("Failed to register pcf2127 spi driver: %d\n", ret);
 433                 pcf2127_i2c_unregister_driver();
 434         }
 435
 436         return ret;
 437 }
 438 module_init(pcf2127_init)
 439
 440 static void __exit pcf2127_exit(void)
 441 {
 442         pcf2127_spi_unregister_driver();
 443         pcf2127_i2c_unregister_driver();
 444 }
 445 module_exit(pcf2127_exit)
 446
 447 MODULE_AUTHOR("Renaud Cerrato <r.cerrato@til-technologies.fr>");
 448 MODULE_DESCRIPTION("NXP PCF2127/29 RTC driver");
 449 MODULE_LICENSE("GPL v2");