Apple-1-HW/verilog-apple-one
1
0
Fork 0
mirror of https://github.com/alangarf/apple-one.git synced 2024-06-11 04:29:33 +00:00
Code Issues Projects Releases Wiki Activity

Update and rename . .. to README.md

Browse Source
This commit is contained in:
oa-stepien 2019-07-25 13:46:03 +02:00 committed by GitHub
parent cecd0dbc1c
commit 140bafd817
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
2 changed files with 73 additions and 1 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

1
rtl/updatedAppleI/. ..
View File

@ -1 +0,0 @@

73
rtl/updatedAppleI/README.md Normal file
View File

@ -0,0 +1,73 @@
## What´s updated?
I have updated some files:
- ram.v -> Adding the "loader" or "cassette loader" based on a predefined order of programs in "/progs_apple/programs.HEX"
- PS/2 and USB keyboard use the same codification, and worked
- Code to use board's display in"display.v"
- Code to make a "circular array" for 10 programs (from 0 to 9) and show in the display
## Why I made this update?
Basically it my Final Proyect for Computer Science Degree in ETSISI,UPM,Madrid,Spain
Also, the are some things as the loader or the USB keyboard, and it's nice to add some of them
## How works the display?
![display schema]()
It's made of 4 digit of 7 segments each, so 32 bits for correct display of each "acronim of a program"
With a circular array, you can shift both ways, and could load on memory with a button.
###### More Easy!
## Which programs can work?
In the folder "/progs_apple/" you have a file "programs.hex", Its used to combine all codes in an unique file.
Verilog and Xilinx ISE are a bit "delicated" using various files to the same job.
Additionally, in the folder "/progs_apple/Hex/" there are all the Hex or ".bin" files. All tested in this project and working. The order used is the next:
Due to some 'not-availability' of some 7 segments characters, I used similiars 'graphically'.
Block 0 of 3 Block Memory
0.nUL : Program "Null", erases all the RAM. No execution
1.A30 : Program "Apple 30th", Apple I's Graphic Demo. Executes with 280R
2.hEL : Program "Hello World", as the name indicates, print a "Hello World!". Executes with 280R
3.LUn : Program "Lunar Lander", land a Lunar Module on the Moon. Executes with 300R
4.HEH : Program "Memory Test", test the first addreses of the memory (h00-hFF). Executes with 280R and requires execute "01: 05 0 10" before execution
5.uCh : Program "MicroChess", working microchess of the Apple I. Executes with 1000R
6.PAS : Program "Pasart", Don't know the meaning, something about "Matrix Art". Executes with 300R
7.St1 : Program #1 "Star Trek", Text adventure from Star Trek. Load "pre-280" addresses.
8.St2 : Program #2 "Star Trek", Text adventure from Star Trek. Load "post-280" addresses. Executes with BASIC (>E2B3R)
9.Lto : Program "Little Tower", Text adventure in a tower. Not work propperly despite the same code as original (memory perhaps). Executes with 300R
Block 1 of 3 Block Memory
0.bJ1 : Program #1 "BlackJack", BlackJack or 21 game. Load "pre-280" addresses.
1.bJ2 : Program #2 "BlackJack", BlackJack or 21 game. Load "post-280" addresses. Executes with BASIC (>E2B3R)
2.Ck1 : Program #1 "Checkers", Checkers game, more visual than Chess. Load "pre-280" addresses.
3.Ck2 : Program #2 "Checkers", Checkers game, more visual than Chess. Load "post-280" addresses. Executes with BASIC (>E2B3R)
4.hA1 : Program #1 "Hamurabi", Hamurabi game about strategy. Load "pre-280" addresses.
5.hA2 : Program #2 "Hamurabi", Hamurabi game about strategy. Load "post-280" addresses. Executes with BASIC (>E2B3R)
6.Ht1 : Program #1 "Matrix", Visual Effect similar to the movie Matrix, characters "falling" on screen. Load "pre-280" addresses.
7.Ht2 : Program #2 "Matrix", Visual Effect similar to the movie Matrix, characters "falling" on screen. Load "post-280" addresses. Executes with BASIC (>E2B3R)
8.SL1 : Program #1 "Slots", Slots game. Load "pre-280" addresses.
9.SL2 : Program #2 "Slots", Slots game. Load "post-280" addresses. Executes with BASIC (>E2B3R)
Block 2 of 3 Block Memory
0.Hon : Program "Monitor", A better version of Wozmon, with some addings as a calculator. Executes with F3DR
1.HP1 : Program #1 "Wumpus", Hunt the Wumpus' game. Load "pre-280" addresses.
2.HP2 : Program #2 "Wumpus", Hunt the Wumpus' game. Load "post-280" addresses. Executes with BASIC (>E2B3R)
3-9: Blank, for new programs.
Block 3 of 3 Block Memory
0-9: Blank, for new programs.
## Use of the board
![board use]()
## Additional Comments
I´m satisfied with this project and thanks for any support or gratitude.