// SPDX-License-Identifier: GPL-2.0-or-later /* * IBM OPAL RTC driver * Copyright (C) 2014 IBM */ #define pr_fmt(fmt) KBUILD_MODNAME ": " fmt #define DRVNAME "rtc-opal" #include <linux/module.h> #include <linux/err.h> #include <linux/rtc.h> #include <linux/delay.h> #include <linux/bcd.h> #include <linux/platform_device.h> #include <linux/of.h> #include <asm/opal.h> #include <asm/firmware.h> static void opal_to_tm(u32 y_m_d, u64 h_m_s_ms, struct rtc_time *tm) { tm->tm_year = ((bcd2bin(y_m_d >> 24) * 100) + bcd2bin((y_m_d >> 16) & 0xff)) - 1900; tm->tm_mon = bcd2bin((y_m_d >> 8) & 0xff) - 1; tm->tm_mday = bcd2bin(y_m_d & 0xff); tm->tm_hour = bcd2bin((h_m_s_ms >> 56) & 0xff); tm->tm_min = bcd2bin((h_m_s_ms >> 48) & 0xff); tm->tm_sec = bcd2bin((h_m_s_ms >> 40) & 0xff); tm->tm_wday = -1; } static void tm_to_opal(struct rtc_time *tm, u32 *y_m_d, u64 *h_m_s_ms) { *y_m_d |= ((u32)bin2bcd((tm->tm_year + 1900) / 100)) << 24; *y_m_d |= ((u32)bin2bcd((tm->tm_year + 1900) % 100)) << 16; *y_m_d |= ((u32)bin2bcd((tm->tm_mon + 1))) << 8; *y_m_d |= ((u32)bin2bcd(tm->tm_mday)); *h_m_s_ms |= ((u64)bin2bcd(tm->tm_hour)) << 56; *h_m_s_ms |= ((u64)bin2bcd(tm->tm_min)) << 48; *h_m_s_ms |= ((u64)bin2bcd(tm->tm_sec)) << 40; } static int opal_get_rtc_time(struct device *dev, struct rtc_time *tm) { s64 rc = OPAL_BUSY; int retries = 10; u32 y_m_d; u64 h_m_s_ms; __be32 __y_m_d; __be64 __h_m_s_ms; while (rc == OPAL_BUSY || rc == OPAL_BUSY_EVENT) { rc = opal_rtc_read(&__y_m_d, &__h_m_s_ms); if (rc == OPAL_BUSY_EVENT) { msleep(OPAL_BUSY_DELAY_MS); opal_poll_events(NULL); } else if (rc == OPAL_BUSY) { msleep(OPAL_BUSY_DELAY_MS); } else if (rc == OPAL_HARDWARE || rc == OPAL_INTERNAL_ERROR) { if (retries--) { msleep(10); /* Wait 10ms before retry */ rc = OPAL_BUSY; /* go around again */ } } } if (rc != OPAL_SUCCESS) return -EIO; y_m_d = be32_to_cpu(__y_m_d); h_m_s_ms = be64_to_cpu(__h_m_s_ms); opal_to_tm(y_m_d, h_m_s_ms, tm); return 0; } static int opal_set_rtc_time(struct device *dev, struct rtc_time *tm) { s64 rc = OPAL_BUSY; int retries = 10; u32 y_m_d = 0; u64 h_m_s_ms = 0; tm_to_opal(tm, &y_m_d, &h_m_s_ms); while (rc == OPAL_BUSY || rc == OPAL_BUSY_EVENT) { rc = opal_rtc_write(y_m_d, h_m_s_ms); if (rc == OPAL_BUSY_EVENT) { msleep(OPAL_BUSY_DELAY_MS); opal_poll_events(NULL); } else if (rc == OPAL_BUSY) { msleep(OPAL_BUSY_DELAY_MS); } else if (rc == OPAL_HARDWARE || rc == OPAL_INTERNAL_ERROR) { if (retries--) { msleep(10); /* Wait 10ms before retry */ rc = OPAL_BUSY; /* go around again */ } } } return rc == OPAL_SUCCESS ? 0 : -EIO; } /* * TPO Timed Power-On * * TPO get/set OPAL calls care about the hour and min and to make it consistent * with the rtc utility time conversion functions, we use the 'u64' to store * its value and perform bit shift by 32 before use.. */ static int opal_get_tpo_time(struct device *dev, struct rtc_wkalrm *alarm) { __be32 __y_m_d, __h_m; struct opal_msg msg; int rc, token; u64 h_m_s_ms; u32 y_m_d; token = opal_async_get_token_interruptible(); if (token < 0) { if (token != -ERESTARTSYS) pr_err("Failed to get the async token\n"); return token; } rc = opal_tpo_read(token, &__y_m_d, &__h_m); if (rc != OPAL_ASYNC_COMPLETION) { rc = -EIO; goto exit; } rc = opal_async_wait_response(token, &msg); if (rc) { rc = -EIO; goto exit; } rc = opal_get_async_rc(msg); if (rc != OPAL_SUCCESS) { rc = -EIO; goto exit; } y_m_d = be32_to_cpu(__y_m_d); h_m_s_ms = ((u64)be32_to_cpu(__h_m) << 32); /* check if no alarm is set */ if (y_m_d == 0 && h_m_s_ms == 0) { pr_debug("No alarm is set\n"); rc = -ENOENT; goto exit; } else { pr_debug("Alarm set to %x %llx\n", y_m_d, h_m_s_ms); } opal_to_tm(y_m_d, h_m_s_ms, &alarm->time); exit: opal_async_release_token(token); return rc; } /* Set Timed Power-On */ static int opal_set_tpo_time(struct device *dev, struct rtc_wkalrm *alarm) { u64 h_m_s_ms = 0; struct opal_msg msg; u32 y_m_d = 0; int token, rc; /* if alarm is enabled */ if (alarm->enabled) { tm_to_opal(&alarm->time, &y_m_d, &h_m_s_ms); pr_debug("Alarm set to %x %llx\n", y_m_d, h_m_s_ms); } else { pr_debug("Alarm getting disabled\n"); } token = opal_async_get_token_interruptible(); if (token < 0) { if (token != -ERESTARTSYS) pr_err("Failed to get the async token\n"); return token; } /* TPO, we care about hour and minute */ rc = opal_tpo_write(token, y_m_d, (u32)((h_m_s_ms >> 32) & 0xffff0000)); if (rc != OPAL_ASYNC_COMPLETION) { rc = -EIO; goto exit; } rc = opal_async_wait_response(token, &msg); if (rc) { rc = -EIO; goto exit; } rc = opal_get_async_rc(msg); if (rc != OPAL_SUCCESS) rc = -EIO; exit: opal_async_release_token(token); return rc; } static int opal_tpo_alarm_irq_enable(struct device *dev, unsigned int enabled) { struct rtc_wkalrm alarm = { .enabled = 0 }; /* * TPO is automatically enabled when opal_set_tpo_time() is called with * non-zero rtc-time. We only handle disable case which needs to be * explicitly told to opal. */ return enabled ? 0 : opal_set_tpo_time(dev, &alarm); } static const struct rtc_class_ops opal_rtc_ops = { .read_time = opal_get_rtc_time, .set_time = opal_set_rtc_time, .read_alarm = opal_get_tpo_time, .set_alarm = opal_set_tpo_time, .alarm_irq_enable = opal_tpo_alarm_irq_enable, }; static int opal_rtc_probe(struct platform_device *pdev) { struct rtc_device *rtc; rtc = devm_rtc_allocate_device(&pdev->dev); if (IS_ERR(rtc)) return PTR_ERR(rtc); if (pdev->dev.of_node && (of_property_read_bool(pdev->dev.of_node, "wakeup-source") || of_property_read_bool(pdev->dev.of_node, "has-tpo")/* legacy */)) device_set_wakeup_capable(&pdev->dev, true); else clear_bit(RTC_FEATURE_ALARM, rtc->features); rtc->ops = &opal_rtc_ops; rtc->range_min = RTC_TIMESTAMP_BEGIN_0000; rtc->range_max = RTC_TIMESTAMP_END_9999; clear_bit(RTC_FEATURE_UPDATE_INTERRUPT, rtc->features); return devm_rtc_register_device(rtc); } static const struct of_device_id opal_rtc_match[] = { { .compatible = "ibm,opal-rtc", }, { } }; MODULE_DEVICE_TABLE(of, opal_rtc_match); static const struct platform_device_id opal_rtc_driver_ids[] = { { .name = "opal-rtc", }, { } }; MODULE_DEVICE_TABLE(platform, opal_rtc_driver_ids); static struct platform_driver opal_rtc_driver = { .probe = opal_rtc_probe, .id_table = opal_rtc_driver_ids, .driver = { .name = DRVNAME, .of_match_table = opal_rtc_match, }, }; static int __init opal_rtc_init(void) { if (!firmware_has_feature(FW_FEATURE_OPAL)) return -ENODEV; return platform_driver_register(&opal_rtc_driver); } static void __exit opal_rtc_exit(void) { platform_driver_unregister(&opal_rtc_driver); } MODULE_AUTHOR("Neelesh Gupta <neelegup@linux.vnet.ibm.com>"); MODULE_DESCRIPTION("IBM OPAL RTC driver"); MODULE_LICENSE("GPL"); module_init(opal_rtc_init); module_exit(opal_rtc_exit);