[qemu.git] / hw / audio / marvell_88w8618.c

/*
 * Marvell 88w8618 audio emulation extracted from
 * Marvell MV88w8618 / Freecom MusicPal emulation.
 *
 * Copyright (c) 2008 Jan Kiszka
 *
 * This code is licensed under the GNU GPL v2.
 *
 * Contributions after 2012-01-13 are licensed under the terms of the
 * GNU GPL, version 2 or (at your option) any later version.
 */
#include "qemu/osdep.h"
#include "hw/sysbus.h"
#include "hw/hw.h"
#include "hw/i2c/i2c.h"
#include "audio/audio.h"

#define MP_AUDIO_SIZE           0x00001000

/* Audio register offsets */
#define MP_AUDIO_PLAYBACK_MODE  0x00
#define MP_AUDIO_CLOCK_DIV      0x18
#define MP_AUDIO_IRQ_STATUS     0x20
#define MP_AUDIO_IRQ_ENABLE     0x24
#define MP_AUDIO_TX_START_LO    0x28
#define MP_AUDIO_TX_THRESHOLD   0x2C
#define MP_AUDIO_TX_STATUS      0x38
#define MP_AUDIO_TX_START_HI    0x40

/* Status register and IRQ enable bits */
#define MP_AUDIO_TX_HALF        (1 << 6)
#define MP_AUDIO_TX_FULL        (1 << 7)

/* Playback mode bits */
#define MP_AUDIO_16BIT_SAMPLE   (1 << 0)
#define MP_AUDIO_PLAYBACK_EN    (1 << 7)
#define MP_AUDIO_CLOCK_24MHZ    (1 << 9)
#define MP_AUDIO_MONO           (1 << 14)

#define TYPE_MV88W8618_AUDIO "mv88w8618_audio"
#define MV88W8618_AUDIO(obj) \
    OBJECT_CHECK(mv88w8618_audio_state, (obj), TYPE_MV88W8618_AUDIO)

typedef struct mv88w8618_audio_state {
    SysBusDevice parent_obj;

    MemoryRegion iomem;
    qemu_irq irq;
    uint32_t playback_mode;
    uint32_t status;
    uint32_t irq_enable;
    uint32_t phys_buf;
    uint32_t target_buffer;
    uint32_t threshold;
    uint32_t play_pos;
    uint32_t last_free;
    uint32_t clock_div;
    void *wm;
} mv88w8618_audio_state;

static void mv88w8618_audio_callback(void *opaque, int free_out, int free_in)
{
    mv88w8618_audio_state *s = opaque;
    int16_t *codec_buffer;
    int8_t buf[4096];
    int8_t *mem_buffer;
    int pos, block_size;

    if (!(s->playback_mode & MP_AUDIO_PLAYBACK_EN)) {
        return;
    }
    if (s->playback_mode & MP_AUDIO_16BIT_SAMPLE) {
        free_out <<= 1;
    }
    if (!(s->playback_mode & MP_AUDIO_MONO)) {
        free_out <<= 1;
    }
    block_size = s->threshold / 2;
    if (free_out - s->last_free < block_size) {
        return;
    }
    if (block_size > 4096) {
        return;
    }
    cpu_physical_memory_read(s->target_buffer + s->play_pos, buf, block_size);
    mem_buffer = buf;
    if (s->playback_mode & MP_AUDIO_16BIT_SAMPLE) {
        if (s->playback_mode & MP_AUDIO_MONO) {
            codec_buffer = wm8750_dac_buffer(s->wm, block_size >> 1);
            for (pos = 0; pos < block_size; pos += 2) {
                *codec_buffer++ = *(int16_t *)mem_buffer;
                *codec_buffer++ = *(int16_t *)mem_buffer;
                mem_buffer += 2;
            }
        } else {
            memcpy(wm8750_dac_buffer(s->wm, block_size >> 2),
                   (uint32_t *)mem_buffer, block_size);
        }
    } else {
        if (s->playback_mode & MP_AUDIO_MONO) {
            codec_buffer = wm8750_dac_buffer(s->wm, block_size);
            for (pos = 0; pos < block_size; pos++) {
                *codec_buffer++ = cpu_to_le16(256 * *mem_buffer);
                *codec_buffer++ = cpu_to_le16(256 * *mem_buffer++);
            }
        } else {
            codec_buffer = wm8750_dac_buffer(s->wm, block_size >> 1);
            for (pos = 0; pos < block_size; pos += 2) {
                *codec_buffer++ = cpu_to_le16(256 * *mem_buffer++);
                *codec_buffer++ = cpu_to_le16(256 * *mem_buffer++);
            }
        }
    }
    wm8750_dac_commit(s->wm);

    s->last_free = free_out - block_size;

    if (s->play_pos == 0) {
        s->status |= MP_AUDIO_TX_HALF;
        s->play_pos = block_size;
    } else {
        s->status |= MP_AUDIO_TX_FULL;
        s->play_pos = 0;
    }

    if (s->status & s->irq_enable) {
        qemu_irq_raise(s->irq);
    }
}

static void mv88w8618_audio_clock_update(mv88w8618_audio_state *s)
{
    int rate;

    if (s->playback_mode & MP_AUDIO_CLOCK_24MHZ) {
        rate = 24576000 / 64; /* 24.576MHz */
    } else {
        rate = 11289600 / 64; /* 11.2896MHz */
    }
    rate /= ((s->clock_div >> 8) & 0xff) + 1;

    wm8750_set_bclk_in(s->wm, rate);
}

static uint64_t mv88w8618_audio_read(void *opaque, hwaddr offset,
                                    unsigned size)
{
    mv88w8618_audio_state *s = opaque;

    switch (offset) {
    case MP_AUDIO_PLAYBACK_MODE:
        return s->playback_mode;

    case MP_AUDIO_CLOCK_DIV:
        return s->clock_div;

    case MP_AUDIO_IRQ_STATUS:
        return s->status;

    case MP_AUDIO_IRQ_ENABLE:
        return s->irq_enable;

    case MP_AUDIO_TX_STATUS:
        return s->play_pos >> 2;

    default:
        return 0;
    }
}

static void mv88w8618_audio_write(void *opaque, hwaddr offset,
                                  uint64_t value, unsigned size)
{
    mv88w8618_audio_state *s = opaque;

    switch (offset) {
    case MP_AUDIO_PLAYBACK_MODE:
        if (value & MP_AUDIO_PLAYBACK_EN &&
            !(s->playback_mode & MP_AUDIO_PLAYBACK_EN)) {
            s->status = 0;
            s->last_free = 0;
            s->play_pos = 0;
        }
        s->playback_mode = value;
        mv88w8618_audio_clock_update(s);
        break;

    case MP_AUDIO_CLOCK_DIV:
        s->clock_div = value;
        s->last_free = 0;
        s->play_pos = 0;
        mv88w8618_audio_clock_update(s);
        break;

    case MP_AUDIO_IRQ_STATUS:
        s->status &= ~value;
        break;

    case MP_AUDIO_IRQ_ENABLE:
        s->irq_enable = value;
        if (s->status & s->irq_enable) {
            qemu_irq_raise(s->irq);
        }
        break;

    case MP_AUDIO_TX_START_LO:
        s->phys_buf = (s->phys_buf & 0xFFFF0000) | (value & 0xFFFF);
        s->target_buffer = s->phys_buf;
        s->play_pos = 0;
        s->last_free = 0;
        break;

    case MP_AUDIO_TX_THRESHOLD:
        s->threshold = (value + 1) * 4;
        break;

    case MP_AUDIO_TX_START_HI:
        s->phys_buf = (s->phys_buf & 0xFFFF) | (value << 16);
        s->target_buffer = s->phys_buf;
        s->play_pos = 0;
        s->last_free = 0;
        break;
    }
}

static void mv88w8618_audio_reset(DeviceState *d)
{
    mv88w8618_audio_state *s = MV88W8618_AUDIO(d);

    s->playback_mode = 0;
    s->status = 0;
    s->irq_enable = 0;
    s->clock_div = 0;
    s->threshold = 0;
    s->phys_buf = 0;
}

static const MemoryRegionOps mv88w8618_audio_ops = {
    .read = mv88w8618_audio_read,
    .write = mv88w8618_audio_write,
    .endianness = DEVICE_NATIVE_ENDIAN,
};

static int mv88w8618_audio_init(SysBusDevice *dev)
{
    mv88w8618_audio_state *s = MV88W8618_AUDIO(dev);

    sysbus_init_irq(dev, &s->irq);

    wm8750_data_req_set(s->wm, mv88w8618_audio_callback, s);

    memory_region_init_io(&s->iomem, OBJECT(s), &mv88w8618_audio_ops, s,
                          "audio", MP_AUDIO_SIZE);
    sysbus_init_mmio(dev, &s->iomem);

    return 0;
}

static const VMStateDescription mv88w8618_audio_vmsd = {
    .name = "mv88w8618_audio",
    .version_id = 1,
    .minimum_version_id = 1,
    .fields = (VMStateField[]) {
        VMSTATE_UINT32(playback_mode, mv88w8618_audio_state),
        VMSTATE_UINT32(status, mv88w8618_audio_state),
        VMSTATE_UINT32(irq_enable, mv88w8618_audio_state),
        VMSTATE_UINT32(phys_buf, mv88w8618_audio_state),
        VMSTATE_UINT32(target_buffer, mv88w8618_audio_state),
        VMSTATE_UINT32(threshold, mv88w8618_audio_state),
        VMSTATE_UINT32(play_pos, mv88w8618_audio_state),
        VMSTATE_UINT32(last_free, mv88w8618_audio_state),
        VMSTATE_UINT32(clock_div, mv88w8618_audio_state),
        VMSTATE_END_OF_LIST()
    }
};

static Property mv88w8618_audio_properties[] = {
    DEFINE_PROP_PTR("wm8750", mv88w8618_audio_state, wm),
    {/* end of list */},
};

static void mv88w8618_audio_class_init(ObjectClass *klass, void *data)
{
    DeviceClass *dc = DEVICE_CLASS(klass);
    SysBusDeviceClass *k = SYS_BUS_DEVICE_CLASS(klass);

    k->init = mv88w8618_audio_init;
    dc->reset = mv88w8618_audio_reset;
    dc->vmsd = &mv88w8618_audio_vmsd;
    dc->props = mv88w8618_audio_properties;
    /* Reason: pointer property "wm8750" */
    dc->cannot_instantiate_with_device_add_yet = true;
}

static const TypeInfo mv88w8618_audio_info = {
    .name          = TYPE_MV88W8618_AUDIO,
    .parent        = TYPE_SYS_BUS_DEVICE,
    .instance_size = sizeof(mv88w8618_audio_state),
    .class_init    = mv88w8618_audio_class_init,
};

static void mv88w8618_register_types(void)
{
    type_register_static(&mv88w8618_audio_info);
}

type_init(mv88w8618_register_types)
Commit	Line	Data
ef07b491 AZ	1	/*
	2	* Marvell 88w8618 audio emulation extracted from
	3	* Marvell MV88w8618 / Freecom MusicPal emulation.
	4	*
	5	* Copyright (c) 2008 Jan Kiszka
	6	*
8e31bf38	7	* This code is licensed under the GNU GPL v2.
6b620ca3 PB	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.
ef07b491	11	*/
6086a565	12	#include "qemu/osdep.h"
83c9f4ca PB	13	#include "hw/sysbus.h"
83c9f4ca PB	14	#include "hw/hw.h"
0d09e41a	15	#include "hw/i2c/i2c.h"
ef07b491 AZ	16	#include "audio/audio.h"
	17
	18	#define MP_AUDIO_SIZE 0x00001000
	19
	20	/* Audio register offsets */
	21	#define MP_AUDIO_PLAYBACK_MODE 0x00
	22	#define MP_AUDIO_CLOCK_DIV 0x18
	23	#define MP_AUDIO_IRQ_STATUS 0x20
	24	#define MP_AUDIO_IRQ_ENABLE 0x24
	25	#define MP_AUDIO_TX_START_LO 0x28
	26	#define MP_AUDIO_TX_THRESHOLD 0x2C
	27	#define MP_AUDIO_TX_STATUS 0x38
	28	#define MP_AUDIO_TX_START_HI 0x40
	29
	30	/* Status register and IRQ enable bits */
	31	#define MP_AUDIO_TX_HALF (1 << 6)
	32	#define MP_AUDIO_TX_FULL (1 << 7)
	33
	34	/* Playback mode bits */
	35	#define MP_AUDIO_16BIT_SAMPLE (1 << 0)
	36	#define MP_AUDIO_PLAYBACK_EN (1 << 7)
	37	#define MP_AUDIO_CLOCK_24MHZ (1 << 9)
	38	#define MP_AUDIO_MONO (1 << 14)
	39
9e3f8599 AF	40	#define TYPE_MV88W8618_AUDIO "mv88w8618_audio"
	41	#define MV88W8618_AUDIO(obj) \
	42	OBJECT_CHECK(mv88w8618_audio_state, (obj), TYPE_MV88W8618_AUDIO)
	43
ef07b491	44	typedef struct mv88w8618_audio_state {
9e3f8599 AF	45	SysBusDevice parent_obj;
9e3f8599 AF	46
e2ba99e9	47	MemoryRegion iomem;
ef07b491 AZ	48	qemu_irq irq;
	49	uint32_t playback_mode;
	50	uint32_t status;
	51	uint32_t irq_enable;
d5b61ddd	52	uint32_t phys_buf;
ef07b491	53	uint32_t target_buffer;
d5b61ddd JK	54	uint32_t threshold;
	55	uint32_t play_pos;
	56	uint32_t last_free;
ef07b491	57	uint32_t clock_div;
e855761c	58	void *wm;
ef07b491 AZ	59	} mv88w8618_audio_state;
	60
	61	static void mv88w8618_audio_callback(void *opaque, int free_out, int free_in)
	62	{
	63	mv88w8618_audio_state *s = opaque;
	64	int16_t *codec_buffer;
	65	int8_t buf[4096];
	66	int8_t *mem_buffer;
	67	int pos, block_size;
	68
49fedd0d	69	if (!(s->playback_mode & MP_AUDIO_PLAYBACK_EN)) {
ef07b491	70	return;
49fedd0d JK	71	}
49fedd0d JK	72	if (s->playback_mode & MP_AUDIO_16BIT_SAMPLE) {
ef07b491	73	free_out <<= 1;
49fedd0d JK	74	}
49fedd0d JK	75	if (!(s->playback_mode & MP_AUDIO_MONO)) {
ef07b491	76	free_out <<= 1;
49fedd0d	77	}
ef07b491	78	block_size = s->threshold / 2;
49fedd0d	79	if (free_out - s->last_free < block_size) {
ef07b491	80	return;
49fedd0d JK	81	}
49fedd0d JK	82	if (block_size > 4096) {
ef07b491	83	return;
49fedd0d	84	}
e1fe50dc	85	cpu_physical_memory_read(s->target_buffer + s->play_pos, buf, block_size);
ef07b491 AZ	86	mem_buffer = buf;
	87	if (s->playback_mode & MP_AUDIO_16BIT_SAMPLE) {
	88	if (s->playback_mode & MP_AUDIO_MONO) {
	89	codec_buffer = wm8750_dac_buffer(s->wm, block_size >> 1);
	90	for (pos = 0; pos < block_size; pos += 2) {
	91	codec_buffer++ = (int16_t *)mem_buffer;
	92	codec_buffer++ = (int16_t *)mem_buffer;
	93	mem_buffer += 2;
	94	}
49fedd0d	95	} else {
ef07b491 AZ	96	memcpy(wm8750_dac_buffer(s->wm, block_size >> 2),
ef07b491 AZ	97	(uint32_t *)mem_buffer, block_size);
49fedd0d	98	}
ef07b491 AZ	99	} else {
	100	if (s->playback_mode & MP_AUDIO_MONO) {
	101	codec_buffer = wm8750_dac_buffer(s->wm, block_size);
	102	for (pos = 0; pos < block_size; pos++) {
	103	codec_buffer++ = cpu_to_le16(256 *mem_buffer);
	104	codec_buffer++ = cpu_to_le16(256 *mem_buffer++);
	105	}
	106	} else {
	107	codec_buffer = wm8750_dac_buffer(s->wm, block_size >> 1);
	108	for (pos = 0; pos < block_size; pos += 2) {
	109	codec_buffer++ = cpu_to_le16(256 *mem_buffer++);
	110	codec_buffer++ = cpu_to_le16(256 *mem_buffer++);
	111	}
	112	}
	113	}
	114	wm8750_dac_commit(s->wm);
	115
	116	s->last_free = free_out - block_size;
	117
	118	if (s->play_pos == 0) {
	119	s->status \|= MP_AUDIO_TX_HALF;
	120	s->play_pos = block_size;
	121	} else {
	122	s->status \|= MP_AUDIO_TX_FULL;
	123	s->play_pos = 0;
	124	}
	125
49fedd0d	126	if (s->status & s->irq_enable) {
ef07b491	127	qemu_irq_raise(s->irq);
49fedd0d	128	}
ef07b491 AZ	129	}
	130
	131	static void mv88w8618_audio_clock_update(mv88w8618_audio_state *s)
	132	{
	133	int rate;
	134
49fedd0d	135	if (s->playback_mode & MP_AUDIO_CLOCK_24MHZ) {
ef07b491	136	rate = 24576000 / 64; /* 24.576MHz */
49fedd0d	137	} else {
ef07b491	138	rate = 11289600 / 64; /* 11.2896MHz */
49fedd0d	139	}
ef07b491 AZ	140	rate /= ((s->clock_div >> 8) & 0xff) + 1;
	141
	142	wm8750_set_bclk_in(s->wm, rate);
	143	}
	144
a8170e5e	145	static uint64_t mv88w8618_audio_read(void *opaque, hwaddr offset,
e2ba99e9	146	unsigned size)
ef07b491 AZ	147	{
	148	mv88w8618_audio_state *s = opaque;
	149
	150	switch (offset) {
	151	case MP_AUDIO_PLAYBACK_MODE:
	152	return s->playback_mode;
	153
	154	case MP_AUDIO_CLOCK_DIV:
	155	return s->clock_div;
	156
	157	case MP_AUDIO_IRQ_STATUS:
	158	return s->status;
	159
	160	case MP_AUDIO_IRQ_ENABLE:
	161	return s->irq_enable;
	162
	163	case MP_AUDIO_TX_STATUS:
	164	return s->play_pos >> 2;
	165
	166	default:
	167	return 0;
	168	}
	169	}
	170
a8170e5e	171	static void mv88w8618_audio_write(void *opaque, hwaddr offset,
e2ba99e9	172	uint64_t value, unsigned size)
ef07b491 AZ	173	{
	174	mv88w8618_audio_state *s = opaque;
	175
	176	switch (offset) {
	177	case MP_AUDIO_PLAYBACK_MODE:
	178	if (value & MP_AUDIO_PLAYBACK_EN &&
	179	!(s->playback_mode & MP_AUDIO_PLAYBACK_EN)) {
	180	s->status = 0;
	181	s->last_free = 0;
	182	s->play_pos = 0;
	183	}
	184	s->playback_mode = value;
	185	mv88w8618_audio_clock_update(s);
	186	break;
	187
	188	case MP_AUDIO_CLOCK_DIV:
	189	s->clock_div = value;
	190	s->last_free = 0;
	191	s->play_pos = 0;
	192	mv88w8618_audio_clock_update(s);
	193	break;
	194
	195	case MP_AUDIO_IRQ_STATUS:
	196	s->status &= ~value;
	197	break;
	198
	199	case MP_AUDIO_IRQ_ENABLE:
	200	s->irq_enable = value;
49fedd0d	201	if (s->status & s->irq_enable) {
ef07b491	202	qemu_irq_raise(s->irq);
49fedd0d	203	}
ef07b491 AZ	204	break;
	205
	206	case MP_AUDIO_TX_START_LO:
	207	s->phys_buf = (s->phys_buf & 0xFFFF0000) \| (value & 0xFFFF);
	208	s->target_buffer = s->phys_buf;
	209	s->play_pos = 0;
	210	s->last_free = 0;
	211	break;
	212
	213	case MP_AUDIO_TX_THRESHOLD:
	214	s->threshold = (value + 1) * 4;
	215	break;
	216
	217	case MP_AUDIO_TX_START_HI:
	218	s->phys_buf = (s->phys_buf & 0xFFFF) \| (value << 16);
	219	s->target_buffer = s->phys_buf;
	220	s->play_pos = 0;
	221	s->last_free = 0;
	222	break;
	223	}
	224	}
	225
d5b61ddd	226	static void mv88w8618_audio_reset(DeviceState *d)
ef07b491	227	{
9e3f8599	228	mv88w8618_audio_state *s = MV88W8618_AUDIO(d);
ef07b491 AZ	229
	230	s->playback_mode = 0;
	231	s->status = 0;
	232	s->irq_enable = 0;
267c4840 JK	233	s->clock_div = 0;
	234	s->threshold = 0;
	235	s->phys_buf = 0;
ef07b491 AZ	236	}
ef07b491 AZ	237
e2ba99e9 BC	238	static const MemoryRegionOps mv88w8618_audio_ops = {
	239	.read = mv88w8618_audio_read,
	240	.write = mv88w8618_audio_write,
	241	.endianness = DEVICE_NATIVE_ENDIAN,
ef07b491 AZ	242	};
ef07b491 AZ	243
81a322d4	244	static int mv88w8618_audio_init(SysBusDevice *dev)
ef07b491	245	{
9e3f8599	246	mv88w8618_audio_state *s = MV88W8618_AUDIO(dev);
ef07b491 AZ	247
	248	sysbus_init_irq(dev, &s->irq);
	249
	250	wm8750_data_req_set(s->wm, mv88w8618_audio_callback, s);
	251
64bde0f3	252	memory_region_init_io(&s->iomem, OBJECT(s), &mv88w8618_audio_ops, s,
e2ba99e9	253	"audio", MP_AUDIO_SIZE);
750ecd44	254	sysbus_init_mmio(dev, &s->iomem);
ef07b491	255
81a322d4	256	return 0;
ef07b491 AZ	257	}
ef07b491 AZ	258
d5b61ddd JK	259	static const VMStateDescription mv88w8618_audio_vmsd = {
	260	.name = "mv88w8618_audio",
	261	.version_id = 1,
	262	.minimum_version_id = 1,
d5b61ddd JK	263	.fields = (VMStateField[]) {
	264	VMSTATE_UINT32(playback_mode, mv88w8618_audio_state),
	265	VMSTATE_UINT32(status, mv88w8618_audio_state),
	266	VMSTATE_UINT32(irq_enable, mv88w8618_audio_state),
	267	VMSTATE_UINT32(phys_buf, mv88w8618_audio_state),
	268	VMSTATE_UINT32(target_buffer, mv88w8618_audio_state),
	269	VMSTATE_UINT32(threshold, mv88w8618_audio_state),
	270	VMSTATE_UINT32(play_pos, mv88w8618_audio_state),
	271	VMSTATE_UINT32(last_free, mv88w8618_audio_state),
	272	VMSTATE_UINT32(clock_div, mv88w8618_audio_state),
	273	VMSTATE_END_OF_LIST()
	274	}
	275	};
	276
999e12bb AL	277	static Property mv88w8618_audio_properties[] = {
	278	DEFINE_PROP_PTR("wm8750", mv88w8618_audio_state, wm),
	279	{/* end of list */},
	280	};
	281
	282	static void mv88w8618_audio_class_init(ObjectClass klass, void data)
	283	{
39bffca2	284	DeviceClass *dc = DEVICE_CLASS(klass);
999e12bb AL	285	SysBusDeviceClass *k = SYS_BUS_DEVICE_CLASS(klass);
	286
	287	k->init = mv88w8618_audio_init;
39bffca2 AL	288	dc->reset = mv88w8618_audio_reset;
	289	dc->vmsd = &mv88w8618_audio_vmsd;
	290	dc->props = mv88w8618_audio_properties;
1b111dc1 MA	291	/* Reason: pointer property "wm8750" */
1b111dc1 MA	292	dc->cannot_instantiate_with_device_add_yet = true;
999e12bb AL	293	}
999e12bb AL	294
8c43a6f0	295	static const TypeInfo mv88w8618_audio_info = {
9e3f8599	296	.name = TYPE_MV88W8618_AUDIO,
39bffca2 AL	297	.parent = TYPE_SYS_BUS_DEVICE,
	298	.instance_size = sizeof(mv88w8618_audio_state),
	299	.class_init = mv88w8618_audio_class_init,
ef07b491	300	};
ef07b491	301
83f7d43a	302	static void mv88w8618_register_types(void)
ef07b491	303	{
39bffca2	304	type_register_static(&mv88w8618_audio_info);
ef07b491 AZ	305	}
ef07b491 AZ	306
83f7d43a	307	type_init(mv88w8618_register_types)