MAX-IDE入门

——

作者：时间：2007-01-26 来源：《Maxim公司》

加入技术交流群
- 扫码加入
  和技术大咖面对面交流
  海量资料库查询

安装max-ide

系统要求

操作系统：windows 98, windows nt, windows 2000, windows me或者windows xp

至少一个未用的串行com端口(用于与maxq评估板通信)，或者一个usb至串口适配器和一个未用的usb端口。

运行安装程序

max-ide的安装包为max-ide.zip，可以从maxq网页下载。

下载该安装包，解压缩，然后运行setup.exe，将max-ide安装到您的硬盘上。
在installshield对话框中，选择典型安装，安装评估板maxq开发所需要的全部文件。

安装完成后，可以从开始菜单启动max-ide。

max-ide安装的文件

max-ide的主执行程序和帮助文件位于max-ide根目录下，默认路径为{program files}max-ide。其他文件在以下子目录中。

本文引用地址：https://www.eepw.com.cn/article/20641.htm

compilers子目录含有max-ide安装的所有编译器和汇编器的可执行程序和数据文件。至少包含标准maxq汇编器；也可能会安装一些其它汇编器和编译器，和你的获得渠道有关。

devices子目录含有库、驱动程序和配置文件，用于将应用定位于各种maxq微控制器和评估板，并完成它们之间的通信。

examples子目录含有代码实例(/xxx_demo)，以及所有maxq微控制器的标准包含文件和库(/api)。

设置jtag接口

jtag适配板

通过一个专用的jtag测试访问端口(tap)，max-ide与maxq微控制器的引导装载程序和调试引擎接口，这个测试口符合jtag ieee标准1149。该接口由以下信号组成(它们通常与端口引脚复用)：tms (测试模式选择)、tck (测试时钟)、tdi (测试数据输入)和tdo (测试数据输出)。

图1显示了串口-jtag适配器(包含于所有maxq微控制器评估板中)是如何连接pc串行com口和maxq微控制器的jtag口的。

图1. 用于maxq的串口-jtag接口。

jtag接口信号和电缆

jtag适配器通过10芯带状电缆和2 x 5、0.100"间距的接插件与maxq评估板连接。该电缆传输的信号列在下面表1中。

表1. jtag接口信号

连接评估板

根据所采用的评估板类型，需要对jtag适配板、评估板或者两者供电。此处给出两个电路板的简要设置方法(表2)；更详细的说明请参考评估板数据资料。注意，无论是jtag适配板还是maxq评估板，所用的电源均为直流电源，中心为正。

表2. 评估板设置

使用max-ide时，请按照以下步骤设置maxq评估板和jtag适配板(图2)：

如上所述将电源接到jtag适配板。
如上所述设置评估板和jtag适配板的跳线。可能还需要根据评估需要设置评估板上其他的跳线或者dip开关；更详细的信息请参考评估板数据资料。
连接2 x 5 10芯带状电缆到jtag适配板上的p2插座和评估板上的对应插座。连接器仅能从一个方向连接；否则，请确定红线连接至两个插座相同编号的引脚。
使用直通串行电缆将jtag适配板上的j1连接至pc com端口。
打开所有电源。

图2. maxq2000评估板和jtag适配板。

在max-ide中建立项目

建立一个新的maxq汇编项目

按照以下步骤，在max-ide中建立一个新的maxq汇编语言项目：

从max-ide菜单选择device maxq jtag。
选择project new project。建立一个未命名的项目。
选择project save project as。选择您希望保存项目(.prj 文件)的位置。
要建立一个新的汇编代码文件，可选择file new file。在文件中输入汇编代码后，选择file save as，在你的项目目录下保存新建立的.asm文件。下一步，选择project add files，选择新建的文件，加入到项目中。
要将已有的汇编代码文件加入到项目中，选择project add files，然后选择要加入的文件。
不必将包含文件加入到项目中，汇编过程会自动读入包含文件。

maxq2000的一个汇编文件实例如下：

$include (..apimaxq2000.inc)

org 0000h

main:
jump $

end

以上$include行因包含文件的位置而异。关于$include和org伪指令的详细信息，请参考本文档的“使用max-ide汇编器”一节。

关于汇编和包含文件的说明

全体maxq微控制器共有的系统寄存器(例如累加器、数据指针和循环控制寄存器)已在max-ide汇编器中进行了预定义。外设寄存器因器件而异，必须在包含文件中定义。用于各种maxq微控制器的标准包含文件随max-ide一起被安装；上例中的包含文件是用于maxq2000的。

预处理伪指令(例如等同、定义和宏)不会在一个项目内的不同文件之间传送。如果一个max-ide汇编项目含有一个以上的汇编文件，各汇编文件必须含有它要用到的预处理伪指令或者文件包含伪指令。

不管项目中有多少汇编文件，每个文件的最后必须有"end"声明。

不要在包含文件中加入"end"声明。

项目中含有多个汇编文件时，所有文件中的所有标识符都为公用的；即，任何汇编文件中的代码都可以调用或引用同一项目中任何其他汇编文件中的例程或标号。

打开一个已有的项目

要打开一个以前建立的max-ide项目，只需从菜单中选择project open project，然后选择你希望打开的.prj文件。注意，如果jtag适配板和评估板没有正确连接和上电，打开maxq jtag项目时可能会产生错误信息。

当一个项目已经建立或者打开后，该项目中的汇编代码文件将被列在左侧的面板上。双击文件名可以将其打开，以便在max-ide中进行编辑，如下面的图3所示。

图3. max-ide项目环境

运行和调试代码

编译项目

要编译项目文件，从菜单中选择debug make或者debug build all，或者点击工具条上这些命令的快捷按钮，或者按下f7 (作用与make相同)。maxq编译器运行，如果没有错误，消息窗口中将出现"compiling...build successful."。构建过程中的任何错误将会出现在消息窗口中。

运行项目

项目被成功编译后，可以采用以下方法之一，在调试器中执行该项目。

选择debug run (f5)后，编译后的项目代码通过jtag接口被装入maxq微控制器并启动运行。程序将持续运行，直到选择了debug stop (shift+f5)、点击pause按钮或者程序执行到断点为止。

选择debug step into (f11)后，编译后的程序被载入，在源代码的第一行暂停程序执行。

选择debug run to cursor (control+f10)后，编译后的程序被载入，并开始运行，直到程序运行到编辑窗口中光标所在的行，或者遇到断点，先到者为准。如果光标不在源代码行上，选择该选项将导致错误。

断点用来使程序运行到预定位置时暂停下来，可以采用以下三种方法之一设置或清除。

将光标移到您希望建立断点的行，选择debug toggle breakpoint。
将光标移到您希望建立断点的行，点击工具条上的禁行灯图标。
在编辑窗口中，单击您希望建立断点的行号。

注意，可以将断点设在没有源代码的行上，但是这不会起作用。maxq微控制器支持一次设4个断点；如果选择run to cursor，这将占用一个断点，因此，在这种情况下，只能设置3个断点。

选择debug stop，或者单击工具条上的stop图标，将完全停止程序运行。但是，如果停止在第一行(step into)、光标行(run to cursor)或者设置了断点的行，接下来还可以使用单步模式运行程序。也可以通过单击pause按钮进入单步模式。在该模式下，以绿色箭头标志当前运行所处的位置，可使用下列命令：

debug step into (f11), debug step over (f10)和debug step out(shift+f10)，在汇编调试模式下，这些命令的作用相同，即执行单个指令，将执行点转至下一指令。

debug run，从当前位置开始运行，直到下一个断点，如上所述。

debug run to cursor，从当前位置开始运行，直到光标所在的行，如上所述。

注意，运行在汇编语言调试模式时，debug菜单下的high-level debug和low-level debug设置不起作用。

显示和编辑处理器寄存器

程序装入并执行了至少一条指令后，就可以利用调试器来查看和编辑maxq微控制器的寄存器。选择window show registers 将显示寄存器组。随着调试器中代码的执行，这些寄存器中的数值将随之更新。双击可写寄存器的数值区可以对其进行编辑，可以输入十六进制、十进制或二进制的新值。

使用maxq2000评估板时应注意：如果装配了lcd子板，不要手动编辑po0, pd0, po1, pd1, po2, pd2, po3或者pd3寄存器的值。当带有lcd时，这些引脚上的静态输出会损坏lcd。

显示和编辑处理器存储器

程序装入并至少执行一条指令后，就可以查看和编辑maxq微控制器的内部存储器了。选择window show memory 将显示内部存储器。通过显示窗口中的下拉列表，你可以选择查看代码、数据或者堆栈存储器。代码和堆栈区用16位宽显示，数据区用8位宽显示。数据和堆栈区的存储器值可以编辑，双击某个存储器位置并输入新值即可。

使用max-ide汇编器

max-ide提供一个多道汇编器，用于开发maxq汇编语言应用程序。该汇编程序含有一个单道预处理器，能够使用包含文件、符号等式、条件汇编和宏。汇编器和预处理器完全集成在max-ide环境中。

有关如何使用宏以及其他预处理伪指令的举例，请参考macro实例项目。

一般语法

maxq汇编器和预处理器均对大小写不敏感。汇编语句遵循以下格式：

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

如以下代码：

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

标志符(例如上面的main标号)可以含有字符[a-za-z_?$0-9]，但是不能以0-9数字开始。其长度可以达到127个字符。

请参考maxq系列用户指南，了解maxq微控制器系列的体系结构、指令集、寻址模式和核心寄存器的详细说明。

源文件

项目编译时，max-ide项目窗口列出的所有汇编源文件(.asm)将按照窗口中文件列出顺序进行汇编。没有提供链接器，因此，在汇编多个文件时，就如同它们被合并到单个文件中进行汇编一样。

源文件可以包含伪指令、等同/定义、宏、条件汇编模块和声明等。任何源代码文件的最后一行必须为end伪指令：

end

包含文件

不必刻意添加包含(.inc)文件到项目中。它们可以由“include”伪指令自动读入和解析，就如同包含文件的全部文本被加入到源文件中“include”伪指令所在的位置一样。

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

包含文件可以含有“include”伪指令、等同、宏和db/dw数据声明，但是不能含有汇编子程序。包含文件不必结束于end伪指令。
max-ide为每种maxq微控制器提供标准包含文件，在其中定义了该类微控制器的外设寄存器组，以及应用rom所提供函数的地址。这些包含文件可用于所有汇编语言项目；它们位于max-ide主安装目录的examples子目录中。

常数

语句或等同说明中作为立即数的常数可以采用以下四种格式之一。

十进制(默认)—以非字符或d结尾。例如：10, 07d
二进制—以b结尾。例如：01b, 1101101b
十六进制—以0-9数字开始，以h结尾。例如：10h, 09ffeh
单字符—转换为一个字节的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

等同

等同说明，即equ伪指令，用来在任何使用常数的地方代替数字常数。可以使用任何格式和上面所提到的常数运算符。标号不被认作常数。

one equ 01
two equ 02

move acc, #one
move acc, #(one+two)

等同也可以被后面的等同说明引用。

one equ 01
two equ one+one

定义

定义伪指令支持c风格的直接文本替换，不需要额外的处理，常用于包含文件中定义外设寄存器。替换文本被限制为单行；不支持接续符。不支持c风格的宏。

#define po[0] m0[0]

move acc, po[0] ; parses as move acc, m0[0]

数据声明

db和dw伪指令用于在十六进制文件的当前位置插入原始数据字节(包括来自于字符串值的数据字节)或字。

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)

注意，这些数据将被插入到代码空间中。因此，如果db声明出现在两组指令之间，那么定义的字节数必须是偶数，以免发生字对齐汇编错误。
条件汇编
只有符合某些布尔条件时，才对某块代码进行汇编。具有以下格式。

if ()
statements
...
endif