git.gag.com Git - fw/sdcc/blob - device/include/mcs51/compiler.h

   1 /** \file compiler.h\r
   2   * \author Maarten Brock\r
   3   *\r
   4   * This library is free software; you can redistribute it and/or\r
   5   * modify it under the terms of the GNU Lesser General Public\r
   6   * License as published by the Free Software Foundation; either\r
   7   * version 2.1 of the License, or (at your option) any later version.\r
   8   *\r
   9   * This library is distributed in the hope that it will be useful,\r
  10   * but WITHOUT ANY WARRANTY; without even the implied warranty of\r
  11   * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU\r
  12   * Lesser General Public License for more details.\r
  13   *\r
  14   * You should have received a copy of the GNU Lesser General Public\r
  15   * License along with this library; if not, write to the Free Software\r
  16   * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307 USA\r
  17   *\r
  18   * In other words, you are welcome to use, share and improve this program.\r
  19   * You are forbidden to forbid anyone else to use, share and improve\r
  20   * what you give them. Help stamp out software-hoarding!\r
  21   *\r
  22   * Header file to overcome 8051 compiler differences for specifying\r
  23   * special function registers. The following compilers are supported:\r
  24   * SDCC, Keil, Raisonance, IAR, Hi-Tech, Tasking, Crossware, Wickenhäuser.\r
  25   * Unfortunately not for use with Dunfield. The compilers are identified by\r
  26   * their unique predefined macros. See also:\r
  27   * http://predef.sourceforge.net/precomp.html\r
  28   *\r
  29   * SBIT and SFR define special bit and special function registers at the given\r
  30   * address. SFR16 and SFR32 define sfr combinations at adjacent addresses in\r
  31   * little-endian format. SFR16E and SFR32E define sfr combinations without\r
  32   * prerequisite byte order or adjacency. None of these multi-byte sfr\r
  33   * combinations will guarantee the order in which they are accessed when read\r
  34   * or written.\r
  35   * SFR16X and SFR32X for 16 bit and 32 bit xdata registers are not defined\r
  36   * to avoid portability issues because of compiler endianness.\r
  37   * This file is to be included in every microcontroller specific header file.\r
  38   * Example:\r
  39   *\r
  40   * // my_mcu.h: sfr definitions for my mcu\r
  41   * #include <compiler.h>\r
  42   *\r
  43   * SBIT  (P0_1, 0x80, 1);      // Port 0 pin 1\r
  44   *\r
  45   * SFR   (P0, 0x80);           // Port 0\r
  46   *\r
  47   * SFRX  (CPUCS, 0xE600);      // Cypress FX2 Control and Status register in xdata memory at 0xE600\r
  48   *\r
  49   * SFR16 (TMR2, 0xCC);         // Timer 2, lsb at 0xCC, msb at 0xCD\r
  50   *\r
  51   * SFR16E(TMR0, 0x8C8A);       // Timer 0, lsb at 0x8A, msb at 0x8C\r
  52   *\r
  53   * SFR32 (MAC0ACC, 0x93);      // SiLabs C8051F120 32 bits MAC0 Accumulator, lsb at 0x93, msb at 0x96\r
  54   *\r
  55   * SFR32E(SUMR, 0xE5E4E3E2);   // TI MSC1210 SUMR 32 bits Summation register, lsb at 0xE2, msb at 0xE5\r
  56   *\r
  57  */\r
  58 \r
  59 #ifndef COMPILER_H\r
  60 #define COMPILER_H\r
  61 \r
  62 /** SDCC - Small Device C Compiler\r
  63   * http://sdcc.sf.net\r
  64  */\r
  65 #if defined SDCC\r
  66 # define SBIT(name, addr, bit)  __sbit  __at(addr+bit)                  name\r
  67 # define SFR(name, addr)        __sfr   __at(addr)                      name\r
  68 # define SFRX(name, addr)       xdata volatile unsigned char __at(addr) name\r
  69 # define SFR16(name, addr)      __sfr16 __at(((addr+1U)<<8) | addr)     name\r
  70 # define SFR16E(name, fulladdr) __sfr16 __at(fulladdr)                  name\r
  71 # define SFR32(name, addr)      __sfr32 __at(((addr+3UL)<<24) | ((addr+2UL)<<16) | ((addr+1UL)<<8) | addr) name\r
  72 # define SFR32E(name, fulladdr) __sfr32 __at(fulladdr)                  name\r
  73 \r
  74 /** Keil C51\r
  75   * http://www.keil.com\r
  76  */\r
  77 #elif defined __CX51__\r
  78 # define SBIT(name, addr, bit)  sbit  name = addr^bit\r
  79 # define SFR(name, addr)        sfr   name = addr\r
  80 # define SFRX(name, addr)       volatile unsigned char xdata name _at_ addr\r
  81 # define SFR16(name, addr)      sfr16 name = addr\r
  82 # define SFR16E(name, fulladdr) /* not supported */\r
  83 # define SFR32(name, fulladdr)  /* not supported */\r
  84 # define SFR32E(name, fulladdr) /* not supported */\r
  85 \r
  86 /** Raisonance\r
  87   * http://www.raisonance.com\r
  88  */\r
  89 #elif defined __RC51__\r
  90 # define SBIT(name, addr, bit)  at (addr+bit) sbit                   name\r
  91 # define SFR(name, addr)        sfr at addr                          name\r
  92 # define SFRX(name, addr)       xdata at addr volatile unsigned char name\r
  93 # define SFR16(name, addr)      sfr16 at addr                        name\r
  94 # define SFR16E(name, fulladdr) /* not supported */\r
  95 # define SFR32(name, fulladdr)  /* not supported */\r
  96 # define SFR32E(name, fulladdr) /* not supported */\r
  97 \r
  98 /** IAR 8051\r
  99   * http://www.iar.com\r
 100  */\r
 101 #elif defined __ICC8051__\r
 102 # define SBIT(name, addr, bit)  __bit __no_init volatile bool name @ (addr+bit)\r
 103 # define SFR(name, addr)        __sfr __no_init volatile unsigned char name @ addr\r
 104 # define SFRX(name, addr)       __xdata __no_init volatile unsigned char name @ addr\r
 105 # define SFR16(name, addr)      __sfr __no_init volatile unsigned int  name @ addr\r
 106 # define SFR16E(name, fulladdr) /* not supported */\r
 107 # define SFR32(name, fulladdr)  __sfr __no_init volatile unsigned long name @ addr\r
 108 # define SFR32E(name, fulladdr) /* not supported */\r
 109 \r
 110 /** Tasking / Altium\r
 111   * http://www.altium.com/tasking\r
 112  */\r
 113 #elif defined _CC51\r
 114 # define SBIT(name, addr, bit)  _sfrbit  name _at(addr+bit)\r
 115 # define SFR(name, addr)        _sfrbyte name _at(addr)\r
 116 # define SFRX(name, addr)       _xdat volatile unsigned char name _at(addr)\r
 117 #if _CC51 > 71\r
 118 # define SFR16(name, addr)      _sfrword _little name _at(addr)\r
 119 #else\r
 120 # define SFR16(name, addr)      /* not supported */\r
 121 #endif\r
 122 # define SFR16E(name, fulladdr) /* not supported */\r
 123 # define SFR32(name, fulladdr)  /* not supported */\r
 124 # define SFR32E(name, fulladdr) /* not supported */\r
 125 \r
 126 /** Hi-Tech 8051\r
 127   * http://www.htsoft.com\r
 128  */\r
 129 #elif defined HI_TECH_C\r
 130 # define SBIT(name, addr, bit)  volatile bit           name @ (addr+bit)\r
 131 # define SFR(name, addr)        volatile unsigned char name @ addr\r
 132 # define SFRX(name, addr)       volatile far unsigned char name @ addr\r
 133 # define SFR16(name, addr)      /* not supported */\r
 134 # define SFR16E(name, fulladdr) /* not supported */\r
 135 # define SFR32(name, fulladdr)  /* not supported */\r
 136 # define SFR32E(name, fulladdr) /* not supported */\r
 137 \r
 138 /** Crossware\r
 139   * http://www.crossware.com\r
 140  */\r
 141 #elif defined _XC51_VER\r
 142 # define SBIT(name, addr, bit)  _sfrbit  name = (addr+bit)\r
 143 # define SFR(name, addr)        _sfr     name = addr\r
 144 # define SFRX(name, addr)       volatile unsigned char _xdata name _at addr\r
 145 # define SFR16(name, addr)      _sfrword name = addr\r
 146 # define SFR16E(name, fulladdr) /* not supported */\r
 147 # define SFR32(name, fulladdr)  /* not supported */\r
 148 # define SFR32E(name, fulladdr) /* not supported */\r
 149 \r
 150 /** Wickenhäuser\r
 151   * http://www.wickenhaeuser.de\r
 152  */\r
 153 #elif defined __UC__\r
 154 # define SBIT(name, addr, bit)  unsigned char bit  name @ (addr+bit)\r
 155 # define SFR(name, addr)        near unsigned char name @ addr\r
 156 # define SFRX(name, addr)       xdata volatile unsigned char name @ addr\r
 157 # define SFR16(name, addr)      /* not supported */\r
 158 # define SFR16E(name, fulladdr) /* not supported */\r
 159 # define SFR32(name, fulladdr)  /* not supported */\r
 160 # define SFR32E(name, fulladdr) /* not supported */\r
 161 \r
 162 /** default\r
 163   * unknown compiler\r
 164  */\r
 165 #elif\r
 166 # warning unknown compiler\r
 167 # define SBIT(name, addr, bit)  volatile bool           name\r
 168 # define SFR(name, addr)        volatile unsigned char  name\r
 169 # define SFRX(name, addr)       volatile unsigned char  name\r
 170 # define SFR16(name, addr)      volatile unsigned short name\r
 171 # define SFR16E(name, fulladdr) volatile unsigned short name\r
 172 # define SFR32(name, fulladdr)  volatile unsigned long  name\r
 173 # define SFR32E(name, fulladdr) volatile unsigned long  name\r
 174 \r
 175 #endif\r
 176 \r
 177 #endif //COMPILER_H\r