1/* Copyright (c) 2013-2015 Jeffrey Pfau
  2 *
  3 * This Source Code Form is subject to the terms of the Mozilla Public
  4 * License, v. 2.0. If a copy of the MPL was not distributed with this
  5 * file, You can obtain one at http://mozilla.org/MPL/2.0/. */
  6#ifndef GBA_HARDWARE_H
  7#define GBA_HARDWARE_H
  8
  9#include "util/common.h"
 10
 11#include "macros.h"
 12
 13#include <time.h>
 14
 15#define IS_GPIO_REGISTER(reg) ((reg) == GPIO_REG_DATA || (reg) == GPIO_REG_DIRECTION || (reg) == GPIO_REG_CONTROL)
 16
 17struct GBARotationSource {
 18	void (*sample)(struct GBARotationSource*);
 19
 20	int32_t (*readTiltX)(struct GBARotationSource*);
 21	int32_t (*readTiltY)(struct GBARotationSource*);
 22
 23	int32_t (*readGyroZ)(struct GBARotationSource*);
 24};
 25
 26struct GBALuminanceSource {
 27	void (*sample)(struct GBALuminanceSource*);
 28
 29	uint8_t (*readLuminance)(struct GBALuminanceSource*);
 30};
 31
 32struct GBARTCSource {
 33	void (*sample)(struct GBARTCSource*);
 34
 35	time_t (*unixTime)(struct GBARTCSource*);
 36};
 37
 38enum GBAHardwareDevice {
 39	HW_NO_OVERRIDE = 0x8000,
 40	HW_NONE = 0,
 41	HW_RTC = 1,
 42	HW_RUMBLE = 2,
 43	HW_LIGHT_SENSOR = 4,
 44	HW_GYRO = 8,
 45	HW_TILT = 16
 46};
 47
 48enum GPIORegister {
 49	GPIO_REG_DATA = 0xC4,
 50	GPIO_REG_DIRECTION = 0xC6,
 51	GPIO_REG_CONTROL = 0xC8
 52};
 53
 54enum GPIODirection {
 55	GPIO_WRITE_ONLY = 0,
 56	GPIO_READ_WRITE = 1
 57};
 58
 59DECL_BITFIELD(RTCControl, uint32_t);
 60DECL_BIT(RTCControl, MinIRQ, 3);
 61DECL_BIT(RTCControl, Hour24, 6);
 62DECL_BIT(RTCControl, Poweroff, 7);
 63
 64enum RTCCommand {
 65	RTC_RESET = 0,
 66	RTC_DATETIME = 2,
 67	RTC_FORCE_IRQ = 3,
 68	RTC_CONTROL = 4,
 69	RTC_TIME = 6
 70};
 71
 72DECL_BITFIELD(RTCCommandData, uint32_t);
 73DECL_BITS(RTCCommandData, Magic, 0, 4);
 74DECL_BITS(RTCCommandData, Command, 4, 3);
 75DECL_BIT(RTCCommandData, Reading, 7);
 76
 77struct GBARTC {
 78	int bytesRemaining;
 79	int transferStep;
 80	int bitsRead;
 81	int bits;
 82	int commandActive;
 83	RTCCommandData command;
 84	RTCControl control;
 85	uint8_t time[7];
 86} __attribute__((packed));
 87
 88struct GBARumble {
 89	void (*setRumble)(struct GBARumble*, int enable);
 90};
 91
 92DECL_BITFIELD(GPIOPin, uint16_t);
 93
 94struct GBACartridgeHardware {
 95	struct GBA* p;
 96	int devices;
 97	enum GPIODirection readWrite;
 98	uint16_t* gpioBase;
 99
100	uint16_t pinState;
101	uint16_t direction;
102
103	struct GBARTC rtc;
104
105	uint16_t gyroSample;
106	bool gyroEdge;
107
108	unsigned lightCounter : 12;
109	uint8_t lightSample;
110	bool lightEdge;
111
112	uint16_t tiltX;
113	uint16_t tiltY;
114	int tiltState;
115};
116
117void GBAHardwareInit(struct GBACartridgeHardware* gpio, uint16_t* gpioBase);
118void GBAHardwareClear(struct GBACartridgeHardware* gpio);
119
120void GBAHardwareInitRTC(struct GBACartridgeHardware* gpio);
121void GBAHardwareInitGyro(struct GBACartridgeHardware* gpio);
122void GBAHardwareInitRumble(struct GBACartridgeHardware* gpio);
123void GBAHardwareInitLight(struct GBACartridgeHardware* gpio);
124void GBAHardwareInitTilt(struct GBACartridgeHardware* gpio);
125
126void GBAHardwareGPIOWrite(struct GBACartridgeHardware* gpio, uint32_t address, uint16_t value);
127void GBAHardwareTiltWrite(struct GBACartridgeHardware* gpio, uint32_t address, uint8_t value);
128uint8_t GBAHardwareTiltRead(struct GBACartridgeHardware* gpio, uint32_t address);
129
130struct GBASerializedState;
131void GBAHardwareSerialize(const struct GBACartridgeHardware* gpio, struct GBASerializedState* state);
132void GBAHardwareDeserialize(struct GBACartridgeHardware* gpio, const struct GBASerializedState* state);
133
134#endif