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
  67 avr_register_io(
  68                 avr_t *avr,
  69                 avr_io_t * io);
  70 // Sets an IO module "official" IRQs and the ioctl used to get to them. if 'irqs' is NULL,
  71 // 'count' will be allocated
  72 avr_irq_t *
  73 avr_io_setirqs(
  74                 avr_io_t * io,
  75                 uint32_t ctl,
  76                 int count,
  77                 avr_irq_t * irqs);
  78
  79 // register a callback for when IO register "addr" is read
  80 void
  81 avr_register_io_read(
  82                 avr_t *avr,
  83                 avr_io_addr_t addr,
  84                 avr_io_read_t read,
  85                 void * param);
  86 // register a callback for when the IO register is written. callback has to set the memory itself
  87 void
  88 avr_register_io_write(
  89                 avr_t *avr,
  90                 avr_io_addr_t addr,
  91                 avr_io_write_t write,
  92                 void * param);
  93 // call every IO modules until one responds to this
  94 int
  95 avr_ioctl(
  96                 avr_t *avr,
  97                 uint32_t ctl,
  98                 void * io_param);
  99 // get the specific irq for a module, check AVR_IOCTL_IOPORT_GETIRQ for example
 100 struct avr_irq_t * avr_io_getirq(avr_t * avr, uint32_t ctl, int index);
 101
 102 // get the IRQ for an absolute IO address
 103 // this allows any code to hook an IRQ in any io address, for example
 104 // tracing changes of values into a register
 105 // Note that the values do not "magicaly" change, they change only
 106 // when the AVR code attempt to read and write at that address
 107 //
 108 // the "index" is a bit number, or ALL bits if index == 8
 109 #define AVR_IOMEM_IRQ_ALL 8
 110 avr_irq_t *
 111 avr_iomem_getirq(
 112                 avr_t * avr,
 113                 avr_io_addr_t addr,
 114                 int index);
 115
 116 // Terminates all IOs and remove from them from the io chain
 117 void
 118 avr_deallocate_ios(
 119                 avr_t *avr);
 120
 121 #ifdef __cplusplus
 122 };
 123 #endif
 124
 125 #endif /* __SIM_IO_H__ */