mirror of
https://github.com/DutchMaker/Apple-1-Mini.git
synced 2024-10-31 19:04:44 +00:00
205 lines
4.5 KiB
C++
205 lines
4.5 KiB
C++
// -----------------------------------------------------------------------------
|
|
// Apple 1 Replica firmware for Arduino
|
|
//
|
|
// Version 1.0
|
|
// By Ruud van Falier
|
|
//
|
|
// Enables serial communication between an Arduino and the Apple 1 PIA.
|
|
// Heavily based on Propeller source code from Briel Computers Apple 1 replica.
|
|
// -----------------------------------------------------------------------------
|
|
|
|
// Port definitions (Arduino pins connected to the PIA)
|
|
#define DA A0
|
|
#define RDA A1
|
|
#define PB0 2
|
|
#define PB1 3
|
|
#define PB2 4
|
|
#define PB3 A5
|
|
#define PB4 A4
|
|
#define PB5 A3
|
|
#define PB6 A2
|
|
#define PA0 5
|
|
#define PA1 6
|
|
#define PA2 7
|
|
#define PA3 8
|
|
#define PA4 9
|
|
#define PA5 10
|
|
#define PA6 11
|
|
#define STROBE 12
|
|
|
|
// VT100 codes (u)sed for cursor implementation)
|
|
#define OFF "\033[0m"
|
|
#define BLINK "\033[5m"
|
|
#define COLOR "\033[35m"
|
|
#define BLINK_COLOR "\033[5;35m"
|
|
#define BOLD_COLOR "\033[1;35m"
|
|
#define CLS "\033[2J"
|
|
#define BACKSPACE "\010"
|
|
#define CURSOR_CHAR "@"
|
|
|
|
uint8_t video_data = 0;
|
|
uint8_t video_data_pins[] = { PB0, PB1, PB2, PB3, PB4, PB5, PB6 };
|
|
uint8_t serial_data;
|
|
bool cursor_visible = false;
|
|
|
|
void setup()
|
|
{
|
|
// Setup video data pins (output from the PIA)
|
|
pinMode(RDA, OUTPUT);
|
|
pinMode(DA, INPUT);
|
|
pinMode(PB0, INPUT);
|
|
pinMode(PB1, INPUT);
|
|
pinMode(PB2, INPUT);
|
|
pinMode(PB3, INPUT);
|
|
pinMode(PB4, INPUT);
|
|
pinMode(PB5, INPUT);
|
|
pinMode(PB6, INPUT);
|
|
|
|
// Setup ASCII data pins (input for the PIA)
|
|
pinMode(STROBE, OUTPUT);
|
|
pinMode(PA0, OUTPUT);
|
|
pinMode(PA1, OUTPUT);
|
|
pinMode(PA2, OUTPUT);
|
|
pinMode(PA3, OUTPUT);
|
|
pinMode(PA4, OUTPUT);
|
|
pinMode(PA5, OUTPUT);
|
|
pinMode(PA6, OUTPUT);
|
|
|
|
Serial.begin(9600);
|
|
|
|
cursor_visible = false;
|
|
Serial.print(CLS);
|
|
Serial.print(BOLD_COLOR);
|
|
Serial.println("Apple 1 Replica");
|
|
Serial.print(OFF);
|
|
Serial.print(COLOR);
|
|
Serial.println("Firmware version 1.0");
|
|
Serial.println("Ruud van Falier, 2017");
|
|
Serial.println("---------------------------------");
|
|
Serial.println();
|
|
Serial.println("Ready...");
|
|
Serial.print(OFF);
|
|
|
|
show_cursor();
|
|
}
|
|
|
|
void loop()
|
|
{
|
|
process_video_data();
|
|
process_serial_data();
|
|
}
|
|
|
|
/*
|
|
* Retrieves video (character) data from the PIA and sends it to the user over the serial connection.
|
|
*/
|
|
void process_video_data()
|
|
{
|
|
// Tell the PIA we are ready to receive data.
|
|
digitalWrite(RDA, HIGH);
|
|
delay(10);
|
|
|
|
if (digitalRead(DA))
|
|
{
|
|
// Data is available.
|
|
video_data = 0;
|
|
|
|
// Decode the data bits to a byte.
|
|
for (int i = 0; i < 7; i++)
|
|
{
|
|
if (digitalRead(video_data_pins[i]))
|
|
{
|
|
video_data |= (1 << i);
|
|
}
|
|
}
|
|
|
|
if (video_data == 13)
|
|
{
|
|
// Carrage return.
|
|
hide_cursor();
|
|
Serial.println();
|
|
}
|
|
else if (video_data > 31)
|
|
{
|
|
// Display-compatible character.
|
|
hide_cursor();
|
|
Serial.print(COLOR);
|
|
Serial.print((char)video_data);
|
|
Serial.print(OFF);
|
|
}
|
|
|
|
digitalWrite(RDA, LOW);
|
|
delay(10);
|
|
}
|
|
else
|
|
{
|
|
show_cursor();
|
|
}
|
|
}
|
|
|
|
/*
|
|
* Processes data received from the serial connection.
|
|
* Puts the received data on to the PIA where the CPU will read it from.
|
|
*/
|
|
void process_serial_data()
|
|
{
|
|
// Wait for serial data coming in.
|
|
if (Serial.available() > 0)
|
|
{
|
|
serial_data = Serial.read();
|
|
|
|
if (serial_data == 203)
|
|
{
|
|
// Translate uppercase ESC to normal ESC.
|
|
serial_data = 27;
|
|
}
|
|
|
|
if (serial_data >= 97 && serial_data <= 122)
|
|
{
|
|
// Translate lowercase characters to uppercase as the Apple 1 only supports uppercase.
|
|
serial_data -= 32;
|
|
}
|
|
|
|
if (serial_data < 96)
|
|
{
|
|
// Encode any Apple 1 compatible character to data bits.
|
|
digitalWrite(PA6, bitRead(serial_data, 6));
|
|
digitalWrite(PA5, bitRead(serial_data, 5));
|
|
digitalWrite(PA4, bitRead(serial_data, 4));
|
|
digitalWrite(PA3, bitRead(serial_data, 3));
|
|
digitalWrite(PA2, bitRead(serial_data, 2));
|
|
digitalWrite(PA1, bitRead(serial_data, 1));
|
|
digitalWrite(PA0, bitRead(serial_data, 0));
|
|
|
|
// Pulse the STROBE bit so the PIA will process the input.
|
|
digitalWrite(STROBE, HIGH);
|
|
delay(20);
|
|
digitalWrite(STROBE, LOW);
|
|
}
|
|
}
|
|
}
|
|
|
|
/*
|
|
* Remove the cursor character from the screen by sending a backspace.
|
|
*/
|
|
void hide_cursor()
|
|
{
|
|
if (cursor_visible)
|
|
{
|
|
Serial.print(BACKSPACE);
|
|
cursor_visible = false;
|
|
}
|
|
}
|
|
|
|
/*
|
|
* Display blinking cursor character.
|
|
*/
|
|
void show_cursor()
|
|
{
|
|
if (!cursor_visible)
|
|
{
|
|
Serial.print(BLINK_COLOR);
|
|
Serial.print(CURSOR_CHAR);
|
|
Serial.print(OFF);
|
|
cursor_visible = true;
|
|
}
|
|
} |