MAX-IDE入門

安裝max-ide

系統(tǒng)要求

操作系統(tǒng)：windows 98, windows nt, windows 2000, windows me或者windows xp

至少一個(gè)未用的串行com端口(用于與maxq評(píng)估板通信)，或者一個(gè)usb至串口適配器和一個(gè)未用的usb端口。

運(yùn)行安裝程序

max-ide的安裝包為max-ide.zip，可以從maxq網(wǎng)頁(yè)下載。

下載該安裝包，解壓縮，然后運(yùn)行setup.exe，將max-ide安裝到您的硬盤上。
在installshield對(duì)話框中，選擇典型安裝，安裝評(píng)估板maxq開發(fā)所需要的全部文件。

安裝完成后，可以從開始菜單啟動(dòng)max-ide。

max-ide安裝的文件

max-ide的主執(zhí)行程序和幫助文件位于max-ide根目錄下，默認(rèn)路徑為{program files}max-ide。其他文件在以下子目錄中。

compilers子目錄含有max-ide安裝的所有編譯器和匯編器的可執(zhí)行程序和數(shù)據(jù)文件。至少包含標(biāo)準(zhǔn)maxq匯編器；也可能會(huì)安裝一些其它匯編器和編譯器，和你的獲得渠道有關(guān)。

devices子目錄含有庫(kù)、驅(qū)動(dòng)程序和配置文件，用于將應(yīng)用定位于各種maxq微控制器和評(píng)估板，并完成它們之間的通信。

examples子目錄含有代碼實(shí)例(/xxx_demo)，以及所有maxq微控制器的標(biāo)準(zhǔn)包含文件和庫(kù)(/api)。

設(shè)置jtag接口

jtag適配板

通過(guò)一個(gè)專用的jtag測(cè)試訪問端口(tap)，max-ide與maxq微控制器的引導(dǎo)裝載程序和調(diào)試引擎接口，這個(gè)測(cè)試口符合jtag ieee標(biāo)準(zhǔn)1149。該接口由以下信號(hào)組成(它們通常與端口引腳復(fù)用)：tms (測(cè)試模式選擇)、tck (測(cè)試時(shí)鐘)、tdi (測(cè)試數(shù)據(jù)輸入)和tdo (測(cè)試數(shù)據(jù)輸出)。

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

jtag接口信號(hào)和電纜

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

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

連接評(píng)估板

根據(jù)所采用的評(píng)估板類型，需要對(duì)jtag適配板、評(píng)估板或者兩者供電。此處給出兩個(gè)電路板的簡(jiǎn)要設(shè)置方法(表2)；更詳細(xì)的說(shuō)明請(qǐng)參考評(píng)估板數(shù)據(jù)資料。注意，無(wú)論是jtag適配板還是maxq評(píng)估板，所用的電源均為直流電源，中心為正。

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

使用max-ide時(shí)，請(qǐng)按照以下步驟設(shè)置maxq評(píng)估板和jtag適配板(圖2)：

如上所述將電源接到j(luò)tag適配板。
如上所述設(shè)置評(píng)估板和jtag適配板的跳線。可能還需要根據(jù)評(píng)估需要設(shè)置評(píng)估板上其他的跳線或者dip開關(guān)；更詳細(xì)的信息請(qǐng)參考評(píng)估板數(shù)據(jù)資料。
連接2 x 5 10芯帶狀電纜到j(luò)tag適配板上的p2插座和評(píng)估板上的對(duì)應(yīng)插座。連接器僅能從一個(gè)方向連接；否則，請(qǐng)確定紅線連接至兩個(gè)插座相同編號(hào)的引腳。
使用直通串行電纜將jtag適配板上的j1連接至pc com端口。
打開所有電源。

在max-ide中建立項(xiàng)目

建立一個(gè)新的maxq匯編項(xiàng)目

按照以下步驟，在max-ide中建立一個(gè)新的maxq匯編語(yǔ)言項(xiàng)目：

從max-ide菜單選擇device maxq jtag。
選擇project new project。建立一個(gè)未命名的項(xiàng)目。
選擇project save project as。選擇您希望保存項(xiàng)目(.prj 文件)的位置。
要建立一個(gè)新的匯編代碼文件，可選擇file new file。在文件中輸入?yún)R編代碼后，選擇file save as，在你的項(xiàng)目目錄下保存新建立的.asm文件。下一步，選擇project add files，選擇新建的文件，加入到項(xiàng)目中。
要將已有的匯編代碼文件加入到項(xiàng)目中，選擇project add files，然后選擇要加入的文件。
不必將包含文件加入到項(xiàng)目中，匯編過(guò)程會(huì)自動(dòng)讀入包含文件。

maxq2000的一個(gè)匯編文件實(shí)例如下：

$include (..apimaxq2000.inc)

org 0000h

main:
jump $

end

以上$include行因包含文件的位置而異。關(guān)于$include和org偽指令的詳細(xì)信息，請(qǐng)參考本文檔的“使用max-ide匯編器”一節(jié)。

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

全體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)目?jī)?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)。

打開一個(gè)已有的項(xiàng)目

要打開一個(gè)以前建立的max-ide項(xiàng)目，只需從菜單中選擇project open project，然后選擇你希望打開的.prj文件。注意，如果jtag適配板和評(píng)估板沒有正確連接和上電，打開maxq jtag項(xiàng)目時(shí)可能會(huì)產(chǎn)生錯(cuò)誤信息。

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

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

編譯項(xiàng)目

要編譯項(xiàng)目文件，從菜單中選擇debug make或者debug build all，或者點(diǎn)擊工具條上這些命令的快捷按鈕，或者按下f7 (作用與make相同)。maxq編譯器運(yùn)行，如果沒有錯(cuò)誤，消息窗口中將出現(xiàn)"compiling...build successful."。構(gòu)建過(guò)程中的任何錯(cuò)誤將會(huì)出現(xiàn)在消息窗口中。

運(yùn)行項(xiàng)目

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

選擇debug run (f5)后，編譯后的項(xiàng)目代碼通過(guò)jtag接口被裝入maxq微控制器并啟動(dòng)運(yùn)行。程序?qū)⒊掷m(xù)運(yùn)行，直到選擇了debug stop (shift+f5)、點(diǎn)擊pause按鈕或者程序執(zhí)行到斷點(diǎn)為止。

選擇debug step into (f11)后，編譯后的程序被載入，在源代碼的第一行暫停程序執(zhí)行。

選擇debug run to cursor (control+f10)后，編譯后的程序被載入，并開始運(yùn)行，直到程序運(yùn)行到編輯窗口中光標(biāo)所在的行，或者遇到斷點(diǎn)，先到者為準(zhǔn)。如果光標(biāo)不在源代碼行上，選擇該選項(xiàng)將導(dǎo)致錯(cuò)誤。

斷點(diǎn)用來(lái)使程序運(yùn)行到預(yù)定位置時(shí)暫停下來(lái)，可以采用以下三種方法之一設(shè)置或清除。

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

注意，可以將斷點(diǎn)設(shè)在沒有源代碼的行上，但是這不會(huì)起作用。maxq微控制器支持一次設(shè)4個(gè)斷點(diǎn)；如果選擇run to cursor，這將占用一個(gè)斷點(diǎn)，因此，在這種情況下，只能設(shè)置3個(gè)斷點(diǎn)。

選擇debug stop，或者單擊工具條上的stop圖標(biāo)，將完全停止程序運(yùn)行。但是，如果停止在第一行(step into)、光標(biāo)行(run to cursor)或者設(shè)置了斷點(diǎn)的行，接下來(lái)還可以使用單步模式運(yùn)行程序。也可以通過(guò)單擊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)所在的行，如上所述。

注意，運(yùn)行在匯編語(yǔ)言調(diào)試模式時(shí)，debug菜單下的high-level debug和low-level debug設(shè)置不起作用。

顯示和編輯處理器寄存器

程序裝入并執(zhí)行了至少一條指令后，就可以利用調(diào)試器來(lái)查看和編輯maxq微控制器的寄存器。選擇window show registers 將顯示寄存器組。隨著調(diào)試器中代碼的執(zhí)行，這些寄存器中的數(shù)值將隨之更新。雙擊可寫寄存器的數(shù)值區(qū)可以對(duì)其進(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)帶有l(wèi)cd時(shí)，這些引腳上的靜態(tài)輸出會(huì)損壞lcd。

顯示和編輯處理器存儲(chǔ)器

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

使用max-ide匯編器

max-ide提供一個(gè)多道匯編器，用于開發(fā)maxq匯編語(yǔ)言應(yīng)用程序。該匯編程序含有一個(gè)單道預(yù)處理器，能夠使用包含文件、符號(hào)等式、條件匯編和宏。匯編器和預(yù)處理器完全集成在max-ide環(huán)境中。

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

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

main:
move acc, a[2] ; copy a[2] to active accumulator

標(biāo)志符(例如上面的main標(biāo)號(hào))可以含有字符[a-za-z_?$0-9]，但是不能以0-9數(shù)字開始。其長(zhǎng)度可以達(dá)到127個(gè)字符。

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

源文件

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

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

end

包含文件

不必刻意添加包含(.inc)文件到項(xiàng)目中。它們可以由“include”偽指令自動(dòng)讀入和解析，就如同包含文件的全部文本被加入到源文件中“include”偽指令所在的位置一樣。

(source file): (equates.inc):
$include(equates.inc) ---> mask1 equ 0ffh
mask2 equ 0feh
(resume parsing in source <---
file)

常數(shù)

語(yǔ)句或等同說(shuō)明中作為立即數(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)

等同也可以被后面的等同說(shuō)明引用。

one equ 01
two equ one+one

定義

定義偽指令支持c風(fēng)格的直接文本替換，不需要額外的處理，常用于包含文件中定義外設(shè)寄存器。替換文本被限制為單行；不支持接續(xù)符。不支持c風(fēng)格的宏。

#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)

if ()
statements
...
endif

布爾表達(dá)式可以由常數(shù)、等同或者以下布爾運(yùn)算符組成：=, !=, <, <=, >, 和 >=。在條件匯編代碼塊中只能有代碼和包含語(yǔ)句，而不能有宏或者等同說(shuō)明。

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

最簡(jiǎn)單的一類宏僅是在其被引用時(shí)，將其代碼插入。所插入代碼中的等同、定義和嵌套的宏調(diào)用等均按常規(guī)方式處理。

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

宏也可以含有局部標(biāo)識(shí)符，代碼展開后對(duì)其重新命名，這樣每次引用宏時(shí)它們各不相同。

loopn macro param count
local l1
move lc[0], count
l1:
djnz lc[0], l1
endm

在引用這個(gè)宏時(shí)，插入其代碼時(shí)標(biāo)號(hào)l1將被更改為一個(gè)不同的臨時(shí)標(biāo)號(hào)。