Beck IPC@CHIP DK241 User manual

IPC@CHIP®DK241
Getting Started V1.02
Copyright © 2009 Beck IPC GmbH Page 1 of 36
Getting Started –DK241
IPC@CHIP®Embedded Web Controller Family
Development Kit DK241 Order No. 563965

IPC@CHIP®DK241
Getting Started V1.02
Copyright © 2009 Beck IPC GmbH Page 2 of 36
Table of Contents
1INTRODUCTION.................................................................................................. 3
2SYSTEM START-UP............................................................................................ 3
2.1 WHAT DO WE NEED TO GET STARTED? .................................................................................. 3
2.2 STEP 1–SWITCHING ON THE DB240 DEVELOPMENT BOARD................................................. 4
2.3 STEP 2–STARTING THE ONE-WORKBENCH ......................................................................... 5
2.4 STEP 3–SETTING UP COMMUNICATION................................................................................. 7
2.4.1 Setting up the serial communication.................................................................................. 7
2.4.2 Setting up the Ethernet communication............................................................................. 8
2.5 STEP 4–DOWNLOADING THE DB240 ONLINE DEMO PROGRAM............................................ 14
2.6 STEP 5–OPERATING THE DEMO PROGRAM......................................................................... 16
2.7 STEP 6–CONFIGURING SD/MMC-CARD............................................................................ 18
3INFORMATION FOR ADVANCED USERS........................................................ 19
3.1 UPDATING THE @CHIP-RTOS-PPC.................................................................................. 19
3.2 UPDATING THE ONE-WORKBENCH ..................................................................................... 20
3.2.1 Show currently installed features..................................................................................... 20
3.2.2 Find and install updates and new features...................................................................... 21
3.3 USING THE IPC@CHIPTOOL APPLICATION........................................................................ 24
3.4 DEVELOPING SOFTWARE FOR YOUR IPC@CHIP®............................................................... 25
3.5 DEBUGGING YOUR IPC@CHIP®APPLICATIONS................................................................... 28
3.6 MISCELLANEOUS................................................................................................................ 31
3.6.1 The CHIP.INI configuration file........................................................................................ 31
3.6.2 The command shell ......................................................................................................... 31
3.6.3 The web server................................................................................................................ 31
3.6.4 The PPP server/client...................................................................................................... 32
3.6.5 IPv4 Basics...................................................................................................................... 33
3.6.6 IPv4/v6 Dual Stack .......................................................................................................... 34
4APPENDIX - WHERE TO GET FURTHER INFORMATION............................... 35
4.1 GETTING STARTED............................................................................................................. 35
4.2 UPDATES,TOOLS AND EXAMPLES........................................................................................ 35
4.3 SUPPORT........................................................................................................................... 35
4.4 ORDER NUMBERS............................................................................................................... 35

IPC@CHIP®DK241
Getting Started V1.02
Copyright © 2009 Beck IPC GmbH Page 3 of 36
1 Introduction
Congratulations on purchasing your IPC@CHIP®DK241 Development Kit. The Development
Kit is a complete ready-to-use development system for building applications based on the
Embedded Web Controller IPC@CHIP®SC243. It runs with the preinstalled @CHIP-RTOS-
PPC operating system, which includes features like a real-time kernel that is capable of
running applications concurrently, a full TCP/IP stack with a UDP/TCP socket interface, DHCP,
FTP, PPP, Telnet, SSH server, Web server, APIs for CAN and USB controllers, etc.
The Development Kit contains both hardware and software components required for a basic
development. This document will introduce you to the several components of the DK241.
Chapter X2Xprovides a step-by-step guide on how to put the DK241 into operation. Chapter X3X
describes selected components of the DK241 for advanced users. Chapter X4Xpoints the way to
further information.
2 System Start-up
2.1 What do we need to get started?
- The Development Kit DK241 consisting of:
oDevelopment Board DB240
oEmbedded Web Controller
IPC@CHIP®SC243 (on the DB240)
oSerial null-modem cable
oEthernet patch cable (gray)
oEthernet cross-over cable (red)
oSecure Digital (SD) memory card
oPower supply unit
oONE-Workbench for IPC@CHIP®
CD (including GNU C/C++ compiler,
DK241 startup documentation and
drivers)
- Personal Computer
oMicrosoft Windows XP/Vista Operating System
oEthernet network interface
oSerial port
- Software from the enclosed ONE-Workbench CD or the IPC@CHIP®Getting Started
Website at: HTUhttp://www.beck-ipc.com/gettingstartedUTH
oONE-Workbench (on CD only)
oDB240 Visualisation Demo
oEXTDISK driver software
o@CHIPTOOL
Be aware that the Embedded Controller SC243 and the
Development Board DB240 are electrostatic sensitive
components. Observe general precautions for handling.

IPC@CHIP®DK241
Getting Started V1.02
Copyright © 2009 Beck IPC GmbH Page 4 of 36
2.2 Step 1 –Switching on the DB240 Development Board
The Development board DB240 is designed to give you easy access to the functionality of the
IPC@CHIP®SC243, especially to its several interfaces like serial ports, Ethernet, digital I/O,
CAN, USB, etc. The following graphic gives an overview of the most important components of
the DB240 board.
SC243
Extension socket
Power supply
Battery for SRAM
UART1 (Shell & Bootloader)
CF card socket
UART3
MMC / SD-card socket
2 x USB
LEDs and Dip-Switches
2 x CAN
Reset switch
Ethernet
WLAN socket
Bluetooth socket
The AC power supply is delivered with country specific AC adapters. Please choose the right
adapter for your country. Then connect the AC power supply to your main supply and to the
DB240 Development Board to power it. Move the power switch on the DB240 to the ON
position, two green Power LEDs will light up.

IPC@CHIP®DK241
Getting Started V1.02
Copyright © 2009 Beck IPC GmbH Page 5 of 36
2.3 Step 2 –Starting the ONE-Workbench
The ONE-Workbench for IPC@CHIP® is a comfortable integrated development environment
for the SC243/SC223 products. It integrates the GNU C/C++ toolchain for application
development and debugging. It also provides functionality for finding IPC@CHIP®s on the
network, configuring them, updating their operation system, transferring files and using their
shell. The workbench is based on the common Eclipse framework and the CDT C/C++ editor
plug-in. It benefits from a large user community which results in plenty of features for modern
and comfortable software development.
For installing the ONE-Workbench at your PC, execute the setup program
ONE-WORKBENCH-x.x.x-INSTALLER.EXE from the CD.
It‟s strongly discouraged to install the ONE-Workbench to the Windows program files directory
(“C:\Program Files\”), because this may lead to problems during the first program launch
and during the online update, especially if you run with only normal user permissions. It‟s
recommended to install it in some other location, e.g. “C:\ONE-Workbench\”.
Note: If you anyhow install the ONE-Workbench to the Windows program files directory, make
sure that you have administrator rights during the setup and for the first program launch,
because the ONE-Workbench will extract the toolchain on the first launch. Please compile a
program one-time with administrator permissions to assure that the toolchain was completely
and successfully extracted. See the following screenshot how to start the ONE-Workbench as
administrator under Windows Vista, using a right mouse click on the ONE-Workbench desktop
icon.
After the installation, you are able to start the ONE-Workbench application from either the
Windows start menu or from a desktop icon.

IPC@CHIP®DK241
Getting Started V1.02
Copyright © 2009 Beck IPC GmbH Page 6 of 36
During the start of the ONE-Workbench you will be asked to choose an appropriate workspace
folder. Inside of this directory the ONE-Workbench will store your project information and
preference settings.
The following graphic shows the main window of the ONE-Workbench.
The ONE-Workbench comes with detailed help. Select Help Contents from the Help menu for
further information.
If you’re running a firewall, make sure that it does not block any network functions of
the ONE-Workbench such as Telnet, SSH, FTP or the scanning for IPC@CHIP®s.

IPC@CHIP®DK241
Getting Started V1.02
Copyright © 2009 Beck IPC GmbH Page 7 of 36
2.4 Step 3 –Setting up communication
There are basically two ways to connect your DB240 to your PC: the serial interface and
Ethernet. The simplest connection type is the serial interface. Preferably use it to get access to
the shell of your IPC@CHIP®. Ethernet communication is the most powerful. It may be used to
access the shell via Telnet or SSH and it‟s the easiest way to transfer files to the IPC@CHIP®
via FTP.
2.4.1 Setting up the serial communication
To set up serial communication to your Development Board DB240 you need the enclosed
null-modem cable.
1. Connect the null-modem cable to a free serial port of your PC and with the UART1
interface of the DB240.
2. Select the Terminal window in the ONE-Workbench.
3. Click on the green Connect button.
4. Select the Serial connection type and the PC COM port, where you have connected the
null-modem cable. Set the Baud Rate to 19200, Data Bits to 8, Stop Bits to 1and Parity
and Flow Control to None.
5. Click OK. You‟re now connected to your IPC@CHIP®. Press the Return key in the
Terminal window to see the IPC@CHIP® prompt.

IPC@CHIP®DK241
Getting Started V1.02
Copyright © 2009 Beck IPC GmbH Page 8 of 36
Hint: By the way, if you double-click on the title line of a ONE-Workbench window, it will be
maximized. If you double-click again, it will be restored to its original size.
You may now use the commands of the @CHIP-RTOS-PPC shell in the terminal window. The
command DIR will, for example, display a list of the files shipped on your IPC@CHIP®internal
drive.
2.4.2 Setting up the Ethernet communication
Network communication is based on the TCP/IP protocol family. To be able to operate in a
TCP/IP network, your IPC@CHIP®needs to be assigned a valid and unambiguous IP address
and network mask. If you cannot figure out a proper IP address and network mask for your
IPC@CHIP®, please consult your network administrator.
There are two ways of assigning an IP address to your IPC@CHIP®SC243. You may either
configure it by hand or you may use DHCP to automatically assign IP settings. Of course you
will need a DHCP server to achieve the latter.
The default configuration for the IPC@CHIP®is using DHCP since this will ensure that the
IPC@CHIP®adapts to an existing network if this network provides a DHCP server. If your
network doesn‟t have a DHCP server, the IPC@CHIP®will not disturb the operation of your
network.
If you have a regular local network with several clients, connect the DB240‟s Ethernet interface
to your Ethernet hub or switch using the enclosed twisted pair patch cable (gray) and go on to
either section X2.4.2.1Xor X2.4.2.2, depending on how you‟d like to assign IP settings to your
IPC@CHIP®.
If you‟re not connected to a network but want to connect the DB240 directly to your PC, you
have to use the enclosed cross-over twisted pair Ethernet cable (red) to plug the DB240‟s
Ethernet interface to your PC‟s Ethernet interface. Then go on to section X2.4.2.2X.

IPC@CHIP®DK241
Getting Started V1.02
Copyright © 2009 Beck IPC GmbH Page 9 of 36
2.4.2.1 IP address configuration via DHCP
In a network supporting DHCP the IPC@CHIP®retrieves a valid IP configuration from a DHCP
server automatically.
Press the Reset button of your DB240. On the serial terminal window the boot messages will
show up. Here you will see the serial number, @CHIP-RTOS-PPC version, build date and
other information. If an IP configuration could be successfully received from the DHCP server,
this IP configuration will be displayed at the end of the boot messages. In the event of an error,
the message DHCP request failed will be put out after a few seconds.

IPC@CHIP®DK241
Getting Started V1.02
Copyright © 2009 Beck IPC GmbH Page 10 of 36
2.4.2.2 IP address configuration by hand
The easiest way to configure your IPC@CHIP®‟s IP settings by hand is to use the functionality
of the ONE-Workbench @CHIPTOOL View window.
Hint: This window is normally shown at the bottom of the ONE-Workbench application. If it‟s
not shown, select “Show view / @CHIPTOOL view” from the “Window” menu.
In the @CHIPTOOL View window you can see all IPC@CHIP®s found on the network. The
table displays information such as serial number, name, IP configuration and RTOS version.
In a network without a DHCP server your IPC@CHIP®should be displayed as Not configured
or with an IP address from the Auto-IP address range (169.254.x.x), since by default DHCP
and AUTOIP is enabled but no DHCP server could be found.
1. Right-click on your IPC@CHIP®.
2. Select Configure device… from the pop-up menu.
3. In the appearing dialog uncheck Use DHCP and check Configure default network
interface.
4. Fill the fields IP Address, Network mask and, if necessary, Gateway with appropriate
values.
5. Press the Configure button to apply the new settings to your IPC@CHIP®.
6. Close the dialog with the OK button.
7. Go back to the @CHIPTOOL View window. It now shows the new IP configuration.