7+(:22.

,(86(5·6
0$18$/

6XEPLWWHGWR'U%DUQLFNL
6XEPLWWHGE\&6*URXS
.DOOH$QGHUVRQ
-DVRQ%XWWURQ
3DXO&ODUNH
0DWW(QZDOG
'DWH6XEPLWWHG)HE
INTRODUCTION ................................................................................................................... 3
Loading an S19 file..................................................................................................................................... 3
Executing the S19 file................................................................................................................................. 3
Stepping through code ............................................................................................................................ 3
Main Registers ............................................................................................................................................ 4
Viewing the main registers ..................................................................................................................... 4
Modifying the main registers .................................................................................................................. 4
Memory....................................................................................................................................................... 4
Viewing any memory.............................................................................................................................. 4
Setting any memory ................................................................................................................................ 5
Adding a memory watch for any address................................................................................................ 5
Notes on memory watches .................................................................................................................. 5
Adding all the FCB and RMB variables to the memory watch........................................................... 5
Registers.................................................................................................................................................. 5
Ports ............................................................................................................................................................ 5
Viewing the state of a port ...................................................................................................................... 6
Notice.................................................................................................................................................. 6
Toggling the state of a pin....................................................................................................................... 6
Break Point ................................................................................................................................................. 3
,1752'8&7,21
7KH:RRNLHZDVFUHDWHGWRKHOSWKH0RWRURODDVVHPEO\SURJUDPPHUGHEXJDQG
WHVWSURJUDPVPRUHHDVLO\DQGFRQYHQLHQW%HFDXVHWKH:RRNLHUXQVZLWKRXWDQ\
H[WHUQDOKDUGZDUHWKHSURJUDPPHUKDVQRH[WHUQDOGHSHQGHQFLHVRUKDUGZDUH
FRQQHFWLRQSUREOHPV
7KLVPDQXDOGHVFULEHVWKHEDVLFRSHUDWLRQRIWKH:RRNLHXVHULQWHUIDFH0RUH
GHWDLOHGKHOSFDQEHIRXQGLQWKHRQOLQHKHOSIRUWKH:RRNLHDSSOLFDWLRQ

/2$',1*$16),/(
&OLFNRQ)LOHDQG/RDGVILOHWRRSHQWKH0LFURVRIW:LQGRZV2SHQFRPPRQGLDORJ
ER[7KHGHIDXOWILOHW\SHLV6EXWWKH/67ILOHPXVWDOVREHSUHVHQWLQWKHVDPH
GLUHFWRU\DVWKH6ILOH\RXZDQWWRORDG
:KHQDQ6ILOHLVVHOHFWHGWKH/67ILOHZLOOEHORDGHGLQWRWKHFRGHYLHZEHORZWKH
PDLQGLDORJ7KH6HW+&0RGHZLQGRZDOVRDSSHDUV2QHRIWKHIROORZLQJFKRLFHV
PXVWEHVHOHFWHG%ULHIFDVH5XJ:DUULRU%RRWVWUDSRU5XJ:DUULRU([SDQGHG7KH
VWDUWDGGUHVVLVWKHVWDUWYDOXHIRUWKHSURJUDPFRXQWHU7KHGHIDXOWYDOXHLQWKLV
ZLQGRZFRPHVIURPWKH25*VWDWHPHQWLQWKH/67ILOH

&/26,1*7+(6),/(
7RFORVHWKH6ILOHVHOHFW&ORVHIURPWKH)LOHPHQX7KLVZLOOFOHDUWKH/67ILOHIURP
WKHFRGHYLHZLQJDUHD7KLVZLOOQRWHUDVHWKHSURJUDPWKDWLVORDGHGLQPHPRU\DQG
WKHSURJUDPPD\VWLOOEHH[HFXWHG

(;(&87,1*7+(352*5$0
7KHFXUUHQWOLQHWKDWWKHSURJUDPFRXQWHUSRLQWVWRLVDOZD\VKLJKOLJKWHGLQWKH/67ILOH
YLHZ7KH+&FDQEHH[HFXWHGLQWZRGLIIHUHQWZD\VVWHSSLQJDQGUXQQLQJDWIXOO
VSHHG

5XQQLQJD3URJUDPDW)XOO6SHHG
7RUXQWKH+&DWIXOOVSHHGFOLFNWKHUHGOLJKWEXWWRQLQWKHPDLQLQWHUIDFH7KH
OLJKWZLOOWXUQJUHHQDQGWKH:RRNLHZLOOEHUXQQLQJDWDERXWôVSHHGRIWKH
UHDO+&PLFURSURFHVVRU&OLFNWKHEXWWRQDJDLQWRVWRSWKHVLPXODWRU7KH
FXUUHQWOLQHRIFRGHWKDWWKHSURJUDPFRXQWHULVRQZLOOEHKLJKOLJKWHGLQWKH/67
YLHZ2WKHUZD\VWRVWDUWDQGVWRSWKHVLPXODWRUDUHE\SUHVVLQJWKH*NH\RUXQGHU
6LPXODWRUDQG6LPXODWRU6WDUW6WRSIURPWKHPHQX

6HWWLQJ%UHDN3RLQWV
7RVHWDEUHDNSRLQWLQWKH/67ILOHVRWKDWWKHVLPXODWRUZLOOVWRSZKHQWKHSURJUDP
FRXQWHUUHDFKHVWKHEUHDNSRLQWDGGUHVVVLPSO\HQWHUWKHYDOXHIRUWKHEUHDNSRLQW
LQWKHEUHDNSRLQWWH[WER[LQWKHPDLQLQWHUIDFH7KHYDOXHVKRXOGEHLQKH[WR
 PDWFKWKHYDOXHRIWKHDGGUHVVLQWKHVHFRQGFROXPQRIWKH/67ILOH7KLVWRROLV
YHU\KHOSIXOLIWKHEUHDNSRLQWLVVHWLQVLGHDQLQWHUUXSW

6WHSSLQJ7KURXJKD3URJUDP
7RVWHSWKHSURJUDPFRXQWHUWKURXJKWKHFRGHRQHLQVWUXFWLRQDWDWLPHHLWKHUFOLFN
WKHZDONLQJPDQEXWWRQXQGHUWKHOLJKWEXWWRQLQWKHPDLQLQWHUIDFHSUHVVWKH
VSDFHEDURUVHOHFW6LPXODWRUDQG6LPXODWRUVWHSXQGHUWKHPHQX7KHKLJKOLJKWHG
OLQHLQWKH/67YLHZZLOOEHDXWRPDWLFDOO\XSGDWHGIRUHDFKVWHS

&385(*,67(56
7KH&38UHJLVWHUVRIWKH:RRNLHDUHDFFXPXODWRU$$&&$DFFXPXODWRU%
$&&%DFFXPXODWRU'$&&'LQGH[UHJLVWHU;,;LQGH[UHJLVWHU<,<VWDFNSRLQWHU
63SURJUDPFRXQWHU3&DQGFRQGLWLRQFRGHUHJLVWHU&&5

9LHZLQJWKH&385HJLVWHUV
7RYLHZWKHDFFXPXODWRUVDQGPLFURFRQWUROOHUXQLWUHJLVWHUVFOLFNRQWKH0&8
EXWWRQLQWKHPDLQLQWHUIDFH$SRSXSZLQGRZFRQWDLQLQJWKH$&&$$&&%$&&'
,;,<633&DQGWKH&&5LVGLVSOD\HG1RWLFHWKDWDOOWKHRWKHUIXQFWLRQVFDQVWLOO
EHSHUIRUPHGIURPWKHWRROEDURUPDLQLQWHUIDFHZKLOHWKLVZLQGRZLVRSHQ7KH
YDOXHVIRUWKHUHJLVWHUVDUHXSGDWHGZKHQWKHVLPXODWRULVVWHSSHGRUVWRSSHG

0RGLI\LQJWKH&385HJLVWHUV
7RFKDQJHWKHYDOXHRIDUHJLVWHUILUVWFOLFNRQLWVQDPHVRWKDWLWVKLJKOLJKWHG
7KHQFOLFNRQWKH0RGLI\EXWWRQLQWKH0&8ZLQGRZ6HOHFWWKHSURSHUEDVHDQG
HQWHUWKHQHZYDOXHLQWKHWH[WER[1RWLFHWKDWZKHQDQHZEDVHLVVHOHFWHGWKH
YDOXHLQWKHWH[WER[LVDXWRPDWLFDOO\FRQYHUWHGWRWKHQHZEDVH&OLFN2.ZKHQ
ILQLVKHG

0(025<
7KHPHPRU\PDSRIWKH:RRNLHKDVDUDQJHRIDQ\DGGUHVVIURPWR))))
7KHIROORZLQJVHFWLRQGHVFULEHVWKHYDULRXVZD\VWRYLHZDQGPRGLI\PHPRU\ORFDWLRQV

9LHZLQJ0HPRU\
7RYLHZRUVHWWKHFRQWHQWVRIPHPRU\FOLFNRQWKH0HPRU\EXWWRQLQWKHPDLQ
LQWHUIDFH7KHGLDORJZLQGRZWKDWLVGLVSOD\HGZLOODOORZERWKYLHZDQGPRGLI\
RSHUDWLRQV,IWKH'LVSOD\0HPRU\UDGLREXWWRQLVVHOHFWHGWKHQWKHPHPRU\
VWDUWLQJDWWKHVWDUWDGGUHVVEDVHGHWHUPLQHGE\WKHQXPHULFEDVHLVGLVSOD\HGLQ
WKHPHPRU\WH[WER[7KHQXPEHURIE\WHVGHWHUPLQHVKRZPDQ\E\WHVDIWHUWKH
VWDUWDGGUHVVDUHGLVSOD\HGLQWKH0HPRU\WH[WER[
 6HWWLQJDQ\PHPRU\
,IWKH6HW0HPRU\UDGLREXWWRQLVVHOHFWHGLQWKH0HPRU\ZLQGRZWKHQWKHPHPRU\
VWDUWLQJDWWKHVWDUWDGGUHVVLVVHWWRWKHILUVWE\WHRIPHPRU\LQWKH0HPRU\WH[W
ER[7KHYDOXHLQWKH1XPEHURI%\WHVWH[WER[GHWHUPLQHVKRZPDQ\VXFFHHGLQJ
E\WHVDIWHUWKHVWDUWDGGUHVVDUHDOVRVHWWRWKHILUVWE\WHRIWKHPHPRU\LQWKH
0HPRU\WH[WER[

$GGLQJD0HPRU\:DWFK
&OLFNRQWKH0HPRU\:DWFKEXWWRQLQWKHPDLQLQWHUIDFH7KH0HPRU\ZDWFKSRS
XSGLDORJZLOODSSHDUDQGFDQEHOHIWRSHQZKLOHRWKHUFRPPDQGVDUHH[HFXWHG
VXFKDVVWHSRUUXQ7RDGGDPHPRU\ZDWFKFOLFNWKH$GGEXWWRQLQWKH0HPRU\
:DWFKZLQGRZ$GGWKHQDPHRI\RXUYDULDEOHDQGWKHDGGUHVVLQKH[,WVQDPH
DGGUHVVDQGFRQWHQWVZLOOEHGLVSOD\HGLQWKH0HPRU\:DWFKZLQGRZXSRQFOLFNLQJ
2.7RFKDQJHWKHYDOXHRIDQ\YDULDEOHLQWKHPHPRU\ZDWFKFOLFNRQWKHQDPHRI
WKHYDULDEOHVRWKDWLWVQDPHLVKLJKOLJKWHGDQGFOLFNRQWKH0RGLI\EXWWRQ7KH
IROORZLQJZLQGRZZLOOGLVSOD\WKHFXUUHQWYDOXHRIWKHYDULDEOHLQLWVWH[WER[LQWKH
EDVHFRUUHVSRQGLQJWRLWV0HPRU\:DWFKEDVH6HOHFWWKHSURSHUEDVHDQGHQWHUWKH
QHZYDOXH1RWLFHWKDWWKHQXPEHULQWKHWH[WER[ZLOODXWRPDWLFDOO\EHFRQYHUWHG
ZKHQDQHZEDVHLVVHOHFWHG&OLFN2.WRFKDQJHWKHYDOXHRIWKHYDULDEOHWRWKH
FRQWHQWVRIWKHWH[WER[

1RWHVRQ0HPRU\:DWFKHV
7KHRQO\WLPHWKHYDOXHVRIWKHYDULDEOHVDUHXSGDWHGLVZKHQWKHVLPXODWRULV
VWRSSHGRUVWHSSHG7RXSGDWHWKHYDOXHVZKLOHWKHVLPXODWRULVUXQQLQJFOLFN
RQWKH8SGDWHEXWWRQ7RGHOHWHDPHPRU\ZDWFKIURPWKHGLVSOD\FOLFNRQWKH
QDPHRIWKHYDULDEOHDQGWKHQFOLFNWKH'HOHWHEXWWRQ7RWRJJOHWKHEDVHRIWKH
YDOXHRIDOOWKHYDULDEOHVDPRQJKH[GHFLPDODQGELQDU\FOLFNWKH%DVHEXWWRQ

$GGLQJDOOWKH)&%DQG50%YDULDEOHVWRWKHPHPRU\ZDWFK
7RDXWRPDWLFDOO\DGGDOOWKH)&%RU50%YDULDEOHVLQWKH/67ILOHWRWKH0HPRU\
:DWFK&OLFN7RROVDQG$GG5PEZDWFKHVIURPWKHPHQX7KH0HPRU\:DWFK
ZLQGRZPXVWEHRSHQWRSHUIRUPWKLVIXQFWLRQ

5(*,67(56
7RYLHZWKHYDOXHVRIWKHUHJLVWHUVLQPHPRU\IURPWR)FOLFNWKH5HJLVWHUV
EXWWRQ7KH5HJLVWHU:DWFKZLQGRZKDVWKHVDPHIXQFWLRQDOLW\DVWKH0HPRU\:DWFK
ZLQGRZ7KHIXQFWLRQVDUHWKHVDPHDVWKH0HPRU\:DWFKZLQGRZH[FHSWWKH$GGDQG
'HOHWHEXWWRQVDUHQRWDYDLODEOH$OOWKHUHJLVWHUVDUHDOUHDG\GLVSOD\HG,IRWKHU
DGGUHVVHVQHHGWREHDGGHGWRWKHOLVWXVHWKH0HPRU\:DWFKZLQGRZ

32576
7KHIROORZLQJVHFWLRQGHVFULEHVKRZWRYLHZDQGFKDQJHWKHVWDWHRIDQ\RIWKH,2
3RUWV
9LHZLQJWKH6WDWHRID3RUW
7RYLHZDSRUWFOLFNRQWKHFRUUHVSRQGLQJ3RUWEXWWRQLQWKHPDLQLQWHUIDFHDUHD
)RUH[DPSOHWRGLVSOD\WKHVWDWHRI3RUW$FOLFNRQWKH3RUW$EXWWRQ7KH3RUW$
ZLQGRZZLOODSSHDUZLWKHLJKW/('VDQGLWVKH[YDOXH$EULJKWUHG/('LQGLFDWHVD
KLJKVWDWHRQWKHSLQDQGFRQYHUVHO\DGDUN/('UHSUHVHQWVDORZVWDWHRQWKHSLQ
7KLV3RUWZLQGRZLVDSRSXSGLDORJZLQGRZVRRWKHUIXQFWLRQVFDQEHH[HFXWHG
ZKLOHWKHZLQGRZUHPDLQVRSHQ7KHVWDWHZLOODXWRPDWLFDOO\EHXSGDWHGGXULQJ
ERWKWKHVLPXODWRUVWHSDQGVLPXODWRUUXQIXQFWLRQV

1RWLFH
,IWKH/('LVGHVLUHGWREHDFWLYHRQDORZVLJQDOSUHVVLQJWKH$FWLYDWH/RZ
EXWWRQZLOOUHYHUVHWKHOLJKWLQJRIWKH/('V,QYHUVHO\LIWKH/('VDUHDFWLYHORZ
DQGWKH\DUHGHVLUHGWREHDFWLYHRQDKLJKVLJQDOSUHVVWKH$FWLYH+LJKEXWWRQ
WRUHYHUVHWKHOLJKWLQJRIWKH/('V

7RJJOLQJWKH6WDWHRID3LQ
7RWRJJOHWKHVWDWHRIDSLQFOLFNRQLWV/('DQGWKHYDOXHZLOODXWRPDWLFDOO\FKDQJH
7KLVFDQEHGRQHZKHWKHUWKHVLPXODWRULVUXQQLQJRUVWRSSHG