Professional Documents
Culture Documents
User Manual: Webgpi Communication Software
User Manual: Webgpi Communication Software
Communication
Software
User Manual
WebGPI Communication Software
User Manual
About this Manual
Organization To help you quickly find information in this manual, the material is divided into sections,
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
Introduction ........................................................................................................................................................... 5
About this Manual ....................................................................................................................................... 6
About the WebGPI and Web-GPI-Log Applications ....................................................................... 6
This manual documents the WebGPI™ application and the supplemental WebGPI-Log™
application.
T If you are updating your WebGPI application, first uninstall any older versions from your
PC.
• 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.
• Upload tuning values from microcontroller applications and create default tuning
value files containing these values.
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
Path: Start menu > Programs >WebGPI > WebGPI
The Sauer-Danfoss WebGPI window displays when you start the WebGPI application. The
controls in this window access application functions and display application information.
WebGPI Window
Item Description
Menu bar Accesses WebGPI application functions and displays application information.
For more information, see Menu Bar on page 9.
Toolbar Provides quick access to major WebGPI application functions and display important application information.
For more information, see Toolbar on page 11.
Main pane The panes that display here enable you to view, change, and log microcontroller application values.
For more information, see About the View Menu on page 13.
Menu Bar
Menu Bar
Item Description
Communication The commands in this menu control communication between the WebGPI application and the microcontroller.
Connect/ Opens and closes communication between the WebGPI application and the microcontroller.
Disconnect
Tools This menu’s command plots 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.
User Manual Opens a PDF version of the microcontroller application manual. Not all applications have a manual.
Menu Bar
Item Description
Help The commands in this menu open the WebGPI manual and access the Sauer-Danfoss home page.
Sauer-Danfoss Opens the Sauer-Danfoss home page if you have an active internet connection.
WebPage
Toolbar
Toolbar buttons and controls provide quick access to WebGPI application functions.
Toolbar
Item Description
Selects an application for review when you are not connected to a microcontroller.
Disconnecting from a microcontroller makes this button available.
Toggles the view between the current view and the previous view.
Port—selects the RS 232-C port that the WebGPI application uses to communicate with the microcontroller.
Baudrate—selects the data transmission rate between the WebGPI application and the microcontroller.
– Microcontrollers that use Motorola 68HC08 and 68HC08A processors automatically connect at 9600 baud.
– Microcontrollers that use Infineon 167 and Intel 196 processors automatically connect at 19200 baud.
Baudrate replaces Port when you connect to the microcontroller.
Toolbar
Item Description
Changes views in the WebGPI window. For more information, see About the View Menu on page 13.
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).
Normal View
The Normal view splits the WebGPI window into a Navigation pane and a Parameter pane.
• The Navigation pane lists all the parameter sets used in the microcontroller
application. Folders organize similar parameter sets.
• The Parameter pane displays parameter sets. Click in the Navigation pane to select a
parameter set for display.
• Use these panes to view and change parameter values when you are connected to a
microcontroller.
• Use these panes to review parameters when you are not connected to a
microcontroller. You can view a sample set of parameters but not change their values.
Main View
The Main view displays a single Main pane, typically used to view block diagrams.
• 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.
The Main 50% view splits the WebGPI window horizontally, with the Data Logging pane
initially taking up the lower 50% of the window.
This window creates default tuning value files. It also creates files that define the data to
be logged in the WebGPI-Log application.
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.
HEX—select to create a hexadecimal file (*.hex) with the current microcontroller application tuning values.
The values in this file become the default tuning values when you download this file to a microcontroller application.
This selection makes the Machine Default Identification Number available.
XML—select to create an extensible markup language file (*.xml) with the current microcontroller application tuning
values.
Use this file format to store tuning values. You can use these files to create HEADER and HEX files without a
connection to the microcontroller application.
XML (Datalogging)—select to create an xml data log file (*.xml). An xml data log file identifies values to be logged in
the WebGPI-Log application.
Default value from XML- Creates C header files (*.h) and hexadecimal files (*.hex) containing tuning values from a selected xml source file.
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.
Machine Default Enters the suffix appended to the microcontroller application file name that identifies the default tuning value set.
Identification Number
Downloader Pane
This pane downloads application files, default tuning values files, and kernel files to
microcontrollers.
Downloader Pane
Item Description
Microcontroller type Selects the download protocol appropriate for the processor used in the microcontroller.
The WebGPI application automatically selects the correct processor type when it connects to the microcontroller.
You must select the correct type of processor if the WebGPI application fails to connect to the microcontroller.
HC08—selects the Motorola 68HC08 processor download protocol.
167—selects the Infineon 167 processor download protocol.
196—selects the Intel 196 processor download protocol.
HC12—selects the Motorola 68HC12 processor download protocol.
HC08A—selects the Motorola 68HC08A processor download protocol.
164—selects the Infineon 164 processor download protocol.
TI—selects the Texas Instruments (TI) processor download protocol.
Downloader Pane
Item Description
Progress indicator Identifies the defaults, application, and kernel used in the microcontroller.
During a download, it indicates the progress of the download.
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.
Microcontroller application default tuning file names use the format shown above.
Configuration Pane
Path: Communication menu > Configuration
This pane configures the COM port that WebGPI application uses to communicate with
the microcontroller.
T To display this pane, first disconnect the WebGPI application from the microcontroller.
Configuration Pane
Item Description
RS232 Configures the RS-232-C COM port that the WebGPI application uses to communicate with the microcontroller.
Connection timeout Sets the time that the WebGPI application waits for a response indicating a successful initial connection before trying
another baud rate.
The WebGPI application displays an alert message if all connection attempts fail.
Standard timeout Sets the time that the WebGPI application waits for a response during normal operation before trying another baud rate.
The WebGPI application displays an alert message if all connection attempts fail.
Offline Window
Path: Tools menu > Graph
This window displays charts of data that you have logged and saved.
T Use the Data Logging pane (page 30) to log data when you are connected to a
microcontroller.
Offline Window
Item Description
Chart area Displays charts of data that you have logged and saved.
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.
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.
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.
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.
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.
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.
This pane allows you to view microcontroller inputs and directly set microcontroller
outputs when the WebGPI application is in the debug mode.
Clicking IO Test puts the WebGPI application in a troubleshooting debug mode that
bypasses the microcontroller application. To enter the debug mode, you must connect to
the microcontroller without opening the microcontroller application interface.
Warning
The debug mode directly applies output values. It bypasses fault and limit protections.
Changing outputs can cause sudden and unexpected machinery movements that can
result in personal injury and equipment damage.
Understand the consequences of changing microcontroller outputs. Be prepared for sudden
vehicle and machinery movements.
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 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 area Displays a chart of the data that you are logging.
• Set data acquisition parameters such as the update time and the logging time.
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 how many minutes of pre-trigger data are logged when a trigger event occurs.
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.
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.
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.
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.
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.
Data Editor 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.
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
Path: Start menu > Programs > WebGPI > WebGPI-Log
This window opens when you start the WebGPI-Log application. Use the controls in this
window to access application functions.
WebGPI-Log Window
Item Description
Data Logging pane Once you select data to log, this pane displays a chart of the data and Chart menu and a Chart toolbar to format the data.
Toolbar Buttons and controls provide quick access to WebGPI-Log application functions.
Toolbar buttons and controls provide quick access to WebGPI-Log application functions.
WebGPI-Log Toolbar
Item Description
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.
Sets how many minutes of pre-trigger data log when a trigger event occurs.
WebGPI-Log Toolbar
Item Description
About XML Data Log Files, Chart Collections, and ChartFX Files
• XML data log files are extensible mark-up language files (*.xml) that:
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.
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 application’s File Creation window. They define the data to be
logged.
Remove Chart button Temporarily removes an xml data log file from the chart collection.
Close button Closes the Edit Chart Collection window and applies the changes made in this window to the chart displayed in the
data logging pane.
Click the Collection > Save buttons to save any changes made in the Edit Chart Collection window.
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.
Chart Menu
T This menu displays after you select an xml data log that identifies data to be logged.
Chart Menu
Item Description
Edit Commands in this menu copy charts to the clipboard and change the appearance of text in the chart.
Fonts Changes the font, size, and style of text elements in the chart.
Chart Menu
Item Description
Tools Commands in this menu label chart data and display toolbars that change chart colors and patterns.
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.
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.
– General tab—sets general properties such as the screen title and screen background colors.
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.
Gallery Opens a palette with line, bar, and other chart types. Click a selection to change the chart type.
Chart Toolbar
Chart Toolbar
Button Name Description
Gallery Opens a palette with line, bar, and other chart types. Click a selection to change the chart type.
Legend Displays legends that identify the data series in the chart.
Box
Chart Toolbar
Button Name Description
Z-Clustered Displays data clustered along the chart’s z-axis. Not available for all charts.
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.
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
* Recommended cable.
† This cable has a Prog/Read switch. Leave this switch set to Read.
B. As required, enter the Password and set the PWLevel needed to change the
value.
C. Click Send.
1. Connect an appropriate cable between a COM port on your PC and the Sauer-Danfoss
microcontroller.
A. In the Navigation pane, click to open the block diagram with the data to be
plotted.
Right-click to select data to log and set a data trigger in the DataLogging
window.
– Until a data trigger occurs, new data overwrites the oldest data when the
buffer fills. Data logging continues until you click Stop Logging.
– When a data trigger occurs, logging continues until new data (including any
Pretrigger time data) fills the data buffer and then stops.
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.
– When you have defined a data trigger event, use the Pretrigger time to set
the amount of pretrigger data collected when the event occurs.
B. In the Chart menu, click the Save Chart button to open the Save As window. Use
this window to save a file of the logged data (*.CHD) for future viewing.
C. Click Quit Logging to return to the previous pane and cancel all data logging
selections.
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.
– Data logging starts when the value being logged meets both the trigger
condition and value.
How to Create an XML Data Log File for Use in the WebGPI-Log Application
1. Open the WebGPI 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.
A. Click the Save button in the WebGPI window to open the File Creation window.
C. Click the Search button in the File Creation window to open the Select File
window.
D. In the Select File window, name the xml data log file.
E. Click the Save button in the Select File window to close this window.
(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.
B. As needed, change the Port to match the PC COM port that you are using.
If you get a Device is not responding message, click OK to close this message.
Click Download to display the Downloader pane and then perform a force
download procedure, starting with step 4 on page 62.
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.
5. When the download finishes, check the Downloader Progress Indicator to make sure
that your download has been successful.
(When applying power to the microcontroller, do not start your vehicle’s engine.)
B. As needed, change the Port to match the PC COM port that you are using.
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.
6. When the download finishes, check the Downloader Progress Indicator to make sure
that your download has been successful.
(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.
B. As needed, change the Port to match the PC COM port that you are using.
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.
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.
As soon as you click this button, the WebGPI application displays a window with a
Return code error… Please repower… message.
6. When the boot file download finishes, disconnect the boot pin from 0 V.
As needed, use the Search File window to browse to and select the right file.
If you still cannot find the right file, uncheck the File name filter in the
Downloader pane and continue your search.
C. When the download finishes, remove and then reapply microcontroller power.
D. Check the Downloader Progress Indicator to make sure that your download has
been successful.
(When applying power to the microcontroller, do not start your vehicle’s engine.)
B. As needed, change the Port to match the PC COM port that you are using.
If this is not the right file, click Search to display the Select File window. Use this
window to select the right file. If you still cannot find the right file, uncheck the
File name filter in the Downloader pane and continue your search.
As soon as you click this button, the WebGPI application displays a window with a
Return code error… Please repower… message.
As needed, use the Search File window to browse to and select the right file.
If you still cannot find the right file, uncheck the File name filter in the
Downloader pane and continue your search.
C. When the download finishes, remove and then reapply microcontroller power.
D. Check the Downloader Progress Indicator to make sure that your download has
been successful.
T 196 microcontrollers do not have separate defaults files. To change default values, you
must download a new application file with new default values.
(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.
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.
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.
5. When the download finishes, check the Downloader Progress Indicator to make sure
that your download has been successful.
(When applying power to the microcontroller, do not start your vehicle’s engine.)
B. As needed, change the Port to match the COM port that you are using on your PC
to communicate with 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.
6. When the download finishes, check the Downloader Progress Indicator to make sure
that your download has been successful.
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.
(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.
B. As needed, change the Port to match the PC COM port that you are using.
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.
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.
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.
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.
7. When the download finishes, check the Downloader Progress Indicator to make sure
that you have successfully downloaded the kernel and application files.
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.
(When applying power to the microcontroller, do not start your vehicle’s engine.)
B. As needed, change the Port to match the PC COM port that you are using.
If this is not the right file, click Search to display the Select File window. Use this
window to select the file you want.
If you still cannot find the right file, uncheck the File name filter in the
Downloader pane and continue your search.
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.
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.
7. When the download finishes, check the Downloader Progress Indicator to make sure
that you have successfully downloaded the kernel and application files.
If you are using a Sauer-Danfoss KW02012 cable with a Prog/Read switch, set this
switch to Read.
3. Start the WebGPI application, connect to the microcontroller, and display the
Downloader pane.
B. As needed, change the Port to match the PC COM port that you are using.
If you get a Device is not responding message, click OK to close this message.
Click Download to display the Downloader pane and then perform a force
download procedure, starting with step 4 on page 89.
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.
5. When the download finishes, check the Downloader Progress Indicator to make sure
that your download has been successful.
If you are using a Sauer-Danfoss KW02012 cable with a Prog/Read switch, set this
switch to Read.
(When applying power to the microcontroller, do not start your vehicle’s engine.)
B. As needed, change the Port to match the COM port that you are using on your PC
to communicate with 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.
6. When the download finishes, check the Downloader Progress Indicator to make sure
that your download has been successful.
If you are using a Sauer-Danfoss KW02012 cable with a Prog/Read switch, set this
switch to Read.
(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.
B. As needed, change the Port to match the PC COM port that you are using.
If you get a Device is not responding message, Click OK to close this message.
Click Download to display the Downloader pane and then perform a force
download procedure, starting with step 5 on page 95.
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.
D. When the download finishes, remove and then reapply microcontroller power.
D. Check the Downloader Progress Indicator to make sure that your download has
been successful.
B. As needed, change the Port to match the PC COM port that you are using.
If this is not the right file, click Search to display the Select File window. Use this
window to select the right file.
If you still cannot find the right file, uncheck the File name filter in the
Downloader pane and continue your search.
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. If you are using the Sauer-Danfoss KW02012 cable, set this cable’s Prog/Read
switch back to Read and skip lettered steps C and D.
C. Disconnect the “bootstrap pin high” from 5 V.
D. Check the Downloader Progress Indicator to make sure that your download has
been successful.
T HC12 processors do not have separate application and defaults files. To change defaults
values, you must download an application file that contains the new defaults values.
(When applying power to the microcontroller, do not start your vehicle’s engine.)
B. As needed, change the Port to match the PC COM port that you are using.
If this is not the right file, click Search to display the Select File window. Use this
window to browse to and select the file that you want to download.
If you still cannot find the right file, uncheck the File name filter in the
Downloader pane and continue your search.
D. When the download completes, click OK to close the Device is not responding
message.
C. Check the Downloader Progress Indicator to make sure that your download has
been successful.
(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.
B. As needed, change the Port to match the PC COM port that you are using.
If you get a Device is not responding message, click OK to close this message.
Click Download to display the Downloader pane and then perform a force
download procedure, starting with step 4 on page 106.
If this is not the right file, click Search to display the Select File window. Use this
window to browse to and select the file that you want to download.
If you still cannot find the right file, uncheck the File name filter in the
Downloader pane and continue your search.
5. When the download finishes, again remove and then reapply microcontroller power.
D. Check the Downloader Progress Indicator to make sure your download has been
successful.
(When applying power to the microcontroller, do not start your vehicle’s engine.)
B. As needed, change the Port to match the PC COM port that you are using.
If this is not the right file, click Search to display the Select File window. Use this
window to select the file you want.
If you still cannot find the right file, uncheck the File name filter in the
Downloader pane and continue your search.
6. When the download finishes, again remove and then reapply microcontroller power.
D. Check the Downloader Progress Indicator to make sure your download has been
successful.
1. Connect an appropriate RS-232-C cable between a COM port on your PC and the
Sauer-Danfoss microcontroller.
B. As needed, use Port to select the correct COM port on your PC.
A. In the Default value from Micro, select the type of file you want to create:
– HEADER—A C header format (*.h) file with the current application tuning
values. This file’s tuning values can become the default tuning values when
Sauer-Danfoss compiles a new version of the microcontroller application.
– XML—An extensible markup language format file (*.xml) with the current
application tuning values. This is the preferred file format for saving. You can
use this file to create HEADER and HEX files without a connection to the
microcontroller application.
– XML (Datalogging)—An xml format file that identifies the data to be logged
using the WebGPI-Log application.
C. In the Select File window, name the file, select its save location, and click Save to
close the window.
T Application files for TI processors combine kernel, application, and defaults in a single
file.
(When applying power to the microcontroller, do not start your vehicle’s engine.)
B. As needed, change the Port to match the PC COM port that you are using.
If this is not the right file, click the active Search button to display the Select File
window. Use this window to browse to and select the file that you want to
download.
If you still cannot find the right file, uncheck the File name filter in the
Downloader pane and continue your search.
This chapter contains step-by-step instructions for using the WebGPI-Log application to
log data.
T The screen captures shown in this chapter may differ slightly from the screens in your
version of the WebGPI application.
T To use the WebGPI-Log application, you must first use the WebGPI application to create
an xml data log file that defines the values that you want to log.
1. In the WebGPI application, create xml data log files. Write these files to a common
folder.
3. Select the xml data log file that has the data that you want to log.
A. Click the Add Chart button in the WebGPI-Log window to open the Add Chart
to Collection window.
B. In the Add Chart to Collection window, select the xml data file that defines your
data logging selections (what you want to log).
C. In the Add Chart to Collection window, click the Open button to add the values
in the selected xml data file to the WebGPI-Log window.
4. Repeat step 3 to add additional data log values to the WebGPI-Log window.
6. As needed, save the data that you have logged and the formatting that you have
applied to this data in a Chart FX file type.
A. In the WebGPI-Log window’s File menu, click the Save Chart command to open
the Save As window.
B. In the Save As window, name the file and then save it as a Chart FX file type.
XML data log files define the data that you want to log in the WebGPI-Log application.
A. In the WebGPI-Log window, open the Create New Chart Collection window.
C. Browse to the folder that contains the xml data files that you created in step 1.
4. Click the Add Chart button in the WebGPI-Log window to open the Edit Chart
Collection List window.
5. Add xml data log files to the list in the Edit Chart Collection List window.
A. Click the Add Chart button in the Edit Chart Collection List window to open the
Add Chart to Collection window.
B. Select an xml data log file in the Add Chart to Collection window.
C. Click the Open button in the Add Chart to Collection window to add the
selected file to the Edit Chart Collection List window’s List.
As needed, add additional files to the Edit Chart Collection List window.
D. Click the Close button in the Edit Chart Collection List window to close this
window.
Closing the Edit Chart Collect Window prepares the WebGPI-Log window to log all the
values that are contained in the chart collection.
6. Click the Save button in the WebGPI-Log window to open the Save Chart Collection
window.
Click the Save button in the Save Chart Collection window to save the chart
collection as a *.gpi file.
T GPI files reference xml data log files. GPI files should be saved into the same folder as the
xml data log files that they reference.
PC Requirements
See the WebGPI Communication Software Data Sheet for PC operating requirements. You
can find this data sheet at the Sauer-Danfoss Website (http://www.sauer-
danfoss.com/stellent/groups/publications/documents/product_literature/11076524.pdf#
page=1).
Cabling Requirements
The table below lists the cables needed to communicate through a COM port on your PC
with a Sauer-Danfoss microcontroller.
Cabling Requirements
Sauer-Danfoss Microcontroller Sauer-Danfoss Cable Part Number
MC200 PN 1090740
MC400 PN 1090740
* Recommended cable.
† This cable has a Prog/Read switch. Leave this switch set to Read.
B H
Baud settings, 11
How to
change a parameter value, 50
C connect to a microcontroller, 48
create a chart collection in the WebGPI-Log
Cables, required, 121
application, 117
Chart
create a file with microcontroller data, 108
menu bar, Data Logging pane, described, 32
create an xml data log file, 57
Menu Bar, Offline window, described, 24
download files
menu toolbar, Data Logging pane, described, 34
167 processors, 94
menu, WebGPI-Log, about, 43
download files
toolbar, WebGPI-Log, about, 45
167 processors, 86, 88, 91
Configuration pane, described, 22
196 processors, 72, 75, 78, 82
Create a chart collection in the WebGPI-Log application,
HC08/HC08A processors, 59, 61, 64, 68
how to, 117
download files
HC12 processors, 98
D download files
HC126 processors, 102
Data Logging download files
in WebGPI, about, 56 HC12 processors, 105
pane inWebGPI-Log application, described, 42 download files
pane, Chart menu bar, described, 32 TI processors, 110
pane, Chart toolbar, described, 34 log and save data in the WebGPI-Log application,
pane, toolbar, described, 31 114
pane, WebGPI, described, 30 log run-time data, 53
Debug Mode pane, described, 29 restore defaults, 52
Defaults, how to restore, 52 start communication with a microcontroller, 49
E I
Edit Chart Collection List window, described, 41 Information window, described, 28
Installation, PC requirements, 121
F
File
L
Creation window, described, 17 Log and save data in the WebGPI-Log application, how
names, about, 21 to, 114
Files Log run time data, how to, 53
download to 167 processors, how to, 86, 88, 91, 94
download to 196 processors, how to, 72, 75, 78, 82
download to HC08/HC08A processors, how to, 59, M
61, 64, 68 Manual, about, 6
download to HC12 processors, how to, 98, 102, 105 Menu bar
download to TI processors, how to, 110 WebGPI window, 9
how to create microcontroller data files, 108 WebGPI-Log window, 39
K28601 · Rev FB · November 2012 123
WebGPI
User Manual
Index
Microcontroller
connect, how to, 48 W
how to start communication with, 49 WebGPI
about, 6
O PC installation requirements, 121
window
Offline window described, 8
Chart Menu Bar, described, 24 Toolbar, described, 11
Chart Toolbar, described, 26 views, changing, 13
described, 23 WebGPI-Log window, described, 38
Windows and panes
P Configuration, 22
Data Logging, described, 30
Parameter value, how to change, 50 Data Logging, WebGPI-Log application, 42
Debug Mode, described, 29
Downloader pane, described, 19
T Edit Chart Collection List, described, 41
Toolbar File Creation, described, 17
Data Logging pane, described, 31 Information, described, 28
Offline window, described, 26 Offline, described, 23
WebGPI window, described, 11 WebGPI, described, 8
WebGPI-Log, described, 38
V X
Views, changing, 13
XML data log file, how to create, 57