Apple-2-HW
/
apple2idiot
mirror of https://github.com/equant/apple2idiot.git
1
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity

README updated a bit

This commit is contained in:
Nathanial Hendler 2021-09-11 17:38:02 -07:00
parent ddc512fbbf
commit d0b08bb380
1 changed files with 17 additions and 14 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

31
README.md
View File

@ -1,32 +1,35 @@
# apple2idiot
A general purpose ESP32 IOT board for the Apple IIe
A general purpose ESP32 Wifi and Bluetooth board for the Apple II family of computers (with expansion slots).
Things are in the early stages of development, but it is working. The card contains an ESP32 which gives the Apple II access to wifi and bluetooth. It does not provide a TCP stack. Think of this as being more like making your Apple II an IOT device.
This card is essentially an ESP32 module and a dual-port ram chip. The Apple computer and the ESP communicate via the dual-port ram. That means that the ESP32 doesn't acutally have access to read/write any of the Apple computer's data or address busses. I think that's ok. In fact, I think this card is so simple, and stupid, that lots of fun little things can be done with it, but it's not meant to "get your Apple on the internet".
As a user of the card, you write the software that runs on the ESP32 module, and the software that runs on the Apple computer. In the `examples/` folder are examples of how to do simple little things. Software on the apple just peeks/pokes commands and data to the ram chip, and the ESP responds however it's programmed to resppond.
## Some of the example programs that have been developed so far
* Send a message to Slack.
* Get current weather conditions for a city.
* Select Wifi AP.
* Dedicated rot13 string encoder.
## Status
### The Card
This is actively being developed (as of September 2021). The rev 0.1 board doesn't work without
some bodge wires
Rev 0.2 boards are going to be ordered sometime this month.
some bodge wires, and rev 0.2 boards are on their way from China.
### The Apple II Software
None of the Apple //e code is up yet because I don't have a way to transfer it
from my 5.25 floppies to here. But all of this is underway.
from my 5.25 floppies to here. I hope to fix this soon.
### The Card Software
### The Card Software/Firmware
The ESP32 can be programmed using whatever you want. For example, you can use the Arduino IDE/C++ or you can use Lua, or Espressif's environment. Example Arduino programs are in the repo under examples.
## Some of the example programs that have been developed so far
* Get current weather conditions for a city.
* Select Wifi AP.
* Dedicated rot13 string encoder.
The ESP32 can be programmed using whatever you want. For example, you can use
the Arduino IDE/C++ or you can use Lua, or Espressif's environment. Example
Arduino programs are in the repo under examples.
## What could be done with an Apple2Idiot card?