TAQOZ ROM glossary cleanup

bob_g4bby · 2020-07-06 09:29

I'm knocking the glossary of words for TAQOZ ROM into shape and will have some questions as I progress. I don't have P2 hardware at the moment to check stuff. I do have the ROM listing and the Tachyon glossary.

Question: When TAQOZ ROM is started from cold is the list produced by WORD shown under "Getting Started" correct for a real P2 chip -

I've been checking the glossary at the bottom and, naturally enough, there are many words included that shouldn't be there and roughly the same that should be there. If someone could post the WORD list, I'd be grateful.

Publison · 2020-07-06 11:24

Here is the list from my P2ES Rev B

TAQOZ# WORDS ---
DUP OVER SWAP ROT -ROT DROP 3RD 4TH 2DROP 3DROP NIP 2SWAP 2DUP ?DUP AND
ANDN OR XOR ROL ROR >> << SAR 2/ 2* 4/ 4* 8<< 16>> 8>> 9<< 9>> REV |< >|
>N >B >9 BITS NOT = <> 0= 0<> 0< < U< > U> <= => WITHIN DUPC@ C@ W@ @ C+!
C! C@++ W+! W! +! ! BIT! SET CLR SET? 1+ 1- 2+ 2- 4+ + - UM* * W* / U/
U// // */ UM// C++ C-- W++ W-- ++ -- RND GETRND SQRT SETDACS ~ ~~ W~ W~~
C~ C~~ L>S >W L>W W>B W>L B>W B>L MINS MAXS MIN MAX ABS -NEGATE ?NEGATE
NEGATE ON TRUE -1 FALSE OFF GOTO IF ELSE THEN BEGIN UNTIL AGAIN WHILE REPEAT
SWITCH CASE@ CASE= CASE> BREAK CASE ADO DO LOOP +LOOP FOR NEXT ?NEXT I
J LEAVE IC@ I+ BOUNDS H L T F R HIGH LOW FLOAT PIN@ WRPIN WXPIN WYPIN RDPIN
RQPIN AKPIN WAITPIN WRACK PIN @PIN ns PW PULSE PULSES HILO DUTY NCO HZ
KHZ MHZ MUTE BLINK PWM SAW BIT BAUD TXD RXD TXDAT WAITX WAITCNT REBOOT
RESET 0EXIT EXIT NOP CALL JUMP >R R> >L L> !SP DEPTH COG@ COG! LUT@ LUT!
COGID COGINIT COGSTOP NEWCOG COGATN POLLATN SETEDG POLLEDG KEY WKEY KEY!
CON NONE COM CONKEY CONEMIT SEROUT EMIT EMITS CRLF CR CLS SPACE SPACES
RAM DUMP: DUMP DUMPW DUMPL DUMPA DUMPAW QD QW DEBUG lsio COG LUT KB MB
M . PRINT .AS .AS" .DECL .DEC4 HOLD #> <# # #S <D> U. .DEC .BIN .H .B .BYTE
.W .WORD .L .LONG .ADDR PRINT$ LEN$ " ." CTYPE ?EXIT DATA? ERASE FILL CMOVE
<CMOVE s ms us CNT@ LAP LAP@ .LAP .ms HEX DEC BIN .S WORDS @WORDS GET$
SEARCH $># @DATA HERE @HERE @CODES uemit ukey char delim names TASK REG
@WORD SPIN | || , [W] ["] NULL$ $! $= ASM FORGET CREATE$ CREATE VAR pub
pri pre : ; [ ] ' := ==! ALIGN DATCON ALLOT org bytes words longs byte
word long res [C] GRAB NFA' CPA CFA \ --- ( { } IFNDEF IFDEF TAQOZ TERM
AUTO SPIRD SPIRDL SPIWB SPICE SPIWC SPIWW SPIWM SPIWL SPIPINS SPIRX SPITXE
SPITX WAIT CLKDIV RCSLOW HUBSET WP WE CLKHZ ERROR SFPINS SF? SFWE SFINS
SFWD SFSID SFJID SFER4 SFER32 SFER64 SFERASE SFWRPG BACKUP RESTORE SFRDS
SFWRS SFC@ SFW@ SF@ SF .SF SDBUF sdpins MOUNT DIR !SD !SX SD? CMD ACMD
cid SDWR SDRDS SDWRS FLUSH FOPEN FLOAD FGET FREAD FWRITE SECTOR SDRD SDRDS
SDADR SD@ SD! SDC@ SDC! SDW@ SD @FAT @BOOT @ROOT fat END 432 ok
TAQOZ#

Peter Jakacki · 2020-07-06 11:38

Have a look at the ROM listing as that is probably the best place to find all the words and what they do. Don't worry about the slightly different version, just look at ROM_Booter_v33_01h.lst for instance and go down to the dictionary section and there are all the words there. You can then track them back to where they are defined, for the definitive defintion

{ *** DICTIONARY *** }
ff466                      orgh
ff466              romdict
                            ''      CNT,NAME,ATR,addr16
ff466     50554403         byte 3,         "DUP"
ff46a     0073             word DUP
ff46c     45564f04         byte 4,         "OVER"
ff471     0077             word OVER
ff473     41575304         byte 4,         "SWAP"
ff478     007e             word SWAP

bob_g4bby · 2020-07-06 16:06

Thanks chaps, that's made it clear. I've some pruning and adding to do - just wanted to make sure I was starting from current

bob_g4bby · 2020-07-21 14:04

Calling all TAQOZians,

I have included all 432 words in the ROM glossary now
I could do with any help you can give to fill in the blanks / fix errors in the tables. Please use the 'suggestions' feature in the above googledoc and I promise to review all within a day or so ( but not trivia like formatting / fonts etc. )

I'd like the glossary to be complete and accurate before the P2 is finally released in December - it's a 'thank you' to Peter for giving us TAQOZ for free and also Parallax will need professional documentation for TAQOZ, of which this would be a part.

Thanks in anticipation, Bob

Publison · 2020-07-21 14:55

Bob. thanks for all the efforts!

Peter Jakacki · 2020-07-22 00:38

Thanks Bob, I started to fill some extra stuff in there last night. I hadn't realized you were adding this to the into doc. I think maybe I should split this off into its own document and leave a link to it instead?

Here is the link to the glossary itself which I am tidying up. Here's a link to the pubdoc version, the one that is non-editable and does not sign-ins etc and is refreshed shortly after changes are made to the master doc.

bob_g4bby · 2020-07-22 08:05

Many thanks for your editing, Peter, much appreciated. I was given editing rights to the TAQOZ web site - I assumed that was so I could edit the glossary there. Putting a link in there to a separate glossary makes sense, as the TAQOZ web page is very long. I'll leave that to you.

So OK on splitting off the glossary by itself. I've requested editing rights to that. A lot of what remains is to do with words that haven't any comments in the listing so it becomes quite slow working out what the words do, by stepping through them. Hence the call for help.

I'll keep going on the obvious words - the printing words for instance, which are normal forth.

The magnetic loop controller in flashforth was successful, my pal now has a fully working antenna. I'm making a P1 with an sd card on some veroboard to try out Tachyon for real. Bluetooth or usb serial link, everything is in sockets.

TAQOZ ROM glossary cleanup

Comments