MAX-IDE入門

設(shè)置JTAG接口

圖1顯示了串口-JTAG適配器(包含于所有MAXQ微控制器評(píng)估板中)是如何連接PC串行COM口和MAXQ微控制器的JTAG口的。

圖1. 用于MAXQ的串口-JTAG接口。

JTAG接口信號(hào)和電纜
JTAG適配器通過10芯帶狀電纜和2 x 5、0.100"間距的接插件與MAXQ評(píng)估板連接。該電纜傳輸?shù)男盘?hào)列在下面表1中。

表1. JTAG接口信號(hào)

連接評(píng)估板

表2. 評(píng)估板設(shè)置

1. 如上所述將電源接到JTAG適配板。
2. 如上所述設(shè)置評(píng)估板和JTAG適配板的跳線?？赡苓€需要根據(jù)評(píng)估需要設(shè)置評(píng)估板上其他的跳線或者DIP開關(guān)；更詳細(xì)的信息請參考評(píng)估板數(shù)據(jù)資料。
3. 連接2 x 5 10芯帶狀電纜到JTAG適配板上的P2插座和評(píng)估板上的對應(yīng)插座。連接器僅能從一個(gè)方向連接；否則，請確定紅線連接至兩個(gè)插座相同編號(hào)的引腳。
4. 使用直通串行電纜將JTAG適配板上的J1連接至PC COM端口。
5. 打開所有電源。

在MAX-IDE中建立項(xiàng)目

1. 從MAX-IDE菜單選擇Device MAXQ JTAG。
2. 選擇Project New Project。建立一個(gè)未命名的項(xiàng)目。
3. 選擇Project Save Project As。選擇您希望保存項(xiàng)目(.prj 文件)的位置。
4. 要建立一個(gè)新的匯編代碼文件，可選擇File New File。在文件中輸入?yún)R編代碼后，選擇File Save As，在你的項(xiàng)目目錄下保存新建立的.asm文件。下一步，選擇Project Add Files，選擇新建的文件，加入到項(xiàng)目中。
5. 要將已有的匯編代碼文件加入到項(xiàng)目中，選擇Project Add Files，然后選擇要加入的文件。
6. 不必將包含文件加入到項(xiàng)目中，匯編過程會(huì)自動(dòng)讀入包含文件。

$include (..\api\maxQ2000.inc)

org 0000h

main:
    jump  $

end

關(guān)于匯編和包含文件的說明

• 全體MAXQ微控制器共有的系統(tǒng)寄存器(例如累加器、數(shù)據(jù)指針和循環(huán)控制寄存器)已在MAX-IDE匯編器中進(jìn)行了預(yù)定義。外設(shè)寄存器因器件而異，必須在包含文件中定義。用于各種MAXQ微控制器的標(biāo)準(zhǔn)包含文件隨MAX-IDE一起被安裝；上例中的包含文件是用于MAXQ2000的。
• 預(yù)處理偽指令(例如等同、定義和宏)不會(huì)在一個(gè)項(xiàng)目內(nèi)的不同文件之間傳送。如果一個(gè)MAX-IDE匯編項(xiàng)目含有一個(gè)以上的匯編文件，各匯編文件必須含有它要用到的預(yù)處理偽指令或者文件包含偽指令。
• 不管項(xiàng)目中有多少匯編文件，每個(gè)文件的最后必須有"end"聲明。
• 不要在包含文件中加入"end"聲明。
• 項(xiàng)目中含有多個(gè)匯編文件時(shí)，所有文件中的所有標(biāo)識(shí)符都為公用的；即，任何匯編文件中的代碼都可以調(diào)用或引用同一項(xiàng)目中任何其他匯編文件中的例程或標(biāo)號(hào)。

當(dāng)一個(gè)項(xiàng)目已經(jīng)建立或者打開后，該項(xiàng)目中的匯編代碼文件將被列在左側(cè)的面板上。雙擊文件名可以將其打開，以便在MAX-IDE中進(jìn)行編輯，如下面的圖3所示。

圖3. MAX-IDE項(xiàng)目環(huán)境

運(yùn)行和調(diào)試代碼

運(yùn)行項(xiàng)目
項(xiàng)目被成功編譯后，可以采用以下方法之一，在調(diào)試器中執(zhí)行該項(xiàng)目。

1. 選擇Debug Run (F5)后，編譯后的項(xiàng)目代碼通過JTAG接口被裝入MAXQ微控制器并啟動(dòng)運(yùn)行。程序?qū)⒊掷m(xù)運(yùn)行，直到選擇了Debug Stop (Shift+F5)、點(diǎn)擊Pause按鈕或者程序執(zhí)行到斷點(diǎn)為止。
2. 選擇Debug Step Into (F11)后，編譯后的程序被載入，在源代碼的第一行暫停程序執(zhí)行。
3. 選擇Debug Run to Cursor (Control+F10)后，編譯后的程序被載入，并開始運(yùn)行，直到程序運(yùn)行到編輯窗口中光標(biāo)所在的行，或者遇到斷點(diǎn)，先到者為準(zhǔn)。如果光標(biāo)不在源代碼行上，選擇該選項(xiàng)將導(dǎo)致錯(cuò)誤。

• 將光標(biāo)移到您希望建立斷點(diǎn)的行，選擇Debug Toggle Breakpoint。
• 將光標(biāo)移到您希望建立斷點(diǎn)的行，點(diǎn)擊工具條上的禁行燈圖標(biāo)。
• 在編輯窗口中，單擊您希望建立斷點(diǎn)的行號(hào)。

選擇Debug Stop，或者單擊工具條上的Stop圖標(biāo)，將完全停止程序運(yùn)行。但是，如果停止在第一行(Step Into)、光標(biāo)行(Run to Cursor)或者設(shè)置了斷點(diǎn)的行，接下來還可以使用單步模式運(yùn)行程序。也可以通過單擊Pause按鈕進(jìn)入單步模式。在該模式下，以綠色箭頭標(biāo)志當(dāng)前運(yùn)行所處的位置，可使用下列命令：

• Debug Step Into (F11), Debug Step Over (F10)和Debug Step Out(Shift+F10)，在匯編調(diào)試模式下，這些命令的作用相同，即執(zhí)行單個(gè)指令，將執(zhí)行點(diǎn)轉(zhuǎn)至下一指令。
• Debug Run，從當(dāng)前位置開始運(yùn)行，直到下一個(gè)斷點(diǎn)，如上所述。
• Debug Run To Cursor，從當(dāng)前位置開始運(yùn)行，直到光標(biāo)所在的行，如上所述。

顯示和編輯處理器寄存器
程序裝入并執(zhí)行了至少一條指令后，就可以利用調(diào)試器來查看和編輯MAXQ微控制器的寄存器。選擇Window Show Registers 將顯示寄存器組。隨著調(diào)試器中代碼的執(zhí)行，這些寄存器中的數(shù)值將隨之更新。雙擊可寫寄存器的數(shù)值區(qū)可以對其進(jìn)行編輯，可以輸入十六進(jìn)制、十進(jìn)制或二進(jìn)制的新值。

使用MAXQ2000評(píng)估板時(shí)應(yīng)注意：如果裝配了LCD子板，不要手動(dòng)編輯PO0, PD0, PO1, PD1, PO2, PD2, PO3或者PD3寄存器的值。當(dāng)帶有LCD時(shí)，這些引腳上的靜態(tài)輸出會(huì)損壞LCD。

顯示和編輯處理器存儲(chǔ)器
程序裝入并至少執(zhí)行一條指令后，就可以查看和編輯MAXQ微控制器的內(nèi)部存儲(chǔ)器了。選擇Window Show Memory 將顯示內(nèi)部存儲(chǔ)器。通過顯示窗口中的下拉列表，你可以選擇查看代碼、數(shù)據(jù)或者堆棧存儲(chǔ)器。代碼和堆棧區(qū)用16位寬顯示，數(shù)據(jù)區(qū)用8位寬顯示。數(shù)據(jù)和堆棧區(qū)的存儲(chǔ)器值可以編輯，雙擊某個(gè)存儲(chǔ)器位置并輸入新值即可。

使用MAX-IDE匯編器

有關(guān)如何使用宏以及其他預(yù)處理偽指令的舉例，請參考'Macro'實(shí)例項(xiàng)目。

一般語法
MAXQ匯編器和預(yù)處理器均對大小寫不敏感。匯編語句遵循以下格式：

[label:]   [opcode   [parameter [, parameter]]]    [;comment]

main:
move   Acc, A[2]             ; copy A[2] to active accumulator

請參考MAXQ系列用戶指南，了解MAXQ微控制器系列的體系結(jié)構(gòu)、指令集、尋址模式和核心寄存器的詳細(xì)說明。

源文件
項(xiàng)目編譯時(shí)，MAX-IDE項(xiàng)目窗口列出的所有匯編源文件(.asm)將按照窗口中文件列出順序進(jìn)行匯編。沒有提供鏈接器，因此，在匯編多個(gè)文件時(shí)，就如同它們被合并到單個(gè)文件中進(jìn)行匯編一樣。

源文件可以包含偽指令、等同/定義、宏、條件匯編模塊和聲明等。任何源代碼文件的最后一行必須為END偽指令：

end

(source file):                        (equates.inc):
$include(equates.inc)        --->     MASK1  equ  0FFh
                                      MASK2  equ  0FEh
(resume parsing in source    <---
file)

MAX-IDE為每種MAXQ微控制器提供標(biāo)準(zhǔn)包含文件，在其中定義了該類微控制器的外設(shè)寄存器組，以及應(yīng)用ROM所提供函數(shù)的地址。這些包含文件可用于所有匯編語言項(xiàng)目；它們位于MAX-IDE主安裝目錄的Examples子目錄中。

常數(shù)
語句或等同說明中作為立即數(shù)的常數(shù)可以采用以下四種格式之一。

• 十進(jìn)制(默認(rèn))―以非字符或'd'結(jié)尾。例如：10, 07d
• 二進(jìn)制―以'b'結(jié)尾。例如：01b, 1101101b
• 十六進(jìn)制―以0-9數(shù)字開始，以'h'結(jié)尾。例如：10h, 09FFEh
• 單字符―轉(zhuǎn)換為一個(gè)字節(jié)的ASCII值。例如：'A'

   move    Acc, #(1+1)         ; 2 : Addition
   move    Acc, #(4-1)         ; 3 : Subtraction
   move    Acc, #(2*2)         ; 4 : Multiplication
   move    Acc, #(25/5)        ; 5 : Division (truncated to integer)

   move    Acc, #(MIN(6,7))    ; 6 : Minimum of two values
   move    Acc, #(MAX(6, 7))   ; 7 : Maximum of two values
   move    Acc, #'A'           ; ASCII value of 'A'

   move    Acc, #(550h | 055h) ; 555h  : Logical OR
   move    Acc, #(550h & 055h) ; 050h  : Logical AND
   move    Acc, #(550h ^ 055h) ; 505h  : Logical XOR
   move    Acc, HIGH(#1234h)   ; 12h   : Select high byte of word
   move    Acc, LOW(#1234h)    ; 34h   : Select low byte of word
   move    Acc, NOT(#0000h)    ; FFFFh : Bitwise negation
   move    Acc, #001h << 7     ; 080h  : Shift left
   move    Acc, #080h >> 7     ; 001h  : Shift right

ONE equ 01
TWO equ 02

   move    Acc, #ONE
   move    Acc, #(ONE+TWO)

ONE equ 01
TWO equ ONE+ONE

#define PO[0] M0[0]

move    Acc, PO[0]           ; Parses as 'move Acc, M0[0]'

db   055h, 0AAh, 055h, 0AAh    ; byte values
dw   0AAAAh, 05555h            ; word values
db   "MAX-IDE Environment "    ; byte value for each char (padded to even count)

條件匯編
只有符合某些布爾條件時(shí)，才對某塊代碼進(jìn)行匯編。具有以下格式。

IF ()
   statements
   ...
ENDIF

DEBUG equ 0
DOINC equ 1

IF (DEBUG != 0)
   call RoutineDbg
ENDIF

IF (DEBUG = 0)
   call Routine
ENDIF

IF (DOINC = 1)
$include(defines.inc)
ENDIF

 MACRO [[PARAM ] [whitespace AND/OR comma] [] ...]
[LOCAL  [whitespace AND/OR comma] [] ...]

...
ENDM

ThreeNops MACRO
   nop
   nop
   nop
ENDM

ThreeNops        -->      nop
                          nop
                          nop

Inc MACRO PARAM Register
   push    Acc
   move    Acc, Register
   add     #1
   move    Register, Acc
   pop     Acc
ENDM

Inc LC[0]        -->         push Acc
                             move Acc, LC[0]
                             add  #1
                             move LC[0], Acc
                             pop  Acc

LoopN MACRO PARAM Count
LOCAL L1
   move    LC[0], Count
L1:
   djnz    LC[0], L1
ENDM