qemu/hw/rtc/ds1338.c
<<
>>
Prefs
   1/*
   2 * MAXIM DS1338 I2C RTC+NVRAM
   3 *
   4 * Copyright (c) 2009 CodeSourcery.
   5 * Written by Paul Brook
   6 *
   7 * This code is licensed under the GNU GPL v2.
   8 *
   9 * Contributions after 2012-01-13 are licensed under the terms of the
  10 * GNU GPL, version 2 or (at your option) any later version.
  11 */
  12
  13#include "qemu/osdep.h"
  14#include "qemu-common.h"
  15#include "hw/i2c/i2c.h"
  16#include "migration/vmstate.h"
  17#include "qemu/bcd.h"
  18#include "qemu/module.h"
  19
  20/* Size of NVRAM including both the user-accessible area and the
  21 * secondary register area.
  22 */
  23#define NVRAM_SIZE 64
  24
  25/* Flags definitions */
  26#define SECONDS_CH 0x80
  27#define HOURS_12   0x40
  28#define HOURS_PM   0x20
  29#define CTRL_OSF   0x20
  30
  31#define TYPE_DS1338 "ds1338"
  32#define DS1338(obj) OBJECT_CHECK(DS1338State, (obj), TYPE_DS1338)
  33
  34typedef struct DS1338State {
  35    I2CSlave parent_obj;
  36
  37    int64_t offset;
  38    uint8_t wday_offset;
  39    uint8_t nvram[NVRAM_SIZE];
  40    int32_t ptr;
  41    bool addr_byte;
  42} DS1338State;
  43
  44static const VMStateDescription vmstate_ds1338 = {
  45    .name = "ds1338",
  46    .version_id = 2,
  47    .minimum_version_id = 1,
  48    .fields = (VMStateField[]) {
  49        VMSTATE_I2C_SLAVE(parent_obj, DS1338State),
  50        VMSTATE_INT64(offset, DS1338State),
  51        VMSTATE_UINT8_V(wday_offset, DS1338State, 2),
  52        VMSTATE_UINT8_ARRAY(nvram, DS1338State, NVRAM_SIZE),
  53        VMSTATE_INT32(ptr, DS1338State),
  54        VMSTATE_BOOL(addr_byte, DS1338State),
  55        VMSTATE_END_OF_LIST()
  56    }
  57};
  58
  59static void capture_current_time(DS1338State *s)
  60{
  61    /* Capture the current time into the secondary registers
  62     * which will be actually read by the data transfer operation.
  63     */
  64    struct tm now;
  65    qemu_get_timedate(&now, s->offset);
  66    s->nvram[0] = to_bcd(now.tm_sec);
  67    s->nvram[1] = to_bcd(now.tm_min);
  68    if (s->nvram[2] & HOURS_12) {
  69        int tmp = now.tm_hour;
  70        if (tmp % 12 == 0) {
  71            tmp += 12;
  72        }
  73        if (tmp <= 12) {
  74            s->nvram[2] = HOURS_12 | to_bcd(tmp);
  75        } else {
  76            s->nvram[2] = HOURS_12 | HOURS_PM | to_bcd(tmp - 12);
  77        }
  78    } else {
  79        s->nvram[2] = to_bcd(now.tm_hour);
  80    }
  81    s->nvram[3] = (now.tm_wday + s->wday_offset) % 7 + 1;
  82    s->nvram[4] = to_bcd(now.tm_mday);
  83    s->nvram[5] = to_bcd(now.tm_mon + 1);
  84    s->nvram[6] = to_bcd(now.tm_year - 100);
  85}
  86
  87static void inc_regptr(DS1338State *s)
  88{
  89    /* The register pointer wraps around after 0x3F; wraparound
  90     * causes the current time/date to be retransferred into
  91     * the secondary registers.
  92     */
  93    s->ptr = (s->ptr + 1) & (NVRAM_SIZE - 1);
  94    if (!s->ptr) {
  95        capture_current_time(s);
  96    }
  97}
  98
  99static int ds1338_event(I2CSlave *i2c, enum i2c_event event)
 100{
 101    DS1338State *s = DS1338(i2c);
 102
 103    switch (event) {
 104    case I2C_START_RECV:
 105        /* In h/w, capture happens on any START condition, not just a
 106         * START_RECV, but there is no need to actually capture on
 107         * START_SEND, because the guest can't get at that data
 108         * without going through a START_RECV which would overwrite it.
 109         */
 110        capture_current_time(s);
 111        break;
 112    case I2C_START_SEND:
 113        s->addr_byte = true;
 114        break;
 115    default:
 116        break;
 117    }
 118
 119    return 0;
 120}
 121
 122static uint8_t ds1338_recv(I2CSlave *i2c)
 123{
 124    DS1338State *s = DS1338(i2c);
 125    uint8_t res;
 126
 127    res  = s->nvram[s->ptr];
 128    inc_regptr(s);
 129    return res;
 130}
 131
 132static int ds1338_send(I2CSlave *i2c, uint8_t data)
 133{
 134    DS1338State *s = DS1338(i2c);
 135
 136    if (s->addr_byte) {
 137        s->ptr = data & (NVRAM_SIZE - 1);
 138        s->addr_byte = false;
 139        return 0;
 140    }
 141    if (s->ptr < 7) {
 142        /* Time register. */
 143        struct tm now;
 144        qemu_get_timedate(&now, s->offset);
 145        switch(s->ptr) {
 146        case 0:
 147            /* TODO: Implement CH (stop) bit.  */
 148            now.tm_sec = from_bcd(data & 0x7f);
 149            break;
 150        case 1:
 151            now.tm_min = from_bcd(data & 0x7f);
 152            break;
 153        case 2:
 154            if (data & HOURS_12) {
 155                int tmp = from_bcd(data & (HOURS_PM - 1));
 156                if (data & HOURS_PM) {
 157                    tmp += 12;
 158                }
 159                if (tmp % 12 == 0) {
 160                    tmp -= 12;
 161                }
 162                now.tm_hour = tmp;
 163            } else {
 164                now.tm_hour = from_bcd(data & (HOURS_12 - 1));
 165            }
 166            break;
 167        case 3:
 168            {
 169                /* The day field is supposed to contain a value in
 170                   the range 1-7. Otherwise behavior is undefined.
 171                 */
 172                int user_wday = (data & 7) - 1;
 173                s->wday_offset = (user_wday - now.tm_wday + 7) % 7;
 174            }
 175            break;
 176        case 4:
 177            now.tm_mday = from_bcd(data & 0x3f);
 178            break;
 179        case 5:
 180            now.tm_mon = from_bcd(data & 0x1f) - 1;
 181            break;
 182        case 6:
 183            now.tm_year = from_bcd(data) + 100;
 184            break;
 185        }
 186        s->offset = qemu_timedate_diff(&now);
 187    } else if (s->ptr == 7) {
 188        /* Control register. */
 189
 190        /* Ensure bits 2, 3 and 6 will read back as zero. */
 191        data &= 0xB3;
 192
 193        /* Attempting to write the OSF flag to logic 1 leaves the
 194           value unchanged. */
 195        data = (data & ~CTRL_OSF) | (data & s->nvram[s->ptr] & CTRL_OSF);
 196
 197        s->nvram[s->ptr] = data;
 198    } else {
 199        s->nvram[s->ptr] = data;
 200    }
 201    inc_regptr(s);
 202    return 0;
 203}
 204
 205static void ds1338_reset(DeviceState *dev)
 206{
 207    DS1338State *s = DS1338(dev);
 208
 209    /* The clock is running and synchronized with the host */
 210    s->offset = 0;
 211    s->wday_offset = 0;
 212    memset(s->nvram, 0, NVRAM_SIZE);
 213    s->ptr = 0;
 214    s->addr_byte = false;
 215}
 216
 217static void ds1338_class_init(ObjectClass *klass, void *data)
 218{
 219    DeviceClass *dc = DEVICE_CLASS(klass);
 220    I2CSlaveClass *k = I2C_SLAVE_CLASS(klass);
 221
 222    k->event = ds1338_event;
 223    k->recv = ds1338_recv;
 224    k->send = ds1338_send;
 225    dc->reset = ds1338_reset;
 226    dc->vmsd = &vmstate_ds1338;
 227}
 228
 229static const TypeInfo ds1338_info = {
 230    .name          = TYPE_DS1338,
 231    .parent        = TYPE_I2C_SLAVE,
 232    .instance_size = sizeof(DS1338State),
 233    .class_init    = ds1338_class_init,
 234};
 235
 236static void ds1338_register_types(void)
 237{
 238    type_register_static(&ds1338_info);
 239}
 240
 241type_init(ds1338_register_types)
 242