2 * RSB (Reduced Serial Bus) driver.
4 * Author: Chen-Yu Tsai <wens@csie.org>
6 * This file is licensed under the terms of the GNU General Public License
7 * version 2. This program is licensed "as is" without any warranty of any
8 * kind, whether express or implied.
10 * The RSB controller looks like an SMBus controller which only supports
11 * byte and word data transfers. But, it differs from standard SMBus
12 * protocol on several aspects:
13 * - it uses addresses set at runtime to address slaves. Runtime addresses
14 * are sent to slaves using their 12bit hardware addresses. Up to 15
15 * runtime addresses are available.
16 * - it adds a parity bit every 8bits of data and address for read and
17 * write accesses; this replaces the ack bit
18 * - only one read access is required to read a byte (instead of a write
19 * followed by a read access in standard SMBus protocol)
20 * - there's no Ack bit after each read access
22 * This means this bus cannot be used to interface with standard SMBus
23 * devices. Devices known to support this interface include the AXP223,
24 * AXP809, and AXP806 PMICs, and the AC100 audio codec, all from X-Powers.
26 * A description of the operation and wire protocol can be found in the
27 * RSB section of Allwinner's A80 user manual, which can be found at
29 * https://github.com/allwinner-zh/documents/tree/master/A80
31 * This document is officially released by Allwinner.
33 * This driver is based on i2c-sun6i-p2wi.c, the P2WI bus driver.
37 #include <linux/clk.h>
38 #include <linux/clk/clk-conf.h>
39 #include <linux/device.h>
40 #include <linux/interrupt.h>
42 #include <linux/iopoll.h>
43 #include <linux/module.h>
45 #include <linux/of_irq.h>
46 #include <linux/of_platform.h>
47 #include <linux/platform_device.h>
48 #include <linux/regmap.h>
49 #include <linux/reset.h>
50 #include <linux/slab.h>
51 #include <linux/sunxi-rsb.h>
52 #include <linux/types.h>
55 #define RSB_CTRL 0x0 /* Global control */
56 #define RSB_CCR 0x4 /* Clock control */
57 #define RSB_INTE 0x8 /* Interrupt controls */
58 #define RSB_INTS 0xc /* Interrupt status */
59 #define RSB_ADDR 0x10 /* Address to send with read/write command */
60 #define RSB_DATA 0x1c /* Data to read/write */
61 #define RSB_LCR 0x24 /* Line control */
62 #define RSB_DMCR 0x28 /* Device mode (init) control */
63 #define RSB_CMD 0x2c /* RSB Command */
64 #define RSB_DAR 0x30 /* Device address / runtime address */
67 #define RSB_CTRL_START_TRANS BIT(7)
68 #define RSB_CTRL_ABORT_TRANS BIT(6)
69 #define RSB_CTRL_GLOBAL_INT_ENB BIT(1)
70 #define RSB_CTRL_SOFT_RST BIT(0)
73 #define RSB_CCR_SDA_OUT_DELAY(v) (((v) & 0x7) << 8)
74 #define RSB_CCR_MAX_CLK_DIV 0xff
75 #define RSB_CCR_CLK_DIV(v) ((v) & RSB_CCR_MAX_CLK_DIV)
78 #define RSB_INTS_TRANS_ERR_ACK BIT(16)
79 #define RSB_INTS_TRANS_ERR_DATA_BIT(v) (((v) >> 8) & 0xf)
80 #define RSB_INTS_TRANS_ERR_DATA GENMASK(11, 8)
81 #define RSB_INTS_LOAD_BSY BIT(2)
82 #define RSB_INTS_TRANS_ERR BIT(1)
83 #define RSB_INTS_TRANS_OVER BIT(0)
86 #define RSB_LCR_SCL_STATE BIT(5)
87 #define RSB_LCR_SDA_STATE BIT(4)
88 #define RSB_LCR_SCL_CTL BIT(3)
89 #define RSB_LCR_SCL_CTL_EN BIT(2)
90 #define RSB_LCR_SDA_CTL BIT(1)
91 #define RSB_LCR_SDA_CTL_EN BIT(0)
93 /* DEVICE MODE CTRL field values */
94 #define RSB_DMCR_DEVICE_START BIT(31)
95 #define RSB_DMCR_MODE_DATA (0x7c << 16)
96 #define RSB_DMCR_MODE_REG (0x3e << 8)
97 #define RSB_DMCR_DEV_ADDR 0x00
100 #define RSB_CMD_RD8 0x8b
101 #define RSB_CMD_RD16 0x9c
102 #define RSB_CMD_RD32 0xa6
103 #define RSB_CMD_WR8 0x4e
104 #define RSB_CMD_WR16 0x59
105 #define RSB_CMD_WR32 0x63
106 #define RSB_CMD_STRA 0xe8
109 #define RSB_DAR_RTA(v) (((v) & 0xff) << 16)
110 #define RSB_DAR_DA(v) ((v) & 0xffff)
112 #define RSB_MAX_FREQ 20000000
114 #define RSB_CTRL_NAME "sunxi-rsb"
116 struct sunxi_rsb_addr_map {
125 struct reset_control *rstc;
126 struct completion complete;
131 /* bus / slave device related functions */
132 static struct bus_type sunxi_rsb_bus;
134 static int sunxi_rsb_device_match(struct device *dev, struct device_driver *drv)
136 return of_driver_match_device(dev, drv);
139 static int sunxi_rsb_device_probe(struct device *dev)
141 const struct sunxi_rsb_driver *drv = to_sunxi_rsb_driver(dev->driver);
142 struct sunxi_rsb_device *rdev = to_sunxi_rsb_device(dev);
152 irq = of_irq_get(dev->of_node, 0);
154 if (irq == -EPROBE_DEFER)
162 ret = of_clk_set_defaults(dev->of_node, false);
166 return drv->probe(rdev);
169 static int sunxi_rsb_device_remove(struct device *dev)
171 const struct sunxi_rsb_driver *drv = to_sunxi_rsb_driver(dev->driver);
173 return drv->remove(to_sunxi_rsb_device(dev));
176 static struct bus_type sunxi_rsb_bus = {
177 .name = RSB_CTRL_NAME,
178 .match = sunxi_rsb_device_match,
179 .probe = sunxi_rsb_device_probe,
180 .remove = sunxi_rsb_device_remove,
181 .uevent = of_device_uevent_modalias,
184 static void sunxi_rsb_dev_release(struct device *dev)
186 struct sunxi_rsb_device *rdev = to_sunxi_rsb_device(dev);
192 * sunxi_rsb_device_create() - allocate and add an RSB device
193 * @rsb: RSB controller
194 * @node: RSB slave device node
195 * @hwaddr: RSB slave hardware address
196 * @rtaddr: RSB slave runtime address
198 static struct sunxi_rsb_device *sunxi_rsb_device_create(struct sunxi_rsb *rsb,
199 struct device_node *node, u16 hwaddr, u8 rtaddr)
202 struct sunxi_rsb_device *rdev;
204 rdev = kzalloc(sizeof(*rdev), GFP_KERNEL);
206 return ERR_PTR(-ENOMEM);
209 rdev->hwaddr = hwaddr;
210 rdev->rtaddr = rtaddr;
211 rdev->dev.bus = &sunxi_rsb_bus;
212 rdev->dev.parent = rsb->dev;
213 rdev->dev.of_node = node;
214 rdev->dev.release = sunxi_rsb_dev_release;
216 dev_set_name(&rdev->dev, "%s-%x", RSB_CTRL_NAME, hwaddr);
218 err = device_register(&rdev->dev);
220 dev_err(&rdev->dev, "Can't add %s, status %d\n",
221 dev_name(&rdev->dev), err);
225 dev_dbg(&rdev->dev, "device %s registered\n", dev_name(&rdev->dev));
230 put_device(&rdev->dev);
236 * sunxi_rsb_device_unregister(): unregister an RSB device
237 * @rdev: rsb_device to be removed
239 static void sunxi_rsb_device_unregister(struct sunxi_rsb_device *rdev)
241 device_unregister(&rdev->dev);
244 static int sunxi_rsb_remove_devices(struct device *dev, void *data)
246 struct sunxi_rsb_device *rdev = to_sunxi_rsb_device(dev);
248 if (dev->bus == &sunxi_rsb_bus)
249 sunxi_rsb_device_unregister(rdev);
255 * sunxi_rsb_driver_register() - Register device driver with RSB core
256 * @rdrv: device driver to be associated with slave-device.
258 * This API will register the client driver with the RSB framework.
259 * It is typically called from the driver's module-init function.
261 int sunxi_rsb_driver_register(struct sunxi_rsb_driver *rdrv)
263 rdrv->driver.bus = &sunxi_rsb_bus;
264 return driver_register(&rdrv->driver);
266 EXPORT_SYMBOL_GPL(sunxi_rsb_driver_register);
268 /* common code that starts a transfer */
269 static int _sunxi_rsb_run_xfer(struct sunxi_rsb *rsb)
271 if (readl(rsb->regs + RSB_CTRL) & RSB_CTRL_START_TRANS) {
272 dev_dbg(rsb->dev, "RSB transfer still in progress\n");
276 reinit_completion(&rsb->complete);
278 writel(RSB_INTS_LOAD_BSY | RSB_INTS_TRANS_ERR | RSB_INTS_TRANS_OVER,
279 rsb->regs + RSB_INTE);
280 writel(RSB_CTRL_START_TRANS | RSB_CTRL_GLOBAL_INT_ENB,
281 rsb->regs + RSB_CTRL);
283 if (!wait_for_completion_io_timeout(&rsb->complete,
284 msecs_to_jiffies(100))) {
285 dev_dbg(rsb->dev, "RSB timeout\n");
287 /* abort the transfer */
288 writel(RSB_CTRL_ABORT_TRANS, rsb->regs + RSB_CTRL);
290 /* clear any interrupt flags */
291 writel(readl(rsb->regs + RSB_INTS), rsb->regs + RSB_INTS);
296 if (rsb->status & RSB_INTS_LOAD_BSY) {
297 dev_dbg(rsb->dev, "RSB busy\n");
301 if (rsb->status & RSB_INTS_TRANS_ERR) {
302 if (rsb->status & RSB_INTS_TRANS_ERR_ACK) {
303 dev_dbg(rsb->dev, "RSB slave nack\n");
307 if (rsb->status & RSB_INTS_TRANS_ERR_DATA) {
308 dev_dbg(rsb->dev, "RSB transfer data error\n");
316 static int sunxi_rsb_read(struct sunxi_rsb *rsb, u8 rtaddr, u8 addr,
317 u32 *buf, size_t len)
336 dev_err(rsb->dev, "Invalid access width: %zd\n", len);
340 mutex_lock(&rsb->lock);
342 writel(addr, rsb->regs + RSB_ADDR);
343 writel(RSB_DAR_RTA(rtaddr), rsb->regs + RSB_DAR);
344 writel(cmd, rsb->regs + RSB_CMD);
346 ret = _sunxi_rsb_run_xfer(rsb);
350 *buf = readl(rsb->regs + RSB_DATA) & GENMASK(len * 8 - 1, 0);
353 mutex_unlock(&rsb->lock);
358 static int sunxi_rsb_write(struct sunxi_rsb *rsb, u8 rtaddr, u8 addr,
359 const u32 *buf, size_t len)
378 dev_err(rsb->dev, "Invalid access width: %zd\n", len);
382 mutex_lock(&rsb->lock);
384 writel(addr, rsb->regs + RSB_ADDR);
385 writel(RSB_DAR_RTA(rtaddr), rsb->regs + RSB_DAR);
386 writel(*buf, rsb->regs + RSB_DATA);
387 writel(cmd, rsb->regs + RSB_CMD);
388 ret = _sunxi_rsb_run_xfer(rsb);
390 mutex_unlock(&rsb->lock);
395 /* RSB regmap functions */
396 struct sunxi_rsb_ctx {
397 struct sunxi_rsb_device *rdev;
401 static int regmap_sunxi_rsb_reg_read(void *context, unsigned int reg,
404 struct sunxi_rsb_ctx *ctx = context;
405 struct sunxi_rsb_device *rdev = ctx->rdev;
410 return sunxi_rsb_read(rdev->rsb, rdev->rtaddr, reg, val, ctx->size);
413 static int regmap_sunxi_rsb_reg_write(void *context, unsigned int reg,
416 struct sunxi_rsb_ctx *ctx = context;
417 struct sunxi_rsb_device *rdev = ctx->rdev;
419 return sunxi_rsb_write(rdev->rsb, rdev->rtaddr, reg, &val, ctx->size);
422 static void regmap_sunxi_rsb_free_ctx(void *context)
424 struct sunxi_rsb_ctx *ctx = context;
429 static struct regmap_bus regmap_sunxi_rsb = {
430 .reg_write = regmap_sunxi_rsb_reg_write,
431 .reg_read = regmap_sunxi_rsb_reg_read,
432 .free_context = regmap_sunxi_rsb_free_ctx,
433 .reg_format_endian_default = REGMAP_ENDIAN_NATIVE,
434 .val_format_endian_default = REGMAP_ENDIAN_NATIVE,
437 static struct sunxi_rsb_ctx *regmap_sunxi_rsb_init_ctx(struct sunxi_rsb_device *rdev,
438 const struct regmap_config *config)
440 struct sunxi_rsb_ctx *ctx;
442 switch (config->val_bits) {
448 return ERR_PTR(-EINVAL);
451 ctx = kzalloc(sizeof(*ctx), GFP_KERNEL);
453 return ERR_PTR(-ENOMEM);
456 ctx->size = config->val_bits / 8;
461 struct regmap *__devm_regmap_init_sunxi_rsb(struct sunxi_rsb_device *rdev,
462 const struct regmap_config *config,
463 struct lock_class_key *lock_key,
464 const char *lock_name)
466 struct sunxi_rsb_ctx *ctx = regmap_sunxi_rsb_init_ctx(rdev, config);
469 return ERR_CAST(ctx);
471 return __devm_regmap_init(&rdev->dev, ®map_sunxi_rsb, ctx, config,
472 lock_key, lock_name);
474 EXPORT_SYMBOL_GPL(__devm_regmap_init_sunxi_rsb);
476 /* RSB controller driver functions */
477 static irqreturn_t sunxi_rsb_irq(int irq, void *dev_id)
479 struct sunxi_rsb *rsb = dev_id;
482 status = readl(rsb->regs + RSB_INTS);
483 rsb->status = status;
485 /* Clear interrupts */
486 status &= (RSB_INTS_LOAD_BSY | RSB_INTS_TRANS_ERR |
487 RSB_INTS_TRANS_OVER);
488 writel(status, rsb->regs + RSB_INTS);
490 complete(&rsb->complete);
495 static int sunxi_rsb_init_device_mode(struct sunxi_rsb *rsb)
500 /* send init sequence */
501 writel(RSB_DMCR_DEVICE_START | RSB_DMCR_MODE_DATA |
502 RSB_DMCR_MODE_REG | RSB_DMCR_DEV_ADDR, rsb->regs + RSB_DMCR);
504 readl_poll_timeout(rsb->regs + RSB_DMCR, reg,
505 !(reg & RSB_DMCR_DEVICE_START), 100, 250000);
506 if (reg & RSB_DMCR_DEVICE_START)
509 /* clear interrupt status bits */
510 writel(readl(rsb->regs + RSB_INTS), rsb->regs + RSB_INTS);
516 * There are 15 valid runtime addresses, though Allwinner typically
517 * skips the first, for unknown reasons, and uses the following three.
519 * 0x17, 0x2d, 0x3a, 0x4e, 0x59, 0x63, 0x74, 0x8b,
520 * 0x9c, 0xa6, 0xb1, 0xc5, 0xd2, 0xe8, 0xff
522 * No designs with 2 RSB slave devices sharing identical hardware
523 * addresses on the same bus have been seen in the wild. All designs
524 * use 0x2d for the primary PMIC, 0x3a for the secondary PMIC if
525 * there is one, and 0x45 for peripheral ICs.
527 * The hardware does not seem to support re-setting runtime addresses.
528 * Attempts to do so result in the slave devices returning a NACK.
529 * Hence we just hardcode the mapping here, like Allwinner does.
532 static const struct sunxi_rsb_addr_map sunxi_rsb_addr_maps[] = {
533 { 0x3a3, 0x2d }, /* Primary PMIC: AXP223, AXP809, AXP81X, ... */
534 { 0x745, 0x3a }, /* Secondary PMIC: AXP806, ... */
535 { 0xe89, 0x4e }, /* Peripheral IC: AC100, ... */
538 static u8 sunxi_rsb_get_rtaddr(u16 hwaddr)
542 for (i = 0; i < ARRAY_SIZE(sunxi_rsb_addr_maps); i++)
543 if (hwaddr == sunxi_rsb_addr_maps[i].hwaddr)
544 return sunxi_rsb_addr_maps[i].rtaddr;
546 return 0; /* 0 is an invalid runtime address */
549 static int of_rsb_register_devices(struct sunxi_rsb *rsb)
551 struct device *dev = rsb->dev;
552 struct device_node *child, *np = dev->of_node;
560 /* Runtime addresses for all slaves should be set first */
561 for_each_available_child_of_node(np, child) {
562 dev_dbg(dev, "setting child %pOF runtime address\n",
565 ret = of_property_read_u32(child, "reg", &hwaddr);
567 dev_err(dev, "%pOF: invalid 'reg' property: %d\n",
572 rtaddr = sunxi_rsb_get_rtaddr(hwaddr);
574 dev_err(dev, "%pOF: unknown hardware device address\n",
580 * Since no devices have been registered yet, we are the
581 * only ones using the bus, we can skip locking the bus.
584 /* setup command parameters */
585 writel(RSB_CMD_STRA, rsb->regs + RSB_CMD);
586 writel(RSB_DAR_RTA(rtaddr) | RSB_DAR_DA(hwaddr),
587 rsb->regs + RSB_DAR);
590 ret = _sunxi_rsb_run_xfer(rsb);
592 dev_warn(dev, "%pOF: set runtime address failed: %d\n",
596 /* Then we start adding devices and probing them */
597 for_each_available_child_of_node(np, child) {
598 struct sunxi_rsb_device *rdev;
600 dev_dbg(dev, "adding child %pOF\n", child);
602 ret = of_property_read_u32(child, "reg", &hwaddr);
606 rtaddr = sunxi_rsb_get_rtaddr(hwaddr);
610 rdev = sunxi_rsb_device_create(rsb, child, hwaddr, rtaddr);
612 dev_err(dev, "failed to add child device %pOF: %ld\n",
613 child, PTR_ERR(rdev));
619 static const struct of_device_id sunxi_rsb_of_match_table[] = {
620 { .compatible = "allwinner,sun8i-a23-rsb" },
623 MODULE_DEVICE_TABLE(of, sunxi_rsb_of_match_table);
625 static int sunxi_rsb_probe(struct platform_device *pdev)
627 struct device *dev = &pdev->dev;
628 struct device_node *np = dev->of_node;
630 struct sunxi_rsb *rsb;
631 unsigned long p_clk_freq;
632 u32 clk_delay, clk_freq = 3000000;
633 int clk_div, irq, ret;
636 of_property_read_u32(np, "clock-frequency", &clk_freq);
637 if (clk_freq > RSB_MAX_FREQ) {
639 "clock-frequency (%u Hz) is too high (max = 20MHz)\n",
644 rsb = devm_kzalloc(dev, sizeof(*rsb), GFP_KERNEL);
649 platform_set_drvdata(pdev, rsb);
650 r = platform_get_resource(pdev, IORESOURCE_MEM, 0);
651 rsb->regs = devm_ioremap_resource(dev, r);
652 if (IS_ERR(rsb->regs))
653 return PTR_ERR(rsb->regs);
655 irq = platform_get_irq(pdev, 0);
657 dev_err(dev, "failed to retrieve irq: %d\n", irq);
661 rsb->clk = devm_clk_get(dev, NULL);
662 if (IS_ERR(rsb->clk)) {
663 ret = PTR_ERR(rsb->clk);
664 dev_err(dev, "failed to retrieve clk: %d\n", ret);
668 ret = clk_prepare_enable(rsb->clk);
670 dev_err(dev, "failed to enable clk: %d\n", ret);
674 p_clk_freq = clk_get_rate(rsb->clk);
676 rsb->rstc = devm_reset_control_get(dev, NULL);
677 if (IS_ERR(rsb->rstc)) {
678 ret = PTR_ERR(rsb->rstc);
679 dev_err(dev, "failed to retrieve reset controller: %d\n", ret);
680 goto err_clk_disable;
683 ret = reset_control_deassert(rsb->rstc);
685 dev_err(dev, "failed to deassert reset line: %d\n", ret);
686 goto err_clk_disable;
689 init_completion(&rsb->complete);
690 mutex_init(&rsb->lock);
692 /* reset the controller */
693 writel(RSB_CTRL_SOFT_RST, rsb->regs + RSB_CTRL);
694 readl_poll_timeout(rsb->regs + RSB_CTRL, reg,
695 !(reg & RSB_CTRL_SOFT_RST), 1000, 100000);
698 * Clock frequency and delay calculation code is from
699 * Allwinner U-boot sources.
701 * From A83 user manual:
702 * bus clock frequency = parent clock frequency / (2 * (divider + 1))
704 clk_div = p_clk_freq / clk_freq / 2;
707 else if (clk_div > RSB_CCR_MAX_CLK_DIV + 1)
708 clk_div = RSB_CCR_MAX_CLK_DIV + 1;
710 clk_delay = clk_div >> 1;
714 dev_info(dev, "RSB running at %lu Hz\n", p_clk_freq / clk_div / 2);
715 writel(RSB_CCR_SDA_OUT_DELAY(clk_delay) | RSB_CCR_CLK_DIV(clk_div - 1),
716 rsb->regs + RSB_CCR);
718 ret = devm_request_irq(dev, irq, sunxi_rsb_irq, 0, RSB_CTRL_NAME, rsb);
720 dev_err(dev, "can't register interrupt handler irq %d: %d\n",
722 goto err_reset_assert;
725 /* initialize all devices on the bus into RSB mode */
726 ret = sunxi_rsb_init_device_mode(rsb);
728 dev_warn(dev, "Initialize device mode failed: %d\n", ret);
730 of_rsb_register_devices(rsb);
735 reset_control_assert(rsb->rstc);
738 clk_disable_unprepare(rsb->clk);
743 static int sunxi_rsb_remove(struct platform_device *pdev)
745 struct sunxi_rsb *rsb = platform_get_drvdata(pdev);
747 device_for_each_child(rsb->dev, NULL, sunxi_rsb_remove_devices);
748 reset_control_assert(rsb->rstc);
749 clk_disable_unprepare(rsb->clk);
754 static struct platform_driver sunxi_rsb_driver = {
755 .probe = sunxi_rsb_probe,
756 .remove = sunxi_rsb_remove,
758 .name = RSB_CTRL_NAME,
759 .of_match_table = sunxi_rsb_of_match_table,
763 static int __init sunxi_rsb_init(void)
767 ret = bus_register(&sunxi_rsb_bus);
769 pr_err("failed to register sunxi sunxi_rsb bus: %d\n", ret);
773 return platform_driver_register(&sunxi_rsb_driver);
775 module_init(sunxi_rsb_init);
777 static void __exit sunxi_rsb_exit(void)
779 platform_driver_unregister(&sunxi_rsb_driver);
780 bus_unregister(&sunxi_rsb_bus);
782 module_exit(sunxi_rsb_exit);
784 MODULE_AUTHOR("Chen-Yu Tsai <wens@csie.org>");
785 MODULE_DESCRIPTION("Allwinner sunXi Reduced Serial Bus controller driver");
786 MODULE_LICENSE("GPL v2");