Suggestions for improving the README

[danboid]

Hi Andrew

Thanks for writing pi-eeprom-programmer, it sounds like it should be very useful, if I understood how to wire it up!

There are two problems with the README, the first is minor and easily fixed. The first line of the installation instructions is:

git clone [email protected]:andrewteall/pi-eeprom-programmer.git

I'm pretty sure that command will only work for you as the owner of the repo so that line should be changed to:

git clone https://github.com/andrewteall/pi-eeprom-programmer.git

Which will work for everyone with git and an internet connection.

My main problem is that I cannot make any sense of the circuit info. The circuit info would be much better presented in markdown table format to make it easier to read:

https://www.codecademy.com/resources/docs/markdown/tables

More importantly, what do these tables mean? For example, I presume:

I/O3 -> GPIO2 (3)

Means that I'll need to find the datasheet for my EEPROM to find which pin on my EEPROM is I/O3 then connect that to GPIO2, which is GPIO pin 3 right? Because you have notated it like this I can only presume that the pinout for every 28 pin EEPROM is different which is why you don't tell us which pins on the IC connect to specific GPIO pins? I think you should at least explain this and maybe also link to the datasheets for some popular EEPROMS too maybe?

In my case I have some Winbond W27C512 EEPOMS that I want to flash the Atari TOS roms onto. I presume I should be able to do that OK with your program?

Thanks for your help!

EDIT

I've found my datasheet here:

https://mm.digikey.com/Volume0/opasdata/d220001/medias/docus/900/W27C512.pdf

So I'm going to attempt to follow the circuit instructions.

[danboid]

I've failed at the first hurdle.

I've got an RPi4 so its a 40 pin GPIO header.

I'm looking at the pin configuration diagram on p3 of:

https://mm.digikey.com/Volume0/opasdata/d220001/medias/docus/900/W27C512.pdf

I think the README says I need to connect pin I/O3 on the IC to GPIO2 (pin 3 on the GPIO header) but I don't see any mention of I/O3 on the W27C512 pin configuration diagram.

Does this mean I cannot program the W27C512 using your program?