1 // SPDX-License-Identifier: GPL-2.0-or-later
3 * Support for the OLPC DCON and OLPC EC access
5 * Copyright © 2006 Advanced Micro Devices, Inc.
6 * Copyright © 2007-2008 Andres Salomon <dilinger@debian.org>
9 #include <linux/kernel.h>
10 #include <linux/init.h>
11 #include <linux/export.h>
12 #include <linux/delay.h>
14 #include <linux/string.h>
15 #include <linux/platform_device.h>
17 #include <linux/syscore_ops.h>
18 #include <linux/mutex.h>
19 #include <linux/olpc-ec.h>
21 #include <asm/geode.h>
22 #include <asm/setup.h>
24 #include <asm/olpc_ofw.h>
26 struct olpc_platform_t olpc_platform_info;
27 EXPORT_SYMBOL_GPL(olpc_platform_info);
29 /* what the timeout *should* be (in ms) */
30 #define EC_BASE_TIMEOUT 20
32 /* the timeout that bugs in the EC might force us to actually use */
33 static int ec_timeout = EC_BASE_TIMEOUT;
35 static int __init olpc_ec_timeout_set(char *str)
37 if (get_option(&str, &ec_timeout) != 1) {
38 ec_timeout = EC_BASE_TIMEOUT;
39 printk(KERN_ERR "olpc-ec: invalid argument to "
40 "'olpc_ec_timeout=', ignoring!\n");
42 printk(KERN_DEBUG "olpc-ec: using %d ms delay for EC commands.\n",
46 __setup("olpc_ec_timeout=", olpc_ec_timeout_set);
49 * These {i,o}bf_status functions return whether the buffers are full or not.
52 static inline unsigned int ibf_status(unsigned int port)
54 return !!(inb(port) & 0x02);
57 static inline unsigned int obf_status(unsigned int port)
59 return inb(port) & 0x01;
62 #define wait_on_ibf(p, d) __wait_on_ibf(__LINE__, (p), (d))
63 static int __wait_on_ibf(unsigned int line, unsigned int port, int desired)
66 int state = ibf_status(port);
68 for (timeo = ec_timeout; state != desired && timeo; timeo--) {
70 state = ibf_status(port);
73 if ((state == desired) && (ec_timeout > EC_BASE_TIMEOUT) &&
74 timeo < (ec_timeout - EC_BASE_TIMEOUT)) {
75 printk(KERN_WARNING "olpc-ec: %d: waited %u ms for IBF!\n",
76 line, ec_timeout - timeo);
79 return !(state == desired);
82 #define wait_on_obf(p, d) __wait_on_obf(__LINE__, (p), (d))
83 static int __wait_on_obf(unsigned int line, unsigned int port, int desired)
86 int state = obf_status(port);
88 for (timeo = ec_timeout; state != desired && timeo; timeo--) {
90 state = obf_status(port);
93 if ((state == desired) && (ec_timeout > EC_BASE_TIMEOUT) &&
94 timeo < (ec_timeout - EC_BASE_TIMEOUT)) {
95 printk(KERN_WARNING "olpc-ec: %d: waited %u ms for OBF!\n",
96 line, ec_timeout - timeo);
99 return !(state == desired);
103 * This allows the kernel to run Embedded Controller commands. The EC is
104 * documented at <http://wiki.laptop.org/go/Embedded_controller>, and the
105 * available EC commands are here:
106 * <http://wiki.laptop.org/go/Ec_specification>. Unfortunately, while
107 * OpenFirmware's source is available, the EC's is not.
109 static int olpc_xo1_ec_cmd(u8 cmd, u8 *inbuf, size_t inlen, u8 *outbuf,
110 size_t outlen, void *arg)
117 for (i = 0; i < 10 && (obf_status(0x6c) == 1); i++)
120 printk(KERN_ERR "olpc-ec: timeout while attempting to "
121 "clear OBF flag!\n");
125 if (wait_on_ibf(0x6c, 0)) {
126 printk(KERN_ERR "olpc-ec: timeout waiting for EC to "
133 * Note that if we time out during any IBF checks, that's a failure;
134 * we have to return. There's no way for the kernel to clear that.
136 * If we time out during an OBF check, we can restart the command;
137 * reissuing it will clear the OBF flag, and we should be alright.
138 * The OBF flag will sometimes misbehave due to what we believe
139 * is a hardware quirk..
141 pr_devel("olpc-ec: running cmd 0x%x\n", cmd);
144 if (wait_on_ibf(0x6c, 0)) {
145 printk(KERN_ERR "olpc-ec: timeout waiting for EC to read "
150 if (inbuf && inlen) {
151 /* write data to EC */
152 for (i = 0; i < inlen; i++) {
153 pr_devel("olpc-ec: sending cmd arg 0x%x\n", inbuf[i]);
154 outb(inbuf[i], 0x68);
155 if (wait_on_ibf(0x6c, 0)) {
156 printk(KERN_ERR "olpc-ec: timeout waiting for"
157 " EC accept data!\n");
162 if (outbuf && outlen) {
163 /* read data from EC */
164 for (i = 0; i < outlen; i++) {
165 if (wait_on_obf(0x6c, 1)) {
166 printk(KERN_ERR "olpc-ec: timeout waiting for"
167 " EC to provide data!\n");
172 outbuf[i] = inb(0x68);
173 pr_devel("olpc-ec: received 0x%x\n", outbuf[i]);
182 static bool __init check_ofw_architecture(struct device_node *root)
184 const char *olpc_arch;
187 olpc_arch = of_get_property(root, "architecture", &propsize);
188 return propsize == 5 && strncmp("OLPC", olpc_arch, 5) == 0;
191 static u32 __init get_board_revision(struct device_node *root)
196 rev = of_get_property(root, "board-revision-int", &propsize);
200 return be32_to_cpu(*rev);
203 static bool __init platform_detect(void)
205 struct device_node *root = of_find_node_by_path("/");
211 success = check_ofw_architecture(root);
213 olpc_platform_info.boardrev = get_board_revision(root);
214 olpc_platform_info.flags |= OLPC_F_PRESENT;
216 pr_info("OLPC board revision %s%X\n",
217 ((olpc_platform_info.boardrev & 0xf) < 8) ? "pre" : "",
218 olpc_platform_info.boardrev >> 4);
225 static int __init add_xo1_platform_devices(void)
227 struct platform_device *pdev;
229 pdev = platform_device_register_simple("xo1-rfkill", -1, NULL, 0);
231 return PTR_ERR(pdev);
233 pdev = platform_device_register_simple("olpc-xo1", -1, NULL, 0);
235 return PTR_ERR_OR_ZERO(pdev);
238 static int olpc_xo1_ec_suspend(struct platform_device *pdev)
241 * Squelch SCIs while suspended. This is a fix for
242 * <http://dev.laptop.org/ticket/1835>.
244 return olpc_ec_cmd(EC_SET_SCI_INHIBIT, NULL, 0, NULL, 0);
247 static int olpc_xo1_ec_resume(struct platform_device *pdev)
249 /* Tell the EC to stop inhibiting SCIs */
250 olpc_ec_cmd(EC_SET_SCI_INHIBIT_RELEASE, NULL, 0, NULL, 0);
253 * Tell the wireless module to restart USB communication.
254 * Must be done twice.
256 olpc_ec_cmd(EC_WAKE_UP_WLAN, NULL, 0, NULL, 0);
257 olpc_ec_cmd(EC_WAKE_UP_WLAN, NULL, 0, NULL, 0);
262 static struct olpc_ec_driver ec_xo1_driver = {
263 .suspend = olpc_xo1_ec_suspend,
264 .resume = olpc_xo1_ec_resume,
265 .ec_cmd = olpc_xo1_ec_cmd,
266 #ifdef CONFIG_OLPC_XO1_SCI
268 * XO-1 EC wakeups are available when olpc-xo1-sci driver is
271 .wakeup_available = true,
275 static struct olpc_ec_driver ec_xo1_5_driver = {
276 .ec_cmd = olpc_xo1_ec_cmd,
277 #ifdef CONFIG_OLPC_XO15_SCI
279 * XO-1.5 EC wakeups are available when olpc-xo15-sci driver is
282 .wakeup_available = true,
286 static int __init olpc_init(void)
290 if (!olpc_ofw_present() || !platform_detect())
293 /* register the XO-1 and 1.5-specific EC handler */
294 if (olpc_platform_info.boardrev < olpc_board_pre(0xd0)) /* XO-1 */
295 olpc_ec_driver_register(&ec_xo1_driver, NULL);
297 olpc_ec_driver_register(&ec_xo1_5_driver, NULL);
298 platform_device_register_simple("olpc-ec", -1, NULL, 0);
300 /* assume B1 and above models always have a DCON */
301 if (olpc_board_at_least(olpc_board(0xb1)))
302 olpc_platform_info.flags |= OLPC_F_DCON;
304 #ifdef CONFIG_PCI_OLPC
305 /* If the VSA exists let it emulate PCI, if not emulate in kernel.
307 if (olpc_platform_info.boardrev < olpc_board_pre(0xd0) &&
309 x86_init.pci.arch_init = pci_olpc_init;
312 if (olpc_platform_info.boardrev < olpc_board_pre(0xd0)) { /* XO-1 */
313 r = add_xo1_platform_devices();
321 postcore_initcall(olpc_init);