Coverage Report

Created: 2026-11-20 08:13

next uncovered line (L), next uncovered region (R), next uncovered branch (B)
/src/qemu/hw/misc/applesmc.c
Line
Count
Source
1
/*
2
 *  Apple SMC controller
3
 *
4
 *  Copyright (c) 2007 Alexander Graf
5
 *
6
 *  Authors: Alexander Graf <agraf@suse.de>
7
 *           Susanne Graf <suse@csgraf.de>
8
 *
9
 * This library is free software; you can redistribute it and/or
10
 * modify it under the terms of the GNU Lesser General Public
11
 * License as published by the Free Software Foundation; either
12
 * version 2.1 of the License, or (at your option) any later version.
13
 *
14
 * This library is distributed in the hope that it will be useful,
15
 * but WITHOUT ANY WARRANTY; without even the implied warranty of
16
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
17
 * Lesser General Public License for more details.
18
 *
19
 * You should have received a copy of the GNU Lesser General Public
20
 * License along with this library; if not, see <http://www.gnu.org/licenses/>.
21
 *
22
 * *****************************************************************
23
 *
24
 * In all Intel-based Apple hardware there is an SMC chip to control the
25
 * backlight, fans and several other generic device parameters. It also
26
 * contains the magic keys used to dongle Mac OS X to the device.
27
 *
28
 * This driver was mostly created by looking at the Linux AppleSMC driver
29
 * implementation and does not support IRQ.
30
 *
31
 */
32
33
#include "qemu/osdep.h"
34
#include "hw/isa/isa.h"
35
#include "hw/core/qdev-properties.h"
36
#include "ui/console.h"
37
#include "qemu/error-report.h"
38
#include "qemu/module.h"
39
#include "qemu/timer.h"
40
#include "qom/object.h"
41
#include "hw/acpi/acpi_aml_interface.h"
42
43
/* #define DEBUG_SMC */
44
45
#define APPLESMC_DEFAULT_IOBASE        0x300
46
#define TYPE_APPLE_SMC "isa-applesmc"
47
0
#define APPLESMC_MAX_DATA_LENGTH       32
48
#define APPLESMC_PROP_IO_BASE "iobase"
49
50
enum {
51
    APPLESMC_DATA_PORT               = 0x00,
52
    APPLESMC_CMD_PORT                = 0x04,
53
    APPLESMC_ERR_PORT                = 0x1e,
54
    APPLESMC_NUM_PORTS               = 0x20,
55
};
56
57
enum {
58
    APPLESMC_READ_CMD                = 0x10,
59
    APPLESMC_WRITE_CMD               = 0x11,
60
    APPLESMC_GET_KEY_BY_INDEX_CMD    = 0x12,
61
    APPLESMC_GET_KEY_TYPE_CMD        = 0x13,
62
};
63
64
enum {
65
    APPLESMC_ST_CMD_DONE             = 0x00,
66
    APPLESMC_ST_DATA_READY           = 0x01,
67
    APPLESMC_ST_BUSY                 = 0x02,
68
    APPLESMC_ST_ACK                  = 0x04,
69
    APPLESMC_ST_NEW_CMD              = 0x08,
70
};
71
72
enum {
73
    APPLESMC_ST_1E_CMD_INTRUPTED     = 0x80,
74
    APPLESMC_ST_1E_STILL_BAD_CMD     = 0x81,
75
    APPLESMC_ST_1E_BAD_CMD           = 0x82,
76
    APPLESMC_ST_1E_NOEXIST           = 0x84,
77
    APPLESMC_ST_1E_WRITEONLY         = 0x85,
78
    APPLESMC_ST_1E_READONLY          = 0x86,
79
    APPLESMC_ST_1E_BAD_INDEX         = 0xb8,
80
};
81
82
#ifdef DEBUG_SMC
83
#define smc_debug(...) fprintf(stderr, "AppleSMC: " __VA_ARGS__)
84
#else
85
0
#define smc_debug(...) do { } while (0)
86
#endif
87
88
static char default_osk[64] = "This is a dummy key. Enter the real key "
89
                              "using the -osk parameter";
90
91
struct AppleSMCData {
92
    uint8_t len;
93
    const char *key;
94
    const char *data;
95
    QLIST_ENTRY(AppleSMCData) node;
96
};
97
98
OBJECT_DECLARE_SIMPLE_TYPE(AppleSMCState, APPLE_SMC)
99
100
struct AppleSMCState {
101
    ISADevice parent_obj;
102
103
    MemoryRegion io_data;
104
    MemoryRegion io_cmd;
105
    MemoryRegion io_err;
106
    uint32_t iobase;
107
    uint8_t cmd;
108
    uint8_t status;
109
    uint8_t status_1e;
110
    uint8_t last_ret;
111
    char key[4];
112
    uint8_t read_pos;
113
    uint8_t data_len;
114
    uint8_t data_pos;
115
    uint8_t data[255];
116
    char *osk;
117
    QLIST_HEAD(, AppleSMCData) data_def;
118
};
119
120
static void applesmc_io_cmd_write(void *opaque, hwaddr addr, uint64_t val,
121
                                  unsigned size)
122
0
{
123
0
    AppleSMCState *s = opaque;
124
0
    uint8_t status = s->status & 0x0f;
125
126
0
    smc_debug("CMD received: 0x%02x\n", (uint8_t)val);
127
0
    switch (val) {
128
0
    case APPLESMC_READ_CMD:
129
        /* did last command run through OK? */
130
0
        if (status == APPLESMC_ST_CMD_DONE || status == APPLESMC_ST_NEW_CMD) {
131
0
            s->cmd = val;
132
0
            s->status = APPLESMC_ST_NEW_CMD | APPLESMC_ST_ACK;
133
0
        } else {
134
0
            smc_debug("ERROR: previous command interrupted!\n");
135
0
            s->status = APPLESMC_ST_NEW_CMD;
136
0
            s->status_1e = APPLESMC_ST_1E_CMD_INTRUPTED;
137
0
        }
138
0
        break;
139
0
    default:
140
0
        smc_debug("UNEXPECTED CMD 0x%02x\n", (uint8_t)val);
141
0
        s->status = APPLESMC_ST_NEW_CMD;
142
0
        s->status_1e = APPLESMC_ST_1E_BAD_CMD;
143
0
    }
144
0
    s->read_pos = 0;
145
0
    s->data_pos = 0;
146
0
}
147
148
static const struct AppleSMCData *applesmc_find_key(AppleSMCState *s)
149
0
{
150
0
    struct AppleSMCData *d;
151
152
0
    QLIST_FOREACH(d, &s->data_def, node) {
153
0
        if (!memcmp(d->key, s->key, 4)) {
154
0
            return d;
155
0
        }
156
0
    }
157
0
    return NULL;
158
0
}
159
160
static void applesmc_io_data_write(void *opaque, hwaddr addr, uint64_t val,
161
                                   unsigned size)
162
0
{
163
0
    AppleSMCState *s = opaque;
164
0
    const struct AppleSMCData *d;
165
166
0
    smc_debug("DATA received: 0x%02x\n", (uint8_t)val);
167
0
    switch (s->cmd) {
168
0
    case APPLESMC_READ_CMD:
169
0
        if ((s->status & 0x0f) == APPLESMC_ST_CMD_DONE) {
170
0
            break;
171
0
        }
172
0
        if (s->read_pos < 4) {
173
0
            s->key[s->read_pos] = val;
174
0
            s->status = APPLESMC_ST_ACK;
175
0
        } else if (s->read_pos == 4) {
176
0
            d = applesmc_find_key(s);
177
0
            if (d != NULL) {
178
0
                memcpy(s->data, d->data, d->len);
179
0
                s->data_len = d->len;
180
0
                s->data_pos = 0;
181
0
                s->status = APPLESMC_ST_ACK | APPLESMC_ST_DATA_READY;
182
0
                s->status_1e = APPLESMC_ST_CMD_DONE;  /* clear on valid key */
183
0
            } else {
184
0
                smc_debug("READ_CMD: key '%c%c%c%c' not found!\n",
185
0
                          s->key[0], s->key[1], s->key[2], s->key[3]);
186
0
                s->status = APPLESMC_ST_CMD_DONE;
187
0
                s->status_1e = APPLESMC_ST_1E_NOEXIST;
188
0
            }
189
0
        }
190
0
        s->read_pos++;
191
0
        break;
192
0
    default:
193
0
        s->status = APPLESMC_ST_CMD_DONE;
194
0
        s->status_1e = APPLESMC_ST_1E_STILL_BAD_CMD;
195
0
    }
196
0
}
197
198
static void applesmc_io_err_write(void *opaque, hwaddr addr, uint64_t val,
199
                                  unsigned size)
200
0
{
201
0
    smc_debug("ERR_CODE received: 0x%02x, ignoring!\n", (uint8_t)val);
202
    /* NOTE: writing to the error port not supported! */
203
0
}
204
205
static uint64_t applesmc_io_data_read(void *opaque, hwaddr addr, unsigned size)
206
0
{
207
0
    AppleSMCState *s = opaque;
208
209
0
    switch (s->cmd) {
210
0
    case APPLESMC_READ_CMD:
211
0
        if (!(s->status & APPLESMC_ST_DATA_READY)) {
212
0
            break;
213
0
        }
214
0
        if (s->data_pos < s->data_len) {
215
0
            s->last_ret = s->data[s->data_pos];
216
0
            smc_debug("READ '%c%c%c%c'[%d] = %02x\n",
217
0
                      s->key[0], s->key[1], s->key[2], s->key[3],
218
0
                      s->data_pos, s->last_ret);
219
0
            s->data_pos++;
220
0
            if (s->data_pos == s->data_len) {
221
0
                s->status = APPLESMC_ST_CMD_DONE;
222
0
                smc_debug("READ '%c%c%c%c' Len=%d complete!\n",
223
0
                          s->key[0], s->key[1], s->key[2], s->key[3],
224
0
                          s->data_len);
225
0
            } else {
226
0
                s->status = APPLESMC_ST_ACK | APPLESMC_ST_DATA_READY;
227
0
            }
228
0
        }
229
0
        break;
230
0
    default:
231
0
        s->status = APPLESMC_ST_CMD_DONE;
232
0
        s->status_1e = APPLESMC_ST_1E_STILL_BAD_CMD;
233
0
    }
234
0
    smc_debug("DATA sent: 0x%02x\n", s->last_ret);
235
236
0
    return s->last_ret;
237
0
}
238
239
static uint64_t applesmc_io_cmd_read(void *opaque, hwaddr addr, unsigned size)
240
0
{
241
0
    AppleSMCState *s = opaque;
242
243
0
    smc_debug("CMD sent: 0x%02x\n", s->status);
244
0
    return s->status;
245
0
}
246
247
static uint64_t applesmc_io_err_read(void *opaque, hwaddr addr, unsigned size)
248
0
{
249
0
    AppleSMCState *s = opaque;
250
251
    /* NOTE: read does not clear the 1e status */
252
0
    smc_debug("ERR_CODE sent: 0x%02x\n", s->status_1e);
253
0
    return s->status_1e;
254
0
}
255
256
static void applesmc_add_key(AppleSMCState *s, const char *key,
257
                             int len, const char *data)
258
0
{
259
0
    struct AppleSMCData *def;
260
261
0
    def = g_new0(struct AppleSMCData, 1);
262
0
    def->key = key;
263
0
    def->len = len;
264
0
    def->data = data;
265
266
0
    QLIST_INSERT_HEAD(&s->data_def, def, node);
267
0
}
268
269
static void qdev_applesmc_isa_reset(DeviceState *dev)
270
0
{
271
0
    AppleSMCState *s = APPLE_SMC(dev);
272
273
0
    s->status = 0x00;
274
0
    s->status_1e = 0x00;
275
0
    s->last_ret = 0x00;
276
0
}
277
278
static const MemoryRegionOps applesmc_data_io_ops = {
279
    .write = applesmc_io_data_write,
280
    .read = applesmc_io_data_read,
281
    .endianness = DEVICE_NATIVE_ENDIAN,
282
    .impl = {
283
        .min_access_size = 1,
284
        .max_access_size = 1,
285
    },
286
};
287
288
static const MemoryRegionOps applesmc_cmd_io_ops = {
289
    .write = applesmc_io_cmd_write,
290
    .read = applesmc_io_cmd_read,
291
    .endianness = DEVICE_NATIVE_ENDIAN,
292
    .impl = {
293
        .min_access_size = 1,
294
        .max_access_size = 1,
295
    },
296
};
297
298
static const MemoryRegionOps applesmc_err_io_ops = {
299
    .write = applesmc_io_err_write,
300
    .read = applesmc_io_err_read,
301
    .endianness = DEVICE_NATIVE_ENDIAN,
302
    .impl = {
303
        .min_access_size = 1,
304
        .max_access_size = 1,
305
    },
306
};
307
308
static void applesmc_isa_realize(DeviceState *dev, Error **errp)
309
0
{
310
0
    AppleSMCState *s = APPLE_SMC(dev);
311
312
0
    memory_region_init_io(&s->io_data, OBJECT(s), &applesmc_data_io_ops, s,
313
0
                          "applesmc-data", 1);
314
0
    isa_register_ioport(&s->parent_obj, &s->io_data,
315
0
                        s->iobase + APPLESMC_DATA_PORT);
316
317
0
    memory_region_init_io(&s->io_cmd, OBJECT(s), &applesmc_cmd_io_ops, s,
318
0
                          "applesmc-cmd", 1);
319
0
    isa_register_ioport(&s->parent_obj, &s->io_cmd,
320
0
                        s->iobase + APPLESMC_CMD_PORT);
321
322
0
    memory_region_init_io(&s->io_err, OBJECT(s), &applesmc_err_io_ops, s,
323
0
                          "applesmc-err", 1);
324
0
    isa_register_ioport(&s->parent_obj, &s->io_err,
325
0
                        s->iobase + APPLESMC_ERR_PORT);
326
327
0
    if (!s->osk || (strlen(s->osk) != 64)) {
328
0
        warn_report("Using AppleSMC with invalid key");
329
0
        s->osk = default_osk;
330
0
    }
331
332
0
    QLIST_INIT(&s->data_def);
333
0
    applesmc_add_key(s, "REV ", 6, "\x01\x13\x0f\x00\x00\x03");
334
0
    applesmc_add_key(s, "OSK0", 32, s->osk);
335
0
    applesmc_add_key(s, "OSK1", 32, s->osk + 32);
336
0
    applesmc_add_key(s, "NATJ", 1, "\x00");
337
0
    applesmc_add_key(s, "MSSP", 1, "\x00");
338
0
    applesmc_add_key(s, "MSSD", 1, "\x03");
339
0
}
340
341
static void applesmc_unrealize(DeviceState *dev)
342
0
{
343
0
    AppleSMCState *s = APPLE_SMC(dev);
344
0
    struct AppleSMCData *d, *next;
345
346
    /* Remove existing entries */
347
0
    QLIST_FOREACH_SAFE(d, &s->data_def, node, next) {
348
0
        QLIST_REMOVE(d, node);
349
0
        g_free(d);
350
0
    }
351
0
}
352
353
static const Property applesmc_isa_properties[] = {
354
    DEFINE_PROP_UINT32(APPLESMC_PROP_IO_BASE, AppleSMCState, iobase,
355
                       APPLESMC_DEFAULT_IOBASE),
356
    DEFINE_PROP_STRING("osk", AppleSMCState, osk),
357
};
358
359
static void build_applesmc_aml(AcpiDevAmlIf *adev, Aml *scope)
360
0
{
361
0
    Aml *crs;
362
0
    AppleSMCState *s = APPLE_SMC(adev);
363
0
    uint32_t iobase = s->iobase;
364
0
    Aml *dev = aml_device("SMC");
365
366
0
    aml_append(dev, aml_name_decl("_HID", aml_eisaid("APP0001")));
367
    /* device present, functioning, decoding, not shown in UI */
368
0
    aml_append(dev, aml_name_decl("_STA", aml_int(0xB)));
369
0
    crs = aml_resource_template();
370
0
    aml_append(crs,
371
0
        aml_io(AML_DECODE16, iobase, iobase, 0x01, APPLESMC_MAX_DATA_LENGTH)
372
0
    );
373
0
    aml_append(crs, aml_irq_no_flags(6));
374
0
    aml_append(dev, aml_name_decl("_CRS", crs));
375
0
    aml_append(scope, dev);
376
0
}
377
378
static void qdev_applesmc_class_init(ObjectClass *klass, const void *data)
379
63
{
380
63
    DeviceClass *dc = DEVICE_CLASS(klass);
381
63
    AcpiDevAmlIfClass *adevc = ACPI_DEV_AML_IF_CLASS(klass);
382
383
63
    dc->realize = applesmc_isa_realize;
384
63
    dc->unrealize = applesmc_unrealize;
385
63
    device_class_set_legacy_reset(dc, qdev_applesmc_isa_reset);
386
63
    device_class_set_props(dc, applesmc_isa_properties);
387
63
    set_bit(DEVICE_CATEGORY_MISC, dc->categories);
388
63
    adevc->build_dev_aml = build_applesmc_aml;
389
63
}
390
391
static const TypeInfo applesmc_isa_info = {
392
    .name          = TYPE_APPLE_SMC,
393
    .parent        = TYPE_ISA_DEVICE,
394
    .instance_size = sizeof(AppleSMCState),
395
    .class_init    = qdev_applesmc_class_init,
396
    .interfaces = (const InterfaceInfo[]) {
397
        { TYPE_ACPI_DEV_AML_IF },
398
        { },
399
    },
400
};
401
402
static void applesmc_register_types(void)
403
63
{
404
63
    type_register_static(&applesmc_isa_info);
405
63
}
406
407
type_init(applesmc_register_types)