AN-6131API
15
Holt Integrated Circuits
Getting Started with the Holt API demo software project and installing
IAR Systems
Embedded Workbench for ARM
Compiler
1.
Installed IAR Systems
Embedded Workbench for ARM
(
EWARM
) compiler is required BEFORE
adding the Holt demo projects, so all Atmel board library files and the demo project folder are
created in the proper location. Follow
the “Holt HI-6131 API Demo Project Installation Guide”
found in the Project folder on the Holt CD-ROM. Before proceeding to the next steps IAR must
be installed and the two Holt project folders must be in the proper folder locations, according to
that guide.
Instructions beyond this point assume you have completed the above installation
tasks.
2.
Launch IAR
Embedded Workbench
from the Windows Start menu. A blank screen should appear.
Open the Holt HI-6131 API Demo Project from the IAR File pull-down menu, click on
File/Open/Workspace and navigate to the project folder location and select “HI-6131 API
Demo.eww” and click the Open button.
3.
An IAR Workspace window should appear on the left side as shown below. If the Workspace
directory pane is missing, select “Workspace” from the View pull-down menu. Make any
window adjustments or open any of the folder groups to view included files to suit your
preferences.
4.
Double click the
main.c
file, it should appear in the text editor pane, similar to the screen
capture shown on the next page.
5.
The first time a project is unzipped and installed in the appropriated folder a Rebuild All should
be performed (from Project pull down menu).
6.
IAR getting started, project management and other guides are available from the IAR
Workbench Help pull down menu.
Mode Holt Project Configurations
IAR project configurations are used to reconfigure the demo software using preprocessor macros.
Configurations are selectable from the Workspace pull-down menu using macros defined in the project
options C/C++ preprocessor tab. The three macros
IAR
,
IAR_SPI_ENABLE
and
IAR_HI-6131_ENABLE
control which sections of code are compiled for the demo project. Other macros are used to enable BC,
RT or SMT sections of code. Holt uses a common code base for multiple projects. This means there are
functions not used in this project but are left in the C and H files. The IAR compiler uses the macros to
select sections of code to build and link. Some references to HI-6130 or HI-6138 MAMBA™ are to be
expected. In some cases some functions are simply not used or macros are used inside a function to select
appropriate code.