Advantech Watchdog Timer UNO-2170 User manual

Watchdog Timer
UNO-2170, UNO-2171,
UNO-205XE
User Manual

UNO Watchdog Timer User Manual ii
Copyright
The documentation and the software included with this product are copy-
righted 2006 by Advantech Co., Ltd. All rights are reserved. Advantech
Co., Ltd. reserves the right to make improvements in the products
described in this manual at any time without notice. No part of this man-
ual may be reproduced, copied, translated or transmitted in any form or
by any means without the prior written permission of Advantech Co., Ltd.
Information provided in this manual is intended to be accurate and reli-
able. However, Advantech Co., Ltd. assumes no responsibility for its use,
nor for any infringements of the rights of third parties, which may result
from its use.
Acknowledgements
Intel and Pentium are trademarks of Intel Corporation.
Microsoft Windows and MS-DOS are registered trademarks of
Microsoft Corp.
All other product names or trademarks are properties of their respective
owners.
P/N: 2003205330 Version: 1.2
Printed in Taiwan September 2006

iii
Declaration of Conformity
CE
This product has passed the CE test for environmental specifications
when shielded cables are used for external wiring. We recommend the use
of shielded cables. This kind of cable is available from Advantech. Please
contact your local supplier for ordering information.
FCC Class A
Note: This equipment has been tested and found to comply with the limits
for a Class A digital device, pursuant to part 15 of the FCC Rules. These
limits are designed to provide reasonable protection against harmful
interference when the equipment is operated in a commercial environ-
ment. This equipment generates, uses, and can radiate radio frequency
energy and, if not installed and used in accordance with the instruction
manual, may cause harmful interference to radio communications. Opera-
tion of this equipment in a residential area is likely to cause harmful inter-
ference in which case the user will be required to correct the interference
at his own expense.
Technical Support and Assistance
Step 1. Visit the Advantech web site at www.advantech.com/support
where you can find the latest information about the product.
Contact your distributor, sales representative, or Advantech's customer
service center for technical support if you need additional assistance.
Please have the following information ready before you call:
- Product name and serial number
- Description of your peripheral attachments
- Description of your software (OS, version, application software, etc.)
- A complete description of the problem
- The exact wording of any error messages

UNO Watchdog Timer User Manual iv

v Table of Contents
Contents
Chapter 1 Installation ....................................................... 2
Chapter 2 Configuration................................................... 8
2.1 User Interface .................................................................... 8
2.1.1 General Tag .................................................................... 9
2.1.2 Setting Tag ................................................................... 11
2.1.3 Event Log Database Operations .................................. 12
2.1.4 Abort Tag ..................................................................... 16
Chapter 3 Function API’s............................................... 18
3.1 Error Codes Returned by Functions ................................ 18
3.2 Data Structures ................................................................ 18
3.2.1 Watchdog Driver Interfaces ......................................... 19
Chapter 4 Example Call Flows....................................... 28
4.1 ElapsedTme..................................................................... 28
4.2 RebootMachine ............................................................... 29
4.3 Setlog............................................................................... 30
4.4 Setmode........................................................................... 31
4.5 TimerSpan ....................................................................... 32
4.6 WatchApplication............................................................ 33
4.7 WatchSystem................................................................... 35

UNO Watchdog Timer User Manual vi

2
CHAPTER
1
Installation
This chapter introduces how to install
UNO-2170, UNO-2171 and UNO-205XE
Watchdog timer driver under Windows
2K/XP platform.

UNO Watchdog Timer User Manual 2
Chapter 1 Installation
<Step1> Insert the UNO-2000 Driver and Utility CD in the CD-ROM, and
execute AdvWDT.exe from following path: “\\UNO-2170, UNO-2171 and
UNO-205XE\Driver\Watchdog Timer\Win2K.XP\”. Click the Next button
to install watchdog timer.

3 Chapter1
<Step2> Enter your name and company, and press Next.
<Step3> For UNO-2170, UNO-2171 and UNO-205XE, please select
“Advantech [W83627HF] WDT” and then press the Next button
for next step.

UNO Watchdog Timer User Manual 4
<Step4 > Select “Typical”, the watchdog timer driver will be installed with
the most common options. Recommended for most users.
<Step 5> Press Next to start the installation.

5 Chapter1
<Step 6> Press the Finish button to finish the watchdog timer installation.
If UNO-2170, UNO-2171 and UNO-205XE watchdog timer is
installed successfully, the relevant applications and samples will
be placed in following path: C:\\Program Files\ADVAN-
TECH\Watchdog\
<Step 7> Press OK to reboot the system.

UNO Watchdog Timer User Manual 6

2
CHAPTER
2
Configuration
This chapter introduces how to use and
configure the watchdog timer function.
You can execute the Watchdog Timer
Configuration in “Control Panel”.

UNO Watchdog Timer User Manual 8
Chapter 2 Configuration
.
2.1 User Interface
There are three tags in Advantech Watchdog Service Configuration, includ-
ing General, Setting and About.
General Tag: Display general information on the watchdog service
Setting Tag: Display setting information on the watchdog service
About Tag: Display the copyright information of the watchdog service

9 Chapter2
2.1.1 General Tag
There are five items mentioned in General tag,
Service Name: Display the name of the Advantech watchdog service in the
Service Control Manager(SCM) database
Watchdog Type: Display the type of the watchdog chipset type. If you are
using UNO-2170, UNO-2171 or UNO-205XE, it will display “Winbond
W83627HF
Running Status: display the watchdog current status: Enabled or Disabled
Elapsed Time: The elapsed time from when the watchdog is enabled. If the
watchdog is disabled, elapsed time will be 00 hour 00 minute 00 second.
Start Watchdog Serviced on Boot: If the this check box is selected and
the settings is applied by the “Apply” button on the main dialog then the
Advantech watchdog service will be started after the system boots, other-
wise the use should start the Advantech service manually.

UNO Watchdog Timer User Manual 10
If the Advantech watchdog service is running, then the caption of this but-
ton will be “Stop Service”, if the user left clicks the button then the Advan-
tech watchdog service will be stopped, if this operation succeeds then the
caption of this button will be changed to “Start Service”, otherwise the
caption will not change a piece of warring message will popup to notify
the user that the service can not be stopped now.

11 Chapter2
2.1.2 Setting Tag
The setting tag includes following items.
(1) “Timer Span” Combo Box: The user can select one timer span for
the watchdog and apply the change when the watchdog is disabled.
(2) “Watch Mode” Group: There are two watch modes: system watch
mode and application watch mode, if you are in Application mode, system
will warn you to “strobe” (reset) the watchdog timer, otherwise the system
will reboot in a specified time period.
Definitions:
System mode: watchdog timer is running in Windows background. If the
hardware is hung up, it will reboot system automatically.
Application mode: watchdog timer will be enabling when you call the
APIs within your application. Further information about the watchdog timer
APIs, please refer to Chapter 3.
(3) “Log Event”: If this check box is selected and press “Apply” button
to apply the setting. Then the “Enabled”, “Disable”, “Reboot” operation
of the watchdog will be logged into the system event base, otherwise the
three operation will be not be logged into the system event base.

UNO Watchdog Timer User Manual 12
(4) “Enable/Disable” Button: Enable or disable the watchdog. If the
watchdog is enabled user cannot change the watch mode and the timer
span, so these related controls become grayed. These controls resume to
theirs normal status when the watchdog become disabled
(6) “Strobe” Button: Strobe the watchdog. This button become avail-
able only when the watchdog runs in application-watch mode and the
watchdog is enabled.
(7) “Reboot” Button: Reboot the machine by no strobe the watchdog
hardware. This button is not available when the watchdog is disabled. If
the watchdog is enabled and the user left clicks this “Reboot” button then
all the three buttons: “Enable/Disable”, “Strobe” and “Reboot” becomes
grayed, no operations can cancel the rebooting machine operation but
stop the Advantech watchdog service
2.1.3 Event Log Database Operations
<Step1> Select “Time Span”, “System” and then click “Log Event”.

13 Chapter2
<Step2> Press “Apply”.
<Step3> Press “Enable”.

UNO Watchdog Timer User Manual 14
<Step4> Open Control Panel and then click “Administrative Tools”.
<Step5> Click “Event Viewer”.