IM3220 Development Kit - Quick Start Guide

Table of Contents

1. Kit content
2. Kit documentation
3. Before you begin
4. Installing the Imsys Developer
5. Installing the IM3220 profile
6. Connecting the socket-board
7. Configure Imsys Developer
8. Building a sample project
9. Starting the PTP Engine from the Command Shell
10. Re-flashing the IM3220 module

1. Kit content

In your kit you can find the following items:

• IM3220-M210 reference module
• IM3000 socket-board S20
• Trace Adapter with cable, rev 1.2
• Imsys Developer 7.1
• Parallel cable
• USB cable

2. Kit documentation

The following documents come with your kit in printed form:

• IM3220 Development Kit Quick Start Guide (this document)

An additional documentation in electronic form is available on the website:

• IM3220 Product Brief
• IM3220 Microcontroller Datasheet
• IM3000 Family Microcontrollers Data Book
• M20 Microcontroller Module Hardware Reference
• S20 Socket Board Hardware Reference

You can download them from http://www.imsystech.com/documents.htm

A complete documentation for Imsys Developer and for IM3220 profile, including C API Reference and Assembler Instructions, can be found inside the Imsys Developer Help system.

3. Before you begin

Prepare a PC for use together with the IM3220 Development Kit. In order to be used with this product, the PC should have a parallel port and a USB port.

4. Installing the Imsys Developer

Imsys Developer is a powerful integrated development environment for the IM3000 microcontroller family platform. A unique serial number is required for installing Imsys Developer. You will find this number on a sticker attached to the Imsys Developer CD pocket.

• Insert the Imsys Developer CD supplied with the kit into the PC and run the enclosed file "setup_imdev71.exe".
• Follow the on-screen instructions during the installation procedure.
• After the installation has completed, you will be asked to reboot your computer.

5. Installing the IM3220 profile

Imsys Developer can be used with any IM3000-based hardware. The individualization of the hardware is handled via software "profiles". These packages contain files and settings specific to each application class. In order to develop software for the IM3220 system, you first need to install its profile. This can be downloaded from our web site once you have purchased the product.

6. Connecting the socket-board

Before you can develop, run and debug any program on the IM3220 system, you have to connect it to the PC. To do that, follow the steps below:

• Connect the Trace Adapter to the PC's parallel port via the parallel cable supplied. Attach the Trace Adapter's flat cable to the socket-board's red "Debug" connector. This connection is used by Imsys Developer to communicate with the IM3220 hardware.
• Optionally connect the socket-board to the network via a hub or a switch. You can also connect it directly to the PC, using a crossover Ethernet cable.
• Finally, connect the socket-board to the PC through the USB cable supplied with the kit. After connecting the "Found New Hardware Wizard" will appear on the PC.
• Download the latest driver package for the on-board USB device "FT232R" from: http://www.ftdichip.com/Drivers/CDM/CDM 2.04.06 WHQL Certified.zip
• Unzip the driver package onto your hard drive. Proceed with the "Found New Hardware Wizard", specifying the path to the stored driver files. After the drivers are installed, a USB Serial Port device should appear on your PC.
• Open the Device Manager from the hardware tab of the System Properties applet (Control Panel / System) and find this device under Ports (COM & LPT) node. Remember its name (e.g. COM3). You will have to use this port to interact with the on-board software, such as the command shell, either through the Imsys Developer's terminal window or through any other terminal emulation software.

7. Configure Imsys Developer

Now, you are ready to start using the Imsys Developer together with the IM3220 Development Kit.

• Start Imsys Developer.
• Select Edit/Options from the Imsys Developer's menu. Go to the Debug tab and specify the parallel port to which the Trace Adapter is connected (e.g. LPT1). Go then to the Terminal tab and specify the USB Serial Port name to which the socket-board is connected (e.g. COM3).
• Open the Terminal window by selecting View/Debug Windows/Terminal from the Imsys Developer's menu and press the Connect button.
• Press the "Reset" button on the socket-board.
• Your IM3220 module is delivered with the firmware preflashed, so you should be able to see an output from the socket-board in the Terminal window:
  
  IM3220-M210 restarting @ Wed Mar 26 16:40:48 2008
Reading a:/system/ish.ini: [OK]
Reading a:/system/system.ini: [OK]
Serial server: [OK]
Setting host name: [OK]
TCP/IP startup: [OK]
Registering hostname in DNS: [FAILED]
FTP server: [OK]
Telnet server: [OK]
Setting timezone to: GMT (DST)
Reading a:/system/startup.ini: [OK]

localhost.localdomain (IM3220-M210, v1.3)
Login:


• To logon to the system the username is "root", with password "root".

The IM3220 system is configured to use a DHCP server for obtaining an IP configuration for its network interface. If the board is not connected to the network, or if you do not have access to a DHCP server, it may take a longer time to start-up.

You can also configure the network interface manually, by using the "ipconfig" command. Type the "help ipconfig" from the command shell to see the detailed command description. Type "help" from the command shell to see the complete list of commands supported.

8. Building a sample project

If you have configured your Imsys Developer, and your IM3220 system boots successfully, you can now start the application development. Below is a short description of how to build and run a sample project within a profile:

• Start Imsys Developer.
• Select File/Open Profile Sample Project/[profile name] from the Imsys Developer's menu. The Open Project dialog containing available sample folders. Double-click on a folder to and select the ".prj" file to open the sample project.
• In the Project View window you will see a list of the files included in the project. If there is a readme.txt file, open it and read the details about the project.
• Press "Build" button in the Imsys Developer toolbox (or press SHIFT+F6 key). You will then see the build process output in the Build Output window (Menu/View/Other Windows/Build Output). If the project was build without errors, you can boot the IM3220 system with the output file.
• Press the "Boot" button in Imsys Developer toolbox (or press F6 key). You will then see the boot process output in the Debug Output window (Menu/View/Other Windows/Build Output):
  
  --- Configuration: Standard, Profile: IM3220-M210 v1.3 ---
Booting target
Parallel port driver IMDPP.SYS ver 7.0.10
Parallel port mode: EPP
I/O port: LPT1
Reset done
Detected processor model: IM3000 (A)
Loading testmicroprogram: Tmpgm.mp (v0.0.268.0)
Detected memory type 97, size 32MB, mode 102
Loading microprogram: im3220m210.mp (v0.1.20.0)
Loading application: HelloWorld.gpx (address 00000000-000C65BB)
Program arguments: "HelloWorld.gpx -l"
Creating EFFS RAM disk...
RAM disk created, 512KB
c0start version: 2.0.1.0
Target successfully booted!


If you encounter any IMDPP Timeout errors, during the booting process of the IM3220 target, please:

• Make sure that the parallel port on your PC is operational
• Re-connect the Trace Adapter and try to boot again
• Change the parallel port mode in Imsys Developer (Menu/Edit/Options), on the Debug tab, from "Auto" to either: "ECP", "EPP" or "Standard" depending on what mode is supported by your PC.

9. Starting the PTP Engine from the Command Shell

When the system is running you can start the PTP engine from the ISH command shell. Open the Terminal window, connect to the board and logon to the system.

From the command line enter command "ptp -start" to start the PTP engine.

Then you can access the PTP engine's user interface by the "ptp" command. To get a list of available commands use the help command, "ptp h".

You can try the following useful commands:

Command	Description
ptp h	List available commands
ptp c	Print current data set
ptp s	Print current states of all ports
ptp x	Start the pulse train.
ptp v	List available debug interface options
ptp v13	Start/stop debug printout of current data set.

The pulse train is preset to a length of 3 ms and a period of 10 ms and is available on the socket board on connector P600 pin 6.

10. Re-flashing the IM3220 module

You can flash your IM3220 system using Imsys Developer and the "FlashIt" project, which can be found under [im3220_profile_path]\Tools\FlashIt.

You can open the project by selecting File/Open Profile Tool Project/ and the open the FlashIt folder and select the FlashIt.prj project file.

Before you run the project you might want to set the correct MAC address in the file mac.txt.

Then boot the IM3220 and the flashing process will start automatically.

The detailed description of the functionality and parameters of this project can be found in its "readme.txt" file. Study it carefully before starting to flash anything onto the IM3220 target.

---

Quick Start Guide IM3220 Development Kit
Document no: STO-DEV7029-LZ Date: 2008-06-13 Revision: 1.3

Revision History

Document: STO-DEV7029-LZ
Previous revision: 1.2
Section	Changes since last revision
-	Updated version numbers in document to match profile version

Copyright (c) Imsys AB

Copyright

Copyright (c) Imsys AB. All rights reserved. No part of this document may be reproduced or translated into any language by any means without the written permission of Imsys AB.

Disclaimer

Imsys AB makes no warranties for the contents of this document or the accuracy or completeness thereof and disclaims any implied warranties of merchantability or fitness for any particular purpose. Further, Imsys AB reserves the right to revise this document and to make changes without notifications to any person of such changes. The information contained in this document is provided solely for use in connection with Imsys AB products. This document should not be construed as transferring or granting a license to any intellectual property rights, neither expressed nor implied.

Imsys AB products have not been designed, tested, or manufactured for use in any application where failure, malfunction, or inaccuracy carries a risk of death, bodily injury, or damage to tangible property, including, but not limited to, use in factory control systems, medical devices or facilities, nuclear facilities, aircraft, watercraft or automobile navigation or communication, emergency systems, or other applications with a similar degree of potential hazard.