git.sur5r.net Git - cc65/blob - include/nes.h

   1 /*****************************************************************************/
   2 /*                                                                           */
   3 /*                                   nes.h                                   */
   4 /*                                                                           */
   5 /*                      NES system specific definitions                      */
   6 /*                                                                           */
   7 /*                                                                           */
   8 /*                                                                           */
   9 /* (C) 2002-2003 Groepaz/Hitmen                                              */
  10 /*                                                                           */
  11 /*                                                                           */
  12 /* This software is provided 'as-is', without any expressed or implied       */
  13 /* warranty.  In no event will the authors be held liable for any damages    */
  14 /* arising from the use of this software.                                    */
  15 /*                                                                           */
  16 /* Permission is granted to anyone to use this software for any purpose,     */
  17 /* including commercial applications, and to alter it and redistribute it    */
  18 /* freely, subject to the following restrictions:                            */
  19 /*                                                                           */
  20 /* 1. The origin of this software must not be misrepresented; you must not   */
  21 /*    claim that you wrote the original software. If you use this software   */
  22 /*    in a product, an acknowledgment in the product documentation would be  */
  23 /*    appreciated but is not required.                                       */
  24 /* 2. Altered source versions must be plainly marked as such, and must not   */
  25 /*    be misrepresented as being the original software.                      */
  26 /* 3. This notice may not be removed or altered from any source              */
  27 /*    distribution.                                                          */
  28 /*                                                                           */
  29 /*****************************************************************************/
  30
  31
  32
  33 #ifndef _NES_H
  34 #define _NES_H
  35
  36
  37
  38 /* Check for errors */
  39 #if !defined(__NES__)
  40 #  error This module may only be used when compiling for the NES!
  41 #endif
  42
  43
  44
  45 /* Key and character defines */
  46 #define CH_ENTER                '\n'
  47 #define CH_CURS_UP              0x01
  48 #define CH_CURS_DOWN            0x02
  49 #define CH_CURS_LEFT            0x03
  50 #define CH_CURS_RIGHT           0x04
  51 #define CH_ESC                  8
  52 #define CH_DEL                  20
  53
  54 #define CH_CROSS                0x10
  55 #define CH_RTEE                 0x17
  56 #define CH_LTEE                 0x0f
  57 #define CH_TTEE                 0x16
  58 #define CH_BTEE                 0x15
  59 #define CH_HLINE                0x0b
  60 #define CH_VLINE                0x0e
  61 #define CH_ULCORNER             0x14
  62 #define CH_URCORNER             0x12
  63 #define CH_LLCORNER             0x11
  64 #define CH_LRCORNER             0x08
  65 #define CH_PI                   0x05
  66
  67 /* Color defines */
  68 #define COLOR_BLACK             0x00
  69 #define COLOR_WHITE             0x01
  70 #define COLOR_RED               0x02
  71 #define COLOR_CYAN              0x03
  72 #define COLOR_VIOLET            0x04
  73 #define COLOR_GREEN             0x05
  74 #define COLOR_BLUE              0x06
  75 #define COLOR_YELLOW            0x07
  76 #define COLOR_ORANGE            0x08
  77 #define COLOR_BROWN             0x09
  78 #define COLOR_LIGHTRED          0x0A
  79 #define COLOR_GRAY1             0x0B
  80 #define COLOR_GRAY2             0x0C
  81 #define COLOR_LIGHTGREEN        0x0D
  82 #define COLOR_LIGHTBLUE         0x0E
  83 #define COLOR_GRAY3             0x0F
  84
  85 /* Return codes of get_tv */
  86 #define TV_NTSC         0
  87 #define TV_PAL          1
  88 #define TV_OTHER        2
  89
  90 /* No support for dynamically loadable drivers */
  91 #define DYN_DRV         0
  92
  93 /* The joystick keys - all keys are supported */
  94 #define KEY_A           0x01
  95 #define KEY_B           0x02
  96 #define KEY_SELECT      0x04
  97 #define KEY_START       0x08
  98 #define KEY_UP          0x10
  99 #define KEY_DOWN        0x20
 100 #define KEY_LEFT        0x40
 101 #define KEY_RIGHT       0x80
 102
 103 /* Define hardware */
 104
 105 /* Picture Processing Unit */
 106 struct __ppu {
 107     unsigned char control;
 108     unsigned char mask;                 /* color; show sprites, background */
 109       signed char volatile const status;
 110     struct {
 111         unsigned char address;
 112         unsigned char data;
 113     } sprite;
 114     unsigned char scroll;
 115     struct {
 116         unsigned char address;
 117         unsigned char data;
 118     } vram;
 119 };
 120 #define PPU             (*(struct __ppu*)0x2000)
 121 #define SPRITE_DMA      (APU.sprite.dma)
 122
 123 /* Audio Processing Unit */
 124 struct __apu {
 125     struct {
 126         unsigned char control;          /* duty, counter halt, volume/envelope */
 127         unsigned char ramp;
 128         unsigned char period_low;       /* timing */
 129         unsigned char len_period_high;  /* length, timing */
 130     } pulse[2];
 131     struct {
 132         unsigned char counter;          /* counter halt, linear counter */
 133         unsigned char unused;
 134         unsigned char period_low;       /* timing */
 135         unsigned char len_period_high;  /* length, timing */
 136     } triangle;
 137     struct {
 138         unsigned char control;          /* counter halt, volume/envelope */
 139         unsigned char unused;
 140         unsigned char period;           /* loop, timing */
 141         unsigned char len;              /* length */
 142     } noise;
 143     struct {
 144         unsigned char control;          /* IRQ, loop, rate */
 145         unsigned char output;           /* output value */
 146         unsigned char address;
 147         unsigned char length;
 148     } delta_mod;                        /* delta pulse-code modulation */
 149     struct {
 150         unsigned char dma;
 151     } sprite;
 152       signed char volatile status;
 153     unsigned char unused;
 154     unsigned char fcontrol;
 155 };
 156 #define APU             (*(struct __apu*)0x4000)
 157
 158 #define JOYPAD          ((unsigned char volatile[2])0x4016)
 159
 160 /* The addresses of the static drivers */
 161 extern void nes_stdjoy_joy[];       /* Referred to by joy_static_stddrv[] */
 162 extern void nes_64_56_2_tgi[];      /* Referred to by tgi_static_stddrv[] */
 163
 164
 165
 166 void waitvblank (void);
 167 /* Wait for the vertical blanking */
 168
 169 unsigned char get_tv (void);
 170 /* Return the video mode the machine is using. */
 171
 172
 173
 174 /* End of nes.h */
 175 #endif