P2 documentation on Google docs
Peter Jakacki
Posts: 10,193
As mentioned in the hub scheme thread I've started a new Google doc page for the instruction set. Anyone with the link can view and at least comment but the whole reason it is done with Google docs is so that it is a live up to the minute document and also so that multiple collaborators can be editing it, even at the same time. I'm hoping that I won't have to go it alone though as there are plenty of other sections that need to be started up separately. Seairth helped last time I did this but I won't be making the mistake of trying to put it all into one document this time, just link them instead. BTW, what happened to him, I haven't seen him on the forums for a while?
P2 instruction set - view and comment link
P2 instruction set - read-only webpage version
You won't be able to edit the document until you click SHARE and request edit permissions. This also requires you to sign in with a Google identity.
Editing is straightforward and has all the usual word processing tools, nothing complicated, in fact a friend's daughter started a job as a fast typist recording workplace agreements live, but they use Google docs so that another person can also fill-in or correct stuff as she types.
So if you are in the know and feel you can contribute then what's holding you back? Let's make this a group effort!
P2 instruction set - view and comment link
P2 instruction set - read-only webpage version
You won't be able to edit the document until you click SHARE and request edit permissions. This also requires you to sign in with a Google identity.
Editing is straightforward and has all the usual word processing tools, nothing complicated, in fact a friend's daughter started a job as a fast typist recording workplace agreements live, but they use Google docs so that another person can also fill-in or correct stuff as she types.
So if you are in the know and feel you can contribute then what's holding you back? Let's make this a group effort!
Comments
I have done a small update to your google docs.
When copying and pasting (just the heading, instruction block and comments before editing them) it is frightfully slow.
Is there any way to quickly add the format for each instruction so they can be edited? Text editing seems to be reasonable.
Depends if you are trying to do this on your ancient XOOM
I just tried editing on my phone, it wasn't too bad but even if the display is full HD it's still only 5.2"!
I have done some editing including an update to ALTDS. I listed a second line for the S bits. Might help explain where some instructions have special purpose bits.
What takes the time is to paste all the instruction blocks in place. Perhaps I will do a big block of them at a time.
Thank you. I can't offer any help on the instruction set, but as a true amateur, I can offer comments.
It is amazing what a few extra words does to clarify an issue. Before you started documenting the instructions, I had no idea if I actually understood what I thought I understood.
As it is, this new instruction set seems about 90% exactly as I expected.
But occasionally I'm still feeling like http://www.youtube.com/watch?v=butZyxI-PRs
The diagram for the memory confabulator (TIMING) needs to become a contest ... I think I understand basically how it all works, but that TIMING diagram does nothing to help me:(
Chip offered the original diagram for experts that understood the general concept as an aid to understanding the actual timing. As a major improvement in functionality over the P1, this mechanism needs pictures and or movies... I know you have asked for assistance... and I think a contest to improve this section might get you some help.
I like the format... but the first time I saw an instruction identifier in bold and the operands in plain text, I wasn't reading across, I was reading down and the operands appeared to have a meaning that it shouldn't. I think the operands need to be in bold type.
Your note on ZCDS is very helpful... but immediately beneath it, ZCMS appears without prior definition.
Thanks.
Rich
I was trying to edit the zcds section better. I have added 5 instruction format blocks.
Would you mind deleting the unused portions of the instructions from each block. ie the first block will just have the 7 "i" bits, the next the ZCI bits, then CCCC, then DDDDDDDDD, then SSSSSSSSS.
Thanks, Ray
I don't need this. See what you think about the general instruction format section.
You will see I have done quite a bit of work around the general instruction format, and added a lot of the instruction format for those that were not done yet. I see you have been very active too. Its been very slow for me as I keep getting java warnings about scripts taking too long.
How do you change the colors of the instruction blocks? I need to change the Z & C bit colors for the DJxx and Jxx instructions.
BTW I've left 2 notes in the docs for you (in pink).
To change the color of a cell or cells just click inside one or select them and go to Table, Table Properties, Cell Background Color, as simple as that. Thanks for the input.
To keep everything concise, is it possible to allow link(s) to outside sources for additional information, discussion and example uses? It (they)would fit nicely right under the SSSSSSSSS field.
At this stage the link could simply read "empty link" and elaborated over time. Maybe a simple "help!!!" button for each instruction, which would link to another document such as this that would do the outside linkages.
Anyway, I thought I'd generate a PDF of it for reference in the meantime.
P16X64A ASSEMBLY MANUAL.pdf
Looks great!
I've got a good feeling this will become a real chip.
All: How could we add a little table to each instruction to simply represent the Z and C flag results for WZ and WC effects?
BTW My iPad Mini Retina works sooooo much better than my Xoom/android on this forum!!! No wonder my wife commandeered it.