[qemu.git] / hw / m48t59.c

/*
 * QEMU M48T59 and M48T08 NVRAM emulation for PPC PREP and Sparc platforms
 * 
 * Copyright (c) 2003-2005, 2007 Jocelyn Mayer
 * 
 * Permission is hereby granted, free of charge, to any person obtaining a copy
 * of this software and associated documentation files (the "Software"), to deal
 * in the Software without restriction, including without limitation the rights
 * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
 * copies of the Software, and to permit persons to whom the Software is
 * furnished to do so, subject to the following conditions:
 *
 * The above copyright notice and this permission notice shall be included in
 * all copies or substantial portions of the Software.
 *
 * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
 * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
 * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL
 * THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
 * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
 * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
 * THE SOFTWARE.
 */
#include "vl.h"
#include "m48t59.h"

//#define DEBUG_NVRAM

#if defined(DEBUG_NVRAM)
#define NVRAM_PRINTF(fmt, args...) do { printf(fmt , ##args); } while (0)
#else
#define NVRAM_PRINTF(fmt, args...) do { } while (0)
#endif

/*
 * The M48T08 and M48T59 chips are very similar. The newer '59 has
 * alarm and a watchdog timer and related control registers. In the
 * PPC platform there is also a nvram lock function.
 */
struct m48t59_t {
    /* Model parameters */
    int type; // 8 = m48t08, 59 = m48t59
    /* Hardware parameters */
    qemu_irq IRQ;
    int mem_index;
    target_phys_addr_t mem_base;
    uint32_t io_base;
    uint16_t size;
    /* RTC management */
    time_t   time_offset;
    time_t   stop_time;
    /* Alarm & watchdog */
    time_t   alarm;
    struct QEMUTimer *alrm_timer;
    struct QEMUTimer *wd_timer;
    /* NVRAM storage */
    uint8_t  lock;
    uint16_t addr;
    uint8_t *buffer;
};

/* Fake timer functions */
/* Generic helpers for BCD */
static inline uint8_t toBCD (uint8_t value)
{
    return (((value / 10) % 10) << 4) | (value % 10);
}

static inline uint8_t fromBCD (uint8_t BCD)
{
    return ((BCD >> 4) * 10) + (BCD & 0x0F);
}

/* RTC management helpers */
static void get_time (m48t59_t *NVRAM, struct tm *tm)
{
    time_t t;

    t = time(NULL) + NVRAM->time_offset;
#ifdef _WIN32
    memcpy(tm,localtime(&t),sizeof(*tm));
#else
    localtime_r (&t, tm) ;
#endif
}

static void set_time (m48t59_t *NVRAM, struct tm *tm)
{
    time_t now, new_time;
    
    new_time = mktime(tm);
    now = time(NULL);
    NVRAM->time_offset = new_time - now;
}

/* Alarm management */
static void alarm_cb (void *opaque)
{
    struct tm tm, tm_now;
    uint64_t next_time;
    m48t59_t *NVRAM = opaque;

    qemu_set_irq(NVRAM->IRQ, 1);
    if ((NVRAM->buffer[0x1FF5] & 0x80) == 0 && 
	(NVRAM->buffer[0x1FF4] & 0x80) == 0 &&
	(NVRAM->buffer[0x1FF3] & 0x80) == 0 &&
	(NVRAM->buffer[0x1FF2] & 0x80) == 0) {
	/* Repeat once a month */
	get_time(NVRAM, &tm_now);
	memcpy(&tm, &tm_now, sizeof(struct tm));
	tm.tm_mon++;
	if (tm.tm_mon == 13) {
	    tm.tm_mon = 1;
	    tm.tm_year++;
	}
	next_time = mktime(&tm);
    } else if ((NVRAM->buffer[0x1FF5] & 0x80) != 0 &&
	       (NVRAM->buffer[0x1FF4] & 0x80) == 0 &&
	       (NVRAM->buffer[0x1FF3] & 0x80) == 0 &&
	       (NVRAM->buffer[0x1FF2] & 0x80) == 0) {
	/* Repeat once a day */
	next_time = 24 * 60 * 60 + mktime(&tm_now);
    } else if ((NVRAM->buffer[0x1FF5] & 0x80) != 0 &&
	       (NVRAM->buffer[0x1FF4] & 0x80) != 0 &&
	       (NVRAM->buffer[0x1FF3] & 0x80) == 0 &&
	       (NVRAM->buffer[0x1FF2] & 0x80) == 0) {
	/* Repeat once an hour */
	next_time = 60 * 60 + mktime(&tm_now);
    } else if ((NVRAM->buffer[0x1FF5] & 0x80) != 0 &&
	       (NVRAM->buffer[0x1FF4] & 0x80) != 0 &&
	       (NVRAM->buffer[0x1FF3] & 0x80) != 0 &&
	       (NVRAM->buffer[0x1FF2] & 0x80) == 0) {
	/* Repeat once a minute */
	next_time = 60 + mktime(&tm_now);
    } else {
	/* Repeat once a second */
	next_time = 1 + mktime(&tm_now);
    }
    qemu_mod_timer(NVRAM->alrm_timer, next_time * 1000);
    qemu_set_irq(NVRAM->IRQ, 0);
}


static void get_alarm (m48t59_t *NVRAM, struct tm *tm)
{
#ifdef _WIN32
    memcpy(tm,localtime(&NVRAM->alarm),sizeof(*tm));
#else
    localtime_r (&NVRAM->alarm, tm);
#endif
}

static void set_alarm (m48t59_t *NVRAM, struct tm *tm)
{
    NVRAM->alarm = mktime(tm);
    if (NVRAM->alrm_timer != NULL) {
        qemu_del_timer(NVRAM->alrm_timer);
	NVRAM->alrm_timer = NULL;
    }
    if (NVRAM->alarm - time(NULL) > 0)
	qemu_mod_timer(NVRAM->alrm_timer, NVRAM->alarm * 1000);
}

/* Watchdog management */
static void watchdog_cb (void *opaque)
{
    m48t59_t *NVRAM = opaque;

    NVRAM->buffer[0x1FF0] |= 0x80;
    if (NVRAM->buffer[0x1FF7] & 0x80) {
	NVRAM->buffer[0x1FF7] = 0x00;
	NVRAM->buffer[0x1FFC] &= ~0x40;
        /* May it be a hw CPU Reset instead ? */
        qemu_system_reset_request();
    } else {
	qemu_set_irq(NVRAM->IRQ, 1);
	qemu_set_irq(NVRAM->IRQ, 0);
    }
}

static void set_up_watchdog (m48t59_t *NVRAM, uint8_t value)
{
    uint64_t interval; /* in 1/16 seconds */

    if (NVRAM->wd_timer != NULL) {
        qemu_del_timer(NVRAM->wd_timer);
	NVRAM->wd_timer = NULL;
    }
    NVRAM->buffer[0x1FF0] &= ~0x80;
    if (value != 0) {
	interval = (1 << (2 * (value & 0x03))) * ((value >> 2) & 0x1F);
	qemu_mod_timer(NVRAM->wd_timer, ((uint64_t)time(NULL) * 1000) +
		       ((interval * 1000) >> 4));
    }
}

/* Direct access to NVRAM */
void m48t59_write (m48t59_t *NVRAM, uint32_t addr, uint32_t val)
{
    struct tm tm;
    int tmp;

    if (addr > 0x1FF8 && addr < 0x2000)
	NVRAM_PRINTF("%s: 0x%08x => 0x%08x\n", __func__, addr, val);
    if (NVRAM->type == 8 && 
        (addr >= 0x1ff0 && addr <= 0x1ff7))
        goto do_write;
    switch (addr) {
    case 0x1FF0:
        /* flags register : read-only */
        break;
    case 0x1FF1:
        /* unused */
        break;
    case 0x1FF2:
        /* alarm seconds */
        tmp = fromBCD(val & 0x7F);
        if (tmp >= 0 && tmp <= 59) {
            get_alarm(NVRAM, &tm);
            tm.tm_sec = tmp;
            NVRAM->buffer[0x1FF2] = val;
            set_alarm(NVRAM, &tm);
        }
        break;
    case 0x1FF3:
        /* alarm minutes */
        tmp = fromBCD(val & 0x7F);
        if (tmp >= 0 && tmp <= 59) {
            get_alarm(NVRAM, &tm);
            tm.tm_min = tmp;
            NVRAM->buffer[0x1FF3] = val;
            set_alarm(NVRAM, &tm);
        }
        break;
    case 0x1FF4:
        /* alarm hours */
        tmp = fromBCD(val & 0x3F);
        if (tmp >= 0 && tmp <= 23) {
            get_alarm(NVRAM, &tm);
            tm.tm_hour = tmp;
            NVRAM->buffer[0x1FF4] = val;
            set_alarm(NVRAM, &tm);
        }
        break;
    case 0x1FF5:
        /* alarm date */
        tmp = fromBCD(val & 0x1F);
        if (tmp != 0) {
            get_alarm(NVRAM, &tm);
            tm.tm_mday = tmp;
            NVRAM->buffer[0x1FF5] = val;
            set_alarm(NVRAM, &tm);
        }
        break;
    case 0x1FF6:
        /* interrupts */
        NVRAM->buffer[0x1FF6] = val;
        break;
    case 0x1FF7:
        /* watchdog */
        NVRAM->buffer[0x1FF7] = val;
        set_up_watchdog(NVRAM, val);
        break;
    case 0x1FF8:
        /* control */
	NVRAM->buffer[0x1FF8] = (val & ~0xA0) | 0x90;
        break;
    case 0x1FF9:
        /* seconds (BCD) */
	tmp = fromBCD(val & 0x7F);
	if (tmp >= 0 && tmp <= 59) {
	    get_time(NVRAM, &tm);
	    tm.tm_sec = tmp;
	    set_time(NVRAM, &tm);
	}
	if ((val & 0x80) ^ (NVRAM->buffer[0x1FF9] & 0x80)) {
	    if (val & 0x80) {
		NVRAM->stop_time = time(NULL);
	    } else {
		NVRAM->time_offset += NVRAM->stop_time - time(NULL);
		NVRAM->stop_time = 0;
	    }
	}
	NVRAM->buffer[0x1FF9] = val & 0x80;
        break;
    case 0x1FFA:
        /* minutes (BCD) */
	tmp = fromBCD(val & 0x7F);
	if (tmp >= 0 && tmp <= 59) {
	    get_time(NVRAM, &tm);
	    tm.tm_min = tmp;
	    set_time(NVRAM, &tm);
	}
        break;
    case 0x1FFB:
        /* hours (BCD) */
	tmp = fromBCD(val & 0x3F);
	if (tmp >= 0 && tmp <= 23) {
	    get_time(NVRAM, &tm);
	    tm.tm_hour = tmp;
	    set_time(NVRAM, &tm);
	}
        break;
    case 0x1FFC:
        /* day of the week / century */
	tmp = fromBCD(val & 0x07);
	get_time(NVRAM, &tm);
	tm.tm_wday = tmp;
	set_time(NVRAM, &tm);
        NVRAM->buffer[0x1FFC] = val & 0x40;
        break;
    case 0x1FFD:
        /* date */
	tmp = fromBCD(val & 0x1F);
	if (tmp != 0) {
	    get_time(NVRAM, &tm);
	    tm.tm_mday = tmp;
	    set_time(NVRAM, &tm);
	}
        break;
    case 0x1FFE:
        /* month */
	tmp = fromBCD(val & 0x1F);
	if (tmp >= 1 && tmp <= 12) {
	    get_time(NVRAM, &tm);
	    tm.tm_mon = tmp - 1;
	    set_time(NVRAM, &tm);
	}
        break;
    case 0x1FFF:
        /* year */
	tmp = fromBCD(val);
	if (tmp >= 0 && tmp <= 99) {
	    get_time(NVRAM, &tm);
            if (NVRAM->type == 8)
                tm.tm_year = fromBCD(val) + 68; // Base year is 1968
            else
                tm.tm_year = fromBCD(val);
	    set_time(NVRAM, &tm);
	}
        break;
    default:
        /* Check lock registers state */
        if (addr >= 0x20 && addr <= 0x2F && (NVRAM->lock & 1))
            break;
        if (addr >= 0x30 && addr <= 0x3F && (NVRAM->lock & 2))
            break;
    do_write:
        if (addr < NVRAM->size) {
            NVRAM->buffer[addr] = val & 0xFF;
	}
        break;
    }
}

uint32_t m48t59_read (m48t59_t *NVRAM, uint32_t addr)
{
    struct tm tm;
    uint32_t retval = 0xFF;

    if (NVRAM->type == 8 && 
        (addr >= 0x1ff0 && addr <= 0x1ff7))
        goto do_read;
    switch (addr) {
    case 0x1FF0:
        /* flags register */
	goto do_read;
    case 0x1FF1:
        /* unused */
	retval = 0;
        break;
    case 0x1FF2:
        /* alarm seconds */
	goto do_read;
    case 0x1FF3:
        /* alarm minutes */
	goto do_read;
    case 0x1FF4:
        /* alarm hours */
	goto do_read;
    case 0x1FF5:
        /* alarm date */
	goto do_read;
    case 0x1FF6:
        /* interrupts */
	goto do_read;
    case 0x1FF7:
	/* A read resets the watchdog */
	set_up_watchdog(NVRAM, NVRAM->buffer[0x1FF7]);
	goto do_read;
    case 0x1FF8:
        /* control */
	goto do_read;
    case 0x1FF9:
        /* seconds (BCD) */
        get_time(NVRAM, &tm);
        retval = (NVRAM->buffer[0x1FF9] & 0x80) | toBCD(tm.tm_sec);
        break;
    case 0x1FFA:
        /* minutes (BCD) */
        get_time(NVRAM, &tm);
        retval = toBCD(tm.tm_min);
        break;
    case 0x1FFB:
        /* hours (BCD) */
        get_time(NVRAM, &tm);
        retval = toBCD(tm.tm_hour);
        break;
    case 0x1FFC:
        /* day of the week / century */
        get_time(NVRAM, &tm);
        retval = NVRAM->buffer[0x1FFC] | tm.tm_wday;
        break;
    case 0x1FFD:
        /* date */
        get_time(NVRAM, &tm);
        retval = toBCD(tm.tm_mday);
        break;
    case 0x1FFE:
        /* month */
        get_time(NVRAM, &tm);
        retval = toBCD(tm.tm_mon + 1);
        break;
    case 0x1FFF:
        /* year */
        get_time(NVRAM, &tm);
        if (NVRAM->type == 8) 
            retval = toBCD(tm.tm_year - 68); // Base year is 1968
        else
            retval = toBCD(tm.tm_year);
        break;
    default:
        /* Check lock registers state */
        if (addr >= 0x20 && addr <= 0x2F && (NVRAM->lock & 1))
            break;
        if (addr >= 0x30 && addr <= 0x3F && (NVRAM->lock & 2))
            break;
    do_read:
        if (addr < NVRAM->size) {
            retval = NVRAM->buffer[addr];
	}
        break;
    }
    if (addr > 0x1FF9 && addr < 0x2000)
	NVRAM_PRINTF("0x%08x <= 0x%08x\n", addr, retval);

    return retval;
}

void m48t59_set_addr (m48t59_t *NVRAM, uint32_t addr)
{
    NVRAM->addr = addr;
}

void m48t59_toggle_lock (m48t59_t *NVRAM, int lock)
{
    NVRAM->lock ^= 1 << lock;
}

/* IO access to NVRAM */
static void NVRAM_writeb (void *opaque, uint32_t addr, uint32_t val)
{
    m48t59_t *NVRAM = opaque;

    addr -= NVRAM->io_base;
    NVRAM_PRINTF("0x%08x => 0x%08x\n", addr, val);
    switch (addr) {
    case 0:
        NVRAM->addr &= ~0x00FF;
        NVRAM->addr |= val;
        break;
    case 1:
        NVRAM->addr &= ~0xFF00;
        NVRAM->addr |= val << 8;
        break;
    case 3:
        m48t59_write(NVRAM, val, NVRAM->addr);
        NVRAM->addr = 0x0000;
        break;
    default:
        break;
    }
}

static uint32_t NVRAM_readb (void *opaque, uint32_t addr)
{
    m48t59_t *NVRAM = opaque;
    uint32_t retval;

    addr -= NVRAM->io_base;
    switch (addr) {
    case 3:
        retval = m48t59_read(NVRAM, NVRAM->addr);
        break;
    default:
        retval = -1;
        break;
    }
    NVRAM_PRINTF("0x%08x <= 0x%08x\n", addr, retval);

    return retval;
}

static void nvram_writeb (void *opaque, target_phys_addr_t addr, uint32_t value)
{
    m48t59_t *NVRAM = opaque;
    
    addr -= NVRAM->mem_base;
    m48t59_write(NVRAM, addr, value & 0xff);
}

static void nvram_writew (void *opaque, target_phys_addr_t addr, uint32_t value)
{
    m48t59_t *NVRAM = opaque;
    
    addr -= NVRAM->mem_base;
    m48t59_write(NVRAM, addr, (value >> 8) & 0xff);
    m48t59_write(NVRAM, addr + 1, value & 0xff);
}

static void nvram_writel (void *opaque, target_phys_addr_t addr, uint32_t value)
{
    m48t59_t *NVRAM = opaque;
    
    addr -= NVRAM->mem_base;
    m48t59_write(NVRAM, addr, (value >> 24) & 0xff);
    m48t59_write(NVRAM, addr + 1, (value >> 16) & 0xff);
    m48t59_write(NVRAM, addr + 2, (value >> 8) & 0xff);
    m48t59_write(NVRAM, addr + 3, value & 0xff);
}

static uint32_t nvram_readb (void *opaque, target_phys_addr_t addr)
{
    m48t59_t *NVRAM = opaque;
    uint32_t retval;
    
    addr -= NVRAM->mem_base;
    retval = m48t59_read(NVRAM, addr);
    return retval;
}

static uint32_t nvram_readw (void *opaque, target_phys_addr_t addr)
{
    m48t59_t *NVRAM = opaque;
    uint32_t retval;
    
    addr -= NVRAM->mem_base;
    retval = m48t59_read(NVRAM, addr) << 8;
    retval |= m48t59_read(NVRAM, addr + 1);
    return retval;
}

static uint32_t nvram_readl (void *opaque, target_phys_addr_t addr)
{
    m48t59_t *NVRAM = opaque;
    uint32_t retval;

    addr -= NVRAM->mem_base;
    retval = m48t59_read(NVRAM, addr) << 24;
    retval |= m48t59_read(NVRAM, addr + 1) << 16;
    retval |= m48t59_read(NVRAM, addr + 2) << 8;
    retval |= m48t59_read(NVRAM, addr + 3);
    return retval;
}

static CPUWriteMemoryFunc *nvram_write[] = {
    &nvram_writeb,
    &nvram_writew,
    &nvram_writel,
};

static CPUReadMemoryFunc *nvram_read[] = {
    &nvram_readb,
    &nvram_readw,
    &nvram_readl,
};

static void m48t59_save(QEMUFile *f, void *opaque)
{
    m48t59_t *s = opaque;

    qemu_put_8s(f, &s->lock);
    qemu_put_be16s(f, &s->addr);
    qemu_put_buffer(f, s->buffer, s->size);
}

static int m48t59_load(QEMUFile *f, void *opaque, int version_id)
{
    m48t59_t *s = opaque;

    if (version_id != 1)
        return -EINVAL;

    qemu_get_8s(f, &s->lock);
    qemu_get_be16s(f, &s->addr);
    qemu_get_buffer(f, s->buffer, s->size);

    return 0;
}

static void m48t59_reset(void *opaque)
{
    m48t59_t *NVRAM = opaque;

    if (NVRAM->alrm_timer != NULL)
        qemu_del_timer(NVRAM->alrm_timer);

    if (NVRAM->wd_timer != NULL)
        qemu_del_timer(NVRAM->wd_timer);
}

/* Initialisation routine */
m48t59_t *m48t59_init (qemu_irq IRQ, target_phys_addr_t mem_base,
                       uint32_t io_base, uint16_t size,
                       int type)
{
    m48t59_t *s;
    target_phys_addr_t save_base;

    s = qemu_mallocz(sizeof(m48t59_t));
    if (!s)
	return NULL;
    s->buffer = qemu_mallocz(size);
    if (!s->buffer) {
        qemu_free(s);
        return NULL;
    }
    s->IRQ = IRQ;
    s->size = size;
    s->mem_base = mem_base;
    s->io_base = io_base;
    s->addr = 0;
    s->type = type;
    if (io_base != 0) {
        register_ioport_read(io_base, 0x04, 1, NVRAM_readb, s);
        register_ioport_write(io_base, 0x04, 1, NVRAM_writeb, s);
    }
    if (mem_base != 0) {
        s->mem_index = cpu_register_io_memory(0, nvram_read, nvram_write, s);
        cpu_register_physical_memory(mem_base, 0x4000, s->mem_index);
    }
    if (type == 59) {
        s->alrm_timer = qemu_new_timer(vm_clock, &alarm_cb, s);
        s->wd_timer = qemu_new_timer(vm_clock, &watchdog_cb, s);
    }
    s->lock = 0;

    qemu_register_reset(m48t59_reset, s);
    save_base = mem_base ? mem_base : io_base;
    register_savevm("m48t59", save_base, 1, m48t59_save, m48t59_load, s);

    return s;
}
Commit	Line	Data
a541f297	1	/*
819385c5	2	* QEMU M48T59 and M48T08 NVRAM emulation for PPC PREP and Sparc platforms
a541f297	3	*
3ccacc4a	4	* Copyright (c) 2003-2005, 2007 Jocelyn Mayer
a541f297 FB	5	*
	6	* Permission is hereby granted, free of charge, to any person obtaining a copy
	7	* of this software and associated documentation files (the "Software"), to deal
	8	* in the Software without restriction, including without limitation the rights
	9	* to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
	10	* copies of the Software, and to permit persons to whom the Software is
	11	* furnished to do so, subject to the following conditions:
	12	*
	13	* The above copyright notice and this permission notice shall be included in
	14	* all copies or substantial portions of the Software.
	15	*
	16	* THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
	17	* IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
	18	* FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL
	19	* THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
	20	* LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
	21	* OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
	22	* THE SOFTWARE.
	23	*/
a541f297	24	#include "vl.h"
c5df018e	25	#include "m48t59.h"
a541f297	26
13ab5daa	27	//#define DEBUG_NVRAM
a541f297	28
13ab5daa	29	#if defined(DEBUG_NVRAM)
a541f297 FB	30	#define NVRAM_PRINTF(fmt, args...) do { printf(fmt , ##args); } while (0)
	31	#else
	32	#define NVRAM_PRINTF(fmt, args...) do { } while (0)
	33	#endif
	34
819385c5 FB	35	/*
	36	* The M48T08 and M48T59 chips are very similar. The newer '59 has
	37	* alarm and a watchdog timer and related control registers. In the
	38	* PPC platform there is also a nvram lock function.
	39	*/
c5df018e	40	struct m48t59_t {
819385c5 FB	41	/* Model parameters */
819385c5 FB	42	int type; // 8 = m48t08, 59 = m48t59
a541f297	43	/* Hardware parameters */
d537cf6c	44	qemu_irq IRQ;
e1bb04f7	45	int mem_index;
5dcb6b91	46	target_phys_addr_t mem_base;
a541f297 FB	47	uint32_t io_base;
	48	uint16_t size;
	49	/* RTC management */
	50	time_t time_offset;
	51	time_t stop_time;
	52	/* Alarm & watchdog */
	53	time_t alarm;
	54	struct QEMUTimer *alrm_timer;
	55	struct QEMUTimer *wd_timer;
	56	/* NVRAM storage */
13ab5daa	57	uint8_t lock;
a541f297 FB	58	uint16_t addr;
a541f297 FB	59	uint8_t *buffer;
c5df018e	60	};
a541f297 FB	61
	62	/* Fake timer functions */
	63	/* Generic helpers for BCD */
	64	static inline uint8_t toBCD (uint8_t value)
	65	{
	66	return (((value / 10) % 10) << 4) \| (value % 10);
	67	}
	68
	69	static inline uint8_t fromBCD (uint8_t BCD)
	70	{
	71	return ((BCD >> 4) * 10) + (BCD & 0x0F);
	72	}
	73
	74	/* RTC management helpers */
	75	static void get_time (m48t59_t NVRAM, struct tm tm)
	76	{
	77	time_t t;
	78
	79	t = time(NULL) + NVRAM->time_offset;
d157e205 FB	80	#ifdef _WIN32
	81	memcpy(tm,localtime(&t),sizeof(*tm));
	82	#else
	83	localtime_r (&t, tm) ;
	84	#endif
a541f297 FB	85	}
	86
	87	static void set_time (m48t59_t NVRAM, struct tm tm)
	88	{
	89	time_t now, new_time;
	90
	91	new_time = mktime(tm);
	92	now = time(NULL);
	93	NVRAM->time_offset = new_time - now;
	94	}
	95
	96	/* Alarm management */
	97	static void alarm_cb (void *opaque)
	98	{
	99	struct tm tm, tm_now;
	100	uint64_t next_time;
	101	m48t59_t *NVRAM = opaque;
	102
d537cf6c	103	qemu_set_irq(NVRAM->IRQ, 1);
a541f297 FB	104	if ((NVRAM->buffer[0x1FF5] & 0x80) == 0 &&
	105	(NVRAM->buffer[0x1FF4] & 0x80) == 0 &&
	106	(NVRAM->buffer[0x1FF3] & 0x80) == 0 &&
	107	(NVRAM->buffer[0x1FF2] & 0x80) == 0) {
	108	/* Repeat once a month */
	109	get_time(NVRAM, &tm_now);
	110	memcpy(&tm, &tm_now, sizeof(struct tm));
	111	tm.tm_mon++;
	112	if (tm.tm_mon == 13) {
	113	tm.tm_mon = 1;
	114	tm.tm_year++;
	115	}
	116	next_time = mktime(&tm);
	117	} else if ((NVRAM->buffer[0x1FF5] & 0x80) != 0 &&
	118	(NVRAM->buffer[0x1FF4] & 0x80) == 0 &&
	119	(NVRAM->buffer[0x1FF3] & 0x80) == 0 &&
	120	(NVRAM->buffer[0x1FF2] & 0x80) == 0) {
	121	/* Repeat once a day */
	122	next_time = 24 * 60 * 60 + mktime(&tm_now);
	123	} else if ((NVRAM->buffer[0x1FF5] & 0x80) != 0 &&
	124	(NVRAM->buffer[0x1FF4] & 0x80) != 0 &&
	125	(NVRAM->buffer[0x1FF3] & 0x80) == 0 &&
	126	(NVRAM->buffer[0x1FF2] & 0x80) == 0) {
	127	/* Repeat once an hour */
	128	next_time = 60 * 60 + mktime(&tm_now);
	129	} else if ((NVRAM->buffer[0x1FF5] & 0x80) != 0 &&
	130	(NVRAM->buffer[0x1FF4] & 0x80) != 0 &&
	131	(NVRAM->buffer[0x1FF3] & 0x80) != 0 &&
	132	(NVRAM->buffer[0x1FF2] & 0x80) == 0) {
	133	/* Repeat once a minute */
	134	next_time = 60 + mktime(&tm_now);
	135	} else {
	136	/* Repeat once a second */
	137	next_time = 1 + mktime(&tm_now);
	138	}
	139	qemu_mod_timer(NVRAM->alrm_timer, next_time * 1000);
d537cf6c	140	qemu_set_irq(NVRAM->IRQ, 0);
a541f297 FB	141	}
	142
	143
	144	static void get_alarm (m48t59_t NVRAM, struct tm tm)
	145	{
d157e205 FB	146	#ifdef _WIN32
	147	memcpy(tm,localtime(&NVRAM->alarm),sizeof(*tm));
	148	#else
	149	localtime_r (&NVRAM->alarm, tm);
	150	#endif
a541f297 FB	151	}
	152
	153	static void set_alarm (m48t59_t NVRAM, struct tm tm)
	154	{
	155	NVRAM->alarm = mktime(tm);
	156	if (NVRAM->alrm_timer != NULL) {
	157	qemu_del_timer(NVRAM->alrm_timer);
	158	NVRAM->alrm_timer = NULL;
	159	}
	160	if (NVRAM->alarm - time(NULL) > 0)
	161	qemu_mod_timer(NVRAM->alrm_timer, NVRAM->alarm * 1000);
	162	}
	163
	164	/* Watchdog management */
	165	static void watchdog_cb (void *opaque)
	166	{
	167	m48t59_t *NVRAM = opaque;
	168
	169	NVRAM->buffer[0x1FF0] \|= 0x80;
	170	if (NVRAM->buffer[0x1FF7] & 0x80) {
	171	NVRAM->buffer[0x1FF7] = 0x00;
	172	NVRAM->buffer[0x1FFC] &= ~0x40;
13ab5daa	173	/* May it be a hw CPU Reset instead ? */
d7d02e3c	174	qemu_system_reset_request();
a541f297	175	} else {
d537cf6c PB	176	qemu_set_irq(NVRAM->IRQ, 1);
d537cf6c PB	177	qemu_set_irq(NVRAM->IRQ, 0);
a541f297 FB	178	}
	179	}
	180
	181	static void set_up_watchdog (m48t59_t *NVRAM, uint8_t value)
	182	{
	183	uint64_t interval; /* in 1/16 seconds */
	184
	185	if (NVRAM->wd_timer != NULL) {
	186	qemu_del_timer(NVRAM->wd_timer);
	187	NVRAM->wd_timer = NULL;
	188	}
	189	NVRAM->buffer[0x1FF0] &= ~0x80;
	190	if (value != 0) {
	191	interval = (1 << (2 * (value & 0x03))) * ((value >> 2) & 0x1F);
	192	qemu_mod_timer(NVRAM->wd_timer, ((uint64_t)time(NULL) * 1000) +
	193	((interval * 1000) >> 4));
	194	}
	195	}
	196
	197	/* Direct access to NVRAM */
819385c5	198	void m48t59_write (m48t59_t *NVRAM, uint32_t addr, uint32_t val)
a541f297	199	{
a541f297 FB	200	struct tm tm;
	201	int tmp;
	202
819385c5 FB	203	if (addr > 0x1FF8 && addr < 0x2000)
	204	NVRAM_PRINTF("%s: 0x%08x => 0x%08x\n", __func__, addr, val);
	205	if (NVRAM->type == 8 &&
	206	(addr >= 0x1ff0 && addr <= 0x1ff7))
	207	goto do_write;
	208	switch (addr) {
a541f297 FB	209	case 0x1FF0:
	210	/* flags register : read-only */
	211	break;
	212	case 0x1FF1:
	213	/* unused */
	214	break;
	215	case 0x1FF2:
	216	/* alarm seconds */
819385c5 FB	217	tmp = fromBCD(val & 0x7F);
	218	if (tmp >= 0 && tmp <= 59) {
	219	get_alarm(NVRAM, &tm);
	220	tm.tm_sec = tmp;
	221	NVRAM->buffer[0x1FF2] = val;
	222	set_alarm(NVRAM, &tm);
	223	}
a541f297 FB	224	break;
	225	case 0x1FF3:
	226	/* alarm minutes */
819385c5 FB	227	tmp = fromBCD(val & 0x7F);
	228	if (tmp >= 0 && tmp <= 59) {
	229	get_alarm(NVRAM, &tm);
	230	tm.tm_min = tmp;
	231	NVRAM->buffer[0x1FF3] = val;
	232	set_alarm(NVRAM, &tm);
	233	}
a541f297 FB	234	break;
	235	case 0x1FF4:
	236	/* alarm hours */
819385c5 FB	237	tmp = fromBCD(val & 0x3F);
	238	if (tmp >= 0 && tmp <= 23) {
	239	get_alarm(NVRAM, &tm);
	240	tm.tm_hour = tmp;
	241	NVRAM->buffer[0x1FF4] = val;
	242	set_alarm(NVRAM, &tm);
	243	}
a541f297 FB	244	break;
	245	case 0x1FF5:
	246	/* alarm date */
819385c5 FB	247	tmp = fromBCD(val & 0x1F);
	248	if (tmp != 0) {
	249	get_alarm(NVRAM, &tm);
	250	tm.tm_mday = tmp;
	251	NVRAM->buffer[0x1FF5] = val;
	252	set_alarm(NVRAM, &tm);
	253	}
a541f297 FB	254	break;
	255	case 0x1FF6:
	256	/* interrupts */
819385c5	257	NVRAM->buffer[0x1FF6] = val;
a541f297 FB	258	break;
	259	case 0x1FF7:
	260	/* watchdog */
819385c5 FB	261	NVRAM->buffer[0x1FF7] = val;
819385c5 FB	262	set_up_watchdog(NVRAM, val);
a541f297 FB	263	break;
	264	case 0x1FF8:
	265	/* control */
	266	NVRAM->buffer[0x1FF8] = (val & ~0xA0) \| 0x90;
	267	break;
	268	case 0x1FF9:
	269	/* seconds (BCD) */
	270	tmp = fromBCD(val & 0x7F);
	271	if (tmp >= 0 && tmp <= 59) {
	272	get_time(NVRAM, &tm);
	273	tm.tm_sec = tmp;
	274	set_time(NVRAM, &tm);
	275	}
	276	if ((val & 0x80) ^ (NVRAM->buffer[0x1FF9] & 0x80)) {
	277	if (val & 0x80) {
	278	NVRAM->stop_time = time(NULL);
	279	} else {
	280	NVRAM->time_offset += NVRAM->stop_time - time(NULL);
	281	NVRAM->stop_time = 0;
	282	}
	283	}
	284	NVRAM->buffer[0x1FF9] = val & 0x80;
	285	break;
	286	case 0x1FFA:
	287	/* minutes (BCD) */
	288	tmp = fromBCD(val & 0x7F);
	289	if (tmp >= 0 && tmp <= 59) {
	290	get_time(NVRAM, &tm);
	291	tm.tm_min = tmp;
	292	set_time(NVRAM, &tm);
	293	}
	294	break;
	295	case 0x1FFB:
	296	/* hours (BCD) */
	297	tmp = fromBCD(val & 0x3F);
	298	if (tmp >= 0 && tmp <= 23) {
	299	get_time(NVRAM, &tm);
	300	tm.tm_hour = tmp;
	301	set_time(NVRAM, &tm);
	302	}
	303	break;
	304	case 0x1FFC:
	305	/* day of the week / century */
	306	tmp = fromBCD(val & 0x07);
	307	get_time(NVRAM, &tm);
	308	tm.tm_wday = tmp;
	309	set_time(NVRAM, &tm);
	310	NVRAM->buffer[0x1FFC] = val & 0x40;
	311	break;
	312	case 0x1FFD:
	313	/* date */
	314	tmp = fromBCD(val & 0x1F);
	315	if (tmp != 0) {
	316	get_time(NVRAM, &tm);
	317	tm.tm_mday = tmp;
	318	set_time(NVRAM, &tm);
	319	}
	320	break;
	321	case 0x1FFE:
	322	/* month */
	323	tmp = fromBCD(val & 0x1F);
	324	if (tmp >= 1 && tmp <= 12) {
	325	get_time(NVRAM, &tm);
	326	tm.tm_mon = tmp - 1;
327	set_time(NVRAM, &tm);
328	}
329	break;
330	case 0x1FFF:
331	/* year */
332	tmp = fromBCD(val);
333	if (tmp >= 0 && tmp <= 99) {
334	get_time(NVRAM, &tm);
180b700d FB	335	if (NVRAM->type == 8)
	336	tm.tm_year = fromBCD(val) + 68; // Base year is 1968
	337	else
	338	tm.tm_year = fromBCD(val);
a541f297 FB	339	set_time(NVRAM, &tm);
	340	}
	341	break;
	342	default:
13ab5daa	343	/* Check lock registers state */
819385c5	344	if (addr >= 0x20 && addr <= 0x2F && (NVRAM->lock & 1))
13ab5daa	345	break;
819385c5	346	if (addr >= 0x30 && addr <= 0x3F && (NVRAM->lock & 2))
13ab5daa	347	break;
819385c5 FB	348	do_write:
	349	if (addr < NVRAM->size) {
	350	NVRAM->buffer[addr] = val & 0xFF;
a541f297 FB	351	}
	352	break;
	353	}
	354	}
	355
819385c5	356	uint32_t m48t59_read (m48t59_t *NVRAM, uint32_t addr)
a541f297	357	{
a541f297 FB	358	struct tm tm;
	359	uint32_t retval = 0xFF;
	360
819385c5 FB	361	if (NVRAM->type == 8 &&
	362	(addr >= 0x1ff0 && addr <= 0x1ff7))
	363	goto do_read;
	364	switch (addr) {
a541f297 FB	365	case 0x1FF0:
	366	/* flags register */
	367	goto do_read;
	368	case 0x1FF1:
	369	/* unused */
	370	retval = 0;
	371	break;
	372	case 0x1FF2:
	373	/* alarm seconds */
	374	goto do_read;
	375	case 0x1FF3:
	376	/* alarm minutes */
	377	goto do_read;
	378	case 0x1FF4:
	379	/* alarm hours */
	380	goto do_read;
	381	case 0x1FF5:
	382	/* alarm date */
	383	goto do_read;
	384	case 0x1FF6:
	385	/* interrupts */
	386	goto do_read;
	387	case 0x1FF7:
	388	/* A read resets the watchdog */
	389	set_up_watchdog(NVRAM, NVRAM->buffer[0x1FF7]);
	390	goto do_read;
	391	case 0x1FF8:
	392	/* control */
	393	goto do_read;
	394	case 0x1FF9:
	395	/* seconds (BCD) */
	396	get_time(NVRAM, &tm);
	397	retval = (NVRAM->buffer[0x1FF9] & 0x80) \| toBCD(tm.tm_sec);
	398	break;
	399	case 0x1FFA:
	400	/* minutes (BCD) */
	401	get_time(NVRAM, &tm);
	402	retval = toBCD(tm.tm_min);
	403	break;
	404	case 0x1FFB:
	405	/* hours (BCD) */
	406	get_time(NVRAM, &tm);
	407	retval = toBCD(tm.tm_hour);
	408	break;
	409	case 0x1FFC:
	410	/* day of the week / century */
	411	get_time(NVRAM, &tm);
	412	retval = NVRAM->buffer[0x1FFC] \| tm.tm_wday;
	413	break;
	414	case 0x1FFD:
	415	/* date */
	416	get_time(NVRAM, &tm);
	417	retval = toBCD(tm.tm_mday);
	418	break;
	419	case 0x1FFE:
	420	/* month */
	421	get_time(NVRAM, &tm);
	422	retval = toBCD(tm.tm_mon + 1);
	423	break;
	424	case 0x1FFF:
	425	/* year */
	426	get_time(NVRAM, &tm);
180b700d FB	427	if (NVRAM->type == 8)
	428	retval = toBCD(tm.tm_year - 68); // Base year is 1968
	429	else
	430	retval = toBCD(tm.tm_year);
a541f297 FB	431	break;
a541f297 FB	432	default:
13ab5daa	433	/* Check lock registers state */
819385c5	434	if (addr >= 0x20 && addr <= 0x2F && (NVRAM->lock & 1))
13ab5daa	435	break;
819385c5	436	if (addr >= 0x30 && addr <= 0x3F && (NVRAM->lock & 2))
13ab5daa	437	break;
819385c5 FB	438	do_read:
	439	if (addr < NVRAM->size) {
	440	retval = NVRAM->buffer[addr];
a541f297 FB	441	}
	442	break;
	443	}
819385c5 FB	444	if (addr > 0x1FF9 && addr < 0x2000)
819385c5 FB	445	NVRAM_PRINTF("0x%08x <= 0x%08x\n", addr, retval);
a541f297 FB	446
	447	return retval;
	448	}
	449
c5df018e	450	void m48t59_set_addr (m48t59_t *NVRAM, uint32_t addr)
a541f297	451	{
a541f297 FB	452	NVRAM->addr = addr;
	453	}
	454
13ab5daa FB	455	void m48t59_toggle_lock (m48t59_t *NVRAM, int lock)
	456	{
	457	NVRAM->lock ^= 1 << lock;
	458	}
	459
a541f297 FB	460	/* IO access to NVRAM */
	461	static void NVRAM_writeb (void *opaque, uint32_t addr, uint32_t val)
	462	{
	463	m48t59_t *NVRAM = opaque;
	464
	465	addr -= NVRAM->io_base;
13ab5daa	466	NVRAM_PRINTF("0x%08x => 0x%08x\n", addr, val);
a541f297 FB	467	switch (addr) {
	468	case 0:
	469	NVRAM->addr &= ~0x00FF;
	470	NVRAM->addr \|= val;
	471	break;
	472	case 1:
	473	NVRAM->addr &= ~0xFF00;
	474	NVRAM->addr \|= val << 8;
	475	break;
	476	case 3:
819385c5	477	m48t59_write(NVRAM, val, NVRAM->addr);
a541f297 FB	478	NVRAM->addr = 0x0000;
	479	break;
	480	default:
	481	break;
	482	}
	483	}
	484
	485	static uint32_t NVRAM_readb (void *opaque, uint32_t addr)
	486	{
	487	m48t59_t *NVRAM = opaque;
13ab5daa	488	uint32_t retval;
a541f297	489
13ab5daa FB	490	addr -= NVRAM->io_base;
	491	switch (addr) {
	492	case 3:
819385c5	493	retval = m48t59_read(NVRAM, NVRAM->addr);
13ab5daa FB	494	break;
	495	default:
	496	retval = -1;
	497	break;
	498	}
	499	NVRAM_PRINTF("0x%08x <= 0x%08x\n", addr, retval);
a541f297	500
13ab5daa	501	return retval;
a541f297 FB	502	}
a541f297 FB	503
e1bb04f7 FB	504	static void nvram_writeb (void *opaque, target_phys_addr_t addr, uint32_t value)
	505	{
	506	m48t59_t *NVRAM = opaque;
	507
	508	addr -= NVRAM->mem_base;
819385c5	509	m48t59_write(NVRAM, addr, value & 0xff);
e1bb04f7 FB	510	}
	511
	512	static void nvram_writew (void *opaque, target_phys_addr_t addr, uint32_t value)
	513	{
	514	m48t59_t *NVRAM = opaque;
	515
	516	addr -= NVRAM->mem_base;
819385c5 FB	517	m48t59_write(NVRAM, addr, (value >> 8) & 0xff);
819385c5 FB	518	m48t59_write(NVRAM, addr + 1, value & 0xff);
e1bb04f7 FB	519	}
	520
	521	static void nvram_writel (void *opaque, target_phys_addr_t addr, uint32_t value)
	522	{
	523	m48t59_t *NVRAM = opaque;
	524
	525	addr -= NVRAM->mem_base;
819385c5 FB	526	m48t59_write(NVRAM, addr, (value >> 24) & 0xff);
	527	m48t59_write(NVRAM, addr + 1, (value >> 16) & 0xff);
	528	m48t59_write(NVRAM, addr + 2, (value >> 8) & 0xff);
	529	m48t59_write(NVRAM, addr + 3, value & 0xff);
e1bb04f7 FB	530	}
	531
	532	static uint32_t nvram_readb (void *opaque, target_phys_addr_t addr)
	533	{
	534	m48t59_t *NVRAM = opaque;
819385c5	535	uint32_t retval;
e1bb04f7 FB	536
e1bb04f7 FB	537	addr -= NVRAM->mem_base;
819385c5	538	retval = m48t59_read(NVRAM, addr);
e1bb04f7 FB	539	return retval;
	540	}
	541
	542	static uint32_t nvram_readw (void *opaque, target_phys_addr_t addr)
	543	{
	544	m48t59_t *NVRAM = opaque;
819385c5	545	uint32_t retval;
e1bb04f7 FB	546
e1bb04f7 FB	547	addr -= NVRAM->mem_base;
819385c5 FB	548	retval = m48t59_read(NVRAM, addr) << 8;
819385c5 FB	549	retval \|= m48t59_read(NVRAM, addr + 1);
e1bb04f7 FB	550	return retval;
	551	}
	552
	553	static uint32_t nvram_readl (void *opaque, target_phys_addr_t addr)
	554	{
	555	m48t59_t *NVRAM = opaque;
819385c5	556	uint32_t retval;
e1bb04f7	557
819385c5 FB	558	addr -= NVRAM->mem_base;
	559	retval = m48t59_read(NVRAM, addr) << 24;
	560	retval \|= m48t59_read(NVRAM, addr + 1) << 16;
	561	retval \|= m48t59_read(NVRAM, addr + 2) << 8;
	562	retval \|= m48t59_read(NVRAM, addr + 3);
e1bb04f7 FB	563	return retval;
	564	}
	565
	566	static CPUWriteMemoryFunc *nvram_write[] = {
	567	&nvram_writeb,
	568	&nvram_writew,
	569	&nvram_writel,
	570	};
	571
	572	static CPUReadMemoryFunc *nvram_read[] = {
	573	&nvram_readb,
	574	&nvram_readw,
	575	&nvram_readl,
	576	};
819385c5	577
3ccacc4a BS	578	static void m48t59_save(QEMUFile f, void opaque)
	579	{
	580	m48t59_t *s = opaque;
	581
	582	qemu_put_8s(f, &s->lock);
	583	qemu_put_be16s(f, &s->addr);
	584	qemu_put_buffer(f, s->buffer, s->size);
	585	}
	586
	587	static int m48t59_load(QEMUFile f, void opaque, int version_id)
	588	{
	589	m48t59_t *s = opaque;
	590
	591	if (version_id != 1)
	592	return -EINVAL;
	593
	594	qemu_get_8s(f, &s->lock);
	595	qemu_get_be16s(f, &s->addr);
	596	qemu_get_buffer(f, s->buffer, s->size);
	597
	598	return 0;
	599	}
	600
	601	static void m48t59_reset(void *opaque)
	602	{
	603	m48t59_t *NVRAM = opaque;
	604
	605	if (NVRAM->alrm_timer != NULL)
	606	qemu_del_timer(NVRAM->alrm_timer);
	607
	608	if (NVRAM->wd_timer != NULL)
	609	qemu_del_timer(NVRAM->wd_timer);
	610	}
	611
a541f297	612	/* Initialisation routine */
5dcb6b91	613	m48t59_t *m48t59_init (qemu_irq IRQ, target_phys_addr_t mem_base,
819385c5 FB	614	uint32_t io_base, uint16_t size,
819385c5 FB	615	int type)
a541f297	616	{
c5df018e	617	m48t59_t *s;
5dcb6b91	618	target_phys_addr_t save_base;
a541f297	619
c5df018e FB	620	s = qemu_mallocz(sizeof(m48t59_t));
c5df018e FB	621	if (!s)
a541f297	622	return NULL;
c5df018e FB	623	s->buffer = qemu_mallocz(size);
	624	if (!s->buffer) {
	625	qemu_free(s);
	626	return NULL;
	627	}
	628	s->IRQ = IRQ;
	629	s->size = size;
e1bb04f7	630	s->mem_base = mem_base;
c5df018e FB	631	s->io_base = io_base;
c5df018e FB	632	s->addr = 0;
819385c5 FB	633	s->type = type;
	634	if (io_base != 0) {
	635	register_ioport_read(io_base, 0x04, 1, NVRAM_readb, s);
	636	register_ioport_write(io_base, 0x04, 1, NVRAM_writeb, s);
	637	}
e1bb04f7 FB	638	if (mem_base != 0) {
	639	s->mem_index = cpu_register_io_memory(0, nvram_read, nvram_write, s);
	640	cpu_register_physical_memory(mem_base, 0x4000, s->mem_index);
	641	}
819385c5 FB	642	if (type == 59) {
	643	s->alrm_timer = qemu_new_timer(vm_clock, &alarm_cb, s);
	644	s->wd_timer = qemu_new_timer(vm_clock, &watchdog_cb, s);
	645	}
13ab5daa FB	646	s->lock = 0;
13ab5daa FB	647
3ccacc4a BS	648	qemu_register_reset(m48t59_reset, s);
	649	save_base = mem_base ? mem_base : io_base;
	650	register_savevm("m48t59", save_base, 1, m48t59_save, m48t59_load, s);
	651
c5df018e	652	return s;
a541f297	653	}