To help you quickly find information in this manual, the material is divided into sections,
topics, subtopics, and details, with descriptive headings set in
appear at the top
In the PDF version of this document, clicking an item
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.
About this Manual ....................................................................................................................................... 6
About the WebGPI and Web-GPI-Log Applications ....................................................................... 6
Menu Bar................................................................................................................................................. 9
About the View Menu .............................................................................................................................. 13
Normal View ........................................................................................................................................ 13
Main View ............................................................................................................................................. 14
Data Logging View ........................................................................................................................... 15
Main 50% View ................................................................................................................................... 16
About File Names ...................................................................................................................................... 21
Data Logging Pane ................................................................................................................................... 30
Data Logging Pane Toolbar .......................................................................................................... 31
Data Logging Pane Chart Menu Bar .......................................................................................... 32
Data Logging Pane Chart Toolbar .............................................................................................. 34
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
3
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
Index .................................................................................................................................................................... 123
4
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
5
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 application’s windows and their controls and
indicators.
•WebGPI-Log Application describes this application’s 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 application’s 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.
6
K28601 · Rev FB · November 2012
WebGPI Communication Software
User Manual
Chapter contents
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
About File Names ...................................................................................................................................... 21
Data Logging Pane ................................................................................................................................... 30
K28601 · Rev FB · November 2012
7
WebGPI Communication Software
User Manual
WebGPI Application
WebGPI Window
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.
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
.
.
.
8
K28601 · Rev FB · November 2012
WebGPI Communication Software
User Manual
WebGPI Application
Menu Bar
Menu Bar
The Menu bar accesses WebGPI application functions and information.
T The Toolbar duplicates many Menu bar selections.
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 The commands in this menu control communication between the WebGPI application and the microcontroller.
Configuration 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 This menu’s command plots data that you have logged and saved.
Graph Displays the Open Real Time Performance window.
Information The commands in this menu display information about the microcontroller application and open an Adobe®
Info Screen Displays the Settings and System Info window.
User Manual Opens a PDF version of the microcontroller application manual. Not all applications have a manual.
Opens and closes communication between the WebGPI application and the microcontroller.
Use this window to chart (plot) data that you have logged and saved.
Acrobat® portable document format (PDF) version of the microcontroller application manual.
This window displays information specific to the microcontroller hardware and application. Not all applications
have this window.
K28601 · Rev FB · November 2012
9
WebGPI Communication Software
User Manual
WebGPI Application
Menu Bar
Item Description
Help
WebGPI Manual Opens a PDF version of this WebGPI User Manual.
Sauer-Danfoss
WebPage
The commands in this menu open the WebGPI manual and access the Sauer-Danfoss home page.
Opens the Sauer-Danfoss home page if you have an active internet connection.
10
K28601 · Rev FB · November 2012
WebGPI Communication Software
User Manual
WebGPI Application
Toolbar
Toolbar
Toolbar buttons and controls provide quick access to WebGPI application functions.
T The Menu bar duplicates many Toolbar selections.
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.
Connect—opens communication between the WebGPI application and the microcontroller.
Disconnect—closes 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.
Port—selects the RS 232-C port that the WebGPI application uses to communicate with the microcontroller.
Baudrate—selects 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/N—displays the microcontroller application software part number.
Hardware-ID—displays the microcontroller hardware identification number.
Machine Default ID-Number—displays the default tuning value set identification number.
OS Version—displays 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
• The Parameter pane displays parameter sets. Click in the Navigation pane to select a
• Use these panes to view and change parameter values when you are connected to a
• Use these panes to review parameters when you are not connected to a
K28601· Rev FB · November 2012
application. Folders organize similar parameter sets.
parameter set for display.
microcontroller.
microcontroller. You can view a sample set of parameters but not change their values.
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
File Creation Window
Item Description
Default value from Micro The HEADER, HEX, and XML selections become available when the WebGPI application connects to the
This window creates default tuning value files. It also creates files that define the data to
be logged in the WebGPI-Log application.
microcontroller application.
HEADER—select 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.
HEX—select 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.
XML—select 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 XML-
File
Search Displays a Select File window.
Machine Default
Identification Number
Search Displays a Select File window.
Create Creates the file.
Creates C header files (*.h) and hexadecimal files (*.hex) containing tuning values from a selected xml source file.
HEADER—select to create a C header file from a selected xml format source file.
HEX—select 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.
Use this window to select the xml file that contains the tuning values for the HEADER or HEX file that you are
creating.
Enters the suffix appended to the microcontroller application file name that identifies the default tuning value set.
Use this window to name the file you are saving or to overwrite an existing file.
18
K28601 · Rev FB · November 2012
WebGPI Communication Software
User Manual
WebGPI Application
Downloader Pane
Downloader Pane
Item Description
Microcontroller type Selects the download protocol appropriate for the processor used in the microcontroller.
This pane downloads application files, default tuning values files, and kernel files to
microcontrollers.
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.
HC08—selects the Motorola 68HC08 processor download protocol.
167—selects the Infineon 167 processor download protocol.
196—selects the Intel 196 processor download protocol.
HC12—selects the Motorola 68HC12 processor download protocol.
HC08A—selects the Motorola 68HC08A processor download protocol.
164—selects the Infineon 164 processor download protocol.
TI—selects 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 Application—displays the controls needed to download a microcontroller application.
Kernel—displays the controls needed to download a kernel (the core of a microcontroller operating system).
Defaults—displays the controls needed to download a tuning parameter defaults file.
File name filter—applies 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 Check—check to have the WebGPI application verify that the file is suitable for the microcontroller processor type
before downloading it.
Empty Security byte—check when downloading a kernel to a 68HC08 or 68HC08A processor that has never been
programmed. Typically, this is not used.
Search
(for application, kernel,
and defaults files)
Search
(for boot files)
Force download/
Stop forcing download
Boot-file download Starts the download of a boot file.
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.
Displays a Select File window.
Use this window to select an application, kernel, or defaults file to download.
The text box to the left of Search identifies the name and location of the file.
Displays a Select File window.
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.
Forces a connection to the microcontroller.
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.
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 pane’s 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
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.
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 timeoutSets 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
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.
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
Offline Window Chart Menu Bar
Commands in this menu bar format charts.
Menu Description
File Open Chart command—displays the Open window. Use this window to select and open a ChartFX *cfx format file.
Save Chart command—displays the Save As window. Use this window to save a chart in the ChartFX *cfx file format.
Page Setup command—displays the Page Setup window. Use this window to set the chart’s print margins and paper
orientation.
Print command—displays the Print window. Use this window to print out the chart.
Copy to Clipboard As a Bitmap command—copies a bitmap image of the chart to the clipboard.
As a Metafile command—copies a Windows Metafile image of the chart to the clipboard.
As Text (data only) command—copies tab-delimited chart data points to the clipboard.
View 3D/2D command—switches between two-dimensional and three-dimensional chart views.
Clustered (Z Axis) command—clusters the chart along its z axis.
Properties command—Displays a Properties window with the following tabs:
– Y Axis tab—sets labeling, tick marks, and gridlines for the y axis.
– Series tab—defines the display and formatting of series.
– General tab—sets general properties such as the screen title and screen background colors.
Tools Values Legend command—Displays a values legend.
Series Legend command—Displays a series legend.
User Legend command—Displays a user legend.
Data Editor command—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.
Toolbar command—hides the toolbar.
To restore the toolbar, right-click the chart. In the pop-up menu that displays, click Toolbar.
Menu command—hides 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 command—displays the contents of the help file.
Search command—searches the help file.
About ChartFX command—displays information about ChartFX software.
K28601 · Rev FB · November 2012
25
WebGPI Communication Software
User Manual
WebGPI Application
Offline Window Chart Toolbar Buttons
Offline Window Chart Toolbar
Buttons in this toolbar format charts.
Button Name Description
Personalized Charts Displays a menu with commands that save and apply chart settings.
Copy to Clipboard Displays a menu with copy commands.
Print Displays a Print window. Use this window to print the chart.
Load My Chart command—applies the chart settings that have been saved through the Save My Chart
command to the currently displayed chart.
Save My Chart command—saves the chart settings that are applied to the current chart.
Restore Defaults command—applies the default settings to the currently displayed chart.
As a Bitmap command—copies a bitmap image of the chart to the clipboard.
As a Metafile command—copies a Windows Metafile image of the chart to the clipboard.
As Text (data only) command—copies tab-delimited chart data points to the clipboard.
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.
3D/2D Switches between two-dimensional and three-dimensional chart views.
Rotated View Rotates the chart along its z axis.
Rotate Around Y
Axis
Rotate Around X
Axis
Clustered (Z Axis) Clusters the chart along its z axis.
Click a color scheme to apply the scheme to the chart.
Selecting a three-dimensional chart view enables the Rotated View button.
Selecting a rotated chart view enables the Rotate Around Y Axis and Rotate Around X Axis buttons.
Rotates the chart around its y axis.
Rotates the chart around its x axis.
26
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.
Point Labels Applies labels to each data point in the chart.
Data Editor Displays a table at the bottom of the chart.
Legend Box Displays legends that identify the chart data.
Grid commands—turns on and off tick mark grid lines.
Interlaced command—applies alternate light and dark (interlaced) backgrounds between y-axis tick marks.
Show Labels command—labels x-axis tick marks.
Staggered command—staggers the labels applied to the x-axis tick marks.
Vertical labels command—rotates by 90° the labels applied to the x-axis tick marks.
Options command—displays a Properties window with the following tabs:
– Y Axis tab—sets labeling, tick marks, and gridlines for the y axis.
– Series tab—defines the display and formatting of series.
– General tab—sets general properties such as the screen title and screen background colors.
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.
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 tab—sets labeling, tick marks, and gridlines for the y axis.
– Series tab—defines the display and formatting of series.
– General tab—sets 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
Warning
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.
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
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.
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
Loading...
+ 96 hidden pages
You need points to download manuals.
1 point = 1 manual.
You can buy points or you can get point for every manual you upload.