k28601_Web GPI User Manual

(1)

(2)

and Headings topics, subtopics, and details, with descriptive headings set in red type. Section titles appear at the top of every page in large red type.

In the PDF version of this document, clicking an item underlined in blue italic type jumps you to the referenced page in the document.

Special Text Formatting Controls and indicators are set in bold black type.

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

Revision history

Revision Date Comment

Rev. EA December 2009 WebGPI Rev. 3.1.x

Rev. FA July 2010 WebGPI Rev. 3.2.x

Rev. FB November 2012 WebGPI Rev. 4.0.x

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.

(3)

Introduction ... 5

About this Manual ... 6

About the WebGPI and Web-GPI-Log Applications ... 6

WebGPI Application ... 7

WebGPI Window ... 8

Menu Bar... 9

Toolbar ... 11

About the View Menu ... 13

Normal View ... 13

Main View ... 14

Data Logging View ... 15

Main 50% View ... 16

File Creation Window ... 17

Downloader Pane ... 19

About File Names ... 21

Application File Names ... 21

Default File Names ... 21

Kernel File Names ... 21

Configuration Pane ... 22

Offline Window... 23

Offline Window Chart Menu Bar ... 24

Offline Window Chart Toolbar ... 26

Information Window ... 28

Debug Mode Pane ... 29

Data Logging Pane ... 30

Data Logging Pane Toolbar ... 31

Data Logging Pane Chart Menu Bar ... 32

Data Logging Pane Chart Toolbar ... 34

WebGPI-Log Application ... 37

WebGPI-Log Window ... 38

(4)

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

(5)

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.

(6)

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.

(7)

Chapter contents

This chapter describes the windows, controls, and indicators in the WebGPI application.

T The screen captures shown in this chapter may differ slightly from the screens in your version of the WebGPI application.

WebGPI Window ... 8

About the View Menu ... 13

File Creation Window ... 17

Downloader Pane ... 19

About File Names ... 21

Configuration Pane ... 22

Offline Window... 23

Information Window ... 28

Debug Mode Pane ... 29

(8)

WebGPI Window

Path: Start menu > Programs >WebGPI > WebGPI

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

WebGPI Window

Item Description

Menu bar Accesses WebGPI application functions and displays application information.

For more information, see Menu Bar on page 9.

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

For more information, see Toolbar on page 11.

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

(9)

Menu Bar

The Menu bar accesses WebGPI application functions and information.

T The Toolbar duplicates many Menu bar selections.

Menu Bar

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

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

Tools This menu’s command plots data that you have logged and saved.

Graph Displays the Open Real Time Performance window.

(10)

Menu Bar

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

(11)

Toolbar

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

T The Menu bar duplicates many Toolbar selections.

Toolbar

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.

(12)

Toolbar

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

(13)

About the View Menu

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

Normal View

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

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

(14)

Main View

(15)

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.

(16)

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.

(17)

File Creation Window

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

File Creation Window

Default value from Micro The HEADER, HEX, and XML selections become available when the WebGPI application connects to the

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.

(18)

File Creation Window

Default value from XML-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.

Search Displays a Select File window.

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

Machine Default Identification Number

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

Search Displays a Select File window.

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

(19)

Downloader Pane

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

Downloader Pane

Microcontroller type Selects the download protocol appropriate for the processor used in the microcontroller.

(20)

Downloader Pane

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)

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.

Search (for boot files)

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.

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 Kernel and a Microcontroller type of HC08, 167, HC08A, or 164 makes this button available.

Download Starts a download of an application or kernel file.

Instruction Displays instructions to help you download files.

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

(21)

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

(22)

Configuration Pane

Path: Communication menu > Configuration

This pane configures the COM port that WebGPI application uses to communicate with the microcontroller.

T To display this pane, first disconnect the WebGPI application from the microcontroller.

Configuration Pane

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.

(23)

Offline Window

Path: Tools menu > Graph

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

T Use the Data Logging pane (page 30) to log data when you are connected to a microcontroller.

Offline Window

(24)

Offline Window Chart Menu Bar

Commands in this menu bar format charts.

Offline Window Chart Menu Bar

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.

(25)

Offline Window Chart Menu Bar

Help Contents command—displays the contents of the help file. Search command—searches the help file.

(26)

Offline Window Chart Toolbar

Buttons in this toolbar format charts.

Offline Window Chart Toolbar Buttons

Button Name Description

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

Load My Chart 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.

Copy to Clipboard Displays a menu with copy commands.

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.

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

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

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

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

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

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

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

Rotated View Rotates the chart along its z axis.

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

Axis

Rotates the chart around its y axis. Rotate Around X

Axis

Rotates the chart around its x axis.

(27)

Offline Window Chart Toolbar Buttons

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

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.

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

(28)

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.

(29)

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.

(30)

Data Logging Pane

View menu > Data Logging or Main 50%

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

Data Logging controls are the same whether your View menu selection is Main or Main 50%.

T The WebGPI-Log application can log data at much higher acquisition rates than the logging function described here.

Data Logging Pane

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.

(31)

Data Logging Pane Toolbar

Controls in this toolbar:

• Start and stop data logging.

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

Data Logging Pane Toolbar

Starts data logging.

You must select data to log to make this button available. Stops data logging.

Clicking Start Logging makes this button available.

Automatically finds the optimum update time based on your data logging selections. This button becomes available when you select data to log.

Stops data logging, clears data log selections, empties the data buffer, and closes the Data Logging pane.

Sets the data acquisition rate.

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

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

The buffer is circular. When the buffer fills, the newest data overwrites the oldest data. Data logging continues until you click Stop Logging.

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

(32)

Data Logging Pane Chart Menu Bar

Commands in this menu bar format charts.

Data Logging Pane Chart Menu Bar

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 format file. 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 data points from the chart 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.

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

(33)

Data Logging Pane Chart Menu Bar

Help Contents command—displays the contents of the help file. Search command—searches the help file.

(34)

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

Copy to Clipboard Displays a menu with copy commands.

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.

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

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

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

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

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

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 Y

Axis

Rotates the chart around its y axis. Rotate Around X

Axis

Rotates the chart around its x axis.

(35)

Data Logging Pane Chart Toolbar Buttons

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

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.

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

Data Editor Data Editor command—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 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.

(36)

(37)

Chapter contents

This chapter describes the WebGPI-Log application’s windows and their controls and indicators.

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

T The screen captures shown in this chapter may differ slightly from the screens in your version of the WebGPI-Log application.

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

(38)

WebGPI-Log Window

Path: Start menu > Programs > WebGPI > WebGPI-Log

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

WebGPI-Log Window

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.

(39)

WebGPI-Log Window Toolbar

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

WebGPI-Log Toolbar

Connect button—opens communication between the WebGPI-Log application and the microcontroller. Disconnect button—closes communication between the WebGPI-Log application and the microcontroller.

Starts communication between the microcontroller and the WebGPI application on the selected RS 232-C port. Click the Disconnect button to make this control available.

Selects the data transmission rate between the WebGPI-Log application and the microcontroller. The WebGPI-Log application automatically selects the optimum rate.

After you connect to the microcontroller, items in this pull-down menu can display the following information:

– Software-P/N—display the microcontroller application software part number. – Hardware-ID—display the microcontroller hardware identification number.

– Machine Default ID-Number—display the default tuning value set identification number. – OS Version—display the version of the kernel (operating system) used in the microcontroller. – EC-Processor type—display the processor type used in the microcontroller.

Shows the name of the currently selected screen collection.

Start Logging button—starts the data logging process.

To make the Start Logging button available, you must connect to the microcontroller and select a screen file (data logging file) to write data to.

(40)

WebGPI-Log Toolbar

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

The buffer is circular. When the buffer fills, the newest data overwrites the oldest data. Data logging continues until you click Stop Logging.

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

File menu > Save Chart writes the contents of the buffer to a ChartFX *.chd format file.

Click to display two additional buttons:

– Edit Collection button—opens the Edit Chart Collection List window. This window lists the xml data log

files in the currently selected chart collection. Use this window to add and remove xml data log files from the chart collection.

You create xml data log files in the WebGPI application’s File Creation windowAdd Chart button—opens the

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

collection. Click to display the:

– New button—opens the Create New Chart Collection window. Use this window to name a new chart

collection.

– Open button—opens the Open Chart Collection button. Use this window to select and open a chart

collection.

– Save button—displays the Save Chart Collection button. Use this window to save a chart collection

Click this button to save changes made in the Edit Chart List Collection window. Displays information about the WebGPI-Log application and Sauer-Danfoss.

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

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

−

You create in the WebGPI application’s File Creation window.

−

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

• Chart collections:

−

Contain sets of xml data log files.

−

Have *.gpi extensions.

• ChartFX (*.chd) files:

−

Define the formatting of the logged data.

(41)

Edit Chart Collection List Window

This window lists the xml data log files in the currently selected chart collection. Use this window to add and remove xml data log files from the chart collection.

T The Close button temporarily applies the changes made in this window to the chart collection displayed in the WebGPI-Log window. Click the Collection button > Save button in the WebGPI-Log window to make changes permanent.

Edit Chart Collection List Window

Chart collection list Lists the xml data log files in the chart collection.

(42)

Data Logging Pane

This pane displays a chart of the data you selected to log, along with a Chart menu and toolbar to format the display of data.

T The Chart menu, Chart toolbar, and Data chart display after you select an xml data log file that identifies the data to be logged.

Data Logging Pane

Chart menu Accesses all charting functions.

Chart toolbar Quickly accesses major charting functions.

(43)

Chart Menu

This menu accesses all charting functions.

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

Chart Menu

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

Save Chart Opens the Save As window.

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

Open Chart Opens the Open window.

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

Save Template Opens the Save As window.

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

Open Template Opens the Open window.

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

(44)

Chart Menu

Tools _{Commands in this menu label chart data and display toolbars that change chart colors and patterns.} Values legend Labels values in the chart.

Series legend Labels the data series in the chart.

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

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

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

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

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

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

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

Rotate Select a three-dimensional view of screen data to make this command available. Opens a ChartFX Properties window with the following tabs:

– 3D tab—defines three-dimensional views of chart data. – Axes tab—sets labeling, tick marks, and gridlines for axes. – Series tab—defines the display and formatting of series.

Click this window’s Help button for more information.

Z-Clustered Displays data clustered along the chart’s z-axis. Not available for all charts.

Properties Opens a ChartFX Properties window with the following tabs:

Zoom Zooms on the chart.

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

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

Help Commands in this menu access information about ChartFX software.

Contents Opens the contents of Help.

Search Searches the Help index.

(45)

Chart Toolbar

This toolbar accesses major charting functions.

T A chart must be selected to display this toolbar.

Chart Toolbar

Open Chart Opens the Open window.

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

Save Chart Opens the Save As window.

Use this window to save a chart or a chart template in the ChartFX CHD file format.

A chart file has data and chart display selections. A chart template file has chart display selections but no data. Copy to

Clipboard

Copies the chart to the clipboard in these formats:

– As a Bitmap 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 data points to the clipboard.

– As OLE Object command—copies an object linking and embedding (OLE) image of the chart to the clipboard.

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

Color Applies colors to elements in the chart.

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

(46)

Chart Toolbar

Properties Opens a ChartFX Properties window with the following tabs:

– General tab—sets general properties such as the chart title and chart background colors.

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

Opens a ChartFX Properties window with the following tabs:

– General tab—sets general properties such as the chart title and chart background colors.

Z-Clustered Displays data clustered along the chart’s 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 setup window.

Use this window to set up the chart for printing.

Print Prints the chart to the selected printer.

Tools Opens a menu with the following commands:

Series legend command—labels the data series in the chart. 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 bars to access data points in the chart and in the table.

Toolbar command—opens the Chart toolbar.

PaletteBar command—opens a palette with colors that you can drag and apply to chart elements. PatternBar command—opens a palette with patterns that you can drag and apply to chart elements.

(47)

Chapter contents

This chapter contains step-by-step instructions for performing common WebGPI tasks.

T The screen captures shown in this chapter may differ slightly from the screens in your version of the WebGPI application.

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

(48)

How to Connect Your PC to a Microcontroller

The WebGPI application uses an RS-232-C COM port on your PC to communicate with Sauer-Danfoss microcontrollers.

The table below lists the cables needed for communication with Sauer-Danfoss microcontrollers through this COM port.

Cabling Requirements

Sauer-Danfoss Microcontroller Sauer-Danfoss Cable Part Number

MC200 PN 1090740

MC400 PN 1090740

S2X PN KW02027* or PN KW02012†

MC300 PN KW02027* or PN KW02012†

* Recommended cable.

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

Connectors—Sauer-Danfoss Cable PN 1090740

(49)

How to Start Communication between the WebGPI Application and a Microcontroller

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

2. Connect to the microcontroller and open its application interface. A. On your PC, start the WebGPI application.

B. As needed, use Port to select the correct COM port. C. Click Connect to connect to the microcontroller.

(50)

How to Change a Parameter Value

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

2. Start communication with the microcontroller (see page 49).

3. Navigate to the parameter set and select the value to be changed. A. In the Navigation pane, click a parameter.

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

(51)

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

B. As required, enter the Password and set the PWLevel needed to change the value.

(52)

How to Restore Defaults

(53)

How to Log Run-Time Data

T WebGPI-Log application data acquisition rates are typically twice as fast as the WebGPI application rates. To log data in the WebGPI-Log application, you must first use the WebGPI application to create an xml data log file that defines the values that you want to log. For more information, see How to Create an XML Data Log File for Use in the

WebGPI-Log Application on page 57.

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

2. Start communication with the microcontroller (see page 49).

3. Select the data to be plotted.

A. In the Navigation pane, click to open the block diagram with the data to be plotted.

(54)

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

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

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

–

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

–

The Logging time sets the size of the data buffer. E. Click on Start Logging to start logging data.

(55)

5. Stop the data logging and save the data. A. Click Stop Logging to stop data logging.

B. In the Chart menu, click the Save Chart button to open the Save As window. Use this window to save a file of the logged data (*.CHD) for future viewing.

(56)

About Selecting Values for Logging

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

The procedure for selecting the values that you want to log is the same for both applications.

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

• A right-click in a block diagram field:

−

Selects values that only log after a trigger event.

−

Displays a Data Logging window.

–

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

–

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

(57)

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

2. Connect the WebGPI application to the microcontroller application. 3. Display the Main pane for the application.

4. In the WebGPI window’s Main pane, select the values that you want to log in the WebGPI-Log application. For more information, see About Selecting Values for Logging

on page 56.

5. Open the File Creation window to create an xml data log file with the values that you want to log in the WebGPI-Log application.

(58)

6. Create the xml data log file.

A. Click the Create button in File Creation window.

(59)

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

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

(60)

4. Download an application or defaults file.

A. Click a File type of either Application or Defaults. B. Check the Application-File or the Default-File selection.

The WebGPI application will download this file to the microcontroller.

If this is not the right file, click Search to display the Select File window. Use this window to browse to and select the right file.

If you still cannot find the right file, uncheck the File name filter in the Downloader pane and continue your search.

C. Click Download to start the download of the file.

(61)

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

(62)

4. Select an application file to download.

A. Click OK to close the No micro selected message.

B. Click a Microcontroller type of either HC08 or HC08A, depending on the type of processor used by your microcontroller.

C. Click a File type of Application. D. Note the Application-File selection.

(63)

5. Download the application file.

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

(64)

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

(When applying power to the microcontroller, do not start your vehicle’s engine.)

3. Start the WebGPI application, connect to the microcontroller, and display the Downloader pane.

A. Start the WebGPI application.

B. As needed, change the Port to match the PC COM port that you are using. C. Click Connect to connect to the microcontroller.

D. Click Download to display the Downloader pane.

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

(65)

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

C. Apply power to the microcontroller.

5. Select and download a boot file. A. Click a File type of Kernel. B. Check the Boot-File selection.

(66)

6. When the boot file download finishes, disconnect the boot pin from 0 V. Do not remove power from the microcontroller in this step.

7. Download a kernel file.

A. Check the Operating System File selection.

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

B. Click Download to download the file.

(67)

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

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

(68)

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

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

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

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

(69)

5. Select and download the boot file.

A. Click OK to close the No micro selected message.

B. Click a Microcontroller type of either HC08 or HC08A, depending on the type of processor used in your microcontroller.

C. Click a File type of Kernel. D. Check the Boot-File selection.

(70)

6. When the download finishes, disconnect the boot pin from 0 V. Do not remove power from the microcontroller in this step.

(71)

8. Check that your download has been successful.

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

(72)

How to Download an Application File to a 196 Processor

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

(73)

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

4. Download an application file.

A. Check the Application-File selection.

(74)

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

(75)

How to Force Download an Application File to a 196 Processor

(76)

A. Click OK to close the No micro selected message. B. Click a Microcontroller type of 196.

(77)

5. Download the application file.

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

(78)

How to Download a Kernel to a 196 Processor

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

(79)

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

4. Select and download a boot file. A. Click a File type of Kernel. B. Check the Boot-File selection.

(80)

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

(81)

6. Download an application file. A. Click a File type of Application. B. Check the Application-File selection.

(82)

How to Force Download a Kernel to a 196 Processor

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

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

(83)

4. Select and download the boot file.

C. Click a File type of Kernel. D. Check the Boot-File selection.

(84)

As needed, use the Search File window to browse to and select the right file. If you still cannot find the right file, uncheck the File name filter in the Downloader pane and continue your search.

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

(85)

6. Download an application file. A. Click a File type of Application. B. Check the Application-File selection.

As needed, use the Search File window to browse to and select the right file. If you still cannot find the right file, uncheck the File name filter in the Downloader pane and continue your search.

(86)

How to Download an Application or Defaults File to a 167 Processor

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

2. Apply power to the microcontroller. (When applying power to the microcontroller, do not start your vehicle’s engine.)

D. Click Download to display the Downloader pane.

If you get a Device is not responding message, click OK to close this message. Click Download to display the Downloader pane and then perform a force

(87)

4. Download an application or defaults file.

A. Click a File type of either Application or Defaults. B. Check the Application-File selection.

If this is not the right file, click Search to display the Select File window. Use this window to browse to and select the right file. If you still cannot find the right file, uncheck the File name filter in the Downloader pane and continue your search. C. Click Download to start the download.

(88)

How to Force Download an Application File to a 167 Processor

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

2. Apply power to the microcontroller.

B. As needed, change the Port to match the COM port that you are using on your PC to communicate with the microcontroller.

(89)