Вы находитесь на странице: 1из 126

WebGPI

Communication
Software
User Manual

WebGPI Communication Software


User Manual
About this Manual
Organization
and Headings

To help you quickly find information in this manual, the material is divided into sections,
topics, subtopics, and details, with descriptive headings set in red type. Section titles
appear at the top of every page in large red type.
In the PDF version of this document, clicking an item underlined in blue italic type jumps
you to the referenced page in the document.

Special Text Formatting

Controls and indicators are set in bold black type.

Table of Contents

A Table of Contents (TOC) appears on the next page. In the PDF version of this document,
the TOC entries are hyperlinked.

Revision history
Revision

Date

Comment

Rev. EA

December 2009

WebGPI Rev. 3.1.x

Rev. FA

July 2010

WebGPI Rev. 3.2.x

Rev. FB

November 2012

WebGPI Rev. 4.0.x

2012 Sauer-Danfoss. All rights reserved.


Sauer-Danfoss accepts no responsibility for possible errors in catalogs, brochures and other printed material.
Sauer-Danfoss reserves the right to alter its products without prior notice. This also applies to products already
ordered provided that such alterations can be made without affecting agreed specifications.
All trademarks in this material are properties of their respective owners.
WebGPI, WebGPI-Log, and Sauer-Danfoss are trademarks of the Sauer-Danfoss Group. The Sauer-Danfoss logotype
is a trademark of the Sauer-Danfoss Group.

K28601 FB November 2012

WebGPI Communication Software


User Manual
Contents

Introduction ........................................................................................................................................................... 5
About this Manual ....................................................................................................................................... 6
About the WebGPI and Web-GPI-Log Applications ....................................................................... 6

WebGPI Application ............................................................................................................................................ 7


WebGPI Window .......................................................................................................................................... 8
Menu Bar................................................................................................................................................. 9
Toolbar ..................................................................................................................................................11
About the View Menu ..............................................................................................................................13
Normal View ........................................................................................................................................13
Main View .............................................................................................................................................14
Data Logging View ...........................................................................................................................15
Main 50% View ...................................................................................................................................16
File Creation Window...............................................................................................................................17
Downloader Pane ......................................................................................................................................19
About File Names ......................................................................................................................................21
Application File Names ...................................................................................................................21
Default File Names ............................................................................................................................21
Kernel File Names..............................................................................................................................21
Configuration Pane ...................................................................................................................................22
Offline Window...........................................................................................................................................23
Offline Window Chart Menu Bar .................................................................................................24
Offline Window Chart Toolbar .....................................................................................................26
Information Window ................................................................................................................................28
Debug Mode Pane ....................................................................................................................................29
Data Logging Pane ...................................................................................................................................30
Data Logging Pane Toolbar ..........................................................................................................31
Data Logging Pane Chart Menu Bar ..........................................................................................32
Data Logging Pane Chart Toolbar ..............................................................................................34

WebGPI-Log Application ................................................................................................................................37


WebGPI-Log Window ...............................................................................................................................38
WebGPI-Log Window Toolbar......................................................................................................39
Data Logging Pane ...........................................................................................................................42

How to Use the WebGPI Application .........................................................................................................47


How to Connect Your PC to a Microcontroller ...............................................................................48
How to Start Communication between the WebGPI Application and a Microcontroller
..........................................................................................................................................................................49
How to Change a Parameter Value.....................................................................................................50
How to Restore Defaults .........................................................................................................................52
How to Log Run-Time Data ...................................................................................................................53
About Selecting Values for Logging ..........................................................................................56
How to Create an XML Data Log File for Use in the WebGPI-Log Application ..................57
How to Download a Defaults or Application File to an HC08 or HC08A Processor .........59
K28601 Rev FB November 2012

WebGPI Communication Software


User Manual
Contents
How to Force Download an Application File to an HC08 or HC08A Processor .................61
How to Download a Kernel to an HCO8 or an HC08A Processor ............................................64
How to Force Download a Kernel to an HCO8 or HC08A Processor ......................................68
How to Download an Application File to a 196 Processor ........................................................72
How to Force Download an Application File to a 196 Processor ............................................75
How to Download a Kernel to a 196 Processor..............................................................................78
How to Force Download a Kernel to a 196 Processor .................................................................82
How to Download an Application or Defaults File to a 167 Processor .................................86
How to Force Download an Application File to a 167 Processor ............................................88
How to Download a Kernel to a 167 Processor..............................................................................91
How to Force Download a Kernel to a 167 Processor .................................................................94
How to Download an Application File to an HC12 Processor ..................................................98
How to Download a Kernel to an HC12 Processor .................................................................... 102
How to Force Download a Kernel to an HC12 Processor ........................................................ 105
How to Create a File with Microcontroller Data ......................................................................... 108
How to Download an Application File to a TI Processor ......................................................... 110

How to Use the WebGPI-Log Application ............................................................................................. 113


How to Log and Save Data.................................................................................................................. 114
How to Create a Chart Collection ..................................................................................................... 117

PC and Cabling Requirements ................................................................................................................... 121


PC Requirements .................................................................................................................................... 121
Cabling Requirements .......................................................................................................................... 121

Index .................................................................................................................................................................... 123

K28601 Rev FB November 2012

WebGPI Communication Software


User Manual
Introduction

This manual documents the WebGPI application and the supplemental WebGPI-Log
application.
This chapter introduces the WebGPI and the WebGPI-Log applications.
T If you are updating your WebGPI application, first uninstall any older versions from your
PC.

K28601 Rev FB November 2012

WebGPI Communication Software


User Manual
Introduction
About this Manual
This manual contains the following chapters:

Introduction (this chapter)Introduces the WebGPI and WebGPI-Log applications.

WebGPI Application describes this applications windows and their controls and
indicators.

WebGPI-Log Application describes this applications windows and their controls and
indicators.

How to Use the WebGPI Application has step-by-step instructions for performing
common WebGPI application tasks.

How to Use the WebGPI-Log Application has step-by-step instructions to log data at
higher rates than can be achieved using the WebGPI applications logging function.

PC and Cabling Requirements details PC and cabling requirements.

About the WebGPI and Web-GPI-Log Applications


The WebGPI application is a browser-based (Web), general-purpose interface (GPI)
software tool for servicing Sauer-Danfoss microcontrollers.
You can use the WebGPI application to:

Download default tuning values, applications, and kernels (operating systems) to


microcontrollers.

Upload tuning values from microcontroller applications and create default tuning
value files containing these values.

View and change microcontroller application values.

Log and plot microcontroller application values.

Troubleshoot and debug microcontroller applications.

The WebGPI-Log application is a high-speed data-logging tool. The WebGPI-Log


application data acquisition rates are typically twice as fast as the WebGPI application
rates The WebGPI-Log application installs along with the WebGPI application.

K28601 Rev FB November 2012

WebGPI Communication Software


User Manual
WebGPI Application
This chapter describes the windows, controls, and indicators in the WebGPI application.
T The screen captures shown in this chapter may differ slightly from the screens in your
version of the WebGPI application.
Chapter contents

WebGPI Window .......................................................................................................................................... 8


About the View Menu ..............................................................................................................................13
File Creation Window...............................................................................................................................17
Downloader Pane ......................................................................................................................................19
About File Names ......................................................................................................................................21
Configuration Pane ...................................................................................................................................22
Offline Window...........................................................................................................................................23
Information Window ................................................................................................................................28
Debug Mode Pane ....................................................................................................................................29
Data Logging Pane ...................................................................................................................................30

K28601 Rev FB November 2012

WebGPI Communication Software


User Manual
WebGPI Application
WebGPI Window
Path: Start menu > Programs >WebGPI > WebGPI

The Sauer-Danfoss WebGPI window displays when you start the WebGPI application. The
controls in this window access application functions and display application information.
WebGPI Window
Item

Description

Menu bar

Accesses WebGPI application functions and displays application information.


For more information, see Menu Bar on page 9.

Toolbar

Provides quick access to major WebGPI application functions and display important application information.
For more information, see Toolbar on page 11.

Main pane

The panes that display here enable you to view, change, and log microcontroller application values.
For more information, see About the View Menu on page 13.

K28601 Rev FB November 2012

WebGPI Communication Software


User Manual
WebGPI Application

Menu Bar

The Menu bar accesses WebGPI application functions and information.


T The Toolbar duplicates many Menu bar selections.
Menu Bar
Item

Description

File

Commands in this menu create and download microcontroller files.

Save

Displays the File Creation window.


This window creates default tuning value files and data logging files for the WebGPI-Log application.

Download

Displays the Downloader pane.


This pane downloads application files, default tuning values files, and kernel (operating system) files to
microcontrollers.

Communication
Configuration

The commands in this menu control communication between the WebGPI application and the microcontroller.
Displays the Configuration pane.
Use this pane to configure the COM port on your PC that communicates with the microcontroller.
Clicking Disconnect and closing communication with the microcontroller makes this command available.

Connect/
Disconnect
Tools
Graph

Opens and closes communication between the WebGPI application and the microcontroller.
This menus command plots data that you have logged and saved.
Displays the Open Real Time Performance window.
Use this window to chart (plot) data that you have logged and saved.

Information
Info Screen

The commands in this menu display information about the microcontroller application and open an Adobe
Acrobat portable document format (PDF) version of the microcontroller application manual.
Displays the Settings and System Info window.
This window displays information specific to the microcontroller hardware and application. Not all applications
have this window.

User Manual

Opens a PDF version of the microcontroller application manual. Not all applications have a manual.

K28601 Rev FB November 2012

WebGPI Communication Software


User Manual
WebGPI Application
Menu Bar
Item

Description

Help

The commands in this menu open the WebGPI manual and access the Sauer-Danfoss home page.

10

WebGPI Manual

Opens a PDF version of this WebGPI User Manual.

Sauer-Danfoss
WebPage

Opens the Sauer-Danfoss home page if you have an active internet connection.

K28601 Rev FB November 2012

WebGPI Communication Software


User Manual
WebGPI Application

Toolbar

Toolbar buttons and controls provide quick access to WebGPI application functions.
T The Menu bar duplicates many Toolbar selections.
Toolbar
Item

Description
Displays the File Creation window.
This window creates default tuning value files. It also creates files that define the data to be logged in the WebGPI-Log
application.
Displays the Downloader pane.
This pane manages downloads to microcontrollers.
Connectopens communication between the WebGPI application and the microcontroller.
Disconnectcloses communication between the WebGPI application and the microcontroller.
Starts communication between the WebGPI application and the microcontroller.
The WebGPI application automatically loads the microcontroller application interface once communication begins.
Displays Debug Mode pane.
This pane directly sets microcontroller inputs and output values. It allows you to bypass the microcontroller
application for troubleshooting purposes.
Not all microcontroller applications have a debug mode.
Displays the Settings and System Info window.
This window displays information that is specific to the microcontroller hardware and application.
Not all microcontroller applications have this window.
Selects an application for review when you are not connected to a microcontroller.
Disconnecting from a microcontroller makes this button available.
Decreases or increases text and graphic sizes in selected panes.
Toggles the view between the current view and the previous view.

Portselects the RS 232-C port that the WebGPI application uses to communicate with the microcontroller.
Baudrateselects the data transmission rate between the WebGPI application and the microcontroller.
Microcontrollers that use Motorola 68HC08 and 68HC08A processors automatically connect at 9600 baud.
Microcontrollers that use Infineon 167 and Intel 196 processors automatically connect at 19200 baud.
Baudrate replaces Port when you connect to the microcontroller.

K28601 Rev FB November 2012

11

WebGPI Communication Software


User Manual
WebGPI Application
Toolbar
Item

Description
Changes views in the WebGPI window. For more information, see About the View Menu on page 13.

Displays the following information when you connect to the microcontroller:


Software-P/Ndisplays the microcontroller application software part number.
Hardware-IDdisplays the microcontroller hardware identification number.
Machine Default ID-Numberdisplays the default tuning value set identification number.
OS Versiondisplays the version of the kernel used in the microcontroller processor.
Status indicators

Show the current WebGPI application status.


The WebGPI application is not connected to the microcontroller.
The WebGPI application is connected to the microcontroller.
The microcontroller application interface is open.
The WebGPI application is creating a hexadecimal format file (*.hex) containing current microcontroller tuning values.
The WebGPI application is creating a C format header file (*.h) with the current microcontroller application tuning
values.
The WebGPI application is creating an extensible markup language file that contains the current microcontroller
tuning values (*.xml).
The WebGPI application is downloading a file to the microcontroller.

12

K28601 Rev FB November 2012

WebGPI Communication Software


User Manual
WebGPI Application

About the View Menu


The pull-down View menu lets you select between Normal, Main, Data Logging, and
Main 50% views.
Normal View

The Normal view splits the WebGPI window into a Navigation pane and a Parameter pane.

The Navigation pane lists all the parameter sets used in the microcontroller
application. Folders organize similar parameter sets.

The Parameter pane displays parameter sets. Click in the Navigation pane to select a
parameter set for display.

Use these panes to view and change parameter values when you are connected to a
microcontroller.

Use these panes to review parameters when you are not connected to a
microcontroller. You can view a sample set of parameters but not change their values.

K28601 Rev FB November 2012

13

WebGPI Communication Software


User Manual
WebGPI Application
Main View

The Main view displays a single Main pane, typically used to view block diagrams.

14

K28601 Rev FB November 2012

WebGPI Communication Software


User Manual
WebGPI Application

Data Logging View

The Data Logging view displays the Data Logging pane.

Use this pane to log and plot application values in real time.

Use the controls in this pane to start and stop data logging, save data for offline
viewing, and change the appearance of data logging charts.

K28601 Rev FB November 2012

15

WebGPI Communication Software


User Manual
WebGPI Application
Main 50% View

The Main 50% view splits the WebGPI window horizontally, with the Data Logging pane
initially taking up the lower 50% of the window.

16

K28601 Rev FB November 2012

WebGPI Communication Software


User Manual
WebGPI Application

File Creation Window

This window creates default tuning value files. It also creates files that define the data to
be logged in the WebGPI-Log application.
File Creation Window
Item

Description

Default value from Micro

The HEADER, HEX, and XML selections become available when the WebGPI application connects to the
microcontroller application.
HEADERselect to create a C header file (*.h) with the current microcontroller application tuning values.
Sauer-Danfoss can use this file as the source for default tuning values when it compiles a new version of the
microcontroller application.
HEXselect to create a hexadecimal file (*.hex) with the current microcontroller application tuning values.
The values in this file become the default tuning values when you download this file to a microcontroller application.
This selection makes the Machine Default Identification Number available.
XMLselect to create an extensible markup language file (*.xml) with the current microcontroller application tuning
values.
Use this file format to store tuning values. You can use these files to create HEADER and HEX files without a
connection to the microcontroller application.
XML (Datalogging)select to create an xml data log file (*.xml). An xml data log file identifies values to be logged in
the WebGPI-Log application.

K28601 Rev FB November 2012

17

WebGPI Communication Software


User Manual
WebGPI Application
File Creation Window
Item

Description

Default value from XMLFile

Creates C header files (*.h) and hexadecimal files (*.hex) containing tuning values from a selected xml source file.
HEADERselect to create a C header file from a selected xml format source file.
HEXselect to create a hexadecimal file from a selected xml format source file.
The values in this hexadecimal file become the default tuning values when you download this file to a microcontroller
application.
The HEX selection makes the Machine Default Identification Number available.

Search

Displays a Select File window.


Use this window to select the xml file that contains the tuning values for the HEADER or HEX file that you are
creating.

Machine Default
Identification Number

Enters the suffix appended to the microcontroller application file name that identifies the default tuning value set.

Search

Displays a Select File window.


Use this window to name the file you are saving or to overwrite an existing file.

Create

18

Creates the file.

K28601 Rev FB November 2012

WebGPI Communication Software


User Manual
WebGPI Application

Downloader Pane

This pane downloads application files, default tuning values files, and kernel files to
microcontrollers.
Downloader Pane
Item

Description

Microcontroller type

Selects the download protocol appropriate for the processor used in the microcontroller.
The WebGPI application automatically selects the correct processor type when it connects to the microcontroller.
You must select the correct type of processor if the WebGPI application fails to connect to the microcontroller.
HC08selects the Motorola 68HC08 processor download protocol.
167selects the Infineon 167 processor download protocol.
196selects the Intel 196 processor download protocol.
HC12selects the Motorola 68HC12 processor download protocol.
HC08Aselects the Motorola 68HC08A processor download protocol.
164selects the Infineon 164 processor download protocol.
TIselects the Texas Instruments (TI) processor download protocol.

K28601 Rev FB November 2012

19

WebGPI Communication Software


User Manual
WebGPI Application
Downloader Pane
Item

Description

File type

Applicationdisplays the controls needed to download a microcontroller application.


Kerneldisplays the controls needed to download a kernel (the core of a microcontroller operating system).
Defaultsdisplays the controls needed to download a tuning parameter defaults file.
File name filterapplies a filter in the Select File window that displays only files appropriate for your File type
download selection and Microcontroller type selection
This filter works with file names that conform to the Sauer-Danfoss naming convention. For more information, see
About File Names on page 21.
File Checkcheck to have the WebGPI application verify that the file is suitable for the microcontroller processor type
before downloading it.
Empty Security bytecheck when downloading a kernel to a 68HC08 or 68HC08A processor that has never been
programmed. Typically, this is not used.

Search

Displays a Select File window.

(for application, kernel,


and defaults files)

Use this window to select an application, kernel, or defaults file to download.

Search
(for boot files)

Displays a Select File window.

The text box to the left of Search identifies the name and location of the file.

Use this window to select the boot file required to download a kernel.
The text box to the left of Search identifies file type, file location, and name of the selected file.
Selecting Kernel and a Microcontroller type of HC08, 167, HC08A, or 164 makes this button available.

Force download/
Stop forcing download

Forces a connection to the microcontroller.

Boot-file download

Starts the download of a boot file.

The button becomes available when the WebGPI application cannot normally connect to the microcontroller.

Selecting Kernel and a Microcontroller type of HC08, 167, HC08A, or 164 makes this button available.
Download

Starts a download of an application or kernel file.

Instruction

Displays instructions to help you download files.

Progress indicator

Identifies the defaults, application, and kernel used in the microcontroller.


During a download, it indicates the progress of the download.

20

K28601 Rev FB November 2012

WebGPI Communication Software


User Manual
WebGPI Application

About File Names


Sauer-Danfoss adopted the following format in March 2002 for application, default, and
kernel file names.
The Downloader panes File name filter works with file names that follow this format.
With File name filter checked, the Select File window displays only files appropriate for
your download selection and processor type.
Application File Names

Microcontroller application file names use the format shown above.


Default File Names

Microcontroller application default tuning file names use the format shown above.
Kernel File Names

Kernel file names use the format shown above.

K28601 Rev FB November 2012

21

WebGPI Communication Software


User Manual
WebGPI Application
Configuration Pane
Path: Communication menu > Configuration

This pane configures the COM port that WebGPI application uses to communicate with
the microcontroller.
T To display this pane, first disconnect the WebGPI application from the microcontroller.
Configuration Pane
Item

Description

RS232

Configures the RS-232-C COM port that the WebGPI application uses to communicate with the microcontroller.

Connection timeout

Sets the time that the WebGPI application waits for a response indicating a successful initial connection before trying
another baud rate.
The WebGPI application displays an alert message if all connection attempts fail.

Standard timeout

Sets the time that the WebGPI application waits for a response during normal operation before trying another baud rate.
The WebGPI application displays an alert message if all connection attempts fail.

Input buffer size

Sets the input buffer size.

Output buffer size

Sets the output buffer size.

User Name

Not implemented in this release.

Application Name

Not implemented in this release.

22

K28601 Rev FB November 2012

WebGPI Communication Software


User Manual
WebGPI Application

Offline Window
Path: Tools menu > Graph

This window displays charts of data that you have logged and saved.
T Use the Data Logging pane (page 30) to log data when you are connected to a
microcontroller.
Offline Window
Item

Description

Chart menu bar

Commands in this menu bar format charts.

Chart toolbar

Buttons in this toolbar format charts.

Chart area

Displays charts of data that you have logged and saved.

K28601 Rev FB November 2012

23

WebGPI Communication Software


User Manual
WebGPI Application
Offline Window Chart Menu Bar

Commands in this menu bar format charts.


Offline Window Chart Menu Bar
Menu

Description

File

Open Chart commanddisplays the Open window. Use this window to select and open a ChartFX *cfx format file.
Save Chart commanddisplays the Save As window. Use this window to save a chart in the ChartFX *cfx file format.
Page Setup commanddisplays the Page Setup window. Use this window to set the charts print margins and paper
orientation.
Print commanddisplays the Print window. Use this window to print out the chart.

Copy to Clipboard

As a Bitmap commandcopies a bitmap image of the chart to the clipboard.


As a Metafile commandcopies a Windows Metafile image of the chart to the clipboard.
As Text (data only) commandcopies tab-delimited chart data points to the clipboard.

View

3D/2D commandswitches between two-dimensional and three-dimensional chart views.


Clustered (Z Axis) commandclusters the chart along its z axis.
Properties commandDisplays a Properties window with the following tabs:
Y Axis tabsets labeling, tick marks, and gridlines for the y axis.
Series tabdefines the display and formatting of series.
General tabsets general properties such as the screen title and screen background colors.

Tools

Values Legend commandDisplays a values legend.


Series Legend commandDisplays a series legend.
User Legend commandDisplays a user legend.
Data Editor commanddisplays a table at the bottom of the chart.
This table shows the value and acquisition time of each data point in the chart.
Use the slider bar to access data points in the chart and in the table.
Changing a data point value in the table also changes the data point in the chart.
Toolbar commandhides the toolbar.
To restore the toolbar, right-click the chart. In the pop-up menu that displays, click Toolbar.
Menu commandhides the menu bar. To restore the menu bar, close and reopen the chart.

24

K28601 Rev FB November 2012

WebGPI Communication Software


User Manual
WebGPI Application

Offline Window Chart Menu Bar


Menu

Description

Help

Contents commanddisplays the contents of the help file.


Search commandsearches the help file.
About ChartFX commanddisplays information about ChartFX software.

K28601 Rev FB November 2012

25

WebGPI Communication Software


User Manual
WebGPI Application
Offline Window Chart Toolbar

Buttons in this toolbar format charts.


Offline Window Chart Toolbar Buttons
Button

Name

Description

Personalized Charts

Displays a menu with commands that save and apply chart settings.
Load My Chart commandapplies the chart settings that have been saved through the Save My Chart
command to the currently displayed chart.
Save My Chart commandsaves the chart settings that are applied to the current chart.
Restore Defaults commandapplies the default settings to the currently displayed chart.

Copy to Clipboard

Displays a menu with copy commands.


As a Bitmap commandcopies a bitmap image of the chart to the clipboard.
As a Metafile commandcopies a Windows Metafile image of the chart to the clipboard.
As Text (data only) commandcopies tab-delimited chart data points to the clipboard.

Print

Displays a Print window. Use this window to print the chart.

Gallery

Displays a palette with line, bar, and other chart types. Click a selection to change the way data displays.

Anti-Aliasing

Applies anti-aliasing to smooth the display of chart lines.

Palette Selector

Displays a palette with color schemes that can be applied to charts.


Click a color scheme to apply the scheme to the chart.

3D/2D

Switches between two-dimensional and three-dimensional chart views.


Selecting a three-dimensional chart view enables the Rotated View button.

Rotated View

Rotates the chart along its z axis.


Selecting a rotated chart view enables the Rotate Around Y Axis and Rotate Around X Axis buttons.

26

Rotate Around Y
Axis

Rotates the chart around its y axis.

Rotate Around X
Axis

Rotates the chart around its x axis.

Clustered (Z Axis)

Clusters the chart along its z axis.

K28601 Rev FB November 2012

WebGPI Communication Software


User Manual
WebGPI Application

Offline Window Chart Toolbar Buttons


Button

Name

Description

Axes Settings

Displays a menu with commands that change how the x axis and y axis display.
Grid commandsturns on and off tick mark grid lines.
Interlaced commandapplies alternate light and dark (interlaced) backgrounds between y-axis tick marks.
Show Labels commandlabels x-axis tick marks.
Staggered commandstaggers the labels applied to the x-axis tick marks.
Vertical labels commandrotates by 90 the labels applied to the x-axis tick marks.
Options commanddisplays a Properties window with the following tabs:
Y Axis tabsets labeling, tick marks, and gridlines for the y axis.
Series tabdefines the display and formatting of series.
General tabsets general properties such as the screen title and screen background colors.

Point Labels

Applies labels to each data point in the chart.

Data Editor

Displays a table at the bottom of the chart.


This table shows the value and acquisition time of each data point in the chart.
Use the slider bar to access data points in the chart and in the table.
Changing a data point value in the table also changes the data point in the chart.

Legend Box

Displays legends that identify the chart data.

Zoom

Enables a zoom tool.


Click and drag in the chart to zoom in on specific areas. Click on the button to zoom out.

Properties

Displays a Properties window with the following tabs:


Y Axis tabsets labeling, tick marks, and gridlines for the y axis.
Series tabdefines the display and formatting of series.
General tabsets general properties such as the screen title and screen background colors.

K28601 Rev FB November 2012

27

WebGPI Communication Software


User Manual
WebGPI Application
Information Window
Path: Information menu > Info Screen

Use this window to view information about the microcontroller application and its
hardware.
The type of microcontroller application determines the type of information displayed. Not
all applications have this window.
T You must connect to the microcontroller to view hardware information.

28

K28601 Rev FB November 2012

WebGPI Communication Software


User Manual
WebGPI Application

Debug Mode Pane

This pane allows you to view microcontroller inputs and directly set microcontroller
outputs when the WebGPI application is in the debug mode.
Clicking IO Test puts the WebGPI application in a troubleshooting debug mode that
bypasses the microcontroller application. To enter the debug mode, you must connect to
the microcontroller without opening the microcontroller application interface.
Warning
The debug mode directly applies output values. It bypasses fault and limit protections.
Changing outputs can cause sudden and unexpected machinery movements that can
result in personal injury and equipment damage.
Understand the consequences of changing microcontroller outputs. Be prepared for sudden
vehicle and machinery movements.

K28601 Rev FB November 2012

29

WebGPI Communication Software


User Manual
WebGPI Application
Data Logging Pane
View menu > Data Logging or Main 50%

Use this pane to plot and save run-time data when you are connected to a microcontroller
application.
Data Logging controls are the same whether your View menu selection is Main or Main
50%.
T The WebGPI-Log application can log data at much higher acquisition rates than the
logging function described here.
Data Logging Pane
Item

Description

Data logging toolbar

Controls in this toolbar start and stop data logging and set data acquisition parameters such as the update time and
the logging time.

Chart menu bar

Commands in this menu bar format charts.

Chart toolbar

Buttons in this toolbar format charts.

Chart area

Displays a chart of the data that you are logging.

30

K28601 Rev FB November 2012

WebGPI Communication Software


User Manual
WebGPI Application

Data Logging Pane Toolbar

Controls in this toolbar:

Start and stop data logging.

Set data acquisition parameters such as the update time and the logging time.

Data Logging Pane Toolbar


Item

Description
Starts data logging.
You must select data to log to make this button available.
Stops data logging.
Clicking Start Logging makes this button available.
Automatically finds the optimum update time based on your data logging selections.
This button becomes available when you select data to log.
Stops data logging, clears data log selections, empties the data buffer, and closes the Data Logging pane.

Sets the data acquisition rate.

Sets how many minutes of pre-trigger data are logged when a trigger event occurs.

Sets how many minutes of data are written to a buffer.


The buffer is circular. When the buffer fills, the newest data overwrites the oldest data. Data logging continues until
you click Stop Logging.
When a data trigger occurs, logging continues until new data (including any Pretrigger time data) fills the data
buffer. Then data logging stops.

K28601 Rev FB November 2012

31

WebGPI Communication Software


User Manual
WebGPI Application
Data Logging Pane Chart Menu Bar

Commands in this menu bar format charts.


Data Logging Pane Chart Menu Bar
Menu

Description

File

Open Chart commanddisplays the Open window. Use this window to select and open a ChartFX *cfx format file.
Save Chart commanddisplays the Save As window. Use this window to save a chart in the ChartFX *cfx format file.
Page Setup commanddisplays the Page Setup window. Use this window to set the charts print margins and paper
orientation.
Print commanddisplays the Print window. Use this window to print out the chart.

Copy to Clipboard

As a Bitmap commandcopies a bitmap image of the chart to the clipboard.


As a Metafile commandcopies a Windows Metafile image of the chart to the clipboard.
As Text (data only) commandcopies tab-delimited data points from the chart to the clipboard.

View

3D/2D commandswitches between two-dimensional and three-dimensional chart views.


Clustered (Z Axis) commandclusters the chart along its z axis.
Properties commanddisplays a Properties window with the following tabs:
Y Axis tabsets labeling, tick marks, and gridlines for the y axis.
Series tabdefines the display and formatting of series.
General tabsets general properties such as the screen title and screen background colors.

Tools

Values Legend commandDisplays a values legend.


Series Legend commandDisplays a series legend.
User Legend commandDisplays a user legend.
Data Editor commanddisplays a table at the bottom of the chart.
This table shows the value and acquisition time of each data point in the chart.
Use the slider bar to access data points in the chart and in the table.
Changing a data point value in the table also changes the data point in the chart.
Toolbar commandhides the toolbar. To restore the toolbar, right-click the chart. In the pop-up menu that displays, click
Toolbar.
Menu commandhides the menu bar. To restore the menu bar, close and reopen the chart.

32

K28601 Rev FB November 2012

WebGPI Communication Software


User Manual
WebGPI Application

Data Logging Pane Chart Menu Bar


Menu

Description

Help

Contents commanddisplays the contents of the help file.


Search commandsearches the help file.
About ChartFX commanddisplays information about ChartFX software.

K28601 Rev FB November 2012

33

WebGPI Communication Software


User Manual
WebGPI Application
Data Logging Pane Chart Toolbar

Buttons in this toolbar format charts.


Data Logging Pane Chart Toolbar Buttons
Button

Name

Description

Personalized Charts

Displays a menu with commands that save and apply chart settings.
Load My Chart commandapplies the chart settings that have been saved through the Save My Chart
command to the currently displayed chart.
Save My Chart commandsaves the chart settings that are applied to the current chart.
Restore Defaults commandapplies the default settings to the currently displayed chart.

Copy to Clipboard

Displays a menu with copy commands.


As a Bitmap commandcopies a bitmap image of the chart to the clipboard.
As a Metafile commandcopies a Windows Metafile image of the chart to the clipboard.
As Text (data only) commandcopies tab-delimited chart data points to the clipboard.

Print

Displays a Print window. Use this window to print the chart.

Gallery

Displays a palette with line, bar, and other chart types. Click a selection to change the chart type.

Anti-Aliasing

Applies anti-aliasing to smooth the display of chart lines.

Palette Selector

Displays a palette with color schemes that can be applied to charts.


Click a color scheme to apply the scheme to the chart.

3D/2D

Switches between two-dimensional and three-dimensional chart views.


Selecting a three-dimensional chart view enables the Rotated View button.

Rotated View

Rotates the chart along its z axis.


Selecting a rotated chart view enables the Rotate Around Y Axis and Rotate Around X Axis buttons.

34

Rotate Around Y
Axis

Rotates the chart around its y axis.

Rotate Around X
Axis

Rotates the chart around its x axis.

Clustered (Z Axis)

Clusters the chart along its z axis.

K28601 Rev FB November 2012

WebGPI Communication Software


User Manual
WebGPI Application

Data Logging Pane Chart Toolbar Buttons


Button

Name

Description

Axes Settings

Displays a menu with commands that change how the x axis and y axis display.
Grid commandsturns on and off tick mark grid lines.
Interlaced commandapplies alternate light and dark (interlaced) backgrounds between y-axis tick marks.
Show Labels commandlabels x-axis tick marks.
Staggered commandstaggers the labels applied to the x-axis tick marks.
Vertical labels commandrotates by 90 the labels applied to the x-axis tick marks.
Options commanddisplays a Properties window with the following tabs:
Y Axis tabsets labeling, tick marks, and gridlines for the y axis.
Series tabdefines the display and formatting of series.
General tabsets general properties such as the screen title and screen background colors.

Point Labels

Applies labels to each data point in the chart.

Data Editor

Data Editor commanddisplays a table at the bottom of the chart.


This table shows the value and acquisition time of each data point in the chart.
Use the slider bar to access data points in the chart and in the table.
Changing a data point value in the table also changes the data point in the chart.

Legend Box

Displays legends that identify the chart data.

Zoom

Enables a zoom tool.


Click and drag in the chart to zoom in on specific areas. Click on the button to zoom out.

Properties

Displays a Properties window with the following tabs:


Y Axis tabsets labeling, tick marks, and gridlines for the y axis.
Series tabdefines the display and formatting of series.
General tabsets general properties such as the screen title and screen background colors.

K28601 Rev FB November 2012

35

WebGPI Communication Software


User Manual
WebGPI Application
(This page is intentionally blank.)

36

K28601 Rev FB November 2012

WebGPI Communication Software


User Manual
WebGPI-Log Application
This chapter describes the WebGPI-Log applications windows and their controls and
indicators.
The WebGPI-Log application data acquisition rates are typically twice as fast as the
WebGPI application rates.
T The screen captures shown in this chapter may differ slightly from the screens in your
version of the WebGPI-Log application.
Chapter contents

WebGPI-Log Window .......................................................................................................................................38


WebGPI-Log Window Toolbar ......................................................................................................................39
Data Logging Pane ............................................................................................................................................42

K28601 Rev FB November 2012

37

WebGPI Communication Software


User Manual
WebGPI-Log Application
WebGPI-Log Window
Path: Start menu > Programs > WebGPI > WebGPI-Log

This window opens when you start the WebGPI-Log application. Use the controls in this
window to access application functions.
WebGPI-Log Window
Item

Description

Data Logging pane

Once you select data to log, this pane displays a chart of the data and Chart menu and a Chart toolbar to format the data.

Toolbar

Buttons and controls provide quick access to WebGPI-Log application functions.

38

K28601 Rev FB November 2012

WebGPI Communication Software


User Manual
WebGPI-Log Application

WebGPI-Log Window Toolbar

Toolbar buttons and controls provide quick access to WebGPI-Log application functions.
WebGPI-Log Toolbar
Item

Description
Connect buttonopens communication between the WebGPI-Log application and the microcontroller.
Disconnect buttoncloses communication between the WebGPI-Log application and the microcontroller.

Starts communication between the microcontroller and the WebGPI application on the selected RS 232-C port.
Click the Disconnect button to make this control available.
Selects the data transmission rate between the WebGPI-Log application and the microcontroller.
The WebGPI-Log application automatically selects the optimum rate.
After you connect to the microcontroller, items in this pull-down menu can display the following information:
Software-P/Ndisplay the microcontroller application software part number.
Hardware-IDdisplay the microcontroller hardware identification number.
Machine Default ID-Numberdisplay the default tuning value set identification number.
OS Versiondisplay the version of the kernel (operating system) used in the microcontroller.
EC-Processor typedisplay the processor type used in the microcontroller.

Shows the name of the currently selected screen collection.


Start Logging buttonstarts the data logging process.
To make the Start Logging button available, you must connect to the microcontroller and select a screen file
(data logging file) to write data to.
Stop Logging buttonstops the data logging process.
Shows the data acquisition rate.

Sets how many minutes of pre-trigger data log when a trigger event occurs.

K28601 Rev FB November 2012

39

WebGPI Communication Software


User Manual
WebGPI-Log Application
WebGPI-Log Toolbar
Item

Description
Sets how many minutes of data are written to a buffer.
The buffer is circular. When the buffer fills, the newest data overwrites the oldest data. Data logging continues
until you click Stop Logging.
When a data trigger occurs, logging continues until new data (including any Pretrigger time data) fills the data
buffer. Then data logging stops.
File menu > Save Chart writes the contents of the buffer to a ChartFX *.chd format file.
Click to display two additional buttons:
Edit Collection buttonopens the Edit Chart Collection List window. This window lists the xml data log
files in the currently selected chart collection. Use this window to add and remove xml data log files from the
chart collection.
You create xml data log files in the WebGPI applications File Creation windowAdd Chart buttonopens the
Add Chart to Collection window. Use this window to add xml data log files to the currently selected chart
collection.
Click to display the:
New buttonopens the Create New Chart Collection window. Use this window to name a new chart
collection.
Open buttonopens the Open Chart Collection button. Use this window to select and open a chart
collection.
Save buttondisplays the Save Chart Collection button. Use this window to save a chart collection
Click this button to save changes made in the Edit Chart List Collection window.
Displays information about the WebGPI-Log application and Sauer-Danfoss.

About XML Data Log Files, Chart Collections, and ChartFX Files

XML data log files are extensible mark-up language files (*.xml) that:

You create in the WebGPI applications File Creation window.


Define the data to be logged, but do not contain data.

Chart collections:

Contain sets of xml data log files.


Have *.gpi extensions.

ChartFX (*.chd) files:

Define the formatting of the logged data.


Store the data that has been logged.

40

K28601 Rev FB November 2012

WebGPI Communication Software


User Manual
WebGPI-Log Application

Edit Chart Collection List Window

This window lists the xml data log files in the currently selected chart collection. Use this
window to add and remove xml data log files from the chart collection.
T The Close button temporarily applies the changes made in this window to the chart
collection displayed in the WebGPI-Log window. Click the Collection button > Save
button in the WebGPI-Log window to make changes permanent.

Edit Chart Collection List Window


Item

Description

Chart collection list

Lists the xml data log files in the chart collection.


You create these xml data log files in the WebGPI applications File Creation window. They define the data to be
logged.

Add Chart button

Opens the Add Chart to Collection window.


Use this window to select xml data log file to the chart collection.

Remove Chart button

Temporarily removes an xml data log file from the chart collection.

Close button

Closes the Edit Chart Collection window and applies the changes made in this window to the chart displayed in the
data logging pane.
Click the Collection > Save buttons to save any changes made in the Edit Chart Collection window.

K28601 Rev FB November 2012

41

WebGPI Communication Software


User Manual
WebGPI-Log Application
Data Logging Pane

This pane displays a chart of the data you selected to log, along with a Chart menu and
toolbar to format the display of data.
T The Chart menu, Chart toolbar, and Data chart display after you select an xml data log
file that identifies the data to be logged.
Data Logging Pane
Item

Description

Chart menu

Accesses all charting functions.

Chart toolbar

Quickly accesses major charting functions.

Chart

Displays a chart.

42

K28601 Rev FB November 2012

WebGPI Communication Software


User Manual
WebGPI-Log Application

Chart Menu

This menu accesses all charting functions.


T This menu displays after you select an xml data log that identifies data to be logged.
Chart Menu
Item

Description

File

Commands in this menu save, open, and print charts.

Save Chart

Opens the Save As window.


Use this window to save a chart with logged data to a ChartFX *.chd file. The ChartFX *.chd file also saves the formatting
applied to the screen.

Open Chart

Opens the Open window.


Use this window to open ChartFX *.chd files and ChartFX *.chd template files.

Save Template

Opens the Save As window.


Use this window to save chart formatting selections to a ChartFX *.chd template file. A chart template file has no data.

Open Template

Opens the Open window.


Use this window to apply the formatting in a ChartFX *.chd template file to a chart. Applying a formatting selection to a chart
deletes all the data in the chart.

Print Preview

Opens the Page setup window.


Use this window to set up the chart for printing.

Print

Opens the Print window.


Each printed page contains approximately 18 data collection points.

Edit
Copy to
clipboard

Commands in this menu copy charts to the clipboard and change the appearance of text in the chart.
Copies the chart to the clipboard in these formats:
As a Bitmap commandcopies a bitmap image of the chart to the clipboard.
As a Metafile commandcopies a Windows Metafile image of the chart to the clipboard.
As Text (data only) commandcopies tab-delimited data points to the clipboard.
As OLE Object commandcopies an object linking and embedding (OLE) image of the chart to the clipboard.

Fonts

Changes the font, size, and style of text elements in the chart.

K28601 Rev FB November 2012

43

WebGPI Communication Software


User Manual
WebGPI-Log Application
Chart Menu
Item

Description

Tools

Commands in this menu label chart data and display toolbars that change chart colors and patterns.

Values legend

Labels values in the chart.

Series legend

Labels the data series in the chart.

Data Editor

Displays a table at the bottom of the chart.


This table shows the value and acquisition time of each data point in the chart.
Use the slider bars to access data points in the chart and in the table.
Changing a data point value in the table also changes the data point in the chart.

Toolbar

Opens a toolbar with buttons that quickly access common chart commands.

PaletteBar

Opens a palette with colors that you can drag and apply to chart elements.

PatternBar

Opens a palette with patterns that you can drag and apply to chart elements.

View

Commands in this menu change how the chart formats its data.

3D/2D

Switches between two-dimensional and three-dimensional chart views.

Rotate

Select a three-dimensional view of screen data to make this command available.


Opens a ChartFX Properties window with the following tabs:
3D tabdefines three-dimensional views of chart data.
Axes tabsets labeling, tick marks, and gridlines for axes.
Series tabdefines the display and formatting of series.
General tabsets general properties such as the screen title and screen background colors.
Click this windows Help button for more information.

Z-Clustered

Displays data clustered along the charts z-axis. Not available for all charts.

Properties

Opens a ChartFX Properties window with the following tabs:


3D tabdefines three-dimensional views of chart data.
Axes tabsets labeling, tick marks, and gridlines for axes.
Series tabdefines the display and formatting of series.
General tabsets general properties such as the screen title and screen background colors.
Click this windows Help button for more information.

Zoom

Zooms on the chart.


To zoom in, click the Zoom command. Click and drag in the chart to enlarge a selected area.
To zoom out, click the Zoom command.

Gallery

Opens a palette with line, bar, and other chart types. Click a selection to change the chart type.

Help

Commands in this menu access information about ChartFX software.

44

Contents

Opens the contents of Help.

Search

Searches the Help index.

About ChartFX

Displays information about ChartFX software.

K28601 Rev FB November 2012

WebGPI Communication Software


User Manual
WebGPI-Log Application

Chart Toolbar

This toolbar accesses major charting functions.


T A chart must be selected to display this toolbar.
Chart Toolbar
Button

Name

Description

Open Chart

Opens the Open window.


Use this window to open ChartFX *.chd files and ChartFX *.chd template files.

Save Chart

Opens the Save As window.


Use this window to save a chart or a chart template in the ChartFX CHD file format.
A chart file has data and chart display selections. A chart template file has chart display selections but no data.

Copy to
Clipboard

Copies the chart to the clipboard in these formats:


As a Bitmap commandcopies a bitmap image of the chart to the clipboard.
As a Metafile commandcopies a Windows Metafile image of the chart to the clipboard.
As Text (data only) commandcopies tab-delimited data points to the clipboard.
As OLE Object commandcopies an object linking and embedding (OLE) image of the chart to the clipboard.

Gallery

Opens a palette with line, bar, and other chart types. Click a selection to change the chart type.

Color

Applies colors to elements in the chart.


To apply a color, select a color in this tools palette, and drag the paint bottle to the element.

Vertical
Grid

Applies a vertical grid to the chart.

Horizontal
Grid

Applies a horizontal grid to the chart.

Legend
Box

Displays legends that identify the data series in the chart.

Data Editor

Displays a table at the bottom of the chart.


This table shows the value and acquisition time of each data point in the chart.
Use the slider bars to access data points in the chart and in the table.
Changing a data point value in the table also changes the data point in the chart.

K28601 Rev FB November 2012

45

WebGPI Communication Software


User Manual
WebGPI-Log Application
Chart Toolbar
Button

Name

Description

Properties

Opens a ChartFX Properties window with the following tabs:


3D tabdefines three-dimensional views of chart data.
Axes tabsets labeling, tick marks, and gridlines for axes.
Series tabdefines the display and formatting of series.
General tabsets general properties such as the chart title and chart background colors.
Click this windows Help button for more information.

2D/3D

Switches between two-dimensional and three-dimensional chart views.

Rotate

Select a three-dimensional view of chart data to enable this button.


Opens a ChartFX Properties window with the following tabs:
3D tabdefines three-dimensional views of chart data.
Axes tabsets labeling, tick marks, and gridlines for axes.
Series tabdefines the display and formatting of series.
General tabsets general properties such as the chart title and chart background colors.
Click this windows Help button for more information.

Z-Clustered

Displays data clustered along the charts z-axis. Not available for all charts.

Zoom

Zooms in and out on the data chart.


To zoom in, click this button. Click and drag in the chart to enlarge a selected area. To zoom out, click again on this
button.
Opens the Page setup window.

Print
Preview

Use this window to set up the chart for printing.

Print

Prints the chart to the selected printer.

Tools

Opens a menu with the following commands:


Series legend commandlabels the data series in the chart.
Data Editor commanddisplays a table at the bottom of the chart.
This table shows the value and acquisition time of each data point in the chart.
Use the slider bars to access data points in the chart and in the table.
Changing a data point value in the table also changes the data point in the chart.
Toolbar commandopens the Chart toolbar.
PaletteBar commandopens a palette with colors that you can drag and apply to chart elements.
PatternBar commandopens a palette with patterns that you can drag and apply to chart elements.

46

K28601 Rev FB November 2012

WebGPI Communication Software


User Manual
How to Use the WebGPI Application
This chapter contains step-by-step instructions for performing common WebGPI tasks.
T The screen captures shown in this chapter may differ slightly from the screens in your
version of the WebGPI application.
Chapter contents

How to Connect Your PC to a Microcontroller .......................................................................................48


How to Start Communication Between the WebGPI Application and a Microcontroller .....49
How to Change a Parameter Value .............................................................................................................50
How to Restore Defaults .................................................................................................................................52
How to Log Run-Time Data ............................................................................................................................53
About Selecting Values for Logging ...........................................................................................................56
How to Create an XML Data Log File for Use in the WebGPI-Log Application ..........................57
How to Download a Defaults or Application File to an HC08 or HC08A Processor .................59
How to Force Download an Application File to an HC08 or HC08A Processor .........................61
How to Download a Kernel to an HCO8 or an HC08A Processor ....................................................64
How to Force Download a Kernel to an HCO8 or HC08A Processor ..............................................68
How to Download an Application File to a 196 Processor.................................................................72
How to Force Download an Application File to a 196 Processor ....................................................75
How to Download a Kernel to a 196 Processor ......................................................................................78
How to Force Download a Kernel to a 196 Processor..........................................................................82
How to Download an Application or Defaults File to a 167 Processor .........................................86
How to Force Download an Application File to a 167 Processor ....................................................88
How to Download a Kernel to a 167 Processor ......................................................................................91
How to Force Download a Kernel to a 167 Processor..........................................................................94
How to Download an Application File to an HC12 Processor ..........................................................98
How to Download a Kernel to an HC12 Processor ............................................................................. 102
How to Force Download a Kernel to an HC12 Processor ................................................................ 105
How to Create a File with Microcontroller Data .................................................................................. 108
How to Download an Application File to TI Processor ..................................................................... 110

K28601 Rev FB November 2012

47

WebGPI Communication Software


User Manual
How to Use the WebGPI Application
How to Connect Your PC to a Microcontroller
The WebGPI application uses an RS-232-C COM port on your PC to communicate with
Sauer-Danfoss microcontrollers.
The table below lists the cables needed for communication with Sauer-Danfoss
microcontrollers through this COM port.
Cabling Requirements
Sauer-Danfoss Microcontroller

Sauer-Danfoss Cable Part Number

MC200

PN 1090740

MC400

PN 1090740

S2X

PN KW02027* or PN KW02012

MC300

PN KW02027* or PN KW02012

* Recommended cable.
This cable has a Prog/Read switch. Leave this switch set to Read.

ConnectorsSauer-Danfoss Cable PN 1090740

ConnectorsSauer-Danfoss Cable PN KW02027

48

K28601 Rev FB November 2012

WebGPI Communication Software


User Manual
How to Use the WebGPI Application

How to Start Communication between the WebGPI Application and a Microcontroller


1. Connect an appropriate RS-232-C cable between a COM port on your PC and the
Sauer-Danfoss microcontroller.

2. Connect to the microcontroller and open its application interface.


A. On your PC, start the WebGPI application.
B. As needed, use Port to select the correct COM port.
C. Click Connect to connect to the microcontroller.

Baudrate replaces Port and shows the current rate.

The Software P/N displays the application software part number.

D. Click Application to open the microcontroller application interface.

The Navigation pane lists the microcontroller application parameters.

The Parameter pane identifies the microcontroller application.

K28601 Rev FB November 2012

49

WebGPI Communication Software


User Manual
How to Use the WebGPI Application
How to Change a Parameter Value
1. Connect an appropriate cable between a COM port on your PC and the Sauer-Danfoss
microcontroller.
2. Start communication with the microcontroller (see page 49).

3. Navigate to the parameter set and select the value to be changed.


A. In the Navigation pane, click a parameter.
The Parameter pane displays the parameter you select.
B. In the Navigation pane, click the value you want to change.

50

K28601 Rev FB November 2012

WebGPI Communication Software


User Manual
How to Use the WebGPI Application

4. Change the selected value.


A. Enter the new value.
B. As required, enter the Password and set the PWLevel needed to change the
value.
C. Click Send.

K28601 Rev FB November 2012

51

WebGPI Communication Software


User Manual
How to Use the WebGPI Application
How to Restore Defaults

To restore defaults, click SetDefaults.

52

K28601 Rev FB November 2012

WebGPI Communication Software


User Manual
How to Use the WebGPI Application

How to Log Run-Time Data


T WebGPI-Log application data acquisition rates are typically twice as fast as the WebGPI
application rates. To log data in the WebGPI-Log application, you must first use the
WebGPI application to create an xml data log file that defines the values that you want
to log. For more information, see How to Create an XML Data Log File for Use in the
WebGPI-Log Application on page 57.
1. Connect an appropriate cable between a COM port on your PC and the Sauer-Danfoss
microcontroller.
2. Start communication with the microcontroller (see page 49).

3. Select the data to be plotted.


A. In the Navigation pane, click to open the block diagram with the data to be
plotted.
B. In the block diagram, click the data to be plotted.
Left-click to select data to log, without setting a data trigger.
Right-click to select data to log and set a data trigger in the DataLogging
window.

Until a data trigger occurs, new data overwrites the oldest data when the
buffer fills. Data logging continues until you click Stop Logging.

When a data trigger occurs, logging continues until new data (including any
Pretrigger time data) fills the data buffer and then stops.

K28601 Rev FB November 2012

53

WebGPI Communication Software


User Manual
How to Use the WebGPI Application

4. Open the data logging pane and start logging data.


A. In View, select Data Logging to display a full Data Logging pane.
B. Click on Find Update Time to automatically find the optimum update rate.
C. As needed, use selections in the Chart menu to set the appearance of the data.
D. As needed, enter a Pretrigger time and a Logging time.

E.

54

When you have defined a data trigger event, use the Pretrigger time to set
the amount of pretrigger data collected when the event occurs.

The Logging time sets the size of the data buffer.

Click on Start Logging to start logging data.

K28601 Rev FB November 2012

WebGPI Communication Software


User Manual
How to Use the WebGPI Application

5. Stop the data logging and save the data.


A. Click Stop Logging to stop data logging.
B. In the Chart menu, click the Save Chart button to open the Save As window. Use
this window to save a file of the logged data (*.CHD) for future viewing.
C. Click Quit Logging to return to the previous pane and cancel all data logging
selections.

K28601 Rev FB November 2012

55

WebGPI Communication Software


User Manual
How to Use the WebGPI Application
About Selecting Values for Logging

Values can be selected for immediate logging in the WebGPI application.


Values can also be selected for logging in the WebGPI-Log application.
The procedure for selecting the values that you want to log is the same for both
applications.

A left-click in a block diagram field selects values that get logged as soon as your click
the Start Logging button.

A right-click in a block diagram field:

Selects values that only log after a trigger event.


Displays a Data Logging window.

This window defines the trigger condition and the trigger value for a trigger
event.

Data logging starts when the value being logged meets both the trigger
condition and value.

Select a trigger condition of none to cancel a trigger event.

56

K28601 Rev FB November 2012

WebGPI Communication Software


User Manual
How to Use the WebGPI Application

How to Create an XML Data Log File for Use in the WebGPI-Log Application
1. Open the WebGPI application.
2. Connect the WebGPI application to the microcontroller application.
3. Display the Main pane for the application.
4. In the WebGPI windows Main pane, select the values that you want to log in the
WebGPI-Log application. For more information, see About Selecting Values for Logging
on page 56.

5. Open the File Creation window to create an xml data log file with the values that you
want to log in the WebGPI-Log application.
A. Click the Save button in the WebGPI window to open the File Creation window.
B. Select the XML option in the File Creation window.
C. Click the Search button in the File Creation window to open the Select File
window.
D. In the Select File window, name the xml data log file.
E.

Click the Save button in the Select File window to close this window.

K28601 Rev FB November 2012

57

WebGPI Communication Software


User Manual
How to Use the WebGPI Application

6. Create the xml data log file.


A. Click the Create button in File Creation window.
B. Click OK to close the window with the Save completed message.

58

K28601 Rev FB November 2012

WebGPI Communication Software


User Manual
How to Use the WebGPI Application

How to Download a Defaults or Application File to an HC08 or HC08A Processor


1. Connect an appropriate cable between a PC COM port and the microcontroller.
2. Apply power to the microcontroller.
(When applying power to the microcontroller, do not start your vehicles engine.)

3. Start the WebGPI application, connect to the microcontroller, and display the
Downloader pane.
A. Start the WebGPI application.
B. As needed, change the Port to match the PC COM port that you are using.
C. Click Connect to connect to the microcontroller.
D. Click Download to display the Downloader pane.
If you get a Device is not responding message, click OK to close this message.
Click Download to display the Downloader pane and then perform a force
download procedure, starting with step 4 on page 62.
K28601 Rev FB November 2012

59

WebGPI Communication Software


User Manual
How to Use the WebGPI Application

4. Download an application or defaults file.


A. Click a File type of either Application or Defaults.
B. Check the Application-File or the Default-File selection.
The WebGPI application will download this file to the microcontroller.
If this is not the right file, click Search to display the Select File window. Use this
window to browse to and select the right file.
If you still cannot find the right file, uncheck the File name filter in the
Downloader pane and continue your search.
C. Click Download to start the download of the file.

5. When the download finishes, check the Downloader Progress Indicator to make sure
that your download has been successful.
60

K28601 Rev FB November 2012

WebGPI Communication Software


User Manual
How to Use the WebGPI Application

How to Force Download an Application File to an HC08 or HC08A Processor


1. Connect an appropriate cable between a PC COM port and the microcontroller.
2. Apply power to the microcontroller.
(When applying power to the microcontroller, do not start your vehicles engine.)

3. Start the WebGPI application and display the Downloader pane.


A. Start the WebGPI application.
B. As needed, change the Port to match the PC COM port that you are using.
C. Click Download to display the Downloader pane.

K28601 Rev FB November 2012

61

WebGPI Communication Software


User Manual
How to Use the WebGPI Application

4. Select an application file to download.


A. Click OK to close the No micro selected message.
B. Click a Microcontroller type of either HC08 or HC08A, depending on the type of
processor used by your microcontroller.
C. Click a File type of Application.
D. Note the Application-File selection.
The WebGPI application will download this file to the microcontroller.
If this is not the right file, click Search to display the Select File window. Use this
window to browse to and select the right file.
If you still cannot find the right file, uncheck the File name filter in the
Downloader pane and continue your search.

62

K28601 Rev FB November 2012

WebGPI Communication Software


User Manual
How to Use the WebGPI Application

5. Download the application file.


A. Click Force download to start the download.
B. Remove and then reapply microcontroller power.
C. Click Download to continue the download.

6. When the download finishes, check the Downloader Progress Indicator to make sure
that your download has been successful.

K28601 Rev FB November 2012

63

WebGPI Communication Software


User Manual
How to Use the WebGPI Application
How to Download a Kernel to an HCO8 or an HC08A Processor
1. Connect an appropriate cable between a PC COM port and the microcontroller.
2. Apply power to the microcontroller.
(When applying power to the microcontroller, do not start your vehicles engine.)

3. Start the WebGPI application, connect to the microcontroller, and display the
Downloader pane.
A. Start the WebGPI application.
B. As needed, change the Port to match the PC COM port that you are using.
C. Click Connect to connect to the microcontroller.
D. Click Download to display the Downloader pane.
If you get a Device is not responding message, click OK to close this message.
Click Download to display the Downloader pane and then perform a force
download procedure, starting with 5 on page 69.

64

K28601 Rev FB November 2012

WebGPI Communication Software


User Manual
How to Use the WebGPI Application

4. Connect the microcontroller boot pin to 0 V.


A. Remove power from the microcontroller.
B. Connect the boot pin to 0 V.
C. Apply power to the microcontroller.

5. Select and download a boot file.


A. Click a File type of Kernel.
B. Check the Boot-File selection.
The WebGPI application will download this file to the microcontroller.
If this is not the right file, click Search to display the Select File window. Use this
window to browse to and select the right file.
If you still cannot find the right file, uncheck the File name filter in the
Downloader pane and continue your search.
C. Click Boot-file download to download the file.
As soon as you click this button, the WebGPI application displays a window with a
Return code error Please repower message.
D. Remove and then reapply microcontroller power.
E.

Click OK in the message window to continue the download.

K28601 Rev FB November 2012

65

WebGPI Communication Software


User Manual
How to Use the WebGPI Application
6. When the boot file download finishes, disconnect the boot pin from 0 V.
Do not remove power from the microcontroller in this step.

7. Download a kernel file.


A. Check the Operating System File selection.
The WebGPI application will download this file to the microcontroller.
As needed, use the Search File window to browse to and select the right file.
If you still cannot find the right file, uncheck the File name filter in the
Downloader pane and continue your search.
B. Click Download to download the file.
C. When the download finishes, remove and then reapply microcontroller power.

66

K28601 Rev FB November 2012

WebGPI Communication Software


User Manual
How to Use the WebGPI Application

8. Check that you have successfully downloaded a new file.


A. In the Downloader pane, click Exit to return to the WebGPI window.
B. In the WebGPI window, click Connect to reconnect to the microcontroller.
C. In the WebGPI window, click Download to display the Downloader pane.
D. Check the Downloader Progress Indicator to make sure that your download has
been successful.

K28601 Rev FB November 2012

67

WebGPI Communication Software


User Manual
How to Use the WebGPI Application
How to Force Download a Kernel to an HCO8 or HC08A Processor
1. Connect an appropriate cable between a PC COM port and the microcontroller.
2. Apply power to the microcontroller.
(When applying power to the microcontroller, do not start your vehicles engine.)

3. Start the WebGPI application and display the Downloader pane.


A. Start the WebGPI application.
B. As needed, change the Port to match the PC COM port that you are using.
C. Click Download to display the Downloader pane.
4. Connect the microcontroller boot pin to 0 V.
A. Remove power from the microcontroller.
B. Connect the boot pin to 0 V.
C. Apply power to the microcontroller.
68

K28601 Rev FB November 2012

WebGPI Communication Software


User Manual
How to Use the WebGPI Application

5. Select and download the boot file.


A. Click OK to close the No micro selected message.
B. Click a Microcontroller type of either HC08 or HC08A, depending on the type of
processor used in your microcontroller.
C. Click a File type of Kernel.
D. Check the Boot-File selection.
The WebGPI application will download this file to the microcontroller.
If this is not the right file, click Search to display the Select File window. Use this
window to select the right file. If you still cannot find the right file, uncheck the
File name filter in the Downloader pane and continue your search.
E.

Click Boot-file download to download the file.


As soon as you click this button, the WebGPI application displays a window with a
Return code error Please repower message.

F.

Remove and then reapply microcontroller power.

G.

Click OK in the message window to continue the download.

K28601 Rev FB November 2012

69

WebGPI Communication Software


User Manual
How to Use the WebGPI Application
6. When the download finishes, disconnect the boot pin from 0 V.
Do not remove power from the microcontroller in this step.

7. Download a kernel file.


A. Check the Operating System File selection.
The WebGPI application will download this file to the microcontroller.
As needed, use the Search File window to browse to and select the right file.
If you still cannot find the right file, uncheck the File name filter in the
Downloader pane and continue your search.
B. Click Download to download the file.
C. When the download finishes, remove and then reapply microcontroller power.

70

K28601 Rev FB November 2012

WebGPI Communication Software


User Manual
How to Use the WebGPI Application

8. Check that your download has been successful.


A. In the Downloader pane, click Exit to return to the WebGPI window.
B. In the WebGPI window, click Connect to reconnect to the microcontroller.
C. In the WebGPI window, click Download to display the Downloader pane.
D. Check the Downloader Progress Indicator to make sure that your download has
been successful.

K28601 Rev FB November 2012

71

WebGPI Communication Software


User Manual
How to Use the WebGPI Application
How to Download an Application File to a 196 Processor
T 196 microcontrollers do not have separate defaults files. To change default values, you
must download a new application file with new default values.
1. Connect an appropriate cable between a PC COM port and the microcontroller.
2.

Apply power to the microcontroller.


(When applying power to the microcontroller, do not start your vehicles engine.)

3. Start the WebGPI application, connect to the microcontroller, and display the
Downloader pane.
A. Start the WebGPI application.
B. As needed, change the Port to match the PC COM port that you are using.
C. Click Connect to connect to the microcontroller.
D. Click Download to display the Downloader pane.
72

K28601 Rev FB November 2012

WebGPI Communication Software


User Manual
How to Use the WebGPI Application

If you get a Device is not responding message, click OK to close this message.
Click Download to display the Downloader pane and then perform a force
download procedure, starting with step 4 on page 76.

4. Download an application file.


A. Check the Application-File selection.
The WebGPI application will download this file to the microcontroller.
If this is not the right file, click Search to display the Select File window. Use this
window to browse to and select the right file.
If you still cannot find the right file, uncheck the File name filter in the
Downloader pane and continue your search.
B. Click Download to start the download.

K28601 Rev FB November 2012

73

WebGPI Communication Software


User Manual
How to Use the WebGPI Application

5. When the download finishes, check the Downloader Progress Indicator to make sure
that your download has been successful.

74

K28601 Rev FB November 2012

WebGPI Communication Software


User Manual
How to Use the WebGPI Application

How to Force Download an Application File to a 196 Processor


1. Connect an appropriate cable between a PC COM port and the microcontroller.
2.

Apply power to the microcontroller.


(When applying power to the microcontroller, do not start your vehicles engine.)

3. Start the WebGPI application and display the Downloader pane.


A. Start the WebGPI application.
B. As needed, change the Port to match the COM port that you are using on your PC
to communicate with the microcontroller.
C. Click Download to display the Downloader pane.

K28601 Rev FB November 2012

75

WebGPI Communication Software


User Manual
How to Use the WebGPI Application

4. Select an application file to download.


A. Click OK to close the No micro selected message.
B. Click a Microcontroller type of 196.
C. Click a File type of Application.
D. Note the Application-File selection.
The WebGPI application will download this file to the microcontroller.
If this is not the right file, click Search to display the Select File window. Use this
window to browse to and select the right file.
If you still cannot find the right file, uncheck the File name filter in the
Downloader pane and continue your search.

76

K28601 Rev FB November 2012

WebGPI Communication Software


User Manual
How to Use the WebGPI Application

5. Download the application file.


A. Click Force download to start the download.
B. Remove and then reapply microcontroller power.
C. Click Download to continue the download.

6. When the download finishes, check the Downloader Progress Indicator to make sure
that your download has been successful.

K28601 Rev FB November 2012

77

WebGPI Communication Software


User Manual
How to Use the WebGPI Application
How to Download a Kernel to a 196 Processor
T Downloading a 196 kernel deletes the application file in the 196 processor. After
downloading the kernel, you will have to reinstall the application file.
1. Connect an appropriate cable between a PC COM port and the microcontroller.
2.

Apply power to the microcontroller.


(When applying power to the microcontroller, do not start your vehicles engine.)

3. Start the WebGPI application, connect to the microcontroller, and display the
Downloader pane.
A. Start the WebGPI application.
B. As needed, change the Port to match the PC COM port that you are using.
C. Click Connect to connect to the microcontroller.
D. Click Download to display the Downloader pane.
78

K28601 Rev FB November 2012

WebGPI Communication Software


User Manual
How to Use the WebGPI Application

If you get a Device is not responding message, click OK to close this message.
Click Download to display the Downloader pane and then perform a force
download procedure, starting with step 4 on page 83.

4. Select and download a boot file.


A. Click a File type of Kernel.
B. Check the Boot-File selection.
The WebGPI application will download this file to the microcontroller.
If this is not the right file, click Search to display the Select File window. Use this
window to browse to and select the right file.
If you still cannot find the right file, uncheck the File name filter in the
Downloader pane and continue your search.
C. Click Boot-file download to download the file.

K28601 Rev FB November 2012

79

WebGPI Communication Software


User Manual
How to Use the WebGPI Application

5. Download a kernel file.


A. Check the Operating System File selection.
The WebGPI application will download this file to the microcontroller.
As needed, use the Search File window to browse to and select the right file.
If you still cannot find the right file, uncheck the File name filter in the
Downloader pane and continue your search.
B. Click Download to download the file.

Once you download the boot and kernel files, you must also download the
application file to successfully complete this procedure.

80

K28601 Rev FB November 2012

WebGPI Communication Software


User Manual
How to Use the WebGPI Application

6. Download an application file.


A. Click a File type of Application.
B. Check the Application-File selection.
The WebGPI application will download this file to the microcontroller.
As needed, use the Search File window to browse to and select the right file.
If you still cannot find the right file, uncheck the File name filter in the
Downloader pane and continue your search.
C. Click Download to download the file.

7. When the download finishes, check the Downloader Progress Indicator to make sure
that you have successfully downloaded the kernel and application files.
K28601 Rev FB November 2012

81

WebGPI Communication Software


User Manual
How to Use the WebGPI Application
How to Force Download a Kernel to a 196 Processor
T Downloading a 196 kernel deletes the application file in the 196 processor. After
downloading the kernel, you will have to reinstall the application file.
1. Connect an appropriate cable between a PC COM port and the microcontroller.
2.

Apply power to the microcontroller.


(When applying power to the microcontroller, do not start your vehicles engine.)

3. Start the WebGPI application and display the Downloader pane.


A. Start the WebGPI application.
B. As needed, change the Port to match the PC COM port that you are using.
C. Click Download to display the Downloader pane.

82

K28601 Rev FB November 2012

WebGPI Communication Software


User Manual
How to Use the WebGPI Application

4. Select and download the boot file.


A. Click OK to close the No micro selected message.
B. Click a Microcontroller type of 196.
C. Click a File type of Kernel.
D. Check the Boot-File selection.
The WebGPI application will download this file to the microcontroller.
If this is not the right file, click Search to display the Select File window. Use this
window to select the file you want.
If you still cannot find the right file, uncheck the File name filter in the
Downloader pane and continue your search.
E.

Click Force download to download the file.

F.

Remove and then reapply microcontroller power.

G.

Click Boot-file download to continue the download.

K28601 Rev FB November 2012

83

WebGPI Communication Software


User Manual
How to Use the WebGPI Application

5. Download a kernel file.


A. Check the Operating System File selection.
The WebGPI application will download this file to the microcontroller.
As needed, use the Search File window to browse to and select the right file. If
you still cannot find the right file, uncheck the File name filter in the Downloader
pane and continue your search.
B. Click Download to download the file.

Once you download the boot and kernel files, you must also download the
application file to successfully complete this procedure.

84

K28601 Rev FB November 2012

WebGPI Communication Software


User Manual
How to Use the WebGPI Application

6. Download an application file.


A. Click a File type of Application.
B. Check the Application-File selection.
The WebGPI application will download this file to the microcontroller.
As needed, use the Search File window to browse to and select the right file. If
you still cannot find the right file, uncheck the File name filter in the Downloader
pane and continue your search.
C. Click Download to download the file.

7. When the download finishes, check the Downloader Progress Indicator to make sure
that you have successfully downloaded the kernel and application files.
K28601 Rev FB November 2012

85

WebGPI Communication Software


User Manual
How to Use the WebGPI Application
How to Download an Application or Defaults File to a 167 Processor
1. Connect an appropriate cable between a PC COM port and the microcontroller.
If you are using a Sauer-Danfoss KW02012 cable with a Prog/Read switch, set this
switch to Read.
2. Apply power to the microcontroller. (When applying power to the microcontroller, do
not start your vehicles engine.)

3. Start the WebGPI application, connect to the microcontroller, and display the
Downloader pane.
A. Start the WebGPI application.
B. As needed, change the Port to match the PC COM port that you are using.
C. Click Connect to connect to the microcontroller.
D. Click Download to display the Downloader pane.
If you get a Device is not responding message, click OK to close this message.
Click Download to display the Downloader pane and then perform a force
download procedure, starting with step 4 on page 89.
86

K28601 Rev FB November 2012

WebGPI Communication Software


User Manual
How to Use the WebGPI Application

4. Download an application or defaults file.


A. Click a File type of either Application or Defaults.
B. Check the Application-File selection.
The WebGPI application will download this file to the microcontroller.
If this is not the right file, click Search to display the Select File window. Use this
window to browse to and select the right file. If you still cannot find the right file,
uncheck the File name filter in the Downloader pane and continue your search.
C.

Click Download to start the download.

5. When the download finishes, check the Downloader Progress Indicator to make sure
that your download has been successful.
K28601 Rev FB November 2012

87

WebGPI Communication Software


User Manual
How to Use the WebGPI Application
How to Force Download an Application File to a 167 Processor
1. Connect an appropriate cable between a PC COM port and the microcontroller.
If you are using a Sauer-Danfoss KW02012 cable with a Prog/Read switch, set this
switch to Read.
2.

Apply power to the microcontroller.


(When applying power to the microcontroller, do not start your vehicles engine.)

3. Start the WebGPI application and display the Downloader pane.


A. Start the WebGPI application.
B. As needed, change the Port to match the COM port that you are using on your PC
to communicate with the microcontroller.
C. Click Download to display the Downloader pane.

88

K28601 Rev FB November 2012

WebGPI Communication Software


User Manual
How to Use the WebGPI Application

4. Select an application file to download.


A. Click OK to close the No micro selected message.
B. Click a Microcontroller type of 167.
C. Click a File type of Application.
D. Note the Application-File selection.
The WebGPI application will download this file to the microcontroller.
If this is not the right file, click Search to display the Select File window. Use this
window to browse to and select the right file.
If you still cannot find the right file, uncheck the File name filter in the
Downloader pane and continue your search.

K28601 Rev FB November 2012

89

WebGPI Communication Software


User Manual
How to Use the WebGPI Application

5. Download the application file.


A. Click Force download to start the download.
B. Remove and then reapply microcontroller power.
C. Click Download to continue the download.

6. When the download finishes, check the Downloader Progress Indicator to make sure
that your download has been successful.

90

K28601 Rev FB November 2012

WebGPI Communication Software


User Manual
How to Use the WebGPI Application

How to Download a Kernel to a 167 Processor


1. Connect an appropriate cable between a PC COM port and the microcontroller.
If you are using a Sauer-Danfoss KW02012 cable with a Prog/Read switch, set this
switch to Read.
2.

Apply power to the microcontroller.


(When applying power to the microcontroller, do not start your vehicles engine.)

3. Start the WebGPI application, connect to the microcontroller, and display the
Downloader pane.
A. Start the WebGPI application.
B. As needed, change the Port to match the PC COM port that you are using.
C. Click Connect to connect to the microcontroller.
D. Click Download to display the Downloader pane.

K28601 Rev FB November 2012

91

WebGPI Communication Software


User Manual
How to Use the WebGPI Application
If you get a Device is not responding message, Click OK to close this message.
Click Download to display the Downloader pane and then perform a force
download procedure, starting with step 5 on page 95.

4. Select and download a kernel file.


A. Click a File type of Kernel.
B. Check the Operating System File selection.
The WebGPI application will download this file to the microcontroller.
If this is not the right file, click Search to display the Select File window. Use this
window to browse to and select the right file.
If you still cannot find the right file, uncheck the File name filter in the
Downloader pane and continue your search.
C. Click Download to download the file.
D. When the download finishes, remove and then reapply microcontroller power.

92

K28601 Rev FB November 2012

WebGPI Communication Software


User Manual
How to Use the WebGPI Application

5.

Check that your download has been successful.


A. In the Downloader pane, click Exit to return to the WebGPI window.
B. In the WebGPI window, click Connect to reconnect to the microcontroller.
C. In the WebGPI window, click Download to display the Downloader pane.
D. Check the Downloader Progress Indicator to make sure that your download has
been successful.

K28601 Rev FB November 2012

93

WebGPI Communication Software


User Manual
How to Use the WebGPI Application
How to Force Download a Kernel to a 167 Processor
1.

Connect an appropriate cable between a PC COM port and the microcontroller.


If you are using a Sauer-Danfoss KW02012 cable, set this cables Prog/Read switch to
Prog and skip ahead to step 3.

2.

Prepare the microcontroller for a boot file download.


A. Remove power from the microcontroller.
B. Connect the bootstrap pin high with 5 V.
C. Connect the bootstrap pin low with 0 V.

3.

Apply power to the microcontroller.


(When applying power to the microcontroller, do not start your vehicles engine.)

4. Start the WebGPI application and display the Downloader pane.


A. Start the WebGPI application.
B. As needed, change the Port to match the PC COM port that you are using.
C. Click Download to display the Downloader pane.

94

K28601 Rev FB November 2012

WebGPI Communication Software


User Manual
How to Use the WebGPI Application

5. Select and download the boot file.


A. Click OK to close the No micro selected message.
B. Click a Microcontroller type of 167.
C. Click a File type of Kernel.
D. Check the Boot-File selection.
The WebGPI application will download this file to the microcontroller.
If this is not the right file, click Search to display the Select File window. Use this
window to select the right file.
If you still cannot find the right file, uncheck the File name filter in the
Downloader pane and continue your search.
E.

Click Boot-file download to download the boot file.

K28601 Rev FB November 2012

95

WebGPI Communication Software


User Manual
How to Use the WebGPI Application

6. Download a kernel file.


A. Check the Operating System File selection.
The WebGPI application will download this file to the microcontroller.
As needed, use the Search File window to browse to and select the right file.
If you still cannot find the right file, uncheck the File name filter in the
Downloader pane and continue your search.
B. Click Download to download the file.
7.

When the download finishes, change the microcontroller cabling.


A. Remove power from the microcontroller.
B. If you are using the Sauer-Danfoss KW02012 cable, set this cables Prog/Read
switch back to Read and skip lettered steps C and D.
C. Disconnect the bootstrap pin high from 5 V.
D. Disconnect the bootstrap pin low from 0 V.
E.

96

Apply power to the microcontroller.

K28601 Rev FB November 2012

WebGPI Communication Software


User Manual
How to Use the WebGPI Application

8. Check that you have successfully downloaded a new file.


A. In the Downloader pane, click Exit to return to the WebGPI window.
B. In the WebGPI window, click Connect to reconnect to the microcontroller.
C. In the WebGPI window, click Download to display the Downloader pane.
D. Check the Downloader Progress Indicator to make sure that your download has
been successful.

K28601 Rev FB November 2012

97

WebGPI Communication Software


User Manual
How to Use the WebGPI Application
How to Download an Application File to an HC12 Processor
T HC12 processors do not have separate application and defaults files. To change defaults
values, you must download an application file that contains the new defaults values.
1. Connect an appropriate cable between a PC COM port and the microcontroller.
2. Apply power to the microcontroller.
(When applying power to the microcontroller, do not start your vehicles engine.)

3. Start the WebGPI application and display the Downloader pane.


A. Start the WebGPI application.
B. As needed, change the Port to match the PC COM port that you are using.
C. Click Download to display the Downloader pane.

98

K28601 Rev FB November 2012

WebGPI Communication Software


User Manual
How to Use the WebGPI Application

4. Select an application file to download.


A. Click OK to close the No micro selected message.
B. Click a Microcontroller type of HC12.
C. Click a File type of Application.
D. Note the Application-File selection.
The WebGPI application will download this file to the microcontroller.
If this is not the right file, click Search to display the Select File window. Use this
window to browse to and select the file that you want to download.
If you still cannot find the right file, uncheck the File name filter in the
Downloader pane and continue your search.

K28601 Rev FB November 2012

99

WebGPI Communication Software


User Manual
How to Use the WebGPI Application

5. Download the application file.


A. Click Force download to start the download.
B. Remove and then reapply microcontroller power.
C. Click Download to continue the download.
D. When the download completes, click OK to close the Device is not responding
message.
6. Remove and then reapply microcontroller power.

100

K28601 Rev FB November 2012

WebGPI Communication Software


User Manual
How to Use the WebGPI Application

7. Check that your download has been successful.


A. In the WebGPI window, click Connect to connect to the microcontroller.
B. In the WebGPI window, click Download to display the Downloader pane.
C. Check the Downloader Progress Indicator to make sure that your download has
been successful.

K28601 Rev FB November 2012

101

WebGPI Communication Software


User Manual
How to Use the WebGPI Application
How to Download a Kernel to an HC12 Processor
1. Connect an appropriate cable between a PC COM port and the microcontroller.
2. Apply power to the microcontroller.
(When applying power to the microcontroller, do not start your vehicles engine.)

3. Start the WebGPI application, connect to the microcontroller, and display the
Downloader pane.
A. Start the WebGPI application.
B. As needed, change the Port to match the PC COM port that you are using.
C. Click Connect to connect to the microcontroller.
D. Click Download to display the Downloader pane.
If you get a Device is not responding message, click OK to close this message.
Click Download to display the Downloader pane and then perform a force
download procedure, starting with step 4 on page 106.
102

K28601 Rev FB November 2012

WebGPI Communication Software


User Manual
How to Use the WebGPI Application

4. Select and download a kernel file.


A. Click a File type of Kernel.
B. Check the Operating System File selection.
The WebGPI application will download this file to the microcontroller.
If this is not the right file, click Search to display the Select File window. Use this
window to browse to and select the file that you want to download.
If you still cannot find the right file, uncheck the File name filter in the
Downloader pane and continue your search.
C. Click Force Download to start the download.
D. Remove and then reapply microcontroller power.
E.

Click Download to continue the download.

5. When the download finishes, again remove and then reapply microcontroller power.

K28601 Rev FB November 2012

103

WebGPI Communication Software


User Manual
How to Use the WebGPI Application

6. Check that you have successfully downloaded a new file.


A. In the Downloader pane, click Exit to return to the WebGPI window.
B. In the WebGPI window, click Connect to connect to the microcontroller.
C. In the WebGPI window, click Download to display the Downloader pane.
D. Check the Downloader Progress Indicator to make sure your download has been
successful.

104

K28601 Rev FB November 2012

WebGPI Communication Software


User Manual
How to Use the WebGPI Application

How to Force Download a Kernel to an HC12 Processor


1. Connect an appropriate cable between a PC COM port and the microcontroller.
2. Apply power to the microcontroller.
(When applying power to the microcontroller, do not start your vehicles engine.)

3. Start the WebGPI application and display the Downloader pane.


A. Start the WebGPI application.
B. As needed, change the Port to match the PC COM port that you are using.
C. Click Download to display the Downloader pane.

K28601 Rev FB November 2012

105

WebGPI Communication Software


User Manual
How to Use the WebGPI Application

4. Select the kernel file.


A. Click OK to close the No micro selected message.
B. Click a Microcontroller type of HC12.
C. Click a File type of Kernel.
D. Check the Operating System File selection.
The WebGPI application will download this file to the microcontroller.
If this is not the right file, click Search to display the Select File window. Use this
window to select the file you want.
If you still cannot find the right file, uncheck the File name filter in the
Downloader pane and continue your search.

106

K28601 Rev FB November 2012

WebGPI Communication Software


User Manual
How to Use the WebGPI Application

5. Download the kernel.


A. Click Force Download to start the file download.
B. Remove and then reapply microcontroller power.
C. Click Download to continue the download.
6.

When the download finishes, again remove and then reapply microcontroller power.

7. Check that your download has been successful.


A. In the Downloader pane, click Exit to return to the WebGPI window.
B. In the WebGPI window, click Connect to connect to the microcontroller.
C. In the WebGPI window, click Download to display the Downloader pane.
D. Check the Downloader Progress Indicator to make sure your download has been
successful.
K28601 Rev FB November 2012

107

WebGPI Communication Software


User Manual
How to Use the WebGPI Application
How to Create a File with Microcontroller Data
The following procedure describes how to create files that contain data from the
microcontroller application.
1. Connect an appropriate RS-232-C cable between a COM port on your PC and the
Sauer-Danfoss microcontroller.

2. Open the File Creation window.


A. On your PC, start the WebGPI application.
B. As needed, use Port to select the correct COM port on your PC.
C. Click Connect to connect to the microcontroller.
D. Click Application to open the application interface.
E.
108

Click Save to open the File Creation window.

K28601 Rev FB November 2012

WebGPI Communication Software


User Manual
How to Use the WebGPI Application

3. Create the file.


A. In the Default value from Micro, select the type of file you want to create:

HEADERA C header format (*.h) file with the current application tuning
values. This files tuning values can become the default tuning values when
Sauer-Danfoss compiles a new version of the microcontroller application.

HEXA hexadecimal format file (*.hex) with current application tuning


values that you can download to a microcontroller running an identical
application.

XMLAn extensible markup language format file (*.xml) with the current
application tuning values. This is the preferred file format for saving. You can
use this file to create HEADER and HEX files without a connection to the
microcontroller application.

XML (Datalogging)An xml format file that identifies the data to be logged
using the WebGPI-Log application.

B. Click Search to open the Select File window.


C. In the Select File window, name the file, select its save location, and click Save to
close the window.

K28601 Rev FB November 2012

109

WebGPI Communication Software


User Manual
How to Use the WebGPI Application
How to Download an Application File to a TI Processor
T Application files for TI processors combine kernel, application, and defaults in a single
file.
1. Connect an appropriate cable between a PC COM port and the microcontroller.
2. Apply power to the microcontroller.
(When applying power to the microcontroller, do not start your vehicles engine.)

3. Start the WebGPI application and display the Downloader pane.


A. Start the WebGPI application.
B. As needed, change the Port to match the PC COM port that you are using.
C. Click Download to display the Downloader pane.

110

K28601 Rev FB November 2012

WebGPI Communication Software


User Manual
How to Use the WebGPI Application

4. Select an application file to download.


A. Click OK to close the No micro selected message.
B. Click a Microcontroller type of TI.
C. Click a File type of Application.
D. Note the Application-File selection.
The WebGPI application will download this file to the microcontroller.
If this is not the right file, click the active Search button to display the Select File
window. Use this window to browse to and select the file that you want to
download.
If you still cannot find the right file, uncheck the File name filter in the
Downloader pane and continue your search.

K28601 Rev FB November 2012

111

WebGPI Communication Software


User Manual
How to Use the WebGPI Application

5. Click the Download button to download the application.


At the end of a successful download, the Downloader panes Progress Indicator
shows the application part number and the kernel version.

112

K28601 Rev FB November 2012

WebGPI Communication Software


User Manual
How to Use the WebGPI-Log Application
This chapter contains step-by-step instructions for using the WebGPI-Log application to
log data.
T The screen captures shown in this chapter may differ slightly from the screens in your
version of the WebGPI application.
Chapter contents

How to Log and Save Data .......................................................................................................................... 114


How to Create a Chart Collection ............................................................................................................. 117

K28601 Rev FB November 2012

113

WebGPI Communication Software


User Manual
How to Use the WebGPI-Log Application
How to Log and Save Data
T To use the WebGPI-Log application, you must first use the WebGPI application to create
an xml data log file that defines the values that you want to log.
1. In the WebGPI application, create xml data log files. Write these files to a common
folder.
2. Open the WebGPI-Log application.

3. Select the xml data log file that has the data that you want to log.
A. Click the Add Chart button in the WebGPI-Log window to open the Add Chart
to Collection window.
B. In the Add Chart to Collection window, select the xml data file that defines your
data logging selections (what you want to log).
C. In the Add Chart to Collection window, click the Open button to add the values
in the selected xml data file to the WebGPI-Log window.
4. Repeat step 3 to add additional data log values to the WebGPI-Log window.

114

K28601 Rev FB November 2012

WebGPI Communication Software


User Manual
How to Use the WebGPI-Log Application

5. Use the WebGPI-Log window to log data.


In the WebGPI-Log window:

Click the Connect button to connect to the application.


Click the Start Logging button to start logging data.
Click the Stop Logging button to stop logging data.
Use the Chart menu and Chart toolbar to format the data.

K28601 Rev FB November 2012

115

WebGPI Communication Software


User Manual
How to Use the WebGPI-Log Application

6. As needed, save the data that you have logged and the formatting that you have
applied to this data in a Chart FX file type.
A. In the WebGPI-Log windows File menu, click the Save Chart command to open
the Save As window.
B. In the Save As window, name the file and then save it as a Chart FX file type.

116

K28601 Rev FB November 2012

WebGPI Communication Software


User Manual
How to Use the WebGPI-Log Application

How to Create a Chart Collection


1. In the WebGPI application, create xml data log files. Write these files to a common
folder.
XML data log files define the data that you want to log in the WebGPI-Log application.
2. Open the WebGPI-Log application.

3. Name the new chart collection.


A. In the WebGPI-Log window, open the Create New Chart Collection window.
B. Name the new chart collection.
C. Browse to the folder that contains the xml data files that you created in step 1.
D. Click OK to close the Create New Chart Collection window.

4. Click the Add Chart button in the WebGPI-Log window to open the Edit Chart
Collection List window.

K28601 Rev FB November 2012

117

WebGPI Communication Software


User Manual
How to Use the WebGPI-Log Application

5. Add xml data log files to the list in the Edit Chart Collection List window.
A. Click the Add Chart button in the Edit Chart Collection List window to open the
Add Chart to Collection window.
B. Select an xml data log file in the Add Chart to Collection window.
C. Click the Open button in the Add Chart to Collection window to add the
selected file to the Edit Chart Collection List windows List.
As needed, add additional files to the Edit Chart Collection List window.
D. Click the Close button in the Edit Chart Collection List window to close this
window.

118

K28601 Rev FB November 2012

WebGPI Communication Software


User Manual
How to Use the WebGPI-Log Application

Closing the Edit Chart Collect Window prepares the WebGPI-Log window to log all the
values that are contained in the chart collection.

6. Click the Save button in the WebGPI-Log window to open the Save Chart Collection
window.
Click the Save button in the Save Chart Collection window to save the chart
collection as a *.gpi file.
T GPI files reference xml data log files. GPI files should be saved into the same folder as the
xml data log files that they reference.
K28601 Rev FB November 2012

119

WebGPI Communication Software


User Manual
How to Use the WebGPI-Log Application
(This page is intentionally blank.)

120

K28601 Rev FB November 2012

WebGPI Communication Software


User Manual
PC and Cabling Requirements
PC Requirements
See the WebGPI Communication Software Data Sheet for PC operating requirements. You
can find this data sheet at the Sauer-Danfoss Website (http://www.sauerdanfoss.com/stellent/groups/publications/documents/product_literature/11076524.pdf#
page=1).
Cabling Requirements
The table below lists the cables needed to communicate through a COM port on your PC
with a Sauer-Danfoss microcontroller.
Cabling Requirements
Sauer-Danfoss Microcontroller

Sauer-Danfoss Cable Part Number

MC200

PN 1090740

MC400

PN 1090740

S2X

PN KW02027* or PN KW02012

MC300

PN KW02027* or PN KW02012

* Recommended cable.
This cable has a Prog/Read switch. Leave this switch set to Read.

K28601 Rev FB November 2012

121

WebGPI Communication Software


User Manual
PC and Cabling Requirements
(This page is intentionally blank.)

122

K28601 Rev FB November 2012

WebGPI
User Manual
Index

Baud settings, 11

Data Logging
in WebGPI, about, 56
pane inWebGPI-Log application, described, 42
pane, Chart menu bar, described, 32
pane, Chart toolbar, described, 34
pane, toolbar, described, 31
pane, WebGPI, described, 30
Debug Mode pane, described, 29
Defaults, how to restore, 52

How to
change a parameter value, 50
connect to a microcontroller, 48
create a chart collection in the WebGPI-Log
application, 117
create a file with microcontroller data, 108
create an xml data log file, 57
download files
167 processors, 94
download files
167 processors, 86, 88, 91
196 processors, 72, 75, 78, 82
HC08/HC08A processors, 59, 61, 64, 68
download files
HC12 processors, 98
download files
HC126 processors, 102
download files
HC12 processors, 105
download files
TI processors, 110
log and save data in the WebGPI-Log application,
114
log run-time data, 53
restore defaults, 52
start communication with a microcontroller, 49

Edit Chart Collection List window, described, 41

Information window, described, 28


Installation, PC requirements, 121

C
Cables, required, 121
Chart
menu bar, Data Logging pane, described, 32
Menu Bar, Offline window, described, 24
menu toolbar, Data Logging pane, described, 34
menu, WebGPI-Log, about, 43
toolbar, WebGPI-Log, about, 45
Configuration pane, described, 22
Create a chart collection in the WebGPI-Log application,
how to, 117

F
File
Creation window, described, 17
names, about, 21
Files
download to 167 processors, how to, 86, 88, 91, 94
download to 196 processors, how to, 72, 75, 78, 82
download to HC08/HC08A processors, how to, 59,
61, 64, 68
download to HC12 processors, how to, 98, 102, 105
download to TI processors, how to, 110
how to create microcontroller data files, 108
K28601 Rev FB November 2012

L
Log and save data in the WebGPI-Log application, how
to, 114
Log run time data, how to, 53

M
Manual, about, 6
Menu bar
WebGPI window, 9
WebGPI-Log window, 39
123

WebGPI
User Manual
Index
Microcontroller
connect, how to, 48
how to start communication with, 49

O
Offline window
Chart Menu Bar, described, 24
Chart Toolbar, described, 26
described, 23

P
Parameter value, how to change, 50

T
Toolbar
Data Logging pane, described, 31
Offline window, described, 26
WebGPI window, described, 11

WebGPI
about, 6
PC installation requirements, 121
window
described, 8
Toolbar, described, 11
views, changing, 13
WebGPI-Log window, described, 38
Windows and panes
Configuration, 22
Data Logging, described, 30
Data Logging, WebGPI-Log application, 42
Debug Mode, described, 29
Downloader pane, described, 19
Edit Chart Collection List, described, 41
File Creation, described, 17
Information, described, 28
Offline, described, 23
WebGPI, described, 8
WebGPI-Log, described, 38

Views, changing, 13

124

XML data log file, how to create, 57

K28601 Rev FB November 2012

WebGPI Communication Software


User Manual
This page is intentionally blank.)

Sauer-Danfoss Hydraulic Power Systems


OUR PRODUCTS

- Market Leaders Worldwide

Hydrostatic transmissions

Sauer-Danfoss is a comprehensive supplier providing complete


systems to the global mobile market.

Hydraulic power steering


Electric power steering
Electrohydraulic power steering
Closed and open circuit axial piston
pumps and motors
Gear pumps and motors
Bent axis motors
Orbital motors
Transit mixer drives
Planetary compact gears
Proportional valves

Sauer-Danfoss serves markets such as agriculture, construction, road


building, material handling, municipal, forestry, turf care, and many
others.
We offer our customers optimum solutions for their needs and
develop new products and systems in close cooperation and
partnership with them.
Sauer-Danfoss specializes in integrating a full range of system
components to provide vehicle designers with the most advanced
total system design.
Sauer-Danfoss provides comprehensive worldwide service for its products
through an extensive network of Global Service Partners
strategically located in all parts of the world.

Directional spool valves


Cartridge valves
Hydraulic integrated circuits
Hydrostatic transaxles
Integrated systems

Local address:
Sauer-Danfoss Inc.
3500 Annapolis Lane North
Minneapolis, MN 55447, USA
Phone: +1 763 509-2000
Fax: +1 763 559-5769

Fan drive systems


Electrohydraulics
Microcontrollers and software
Electric motors and inverters
Joysticks and control handles
Displays
Sensors

K28601 Rev FB November 2012


l

Sauer-Danfoss (US) Company


2800 East 13th Street
Ames, IA 50010, USA
Phone: +1 515 239-6000
Fax: +1 515 239-6618

Sauer-Danfoss ApS
DK-6430 Nordborg, Denmark
Phone: +45 7488 4444
Fax: +45 7488 4400

Sauer-Danfoss GmbH & Co. OHG


Postfach 2460, D-24531 Neumnster
Krokamp 35, D-24539 Neumnster, Germany
Phone: +49 4321 871-0
Fax: +49 4321 871 122

Sauer-Danfoss-Daikin LTD
Shin-Osaka TERASAKI 3rd Bldg. 6F
1-5-28 Nishimiyahara, Yodogawa-ku
Osaka 532-0004, Japan
Phone: +81 6 6395 6066
Fax: +81 6 6395 8585

www.sauer-danfoss.com