1
0
mirror of https://github.com/cc65/cc65.git synced 2024-11-15 11:05:56 +00:00
cc65/include/nes.h
Oliver Schmidt 7f52a770d9 Removed joy_masks array.
So far the joy_masks array allowed several joystick drivers for a single target to each have different joy_read return values. However this meant that every call to joy_read implied an additional joy_masks lookup to post-process the return value.

Given that almost all targets only come with a single joystick driver this seems an inappropriate overhead. Therefore now the target header files contain constants matching the return value of the joy_read of the joystick driver(s) on that target.

If there indeed are several joystick drivers for a single target they must agree on a common return value for joy_read. In some cases this was alredy the case as there's a "natural" return value for joy_read. However a few joystick drivers need to be adjusted. This may cause some overhead inside the driver. But that is for sure smaller than the overhead introduced by the joy_masks lookup before.

!!! ToDo !!!

The following three joystick drivers become broken with this commit and need to be adjusted:
- atrmj8.s
- c64-numpad.s
- vic20-stdjoy.s
2017-08-19 19:11:28 +02:00

186 lines
6.6 KiB
C

/*****************************************************************************/
/* */
/* nes.h */
/* */
/* NES system specific definitions */
/* */
/* */
/* */
/* (C) 2002-2003 Groepaz/Hitmen */
/* */
/* */
/* This software is provided 'as-is', without any expressed or implied */
/* warranty. In no event will the authors be held liable for any damages */
/* arising from the use of this software. */
/* */
/* Permission is granted to anyone to use this software for any purpose, */
/* including commercial applications, and to alter it and redistribute it */
/* freely, subject to the following restrictions: */
/* */
/* 1. The origin of this software must not be misrepresented; you must not */
/* claim that you wrote the original software. If you use this software */
/* in a product, an acknowledgment in the product documentation would be */
/* appreciated but is not required. */
/* 2. Altered source versions must be plainly marked as such, and must not */
/* be misrepresented as being the original software. */
/* 3. This notice may not be removed or altered from any source */
/* distribution. */
/* */
/*****************************************************************************/
#ifndef _NES_H
#define _NES_H
/* Check for errors */
#if !defined(__NES__)
# error This module may only be used when compiling for the NES!
#endif
/* Key and character defines */
#define CH_ENTER '\n'
#define CH_CURS_UP 0x01
#define CH_CURS_DOWN 0x02
#define CH_CURS_LEFT 0x03
#define CH_CURS_RIGHT 0x04
#define CH_ESC 8
#define CH_DEL 20
#define CH_CROSS 0x10
#define CH_RTEE 0x17
#define CH_LTEE 0x0f
#define CH_TTEE 0x16
#define CH_BTEE 0x15
#define CH_HLINE 0x0b
#define CH_VLINE 0x0e
#define CH_ULCORNER 0x14
#define CH_URCORNER 0x12
#define CH_LLCORNER 0x11
#define CH_LRCORNER 0x08
#define CH_PI 0x05
/* Color defines */
#define COLOR_BLACK 0x00
#define COLOR_WHITE 0x01
#define COLOR_RED 0x02
#define COLOR_CYAN 0x03
#define COLOR_VIOLET 0x04
#define COLOR_GREEN 0x05
#define COLOR_BLUE 0x06
#define COLOR_YELLOW 0x07
#define COLOR_ORANGE 0x08
#define COLOR_BROWN 0x09
#define COLOR_LIGHTRED 0x0A
#define COLOR_GRAY1 0x0B
#define COLOR_GRAY2 0x0C
#define COLOR_LIGHTGREEN 0x0D
#define COLOR_LIGHTBLUE 0x0E
#define COLOR_GRAY3 0x0F
/* Masks for joy_read */
#define JOY_UP_MASK 0x10
#define JOY_DOWN_MASK 0x20
#define JOY_LEFT_MASK 0x40
#define JOY_RIGHT_MASK 0x80
#define JOY_BTN_1_MASK 0x01
#define JOY_BTN_2_MASK 0x02
#define JOY_BTN_3_MASK 0x04
#define JOY_BTN_4_MASK 0x08
#define JOY_BTN_A_MASK JOY_BTN_1_MASK
#define JOY_BTN_B_MASK JOY_BTN_2_MASK
#define JOY_SELECT_MASK JOY_BTN_3_MASK
#define JOY_START_MASK JOY_BTN_4_MASK
#define JOY_BTN_A(v) ((v) & JOY_BTN_A_MASK)
#define JOY_BTN_B(v) ((v) & JOY_BTN_B_MASK)
#define JOY_SELECT(v) ((v) & JOY_SELECT_MASK)
#define JOY_START(v) ((v) & JOY_START_MASK)
/* Return codes of get_tv */
#define TV_NTSC 0
#define TV_PAL 1
#define TV_OTHER 2
/* No support for dynamically loadable drivers */
#define DYN_DRV 0
/* Define hardware */
/* Picture Processing Unit */
struct __ppu {
unsigned char control;
unsigned char mask; /* color; show sprites, background */
signed char volatile const status;
struct {
unsigned char address;
unsigned char data;
} sprite;
unsigned char scroll;
struct {
unsigned char address;
unsigned char data;
} vram;
};
#define PPU (*(struct __ppu*)0x2000)
#define SPRITE_DMA (APU.sprite.dma)
/* Audio Processing Unit */
struct __apu {
struct {
unsigned char control; /* duty, counter halt, volume/envelope */
unsigned char ramp;
unsigned char period_low; /* timing */
unsigned char len_period_high; /* length, timing */
} pulse[2];
struct {
unsigned char counter; /* counter halt, linear counter */
unsigned char unused;
unsigned char period_low; /* timing */
unsigned char len_period_high; /* length, timing */
} triangle;
struct {
unsigned char control; /* counter halt, volume/envelope */
unsigned char unused;
unsigned char period; /* loop, timing */
unsigned char len; /* length */
} noise;
struct {
unsigned char control; /* IRQ, loop, rate */
unsigned char output; /* output value */
unsigned char address;
unsigned char length;
} delta_mod; /* delta pulse-code modulation */
struct {
unsigned char dma;
} sprite;
signed char volatile status;
unsigned char unused;
unsigned char fcontrol;
};
#define APU (*(struct __apu*)0x4000)
#define JOYPAD ((unsigned char volatile[2])0x4016)
/* The addresses of the static drivers */
extern void nes_stdjoy_joy[]; /* Referred to by joy_static_stddrv[] */
extern void nes_64_56_2_tgi[]; /* Referred to by tgi_static_stddrv[] */
void waitvsync (void);
/* Wait for start of the next frame */
unsigned char get_tv (void);
/* Return the video mode the machine is using. */
/* End of nes.h */
#endif