git.rot13.org Git - simavr/blob - simavr/sim/sim_io.h

   1 /*
   2         sim_io.h
   3
   4         Copyright 2008, 2009 Michel Pollet <buserror@gmail.com>
   5
   6         This file is part of simavr.
   7
   8         simavr is free software: you can redistribute it and/or modify
   9         it under the terms of the GNU General Public License as published by
  10         the Free Software Foundation, either version 3 of the License, or
  11         (at your option) any later version.
  12
  13         simavr is distributed in the hope that it will be useful,
  14         but WITHOUT ANY WARRANTY; without even the implied warranty of
  15         MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  16         GNU General Public License for more details.
  17
  18         You should have received a copy of the GNU General Public License
  19         along with simavr.  If not, see <http://www.gnu.org/licenses/>.
  20  */
  21
  22 #ifndef __SIM_IO_H__
  23 #define __SIM_IO_H__
  24
  25 #include "sim_avr.h"
  26
  27 #ifdef __cplusplus
  28 extern "C" {
  29 #endif
  30
  31 /*
  32  * used by the ioports to implement their own features
  33  * see avr_eeprom.* for an example, and avr_ioctl().
  34  */
  35 #define AVR_IOCTL_DEF(_a,_b,_c,_d) \
  36         (((_a) << 24)|((_b) << 16)|((_c) << 8)|((_d)))
  37
  38 /*
  39  * IO module base struct
  40  * Modules uses that as their first member in their own struct
  41  */
  42 typedef struct avr_io_t {
  43         struct avr_io_t *       next;
  44         avr_t *                         avr;            // avr we are attached to
  45         const char *            kind;           // pretty name, for debug
  46
  47         uint32_t                        irq_ioctl_get;  // used to get irqs from this module
  48         int                                     irq_count;      // number of (optional) irqs
  49         struct avr_irq_t *      irq;            // optional external IRQs
  50         // called at reset time
  51         void (*reset)(struct avr_io_t *io);
  52         // called externally. allow access to io modules and so on
  53         int (*ioctl)(struct avr_io_t *io, uint32_t ctl, void *io_param);
  54
  55         // optional, a function to free up allocated system resources
  56         void (*dealloc)(struct avr_io_t *io);
  57 } avr_io_t;
  58
  59 /*
  60  * IO modules helper functions
  61  */
  62
  63 // registers an IO module, so it's run(), reset() etc are called
  64 // this is called by the AVR core init functions, you /could/ register an external
  65 // one after instanciation, for whatever purpose...
  66 void avr_register_io(avr_t *avr, avr_io_t * io);
  67 // Sets an IO module "official" IRQs and the ioctl used to get to them. if 'irqs' is NULL,
  68 // 'count' will be allocated
  69 struct avr_irq_t * avr_io_setirqs(avr_io_t * io, uint32_t ctl, int count, struct avr_irq_t * irqs);
  70
  71 // register a callback for when IO register "addr" is read
  72 void avr_register_io_read(avr_t *avr, avr_io_addr_t addr, avr_io_read_t read, void * param);
  73 // register a callback for when the IO register is written. callback has to set the memory itself
  74 void avr_register_io_write(avr_t *avr, avr_io_addr_t addr, avr_io_write_t write, void * param);
  75 // call every IO modules until one responds to this
  76 int avr_ioctl(avr_t *avr, uint32_t ctl, void * io_param);
  77 // get the specific irq for a module, check AVR_IOCTL_IOPORT_GETIRQ for example
  78 struct avr_irq_t * avr_io_getirq(avr_t * avr, uint32_t ctl, int index);
  79
  80 // get the IRQ for an absolute IO address
  81 // this allows any code to hook an IRQ in any io address, for example
  82 // tracing changes of values into a register
  83 // Note that the values do not "magicaly" change, they change only
  84 // when the AVR code attempt to read and write at that address
  85 //
  86 // the "index" is a bit number, or ALL bits if index == 8
  87 #define AVR_IOMEM_IRQ_ALL 8
  88 struct avr_irq_t * avr_iomem_getirq(avr_t * avr, avr_io_addr_t addr, int index);
  89
  90 // Terminates all IOs and remove from them from the io chain
  91 void avr_deallocate_ios(avr_t *avr);
  92
  93 #ifdef __cplusplus
  94 };
  95 #endif
  96
  97 #endif /* __SIM_IO_H__ */