| /* |
| * National Semiconductor LM8322/8323 GPIO keyboard & PWM chips. |
| * |
| * Copyright (C) 2008 Nokia Corporation |
| * Written by Andrzej Zaborowski <andrew@openedhand.com> |
| * |
| * This program is free software; you can redistribute it and/or |
| * modify it under the terms of the GNU General Public License as |
| * published by the Free Software Foundation; either version 2 or |
| * (at your option) version 3 of the License. |
| * |
| * This program is distributed in the hope that it will be useful, |
| * but WITHOUT ANY WARRANTY; without even the implied warranty of |
| * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the |
| * GNU General Public License for more details. |
| * |
| * You should have received a copy of the GNU General Public License along |
| * with this program; if not, see <http://www.gnu.org/licenses/>. |
| */ |
| |
| #include "qemu/osdep.h" |
| #include "hw/i2c/i2c.h" |
| #include "hw/irq.h" |
| #include "migration/vmstate.h" |
| #include "qemu/module.h" |
| #include "qemu/timer.h" |
| #include "ui/console.h" |
| #include "qom/object.h" |
| |
| #define TYPE_LM8323 "lm8323" |
| typedef struct LM823KbdState LM823KbdState; |
| DECLARE_INSTANCE_CHECKER(LM823KbdState, LM8323, |
| TYPE_LM8323) |
| |
| struct LM823KbdState { |
| I2CSlave parent_obj; |
| |
| uint8_t i2c_dir; |
| uint8_t i2c_cycle; |
| uint8_t reg; |
| |
| qemu_irq nirq; |
| uint16_t model; |
| |
| struct { |
| qemu_irq out[2]; |
| int in[2][2]; |
| } mux; |
| |
| uint8_t config; |
| uint8_t status; |
| uint8_t acttime; |
| uint8_t error; |
| uint8_t clock; |
| |
| struct { |
| uint16_t pull; |
| uint16_t mask; |
| uint16_t dir; |
| uint16_t level; |
| qemu_irq out[16]; |
| } gpio; |
| |
| struct { |
| uint8_t dbnctime; |
| uint8_t size; |
| uint8_t start; |
| uint8_t len; |
| uint8_t fifo[16]; |
| } kbd; |
| |
| struct { |
| uint16_t file[256]; |
| uint8_t faddr; |
| uint8_t addr[3]; |
| QEMUTimer *tm[3]; |
| } pwm; |
| }; |
| |
| #define INT_KEYPAD (1 << 0) |
| #define INT_ERROR (1 << 3) |
| #define INT_NOINIT (1 << 4) |
| #define INT_PWMEND(n) (1 << (5 + n)) |
| |
| #define ERR_BADPAR (1 << 0) |
| #define ERR_CMDUNK (1 << 1) |
| #define ERR_KEYOVR (1 << 2) |
| #define ERR_FIFOOVR (1 << 6) |
| |
| static void lm_kbd_irq_update(LM823KbdState *s) |
| { |
| qemu_set_irq(s->nirq, !s->status); |
| } |
| |
| static void lm_kbd_gpio_update(LM823KbdState *s) |
| { |
| } |
| |
| static void lm_kbd_reset(DeviceState *dev) |
| { |
| LM823KbdState *s = LM8323(dev); |
| |
| s->config = 0x80; |
| s->status = INT_NOINIT; |
| s->acttime = 125; |
| s->kbd.dbnctime = 3; |
| s->kbd.size = 0x33; |
| s->clock = 0x08; |
| |
| lm_kbd_irq_update(s); |
| lm_kbd_gpio_update(s); |
| } |
| |
| static void lm_kbd_error(LM823KbdState *s, int err) |
| { |
| s->error |= err; |
| s->status |= INT_ERROR; |
| lm_kbd_irq_update(s); |
| } |
| |
| static void lm_kbd_pwm_tick(LM823KbdState *s, int line) |
| { |
| } |
| |
| static void lm_kbd_pwm_start(LM823KbdState *s, int line) |
| { |
| lm_kbd_pwm_tick(s, line); |
| } |
| |
| static void lm_kbd_pwm0_tick(void *opaque) |
| { |
| lm_kbd_pwm_tick(opaque, 0); |
| } |
| static void lm_kbd_pwm1_tick(void *opaque) |
| { |
| lm_kbd_pwm_tick(opaque, 1); |
| } |
| static void lm_kbd_pwm2_tick(void *opaque) |
| { |
| lm_kbd_pwm_tick(opaque, 2); |
| } |
| |
| enum { |
| LM832x_CMD_READ_ID = 0x80, /* Read chip ID. */ |
| LM832x_CMD_WRITE_CFG = 0x81, /* Set configuration item. */ |
| LM832x_CMD_READ_INT = 0x82, /* Get interrupt status. */ |
| LM832x_CMD_RESET = 0x83, /* Reset, same as external one */ |
| LM823x_CMD_WRITE_PULL_DOWN = 0x84, /* Select GPIO pull-up/down. */ |
| LM832x_CMD_WRITE_PORT_SEL = 0x85, /* Select GPIO in/out. */ |
| LM832x_CMD_WRITE_PORT_STATE = 0x86, /* Set GPIO pull-up/down. */ |
| LM832x_CMD_READ_PORT_SEL = 0x87, /* Get GPIO in/out. */ |
| LM832x_CMD_READ_PORT_STATE = 0x88, /* Get GPIO pull-up/down. */ |
| LM832x_CMD_READ_FIFO = 0x89, /* Read byte from FIFO. */ |
| LM832x_CMD_RPT_READ_FIFO = 0x8a, /* Read FIFO (no increment). */ |
| LM832x_CMD_SET_ACTIVE = 0x8b, /* Set active time. */ |
| LM832x_CMD_READ_ERROR = 0x8c, /* Get error status. */ |
| LM832x_CMD_READ_ROTATOR = 0x8e, /* Read rotator status. */ |
| LM832x_CMD_SET_DEBOUNCE = 0x8f, /* Set debouncing time. */ |
| LM832x_CMD_SET_KEY_SIZE = 0x90, /* Set keypad size. */ |
| LM832x_CMD_READ_KEY_SIZE = 0x91, /* Get keypad size. */ |
| LM832x_CMD_READ_CFG = 0x92, /* Get configuration item. */ |
| LM832x_CMD_WRITE_CLOCK = 0x93, /* Set clock config. */ |
| LM832x_CMD_READ_CLOCK = 0x94, /* Get clock config. */ |
| LM832x_CMD_PWM_WRITE = 0x95, /* Write PWM script. */ |
| LM832x_CMD_PWM_START = 0x96, /* Start PWM engine. */ |
| LM832x_CMD_PWM_STOP = 0x97, /* Stop PWM engine. */ |
| LM832x_GENERAL_ERROR = 0xff, /* There was one error. |
| Previously was represented by -1 |
| This is not a command */ |
| }; |
| |
| #define LM832x_MAX_KPX 8 |
| #define LM832x_MAX_KPY 12 |
| |
| static uint8_t lm_kbd_read(LM823KbdState *s, int reg, int byte) |
| { |
| int ret; |
| |
| switch (reg) { |
| case LM832x_CMD_READ_ID: |
| ret = 0x0400; |
| break; |
| |
| case LM832x_CMD_READ_INT: |
| ret = s->status; |
| if (!(s->status & INT_NOINIT)) { |
| s->status = 0; |
| lm_kbd_irq_update(s); |
| } |
| break; |
| |
| case LM832x_CMD_READ_PORT_SEL: |
| ret = s->gpio.dir; |
| break; |
| case LM832x_CMD_READ_PORT_STATE: |
| ret = s->gpio.mask; |
| break; |
| |
| case LM832x_CMD_READ_FIFO: |
| if (s->kbd.len <= 1) |
| return 0x00; |
| |
| /* Example response from the two commands after a INT_KEYPAD |
| * interrupt caused by the key 0x3c being pressed: |
| * RPT_READ_FIFO: 55 bc 00 4e ff 0a 50 08 00 29 d9 08 01 c9 01 |
| * READ_FIFO: bc 00 00 4e ff 0a 50 08 00 29 d9 08 01 c9 01 |
| * RPT_READ_FIFO: bc 00 00 4e ff 0a 50 08 00 29 d9 08 01 c9 01 |
| * |
| * 55 is the code of the key release event serviced in the previous |
| * interrupt handling. |
| * |
| * TODO: find out whether the FIFO is advanced a single character |
| * before reading every byte or the whole size of the FIFO at the |
| * last LM832x_CMD_READ_FIFO. This affects LM832x_CMD_RPT_READ_FIFO |
| * output in cases where there are more than one event in the FIFO. |
| * Assume 0xbc and 0x3c events are in the FIFO: |
| * RPT_READ_FIFO: 55 bc 3c 00 4e ff 0a 50 08 00 29 d9 08 01 c9 |
| * READ_FIFO: bc 3c 00 00 4e ff 0a 50 08 00 29 d9 08 01 c9 |
| * Does RPT_READ_FIFO now return 0xbc and 0x3c or only 0x3c? |
| */ |
| s->kbd.start ++; |
| s->kbd.start &= sizeof(s->kbd.fifo) - 1; |
| s->kbd.len --; |
| |
| return s->kbd.fifo[s->kbd.start]; |
| case LM832x_CMD_RPT_READ_FIFO: |
| if (byte >= s->kbd.len) |
| return 0x00; |
| |
| return s->kbd.fifo[(s->kbd.start + byte) & (sizeof(s->kbd.fifo) - 1)]; |
| |
| case LM832x_CMD_READ_ERROR: |
| return s->error; |
| |
| case LM832x_CMD_READ_ROTATOR: |
| return 0; |
| |
| case LM832x_CMD_READ_KEY_SIZE: |
| return s->kbd.size; |
| |
| case LM832x_CMD_READ_CFG: |
| return s->config & 0xf; |
| |
| case LM832x_CMD_READ_CLOCK: |
| return (s->clock & 0xfc) | 2; |
| |
| default: |
| lm_kbd_error(s, ERR_CMDUNK); |
| fprintf(stderr, "%s: unknown command %02x\n", __func__, reg); |
| return 0x00; |
| } |
| |
| return ret >> (byte << 3); |
| } |
| |
| static void lm_kbd_write(LM823KbdState *s, int reg, int byte, uint8_t value) |
| { |
| switch (reg) { |
| case LM832x_CMD_WRITE_CFG: |
| s->config = value; |
| /* This must be done whenever s->mux.in is updated (never). */ |
| if ((s->config >> 1) & 1) /* MUX1EN */ |
| qemu_set_irq(s->mux.out[0], s->mux.in[0][(s->config >> 0) & 1]); |
| if ((s->config >> 3) & 1) /* MUX2EN */ |
| qemu_set_irq(s->mux.out[0], s->mux.in[0][(s->config >> 2) & 1]); |
| /* TODO: check that this is issued only following the chip reset |
| * and not in the middle of operation and that it is followed by |
| * the GPIO ports re-resablishing through WRITE_PORT_SEL and |
| * WRITE_PORT_STATE (using a timer perhaps) and otherwise output |
| * warnings. */ |
| s->status = 0; |
| lm_kbd_irq_update(s); |
| s->kbd.len = 0; |
| s->kbd.start = 0; |
| s->reg = LM832x_GENERAL_ERROR; |
| break; |
| |
| case LM832x_CMD_RESET: |
| if (value == 0xaa) |
| lm_kbd_reset(DEVICE(s)); |
| else |
| lm_kbd_error(s, ERR_BADPAR); |
| s->reg = LM832x_GENERAL_ERROR; |
| break; |
| |
| case LM823x_CMD_WRITE_PULL_DOWN: |
| if (!byte) |
| s->gpio.pull = value; |
| else { |
| s->gpio.pull |= value << 8; |
| lm_kbd_gpio_update(s); |
| s->reg = LM832x_GENERAL_ERROR; |
| } |
| break; |
| case LM832x_CMD_WRITE_PORT_SEL: |
| if (!byte) |
| s->gpio.dir = value; |
| else { |
| s->gpio.dir |= value << 8; |
| lm_kbd_gpio_update(s); |
| s->reg = LM832x_GENERAL_ERROR; |
| } |
| break; |
| case LM832x_CMD_WRITE_PORT_STATE: |
| if (!byte) |
| s->gpio.mask = value; |
| else { |
| s->gpio.mask |= value << 8; |
| lm_kbd_gpio_update(s); |
| s->reg = LM832x_GENERAL_ERROR; |
| } |
| break; |
| |
| case LM832x_CMD_SET_ACTIVE: |
| s->acttime = value; |
| s->reg = LM832x_GENERAL_ERROR; |
| break; |
| |
| case LM832x_CMD_SET_DEBOUNCE: |
| s->kbd.dbnctime = value; |
| s->reg = LM832x_GENERAL_ERROR; |
| if (!value) |
| lm_kbd_error(s, ERR_BADPAR); |
| break; |
| |
| case LM832x_CMD_SET_KEY_SIZE: |
| s->kbd.size = value; |
| s->reg = LM832x_GENERAL_ERROR; |
| if ( |
| (value & 0xf) < 3 || (value & 0xf) > LM832x_MAX_KPY || |
| (value >> 4) < 3 || (value >> 4) > LM832x_MAX_KPX) |
| lm_kbd_error(s, ERR_BADPAR); |
| break; |
| |
| case LM832x_CMD_WRITE_CLOCK: |
| s->clock = value; |
| s->reg = LM832x_GENERAL_ERROR; |
| if ((value & 3) && (value & 3) != 3) { |
| lm_kbd_error(s, ERR_BADPAR); |
| fprintf(stderr, "%s: invalid clock setting in RCPWM\n", |
| __func__); |
| } |
| /* TODO: Validate that the command is only issued once */ |
| break; |
| |
| case LM832x_CMD_PWM_WRITE: |
| if (byte == 0) { |
| if (!(value & 3) || (value >> 2) > 59) { |
| lm_kbd_error(s, ERR_BADPAR); |
| s->reg = LM832x_GENERAL_ERROR; |
| break; |
| } |
| |
| s->pwm.faddr = value; |
| s->pwm.file[s->pwm.faddr] = 0; |
| } else if (byte == 1) { |
| s->pwm.file[s->pwm.faddr] |= value << 8; |
| } else if (byte == 2) { |
| s->pwm.file[s->pwm.faddr] |= value << 0; |
| s->reg = LM832x_GENERAL_ERROR; |
| } |
| break; |
| case LM832x_CMD_PWM_START: |
| s->reg = LM832x_GENERAL_ERROR; |
| if (!(value & 3) || (value >> 2) > 59) { |
| lm_kbd_error(s, ERR_BADPAR); |
| break; |
| } |
| |
| s->pwm.addr[(value & 3) - 1] = value >> 2; |
| lm_kbd_pwm_start(s, (value & 3) - 1); |
| break; |
| case LM832x_CMD_PWM_STOP: |
| s->reg = LM832x_GENERAL_ERROR; |
| if (!(value & 3)) { |
| lm_kbd_error(s, ERR_BADPAR); |
| break; |
| } |
| |
| timer_del(s->pwm.tm[(value & 3) - 1]); |
| break; |
| |
| case LM832x_GENERAL_ERROR: |
| lm_kbd_error(s, ERR_BADPAR); |
| break; |
| default: |
| lm_kbd_error(s, ERR_CMDUNK); |
| fprintf(stderr, "%s: unknown command %02x\n", __func__, reg); |
| break; |
| } |
| } |
| |
| static int lm_i2c_event(I2CSlave *i2c, enum i2c_event event) |
| { |
| LM823KbdState *s = LM8323(i2c); |
| |
| switch (event) { |
| case I2C_START_RECV: |
| case I2C_START_SEND: |
| s->i2c_cycle = 0; |
| s->i2c_dir = (event == I2C_START_SEND); |
| break; |
| |
| default: |
| break; |
| } |
| |
| return 0; |
| } |
| |
| static uint8_t lm_i2c_rx(I2CSlave *i2c) |
| { |
| LM823KbdState *s = LM8323(i2c); |
| |
| return lm_kbd_read(s, s->reg, s->i2c_cycle ++); |
| } |
| |
| static int lm_i2c_tx(I2CSlave *i2c, uint8_t data) |
| { |
| LM823KbdState *s = LM8323(i2c); |
| |
| if (!s->i2c_cycle) |
| s->reg = data; |
| else |
| lm_kbd_write(s, s->reg, s->i2c_cycle - 1, data); |
| s->i2c_cycle ++; |
| |
| return 0; |
| } |
| |
| static int lm_kbd_post_load(void *opaque, int version_id) |
| { |
| LM823KbdState *s = opaque; |
| |
| lm_kbd_irq_update(s); |
| lm_kbd_gpio_update(s); |
| |
| return 0; |
| } |
| |
| static const VMStateDescription vmstate_lm_kbd = { |
| .name = "LM8323", |
| .version_id = 0, |
| .minimum_version_id = 0, |
| .post_load = lm_kbd_post_load, |
| .fields = (VMStateField[]) { |
| VMSTATE_I2C_SLAVE(parent_obj, LM823KbdState), |
| VMSTATE_UINT8(i2c_dir, LM823KbdState), |
| VMSTATE_UINT8(i2c_cycle, LM823KbdState), |
| VMSTATE_UINT8(reg, LM823KbdState), |
| VMSTATE_UINT8(config, LM823KbdState), |
| VMSTATE_UINT8(status, LM823KbdState), |
| VMSTATE_UINT8(acttime, LM823KbdState), |
| VMSTATE_UINT8(error, LM823KbdState), |
| VMSTATE_UINT8(clock, LM823KbdState), |
| VMSTATE_UINT16(gpio.pull, LM823KbdState), |
| VMSTATE_UINT16(gpio.mask, LM823KbdState), |
| VMSTATE_UINT16(gpio.dir, LM823KbdState), |
| VMSTATE_UINT16(gpio.level, LM823KbdState), |
| VMSTATE_UINT8(kbd.dbnctime, LM823KbdState), |
| VMSTATE_UINT8(kbd.size, LM823KbdState), |
| VMSTATE_UINT8(kbd.start, LM823KbdState), |
| VMSTATE_UINT8(kbd.len, LM823KbdState), |
| VMSTATE_BUFFER(kbd.fifo, LM823KbdState), |
| VMSTATE_UINT16_ARRAY(pwm.file, LM823KbdState, 256), |
| VMSTATE_UINT8(pwm.faddr, LM823KbdState), |
| VMSTATE_BUFFER(pwm.addr, LM823KbdState), |
| VMSTATE_TIMER_PTR_ARRAY(pwm.tm, LM823KbdState, 3), |
| VMSTATE_END_OF_LIST() |
| } |
| }; |
| |
| |
| static void lm8323_realize(DeviceState *dev, Error **errp) |
| { |
| LM823KbdState *s = LM8323(dev); |
| |
| s->model = 0x8323; |
| s->pwm.tm[0] = timer_new_ns(QEMU_CLOCK_VIRTUAL, lm_kbd_pwm0_tick, s); |
| s->pwm.tm[1] = timer_new_ns(QEMU_CLOCK_VIRTUAL, lm_kbd_pwm1_tick, s); |
| s->pwm.tm[2] = timer_new_ns(QEMU_CLOCK_VIRTUAL, lm_kbd_pwm2_tick, s); |
| qdev_init_gpio_out(dev, &s->nirq, 1); |
| } |
| |
| void lm832x_key_event(DeviceState *dev, int key, int state) |
| { |
| LM823KbdState *s = LM8323(dev); |
| |
| if ((s->status & INT_ERROR) && (s->error & ERR_FIFOOVR)) |
| return; |
| |
| if (s->kbd.len >= sizeof(s->kbd.fifo)) { |
| lm_kbd_error(s, ERR_FIFOOVR); |
| return; |
| } |
| |
| s->kbd.fifo[(s->kbd.start + s->kbd.len ++) & (sizeof(s->kbd.fifo) - 1)] = |
| key | (state << 7); |
| |
| /* We never set ERR_KEYOVR because we support multiple keys fine. */ |
| s->status |= INT_KEYPAD; |
| lm_kbd_irq_update(s); |
| } |
| |
| static void lm8323_class_init(ObjectClass *klass, void *data) |
| { |
| DeviceClass *dc = DEVICE_CLASS(klass); |
| I2CSlaveClass *k = I2C_SLAVE_CLASS(klass); |
| |
| dc->reset = lm_kbd_reset; |
| dc->realize = lm8323_realize; |
| k->event = lm_i2c_event; |
| k->recv = lm_i2c_rx; |
| k->send = lm_i2c_tx; |
| dc->vmsd = &vmstate_lm_kbd; |
| } |
| |
| static const TypeInfo lm8323_info = { |
| .name = TYPE_LM8323, |
| .parent = TYPE_I2C_SLAVE, |
| .instance_size = sizeof(LM823KbdState), |
| .class_init = lm8323_class_init, |
| }; |
| |
| static void lm832x_register_types(void) |
| { |
| type_register_static(&lm8323_info); |
| } |
| |
| type_init(lm832x_register_types) |