IM3910 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 IM3910 profile
6. Installing the Java compiler
7. Connecting the socket-board
8. Configure Imsys Developer
9. Building a sample project
10. Re-flashing the IM3910 module

1. Kit content

In your kit you can find the following items:

• M3910-M210 reference module
• IM3000 socket-board S20
• USB Trace Adapter
• Imsys Developer 7.2 on CDROM
• 2 USB cables

2. Kit documentation

The following documents come with your kit in printed form:

• IM3910 Development Kit Quick Start Guide (this document)

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

• IM3910 Product Brief
• IM3910 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 IM3910 profile, including Java API, 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 IM3910 Development Kit. In order to be used with this product, the PC should be equipped with Windows 2000 or Windows XP operating system and have at least two free USB ports.

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_imdev72.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 IM3910 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 IM3910 system, you first need to install its profile. This can be downloaded from our web site once you have purchased the product.

6. Installing the Java compiler

If you are planning to develop Java applications for IM3910 you will need to install the Java Development Kit. You can find it on the Sun Microsystems' website.

7. Connecting the socket-board

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

• 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 IM3910 hardware.
• Connect the Trace Adapter to the PC through the USB cable supplied with the kit. After connecting the “Found New Hardware Wizard” will appear on the PC.
• Locate the drivers for the USB Trace Adapter on the Imsys Developer CD.
• Proceed with the “Found New Hardware Wizard”, specifying the path to the driver files. After the drivers are installed, a USB Trace Adapter Serial Port device should appear on your PC.
• 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 second USB cable supplied with the kit. This cable powers the kit, and also provides serial port communication. After connecting the “Found New Hardware Wizard” will appear on the PC.
• Proceed with the “Found New Hardware Wizard”, again 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.

You may connect several USB Trace Adapters to your PC and debug several IM3910 systems simultaneously. Each USB Trace Adapter is labeled with its own serial number that uniquely identifies this particular Trace Adapter within Imsys Developer.

8. Configure Imsys Developer

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

• Start Imsys Developer.
• If you are planning to use Java, select Edit/Options from the Imsys Developer’s menu, go to the Java tab and specify the path to the Java compiler.
• Then go to the Debug tab and specify “USB” as the Target Interface.
• The list of available USB Trace Adapters identified by their serial numbers will appear in the drop-down box. Select the Trace Adapter you are going to use with this instance of Imsys Developer and press OK.
• Open the Terminal window by selecting View/Debug Windows/Terminal from the Imsys Developer’s menu. Press the “Select Serial Port” button in the Terminal Window toolbar and specify the serial port you want to use (e.g. COM3). This should not be the port belonging to the USB Trace Adapter, but the one that appeared when you connected the USB cable directly from the socket-board to the PC. Then press the “Connect” button.
• Press the “Reset” button on the on the socket-board or on the USB Trace Adapter.
• Your IM3910 module is delivered with the firmware preflashed, so you should be able to see an output from the socket-board in the Terminal window:
  
  IM3910-M210 restarting @ Wed Sep 02 16:40:48 2009
Reading a:/system/ish.ini: [OK]
Reading a:/system/system.ini: [OK]
Serial server: [OK]
JVM startup: [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 (IM3910-M210, v1.4)
Login:


• To logon to the system type "root" as the username and "root" as the password.

The IM3910 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.

9. Building a sample project

If you have configured your Imsys Developer, and your IM3910 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 Sample Project/[profile name] from the Imsys Developer's menu. The Open File dialog will appear. Choose the "HelloWorld.prj" file, from the HelloWorld folder, and open it.
• If you do not have a Java Development Kit installed, remove the "HelloWorld.java" file from the project tree (Menu/View/Project View). Remove also the "HelloWorld.class" file from the RAM Disk (Menu/Project/RAM Disk).
• 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 IM3910 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: IM3910-M210 v1.4 ---
Booting target
Trace Adapter: TAFB63F3
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: im3910m210.mp (v0.1.31.1)
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!
------------------------------------
[ClassLoader] BackGround loaded


10. Re-flashing the IM3910 module

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

Open FlashIt project in Imsys Developer and boot the IM3910 target with it. 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 IM3910 target.

---

Quick Start Guide IM3910 Development Kit
Document no: STO-DEV7020-LZ Date: 2009-08-27 Revision: 1.4

Revision History

Document: STO-DEV7020-LZ
Previous revision: 1.3
Section	Changes since last revision
1, 3, 7	Changed from Trace Adapter 1.2 to USB TA, Changed from Developer 7.1 to Developer 7.2
-	Updated version numbers in document to match profile version

The ownership and copyright of this document belongs to Imsys AB. It must not be disclosed, copied, altered or used without written permission of Imsys AB.