< Previous PageNext Page >

Using the Development Emulator

The SDK includes a Development Emulator, which is a virtual machine that uses your development system's resources for compiling and testing BlackDog applications.

Starting the Emulator

Linux System. To start the Development Emulator on a Linux system, navigate to the top level directory where you extracted the SDK and run the launch-dev.sh. For example:

SDK_HOME/launch-dev.sh

Windows System. To start the Development Emulator on a Windows system, launch the emulator from the Program menu: Start menu > Programs > BlackDog Software Development Kit > BlackDog Software Development Kit.

Running the Emulator

Once you start the emulator, you can use the GCC and GDB tools to compile and debug any C or C++ programs into native Power-PC code.

See Compiling BlackDog Applications for more information.

Connecting to the Emulator from the Host PC

The software emulator does not establish a network connection with the host like the actual BlackDog device. This means that the host cannot initiate any network connections to the virtual machine running in the emulator. Therefore, you must start networking programs such as scp and sftp from within the emulator. Also, you cannot use ssh from the host to obtain a terminal session to the SDK running in the emulator (this is mostly unnecessary since the emulator has a console window that provides command line access to the SDK).

Note: You will need an SSH server (such as OpenSSH from Cygwin) installed on your Windows host in order to copy files from within the emulator.

Exiting the Emulator

To exit the emulator, simply type halt at the command prompt. For example:

blackdog:~# halt

Note: The shutdown may take up to thirty seconds.

 

< Previous PageNext Page >
Copyright © Realm Systems, Inc. 2003-2005.
All rights reserved.