k28601_web gpi user manual

8/10/2019 k28601_Web GPI User Manual

1/126

WebGPI

Communication

Software

User Manual


2/126

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 typejumps

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.

2 K28601FB November 2012


3/126


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 ...................................................................................................................................30Data 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

K28601Rev FB November 2012 3


4/126


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

4 K28601Rev FB November 2012


5/126


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 yourPC.



6/126


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 tuningvalue 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.



7/126


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 yourversion of the WebGPI application.

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 ................................................................................................................................28Debug Mode Pane ....................................................................................................................................29

Data Logging Pane ...................................................................................................................................30



8/126


User Manual

WebGPI Application

WebGPI Window

Path: Startmenu > Programs>WebGPI> WebGPI

The Sauer-Danfoss WebGPIwindow 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, seeMenu Baron page9.

Toolbar Provides quick access to major WebGPI application functions and display important application information.

For more information, seeToolbaron page11.

Main pane The panes that display here enable you to view, change, and log microcontroller application values.

For more information, seeAbout the View Menuon page13.



9/126


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 Creationwindow.

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

Download Displays the Downloaderpane.

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 Configurationpane.Use this pane to configure the COM port on your PC that communicates with the microcontroller.

Clicking Disconnectand closing communication with the microcontroller makes this command available.

Connect/

Disconnect

Opens and closes communication between the WebGPI application and the microcontroller.

Tools This menus command plots data that you have logged and saved.

Graph Displays the Open Real Time Performancewindow.

Use this window to chart (plot) data that you have logged and saved.

Information 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.

Info Screen Displays the Settings and System Infowindow.

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.



10/126


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.

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.



11/126


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 Creationwindow.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 Downloaderpane.

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 Modepane.

This pane directly sets microcontroller inputs and output values. It allows you to bypass the microcontrollerapplication for troubleshooting purposes.

Not all microcontroller applications have a debug mode.

Displays the Settings and System Infowindow.

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.

Baudratereplaces Portwhen you connect to the microcontroller.



12/126


User Manual

WebGPI Application

Toolbar

Item Description

Changes views in the WebGPI window. For more information, seeAbout the View Menuon page13.

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.



13/126


User Manual

WebGPI Application

About the View MenuThe pull-down Viewmenu lets you select between Normal, Main, Data Logging, and

Main 50%views.

Normal View

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



14/126


User Manual

WebGPI Application

Main View

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



15/126


User Manual

WebGPI Application

Data Logging View

The Data Loggingview 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 offlineviewing, and change the appearance of data logging charts.



16/126


User Manual

WebGPI Application

Main 50% View

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



17/126


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.


Item Description

Default value from Micro The HEADER, HEX, and XMLselections 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 Numberavailable.

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 HEADERand HEXfiles without a

connection to the microcontroller application.

XML (Datalogging)select to create an xml data log f ile (*.xml). An xml data log file identifies values to be logged in

the WebGPI-Log application.



18/126


User Manual

WebGPI Application


Item Description

Default value from XML-

File

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 HEXselection makes the Machine Default Identification Numberavailable.

Search Displays a Select Filewindow.

Use this window to select the xml file that contains the tuning values for the HEADERor HEXfile that you are

creating.

Machine DefaultIdentification Number

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

Search Displays a Select Filewindow.

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

Create Creates the file.



19/126


20/126


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 Filewindow that displays only files appropriate for your File type

download selection and Microcontroller typeselection

This filter works with file names that conform to the Sauer-Danfoss naming convention. For more information, see

About File Nameson page21.

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

(for application, kernel,

and defaults files)

Displays a Select Filewindow.

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

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

Search

(for boot files)

Displays a Select Filewindow.

Use this window to select the boot file required to download a kernel.

The text box to the left of Searchidentifies file type, f ile location, and name of the selected file.

Selecting Kerneland a Microcontroller typeof HC08, 167, HC08A, or 164makes this button available.

Force download/

Stop forcing download

Forces a connection to the microcontroller.

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

Boot-file download Starts the download of a boot file.

Selecting Kerneland a Microcontroller typeof HC08, 167, HC08A, or 164makes 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.



21/126


User Manual

WebGPI Application

About File NamesSauer-Danfoss adopted the following format in March 2002 for application, default, and

kernel file names.

The Downloaderpanes File name filterworks with file names that follow this format.

With File name filter checked, the Select Filewindow displays only files appropriate foryour 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.



22/126


User Manual

WebGPI Application

Configuration Pane

Path:Communicationmenu > 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.



23/126


User Manual

WebGPI Application

Offline WindowPath: Toolsmenu > Graph

This window displays charts of data that you have logged and saved.

T Use the Data Loggingpane (page30)to log data when you are connected to amicrocontroller.

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.



24/126


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 Chartcommanddisplays the Openwindow. Use this window to select and open a ChartFX *cfx format file.

Save Chartcommanddisplays the Save As window. Use this window to save a chart in the ChartFX *cfx file format.

Page Setupcommanddisplays the Page Setupwindow. Use this window to set the charts print margins and paper

orientation.

Print commanddisplays the Printwindow. Use this window to print out the chart.

Copy to Clipboard As a Bitmapcommandcopies a bitmap image of the chart to the clipboard.

As a Metafilecommandcopies 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/2Dcommandswitches between two-dimensional and three-dimensional chart views.

Clustered (Z Axis)commandclusters the chart along its z axis.

PropertiescommandDisplays a Propertieswindow with the following tabs:

Y Axis tabsets labeling, tick marks, and gridlines for the y axis.

Seriestabdefines the display and formatting of series.

Generaltabsets general properties such as the screen title and screen background colors.

Tools Values LegendcommandDisplays a values legend.

Series LegendcommandDisplays a series legend.

User LegendcommandDisplays a user legend.

Data Editorcommanddisplays 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.

Toolbarcommandhides the toolbar.

To restore the toolbar, right-click the chart. In the pop-up menu that displays, click Toolbar.

Menucommandhides the menu bar. To restore the menu bar, close and reopen the chart.



25/126


User Manual

WebGPI Application

Offline Window Chart Menu BarMenu Description

Help Contentscommanddisplays the contents of the help file.

Searchcommandsearches the help file.

About ChartFXcommanddisplays information about ChartFX software.



26/126


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 Chartcommandapplies the chart settings that have been saved through the Save My Chart

command to the currently displayed chart.

Save My Chartcommandsaves the chart settings that are applied to the current chart.

Restore Defaultscommandapplies the default settings to the currently displayed chart.

Copy to Clipboard Displays a menu with copy commands.

As a Bitmapcommandcopies a bitmap image of the chart to the clipboard.



Print Displays a Printwindow. 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.

Rotate Around YAxis

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.



27/126


User Manual

WebGPI Application

Offline Window Chart Toolbar ButtonsButton Name Description

Axes Settings Displays a menu with commands that change how the x axis and y axis display.

Gridcommandsturns on and off tick mark grid lines.

Interlacedcommandapplies alternate light and dark (interlaced) backgrounds between y-axis tick marks.

Show Labelscommandlabels x-axis tick marks.

Staggeredcommandstaggers the labels applied to the x-axis tick marks.

Vertical labelscommandrotates by 90 the labels applied to the x-axis tick marks.

Optionscommanddisplays a Propertieswindow with the following tabs:




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.

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 Propertieswindow with the following tabs:






28/126


User Manual

WebGPI Application

Information Window

Path: Informationmenu > 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. Notall applications have this window.

T You must connect to the microcontroller to view hardware information.



29/126


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 Testputs 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.

WarningThe 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.



30/126


User Manual

WebGPI Application

Data Logging Pane

Viewmenu > Data Loggingor Main 50%

Use this pane to plot and save run-time data when you are connected to a microcontroller

application.

Data Loggingcontrols are the same whether your Viewmenu selection is Mainor Main

50%.

T The WebGPI-Log application can log data at much higher acquisition rates than thelogging 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.



31/126


32/126


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 Chartcommanddisplays the Openwindow. Use this window to select and open a ChartFX *cfx format file.

Save Chartcommanddisplays the Save As window. Use this window to save a chart in the ChartFX *cfx format f ile.

Page Setupcommanddisplays the Page Setupwindow. Use this window to set the charts print margins and paper

orientation.

Print commanddisplays the Printwindow. Use this window to print out the chart.

Copy to Clipboard As a Bitmapcommandcopies a bitmap image of the chart to the clipboard.


As Text (data only)commandcopies tab-delimited data points from the chart to the clipboard.

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

Clustered (Z Axis)commandclusters the chart along its z axis.

Propertiescommanddisplays a Propertieswindow with the following tabs:




Tools Values LegendcommandDisplays a values legend.

Series LegendcommandDisplays a series legend.

User LegendcommandDisplays a user legend.





Toolbarcommandhides the toolbar. To restore the toolbar, right-click the chart. In the pop-up menu that displays, click

Toolbar.

Menucommandhides the menu bar. To restore the menu bar, close and reopen the chart.



33/126


34/126


User Manual

WebGPI Application

Data Logging Pane Chart Toolbar

Buttons in this toolbar format charts.

Data Logging Pane Chart Toolbar Buttons


Personalized Charts Displays a menu with commands that save and apply chart settings.

Load My Chartcommandapplies the chart settings that have been saved through the Save My Chart

command to the currently displayed chart.

Save My Chartcommandsaves the chart settings that are applied to the current chart.

Restore Defaultscommandapplies the default settings to the currently displayed chart.

Copy to Clipboard Displays a menu with copy commands.

As a Bitmapcommandcopies a bitmap image of the chart to the clipboard.



Print Displays a Printwindow. 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.


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.

Rotate Around YAxis

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.



35/126


User Manual

WebGPI Application

Data Logging Pane Chart Toolbar ButtonsButton Name Description

Axes Settings Displays a menu with commands that change how the x axis and y axis display.

Gridcommandsturns on and off tick mark grid lines.

Interlacedcommandapplies alternate light and dark (interlaced) backgrounds between y-axis tick marks.

Show Labelscommandlabels x-axis tick marks.

Staggeredcommandstaggers the labels applied to the x-axis tick marks.

Vertical labelscommandrotates by 90 the labels applied to the x-axis tick marks.

Optionscommanddisplays a Propertieswindow with the following tabs:




Point Labels Applies labels to each data point in the chart.

Data Editor Data Editorcommanddisplays a table at the bottom of 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 Propertieswindow with the following tabs:






36/126


User Manual

WebGPI Application

(This page is intentionally blank.)



37/126


User Manual

Chapter contents

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 yourversion of the WebGPI-Log application.

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

WebGPI-Log Window Toolbar ......................................................................................................................39

Data Logging Pane .................................................................................................................... ........................42



38/126


User Manual


WebGPI-Log Window

Path:Startmenu > Programs> WebGPI> WebGPI-Log

This window opens when you start the WebGPI-Log application. Use the controls in thiswindow 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.



39/126


User Manual


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 Disconnectbutton 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 Loggingbuttonstarts the data logging process.

To make the Start Loggingbutton available, you must connect to the microcontroller and select a screen file

(data logging file) to write data to.

Stop Loggingbuttonstops the data logging process.

Shows the data acquisition rate.

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



40/126


User Manual


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 timedata) fills the data

buffer. Then data logging stops.

Filemenu > Save Chartwrites the contents of the buffer to a ChartFX *.chd format file.

Click to display two additional buttons:

Edit Collectionbuttonopens 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 f rom the

chart collection.

You create xml data log files in the WebGPI applications File CreationwindowAdd Chartbuttonopens the

Add Chart to Collectionwindow. Use this window to add xml data log files to the currently selected chart

collection.

Click to display the:

Newbuttonopens the Create New Chart Collectionwindow. Use this window to name a new chart

collection.

Openbuttonopens the Open Chart Collectionbutton. Use this window to select and open a chart

collection.

Savebuttondisplays the Save Chart Collectionbutton. Use this window to save a chart collection

Click this button to save changes made in the Edit Chart List Collectionwindow.

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 Creationwindow.

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.



41/126


User Manual


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 Closebutton temporarily applies the changes made in this window to the chart

collection displayed in the WebGPI-Logwindow. Click the Collectionbutton > Savebutton in the WebGPI-Logwindow 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 Creationwindow. They define the data to be

logged.

Add Chartbutton Opens the Add Chart to Collectionwindow.

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

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

Close button Closes the Edit Chart Collectionwindow and applies the changes made in this window to the chart displayed in the

data logging pane.

Click the Collection> Savebuttons to save any changes made in the Edit Chart Collectionwindow.



42/126


User Manual


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 logfile 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.



43/126


44/126


45/126


46/126


User Manual


Chart Toolbar


Properties Opens a ChartFX Propertieswindow with the following tabs:

3Dtabdefines three-dimensional views of chart data.

Axestabsets labeling, tick marks, and gridlines for axes.


Generaltabsets general properties such as the chart title and chart background colors.

Click this windows Helpbutton for more information.


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

Opens a ChartFX Propertieswindow with the following tabs:

3Dtabdefines three-dimensional views of chart data.

Axestabsets labeling, tick marks, and gridlines for axes.


Generaltabsets general properties such as the chart title and chart background colors.

Click this windows Helpbutton 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.Print

Preview

Opens the Page setupwindow.

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 legendcommandlabels the data series in the chart.



Use the slider bars to access data points in the chart and in the table.


Toolbarcommandopens the Chart toolbar.

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

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



47/126


User Manual

Chapter contents

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 yourversion of the WebGPI application.

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



48/126


User Manual


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/Readswitch. Leave this switch set to Read.

ConnectorsSauer-Danfoss Cable PN 1090740

ConnectorsSauer-Danfoss Cable PN KW02027



49/126


User Manual


How to Start Communication between the WebGPI Application and a Microcontroller1. 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 Portto select the correct COM port.

C. Click Connectto connect to the microcontroller.

Baudratereplaces Portand shows the current rate.

TheSoftware P/Ndisplays the application software part number.

D. Click Applicationto open the microcontroller application interface.

The Navigation pane lists the microcontroller application parameters.

The Parameter pane identifies the microcontroller application.



50/126


51/126


User Manual


4. Change the selected value.A. Enter the new value.

B. As required, enter the Passwordand set the PWLevelneeded to change thevalue.

C. Click Send.



52/126


User Manual


How to Restore Defaults

To restore defaults, click SetDefaults.



53/126


User Manual


How to Log Run-Time DataT 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 Applicationon page 57.

1. Connect an appropriate cable between a COM port on your PC and the Sauer-Danfossmicrocontroller.

2. Start communication with the microcontroller (see page49).

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 thebuffer fills. Data logging continues until you click Stop Logging.

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



54/126


User Manual


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

A. In View, select Data Loggingto display a full Data Logging pane.

B. Click on Find Update Timeto 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 timeand a Logging time.

When you have defined a data trigger event, use the Pretrigger timeto setthe amount of pretrigger data collected when the event occurs.

The Logging timesets the size of the data buffer.

E. Click on Start Loggingto start logging data.



55/126


User Manual


5. Stop the data logging and save the data.

A. Click Stop Loggingto stop data logging.

B. In the Chart menu, click the Save Chartbutton to open the Save Aswindow. Use

this window to save a file of the logged data (*.CHD) for future viewing.

C. Click Quit Loggingto return to the previous pane and cancel all data logging

selections.



56/126


User Manual


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 Loggingbutton.

A right-click in a block diagram field:

Selects values that only log after a trigger event.

Displays a Data Loggingwindow.

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 triggercondition and value.

Select a trigger condition of noneto cancel a trigger event.



57/126


User Manual


How to Create an XML Data Log File for Use in the WebGPI-Log Application1. Open the WebGPI application.

2. Connect the WebGPI application to the microcontroller application.

3. Display the Mainpane for the application.

4. In the WebGPIwindows Mainpane, 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 Creationwindow to create an xml data log file with the values that youwant to log in the WebGPI-Log application.

A. Click the Savebutton in the WebGPIwindow to open the File Creationwindow.

B. Select the XMLoption in the File Creationwindow.

C. Click the Searchbutton in the File Creationwindow to open the SelectFilewindow.

D. In the Select Filewindow, name the xml data log file.

E. Click the Savebutton in the Select File window to close this window.



58/126


User Manual


6. Create the xml data log file.

A. Click the Createbutton in File Creationwindow.

B. Click OKto close the window with the Savecompleted message.



59/126


User Manual


How to Download a Defaults or Application File to an HC08 or HC08A Processor1. 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

Downloaderpane.

A. Start the WebGPI application.

B. As needed, change the Portto match the PC COM port that you are using.


D. Click Downloadto display the Downloaderpane.

If you get a Device is not respondingmessage, click OKto close this message.

Click Downloadto display the Downloaderpane and then perform a force

download procedure, starting with step4 on page62.



60/126


User Manual


4. Download an application or defaults file.

A. Click a File typeof either Applicationor Defaults.

B. Check the Application-Fileor the Default-Fileselection.

The WebGPI application will download this file to the microcontroller.

If this is not the right file, click Searchto display the Select Filewindow. Use this

window to browse to and select the right file.

If you still cannot find the right file, uncheck the File name filterin the

Downloaderpane and continue your search.

C. Click Downloadto start the download of the file.

5. When the download finishes, check the DownloaderProgress Indicator to make surethat your download has been successful.



61/126


User Manual


How to Force Download an Application File to an HC08 or HC08A Processor1. Connect an appropriate cable between a PC COM port and the microcontroller.



3. Start the WebGPI application and display the Downloaderpane.



C. Click Downloadto display the Downloaderpane.



62/126


User Manual


4. Select an application file to download.

A. Click OKto close the No micro selectedmessage.

B. Click a Microcontroller typeof either HC08or HC08A, depending on the type ofprocessor used by your microcontroller.

C. Click a File typeof Application.

D. Note the Application-Fileselection.








63/126


User Manual


5. Download the application file.

A. Click Force downloadto start the download.

B. Remove and then reapply microcontroller power.

C. Click Downloadto continue the download.

6. When the download finishes, check the DownloaderProgress Indicator to make sure

that your download has been successful.



64/126


User Manual


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.




Downloaderpane.





If you get a Device is not respondingmessage, click OKto close this message.

Click Downloadto display the Downloaderpane and then perform a force

download procedure, starting with5 on page69.



65/126


User Manual


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 typeof Kernel.

B. Check the Boot-Fileselection.




If you still cannot find the right file, uncheck the File name filterin theDownloaderpane and continue your search.

C. Click Boot-file downloadto download the file.

As soon as you click this button, the WebGPI application displays a window with a

Return code errorPlease repowermessage.

D. Remove and then reapply microcontroller power.

E. Click OKin the message window to continue the download.



66/126


User Manual


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.


As needed, use the Search Filewindow to browse to and select the right file.



B. Click Downloadto download the file.C. When the download finishes, remove and then reapply microcontroller power.



67/126


User Manual


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

A. In the Downloaderpane, click Exitto return to the WebGPIwindow.

B. In the WebGPI window, click Connectto reconnect to the microcontroller.

C. In the WebGPI window, click Download to display the Downloaderpane.

D. Check the DownloaderProgress Indicator to make sure that your download hasbeen successful.



68/126


User Manual


How to Force Download a Kernel to an HCO8 or HC08A Processor








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.



69/126


User Manual


5. Select and download the boot file.


B. Click a Microcontroller typeof either HC08or HC08A, depending on the type ofprocessor used in your microcontroller.

C. Click a File typeof Kernel.

D. Check the Boot-Fileselection.



window to select the right file. If you still cannot find the right file, uncheck theFile name filterin the Downloaderpane and continue your search.

E. Click Boot-file downloadto download the file.

As soon as you click this button, the WebGPI application displays a window with a

Return code errorPlease repowermessage.

F. Remove and then reapply microcontroller power.

G. Click OKin the message window to continue the download.



70/126


User Manual


6. When the download finishes, disconnect the boot pin from 0 V.

Do not remove power from the microcontroller in this step.







B. Click Downloadto download the file.C. When the download finishes, remove and then reapply microcontroller power.



71/126


User Manual


8. Check that your download has been successful.

A. In the Downloaderpane, click Exitto return to the WebGPIwindow.

B. In the WebGPI window, click Connectto reconnect to the microcontroller.

C. In the WebGPI window, click Download to display the Downloaderpane.

D. Check the DownloaderProgress Indicator to make sure that your download hasbeen successful.



72/126


User Manual


How to Download an Application File to a 196 Processor

T 196 microcontrollers do not have separate defaults files. To change default values, youmust download a new application file with new default values.





Downloaderpane.







73/126


User Manual


If you get a Device is not respondingmessage, click OKto close this message.Click Downloadto display the Downloaderpane and then perform a force


4. Download an application file.

A. Check the Application-Fileselection.






B. Click Downloadto start the download.



74/126


User Manual






75/126


User Manual


How to Force Download an Application File to a 196 Processor1. Connect an appropriate cable between a PC COM port and the microcontroller.





B. As needed, change the Portto match the COM port that you are using on your PCto communicate with the microcontroller.




76/126


User Manual


4. Select an application file to download.


B. Click a Microcontroller typeof 196.

C. Click a File typeof Application.

D. Note the Application-Fileselection.


If this is not the right file, click Searchto display the Select Filewindow. Use thiswindow to browse to and select the right file.





77/126


User Manual


5. Download the application file.

A. Click Force downloadto start the download.

B. Remove and then reapply microcontroller power.

C. Click Downloadto continue the download.





78/126


User Manual


How to Download a Kernel to a 196 Processor

T Downloading a 196 kernel deletes the application file in the 196 processor. Afterdownloading the kernel, you will have to reinstall the application file.





Downloaderpane.







79/126


User Manual


If you get a Device is not respondingmessage, click OKto close this message.Click Downloadto display the Downloaderpane and then perform a force


4. Select and download a boot file.

A. Click a File typeof Kernel.

B. Check the Boot-Fileselection.






C. Click Boot-file downloadto download the file.



80/126


User Manual








B. Click Downloadto download the file.

Once you download the boot and kernel files, you must also download the

application file to successfully complete this procedure.



81/126


User Manual


6. Download an application file.

A. Click a File typeof Application.

B. Check the Application-File selection.





C. Click Downloadto download the file.


that you have successfully downloaded the kernel and application files.



82/126


User Manual


How to Force Download a Kernel to a 196 Processor

T Download

k28601_web gpi user manual

Documents