| // SPDX-License-Identifier: GPL-2.0-only |
| /* |
| * Haoyu HYM8563 RTC driver |
| * |
| * Copyright (C) 2013 MundoReader S.L. |
| * Author: Heiko Stuebner <heiko@sntech.de> |
| * |
| * based on rtc-HYM8563 |
| * Copyright (C) 2010 ROCKCHIP, Inc. |
| */ |
| |
| #include <linux/module.h> |
| #include <linux/clk-provider.h> |
| #include <linux/i2c.h> |
| #include <linux/bcd.h> |
| #include <linux/rtc.h> |
| |
| #define HYM8563_CTL1 0x00 |
| #define HYM8563_CTL1_TEST BIT(7) |
| #define HYM8563_CTL1_STOP BIT(5) |
| #define HYM8563_CTL1_TESTC BIT(3) |
| |
| #define HYM8563_CTL2 0x01 |
| #define HYM8563_CTL2_TI_TP BIT(4) |
| #define HYM8563_CTL2_AF BIT(3) |
| #define HYM8563_CTL2_TF BIT(2) |
| #define HYM8563_CTL2_AIE BIT(1) |
| #define HYM8563_CTL2_TIE BIT(0) |
| |
| #define HYM8563_SEC 0x02 |
| #define HYM8563_SEC_VL BIT(7) |
| #define HYM8563_SEC_MASK 0x7f |
| |
| #define HYM8563_MIN 0x03 |
| #define HYM8563_MIN_MASK 0x7f |
| |
| #define HYM8563_HOUR 0x04 |
| #define HYM8563_HOUR_MASK 0x3f |
| |
| #define HYM8563_DAY 0x05 |
| #define HYM8563_DAY_MASK 0x3f |
| |
| #define HYM8563_WEEKDAY 0x06 |
| #define HYM8563_WEEKDAY_MASK 0x07 |
| |
| #define HYM8563_MONTH 0x07 |
| #define HYM8563_MONTH_CENTURY BIT(7) |
| #define HYM8563_MONTH_MASK 0x1f |
| |
| #define HYM8563_YEAR 0x08 |
| |
| #define HYM8563_ALM_MIN 0x09 |
| #define HYM8563_ALM_HOUR 0x0a |
| #define HYM8563_ALM_DAY 0x0b |
| #define HYM8563_ALM_WEEK 0x0c |
| |
| /* Each alarm check can be disabled by setting this bit in the register */ |
| #define HYM8563_ALM_BIT_DISABLE BIT(7) |
| |
| #define HYM8563_CLKOUT 0x0d |
| #define HYM8563_CLKOUT_ENABLE BIT(7) |
| #define HYM8563_CLKOUT_32768 0 |
| #define HYM8563_CLKOUT_1024 1 |
| #define HYM8563_CLKOUT_32 2 |
| #define HYM8563_CLKOUT_1 3 |
| #define HYM8563_CLKOUT_MASK 3 |
| |
| #define HYM8563_TMR_CTL 0x0e |
| #define HYM8563_TMR_CTL_ENABLE BIT(7) |
| #define HYM8563_TMR_CTL_4096 0 |
| #define HYM8563_TMR_CTL_64 1 |
| #define HYM8563_TMR_CTL_1 2 |
| #define HYM8563_TMR_CTL_1_60 3 |
| #define HYM8563_TMR_CTL_MASK 3 |
| |
| #define HYM8563_TMR_CNT 0x0f |
| |
| struct hym8563 { |
| struct i2c_client *client; |
| struct rtc_device *rtc; |
| #ifdef CONFIG_COMMON_CLK |
| struct clk_hw clkout_hw; |
| #endif |
| }; |
| |
| /* |
| * RTC handling |
| */ |
| |
| static int hym8563_rtc_read_time(struct device *dev, struct rtc_time *tm) |
| { |
| struct i2c_client *client = to_i2c_client(dev); |
| u8 buf[7]; |
| int ret; |
| |
| ret = i2c_smbus_read_i2c_block_data(client, HYM8563_SEC, 7, buf); |
| if (ret < 0) |
| return ret; |
| |
| if (buf[0] & HYM8563_SEC_VL) { |
| dev_warn(&client->dev, |
| "no valid clock/calendar values available\n"); |
| return -EINVAL; |
| } |
| |
| tm->tm_sec = bcd2bin(buf[0] & HYM8563_SEC_MASK); |
| tm->tm_min = bcd2bin(buf[1] & HYM8563_MIN_MASK); |
| tm->tm_hour = bcd2bin(buf[2] & HYM8563_HOUR_MASK); |
| tm->tm_mday = bcd2bin(buf[3] & HYM8563_DAY_MASK); |
| tm->tm_wday = bcd2bin(buf[4] & HYM8563_WEEKDAY_MASK); /* 0 = Sun */ |
| tm->tm_mon = bcd2bin(buf[5] & HYM8563_MONTH_MASK) - 1; /* 0 = Jan */ |
| tm->tm_year = bcd2bin(buf[6]) + 100; |
| |
| return 0; |
| } |
| |
| static int hym8563_rtc_set_time(struct device *dev, struct rtc_time *tm) |
| { |
| struct i2c_client *client = to_i2c_client(dev); |
| u8 buf[7]; |
| int ret; |
| |
| /* Years >= 2100 are to far in the future, 19XX is to early */ |
| if (tm->tm_year < 100 || tm->tm_year >= 200) |
| return -EINVAL; |
| |
| buf[0] = bin2bcd(tm->tm_sec); |
| buf[1] = bin2bcd(tm->tm_min); |
| buf[2] = bin2bcd(tm->tm_hour); |
| buf[3] = bin2bcd(tm->tm_mday); |
| buf[4] = bin2bcd(tm->tm_wday); |
| buf[5] = bin2bcd(tm->tm_mon + 1); |
| |
| /* |
| * While the HYM8563 has a century flag in the month register, |
| * it does not seem to carry it over a subsequent write/read. |
| * So we'll limit ourself to 100 years, starting at 2000 for now. |
| */ |
| buf[6] = bin2bcd(tm->tm_year - 100); |
| |
| /* |
| * CTL1 only contains TEST-mode bits apart from stop, |
| * so no need to read the value first |
| */ |
| ret = i2c_smbus_write_byte_data(client, HYM8563_CTL1, |
| HYM8563_CTL1_STOP); |
| if (ret < 0) |
| return ret; |
| |
| ret = i2c_smbus_write_i2c_block_data(client, HYM8563_SEC, 7, buf); |
| if (ret < 0) |
| return ret; |
| |
| ret = i2c_smbus_write_byte_data(client, HYM8563_CTL1, 0); |
| if (ret < 0) |
| return ret; |
| |
| return 0; |
| } |
| |
| static int hym8563_rtc_alarm_irq_enable(struct device *dev, |
| unsigned int enabled) |
| { |
| struct i2c_client *client = to_i2c_client(dev); |
| int data; |
| |
| data = i2c_smbus_read_byte_data(client, HYM8563_CTL2); |
| if (data < 0) |
| return data; |
| |
| if (enabled) |
| data |= HYM8563_CTL2_AIE; |
| else |
| data &= ~HYM8563_CTL2_AIE; |
| |
| return i2c_smbus_write_byte_data(client, HYM8563_CTL2, data); |
| }; |
| |
| static int hym8563_rtc_read_alarm(struct device *dev, struct rtc_wkalrm *alm) |
| { |
| struct i2c_client *client = to_i2c_client(dev); |
| struct rtc_time *alm_tm = &alm->time; |
| u8 buf[4]; |
| int ret; |
| |
| ret = i2c_smbus_read_i2c_block_data(client, HYM8563_ALM_MIN, 4, buf); |
| if (ret < 0) |
| return ret; |
| |
| /* The alarm only has a minute accuracy */ |
| alm_tm->tm_sec = 0; |
| |
| alm_tm->tm_min = (buf[0] & HYM8563_ALM_BIT_DISABLE) ? |
| -1 : |
| bcd2bin(buf[0] & HYM8563_MIN_MASK); |
| alm_tm->tm_hour = (buf[1] & HYM8563_ALM_BIT_DISABLE) ? |
| -1 : |
| bcd2bin(buf[1] & HYM8563_HOUR_MASK); |
| alm_tm->tm_mday = (buf[2] & HYM8563_ALM_BIT_DISABLE) ? |
| -1 : |
| bcd2bin(buf[2] & HYM8563_DAY_MASK); |
| alm_tm->tm_wday = (buf[3] & HYM8563_ALM_BIT_DISABLE) ? |
| -1 : |
| bcd2bin(buf[3] & HYM8563_WEEKDAY_MASK); |
| |
| ret = i2c_smbus_read_byte_data(client, HYM8563_CTL2); |
| if (ret < 0) |
| return ret; |
| |
| if (ret & HYM8563_CTL2_AIE) |
| alm->enabled = 1; |
| |
| return 0; |
| } |
| |
| static int hym8563_rtc_set_alarm(struct device *dev, struct rtc_wkalrm *alm) |
| { |
| struct i2c_client *client = to_i2c_client(dev); |
| struct rtc_time *alm_tm = &alm->time; |
| u8 buf[4]; |
| int ret; |
| |
| ret = i2c_smbus_read_byte_data(client, HYM8563_CTL2); |
| if (ret < 0) |
| return ret; |
| |
| ret &= ~HYM8563_CTL2_AIE; |
| |
| ret = i2c_smbus_write_byte_data(client, HYM8563_CTL2, ret); |
| if (ret < 0) |
| return ret; |
| |
| buf[0] = (alm_tm->tm_min < 60 && alm_tm->tm_min >= 0) ? |
| bin2bcd(alm_tm->tm_min) : HYM8563_ALM_BIT_DISABLE; |
| |
| buf[1] = (alm_tm->tm_hour < 24 && alm_tm->tm_hour >= 0) ? |
| bin2bcd(alm_tm->tm_hour) : HYM8563_ALM_BIT_DISABLE; |
| |
| buf[2] = (alm_tm->tm_mday <= 31 && alm_tm->tm_mday >= 1) ? |
| bin2bcd(alm_tm->tm_mday) : HYM8563_ALM_BIT_DISABLE; |
| |
| buf[3] = (alm_tm->tm_wday < 7 && alm_tm->tm_wday >= 0) ? |
| bin2bcd(alm_tm->tm_wday) : HYM8563_ALM_BIT_DISABLE; |
| |
| ret = i2c_smbus_write_i2c_block_data(client, HYM8563_ALM_MIN, 4, buf); |
| if (ret < 0) |
| return ret; |
| |
| return hym8563_rtc_alarm_irq_enable(dev, alm->enabled); |
| } |
| |
| static const struct rtc_class_ops hym8563_rtc_ops = { |
| .read_time = hym8563_rtc_read_time, |
| .set_time = hym8563_rtc_set_time, |
| .alarm_irq_enable = hym8563_rtc_alarm_irq_enable, |
| .read_alarm = hym8563_rtc_read_alarm, |
| .set_alarm = hym8563_rtc_set_alarm, |
| }; |
| |
| /* |
| * Handling of the clkout |
| */ |
| |
| #ifdef CONFIG_COMMON_CLK |
| #define clkout_hw_to_hym8563(_hw) container_of(_hw, struct hym8563, clkout_hw) |
| |
| static int clkout_rates[] = { |
| 32768, |
| 1024, |
| 32, |
| 1, |
| }; |
| |
| static unsigned long hym8563_clkout_recalc_rate(struct clk_hw *hw, |
| unsigned long parent_rate) |
| { |
| struct hym8563 *hym8563 = clkout_hw_to_hym8563(hw); |
| struct i2c_client *client = hym8563->client; |
| int ret = i2c_smbus_read_byte_data(client, HYM8563_CLKOUT); |
| |
| if (ret < 0) |
| return 0; |
| |
| ret &= HYM8563_CLKOUT_MASK; |
| return clkout_rates[ret]; |
| } |
| |
| static long hym8563_clkout_round_rate(struct clk_hw *hw, unsigned long rate, |
| unsigned long *prate) |
| { |
| int i; |
| |
| for (i = 0; i < ARRAY_SIZE(clkout_rates); i++) |
| if (clkout_rates[i] <= rate) |
| return clkout_rates[i]; |
| |
| return 0; |
| } |
| |
| static int hym8563_clkout_set_rate(struct clk_hw *hw, unsigned long rate, |
| unsigned long parent_rate) |
| { |
| struct hym8563 *hym8563 = clkout_hw_to_hym8563(hw); |
| struct i2c_client *client = hym8563->client; |
| int ret = i2c_smbus_read_byte_data(client, HYM8563_CLKOUT); |
| int i; |
| |
| if (ret < 0) |
| return ret; |
| |
| for (i = 0; i < ARRAY_SIZE(clkout_rates); i++) |
| if (clkout_rates[i] == rate) { |
| ret &= ~HYM8563_CLKOUT_MASK; |
| ret |= i; |
| return i2c_smbus_write_byte_data(client, |
| HYM8563_CLKOUT, ret); |
| } |
| |
| return -EINVAL; |
| } |
| |
| static int hym8563_clkout_control(struct clk_hw *hw, bool enable) |
| { |
| struct hym8563 *hym8563 = clkout_hw_to_hym8563(hw); |
| struct i2c_client *client = hym8563->client; |
| int ret = i2c_smbus_read_byte_data(client, HYM8563_CLKOUT); |
| |
| if (ret < 0) |
| return ret; |
| |
| if (enable) |
| ret |= HYM8563_CLKOUT_ENABLE; |
| else |
| ret &= ~HYM8563_CLKOUT_ENABLE; |
| |
| return i2c_smbus_write_byte_data(client, HYM8563_CLKOUT, ret); |
| } |
| |
| static int hym8563_clkout_prepare(struct clk_hw *hw) |
| { |
| return hym8563_clkout_control(hw, 1); |
| } |
| |
| static void hym8563_clkout_unprepare(struct clk_hw *hw) |
| { |
| hym8563_clkout_control(hw, 0); |
| } |
| |
| static int hym8563_clkout_is_prepared(struct clk_hw *hw) |
| { |
| struct hym8563 *hym8563 = clkout_hw_to_hym8563(hw); |
| struct i2c_client *client = hym8563->client; |
| int ret = i2c_smbus_read_byte_data(client, HYM8563_CLKOUT); |
| |
| if (ret < 0) |
| return ret; |
| |
| return !!(ret & HYM8563_CLKOUT_ENABLE); |
| } |
| |
| static const struct clk_ops hym8563_clkout_ops = { |
| .prepare = hym8563_clkout_prepare, |
| .unprepare = hym8563_clkout_unprepare, |
| .is_prepared = hym8563_clkout_is_prepared, |
| .recalc_rate = hym8563_clkout_recalc_rate, |
| .round_rate = hym8563_clkout_round_rate, |
| .set_rate = hym8563_clkout_set_rate, |
| }; |
| |
| static struct clk *hym8563_clkout_register_clk(struct hym8563 *hym8563) |
| { |
| struct i2c_client *client = hym8563->client; |
| struct device_node *node = client->dev.of_node; |
| struct clk *clk; |
| struct clk_init_data init; |
| int ret; |
| |
| ret = i2c_smbus_write_byte_data(client, HYM8563_CLKOUT, |
| 0); |
| if (ret < 0) |
| return ERR_PTR(ret); |
| |
| init.name = "hym8563-clkout"; |
| init.ops = &hym8563_clkout_ops; |
| init.flags = 0; |
| init.parent_names = NULL; |
| init.num_parents = 0; |
| hym8563->clkout_hw.init = &init; |
| |
| /* optional override of the clockname */ |
| of_property_read_string(node, "clock-output-names", &init.name); |
| |
| /* register the clock */ |
| clk = clk_register(&client->dev, &hym8563->clkout_hw); |
| |
| if (!IS_ERR(clk)) |
| of_clk_add_provider(node, of_clk_src_simple_get, clk); |
| |
| return clk; |
| } |
| #endif |
| |
| /* |
| * The alarm interrupt is implemented as a level-low interrupt in the |
| * hym8563, while the timer interrupt uses a falling edge. |
| * We don't use the timer at all, so the interrupt is requested to |
| * use the level-low trigger. |
| */ |
| static irqreturn_t hym8563_irq(int irq, void *dev_id) |
| { |
| struct hym8563 *hym8563 = (struct hym8563 *)dev_id; |
| struct i2c_client *client = hym8563->client; |
| int data, ret; |
| |
| rtc_lock(hym8563->rtc); |
| |
| /* Clear the alarm flag */ |
| |
| data = i2c_smbus_read_byte_data(client, HYM8563_CTL2); |
| if (data < 0) { |
| dev_err(&client->dev, "%s: error reading i2c data %d\n", |
| __func__, data); |
| goto out; |
| } |
| |
| data &= ~HYM8563_CTL2_AF; |
| |
| ret = i2c_smbus_write_byte_data(client, HYM8563_CTL2, data); |
| if (ret < 0) { |
| dev_err(&client->dev, "%s: error writing i2c data %d\n", |
| __func__, ret); |
| } |
| |
| out: |
| rtc_unlock(hym8563->rtc); |
| return IRQ_HANDLED; |
| } |
| |
| static int hym8563_init_device(struct i2c_client *client) |
| { |
| int ret; |
| |
| /* Clear stop flag if present */ |
| ret = i2c_smbus_write_byte_data(client, HYM8563_CTL1, 0); |
| if (ret < 0) |
| return ret; |
| |
| ret = i2c_smbus_read_byte_data(client, HYM8563_CTL2); |
| if (ret < 0) |
| return ret; |
| |
| /* Disable alarm and timer interrupts */ |
| ret &= ~HYM8563_CTL2_AIE; |
| ret &= ~HYM8563_CTL2_TIE; |
| |
| /* Clear any pending alarm and timer flags */ |
| if (ret & HYM8563_CTL2_AF) |
| ret &= ~HYM8563_CTL2_AF; |
| |
| if (ret & HYM8563_CTL2_TF) |
| ret &= ~HYM8563_CTL2_TF; |
| |
| ret &= ~HYM8563_CTL2_TI_TP; |
| |
| return i2c_smbus_write_byte_data(client, HYM8563_CTL2, ret); |
| } |
| |
| #ifdef CONFIG_PM_SLEEP |
| static int hym8563_suspend(struct device *dev) |
| { |
| struct i2c_client *client = to_i2c_client(dev); |
| int ret; |
| |
| if (device_may_wakeup(dev)) { |
| ret = enable_irq_wake(client->irq); |
| if (ret) { |
| dev_err(dev, "enable_irq_wake failed, %d\n", ret); |
| return ret; |
| } |
| } |
| |
| return 0; |
| } |
| |
| static int hym8563_resume(struct device *dev) |
| { |
| struct i2c_client *client = to_i2c_client(dev); |
| |
| if (device_may_wakeup(dev)) |
| disable_irq_wake(client->irq); |
| |
| return 0; |
| } |
| #endif |
| |
| static SIMPLE_DEV_PM_OPS(hym8563_pm_ops, hym8563_suspend, hym8563_resume); |
| |
| static int hym8563_probe(struct i2c_client *client) |
| { |
| struct hym8563 *hym8563; |
| int ret; |
| |
| hym8563 = devm_kzalloc(&client->dev, sizeof(*hym8563), GFP_KERNEL); |
| if (!hym8563) |
| return -ENOMEM; |
| |
| hym8563->rtc = devm_rtc_allocate_device(&client->dev); |
| if (IS_ERR(hym8563->rtc)) |
| return PTR_ERR(hym8563->rtc); |
| |
| hym8563->client = client; |
| i2c_set_clientdata(client, hym8563); |
| |
| ret = hym8563_init_device(client); |
| if (ret) { |
| dev_err(&client->dev, "could not init device, %d\n", ret); |
| return ret; |
| } |
| |
| if (client->irq > 0) { |
| unsigned long irqflags = IRQF_TRIGGER_LOW; |
| |
| if (dev_fwnode(&client->dev)) |
| irqflags = 0; |
| |
| ret = devm_request_threaded_irq(&client->dev, client->irq, |
| NULL, hym8563_irq, |
| irqflags | IRQF_ONESHOT, |
| client->name, hym8563); |
| if (ret < 0) { |
| dev_err(&client->dev, "irq %d request failed, %d\n", |
| client->irq, ret); |
| return ret; |
| } |
| } |
| |
| if (client->irq > 0 || |
| device_property_read_bool(&client->dev, "wakeup-source")) { |
| device_init_wakeup(&client->dev, true); |
| } |
| |
| /* check state of calendar information */ |
| ret = i2c_smbus_read_byte_data(client, HYM8563_SEC); |
| if (ret < 0) |
| return ret; |
| |
| dev_dbg(&client->dev, "rtc information is %s\n", |
| (ret & HYM8563_SEC_VL) ? "invalid" : "valid"); |
| |
| hym8563->rtc->ops = &hym8563_rtc_ops; |
| set_bit(RTC_FEATURE_ALARM_RES_MINUTE, hym8563->rtc->features); |
| clear_bit(RTC_FEATURE_UPDATE_INTERRUPT, hym8563->rtc->features); |
| |
| #ifdef CONFIG_COMMON_CLK |
| hym8563_clkout_register_clk(hym8563); |
| #endif |
| |
| return devm_rtc_register_device(hym8563->rtc); |
| } |
| |
| static const struct i2c_device_id hym8563_id[] = { |
| { "hym8563" }, |
| {} |
| }; |
| MODULE_DEVICE_TABLE(i2c, hym8563_id); |
| |
| static const struct of_device_id hym8563_dt_idtable[] = { |
| { .compatible = "haoyu,hym8563" }, |
| {}, |
| }; |
| MODULE_DEVICE_TABLE(of, hym8563_dt_idtable); |
| |
| static struct i2c_driver hym8563_driver = { |
| .driver = { |
| .name = "rtc-hym8563", |
| .pm = &hym8563_pm_ops, |
| .of_match_table = hym8563_dt_idtable, |
| }, |
| .probe = hym8563_probe, |
| .id_table = hym8563_id, |
| }; |
| |
| module_i2c_driver(hym8563_driver); |
| |
| MODULE_AUTHOR("Heiko Stuebner <heiko@sntech.de>"); |
| MODULE_DESCRIPTION("HYM8563 RTC driver"); |
| MODULE_LICENSE("GPL"); |