Advertisement

Quick Links

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

Advertisement

Table of Contents
loading

Summary of Contents for Advantech Watchdog Timer UNO-2170

  • Page 1 Watchdog Timer UNO-2170, UNO-2171, UNO-205XE User Manual...
  • Page 2 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.
  • Page 3 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.
  • Page 4 UNO Watchdog Timer User Manual...
  • Page 5: Table Of Contents

    Contents Chapter 1 Installation ............2 Chapter 2 Configuration........... 8 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 Error Codes Returned by Functions ........
  • Page 6 UNO Watchdog Timer User Manual...
  • Page 7 Installation This chapter introduces how to install UNO-2170, UNO-2171 and UNO-205XE Watchdog timer driver under Windows 2K/XP platform.
  • Page 8: Chapter 1 Installation

    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. UNO Watchdog Timer User Manual...
  • Page 9 <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. Chapter 1...
  • Page 10 <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. UNO Watchdog Timer User Manual...
  • Page 11 <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. Chapter 1...
  • Page 12 UNO Watchdog Timer User Manual...
  • Page 13 Configuration This chapter introduces how to use and configure the watchdog timer function. Y ou can execute the Watchdog Timer Configuration in “Control Panel”.
  • Page 14: Chapter 2 Configuration

    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...
  • Page 15: General Tag

    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...
  • Page 16 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...
  • Page 17: Setting Tag

    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”...
  • Page 18: Event Log Database Operations

    “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”.
  • Page 19 <Step2> Press “Apply”. <Step3> Press “Enable”. Chapter 2...
  • Page 20 <Step4> Open Control Panel and then click “Administrative Tools”. <Step5> Click “Event Viewer”. UNO Watchdog Timer User Manual...
  • Page 21 <Step6> Click the item, “AdsWatchdog” you can view the event message. Chapter 2...
  • Page 22: Abort Tag

    2.1.4 Abort Tag This tag displays the copyright information of the watchdog timer service. UNO Watchdog Timer User Manual...
  • Page 23 Function API’s...
  • Page 24: Chapter 3 Function Api's

    Chapter 3 Function API’s 3.1 Error Codes Returned by Functions 3.2 Data Structures enum WatchMode {WATCH_MODE_SYSTEM = 0, WATCH_MODE_APPLICA TION = 1}; Description: (1) WATCH_MODE_SYSTEM: Watch the whole system, the feed dog thread is supplied in the SYS driver. (2) WATCH_MODE_APPLICATION: Watch the specified application, the user should supply the user thread to feed the dog #define ADS_WA TCHDOG_CHIPSET_UNKNOWN 0 #define ADS_WA TCHDOG_CHIPSET_SOM443...
  • Page 25: Watchdog Driver Interfaces

    enum WatchdogType WA TCHDOG_TYPE_UNKNOWN = ADS_WATCHDOG_CHIPSET_UNKNOWN, WA TCHDOG_TYPE_W83977AF = ADS_WATCHDOG_CHIPSET_W83977AF , WA TCHDOG_TYPE_W83627HF = ADS_WATCHDOG_CHIPSET_W83627HF , WA TCHDOG_TYPE_SOM443 = ADS_WATCHDOG_CHIPSET_SOM443 : Winbond SuperIO W83977AF WATCHDOG_TYPE_W83977AF watchdog Chip : Winbond SuperIO W83627HF WATCHDOG_TYPE_W83627HF watchdog Chip : The 443 standard watchdog Chip WATCHDOG_TYPE_SOM443 3.2.1 Watchdog Driver Interfaces LONG WDT_Init ( LONG * o_hHandle );...
  • Page 26 LONG WDT_DeInit ( LONG * io_hHandle ); Description: De-initialize the watchdog Input Parameters: (1) io_hHandle: Handle of the watchdog Return Values: (1) ADS_WATCHDOG_ERROR_SUCCESS: operation succeed (2) ADS_WATCHDOG_ERROR_DEINITFAILED: Can not de-ini- tialize the watchdog (3) ADS_WATCHDOG_ERROR_INV ALID_HANDLE: Invalid device handle LONG WDT_Enable ( LONG i_hHandle ); Description: Enable the watchdog Input Parameters (1) i_hHandle: Handle of the watchdog driver...
  • Page 27 LONG WDT_SetMode( LONG i_hHandle, WatchMode i_watchMode ); Description: Set the watch mode of the watchdog Input Parameters: (1) i_hHandle: Handle of the watchdog driver (2) i_watchMode: The mode of the watchdog Return Values: (1) ADS_WATCHDOG_ERROR_SUCCESS: operation succeed (2) ADS_WATCHDOG_ERROR_INV ALID_HANDLE: Invalid device handle (3) ADS_WATCHDOG_ERROR_WDT_RUNNING: The watchdog is running now and can not change mode...
  • Page 28 Return Values: (1) ADS_WATCHDOG_ERROR_SUCCESS: operation succeed (2) ADS_WATCHDOG_ERROR_INV ALID_HANDLE: Invalid device handle (3) ADS_WATCHDOG_ERROR_WDT_RUNNING: The watchdog is running now and can not set the timer span of the watchdog LONG WDT_GetTimerSpan ( LONG i_hHandle, DWORD * o_pIndex, DWORD * o_pValue ); Description: Get the timer span of the watchdog Input Parameters: (1) i_hHandle: Handle of the watchdog driver...
  • Page 29 LONG WDT_Strobe ( LONG i_hHandle ); Description: Strobe the watchdog Input Parameters: (1) i_hHandle: Handle of the watchdog drier Return Values: (1) ADS_WATCHDOG_ERROR_SUCCESS: operation succeed (2) ADS_WATCHDOG_ERROR_INV ALID_HANDLE: Invalid device handle LONG WDT_SetType ( LONG i_hHandle, WatchdogType i_watchdogType ); Description: Set the watchdog type Input Parameters: (1) i_hHandle: Handle of the watchdog driver (2) i_ watchdogType: The type of the watchdog...
  • Page 30 LONG WDT_IsEnabled (LONG i_hHandle, BOOL * o_bEnabled ); Description: Get the watchdog’s running status: Enabled or Disabled Input Parameters: (1) i_hHandle: Handle of the watchdog driver (2) o_bEnabled: The watchdog current running status, TRUE for enabled and FALSE for disabled Return Values: (1) ADS_WATCHDOG_ERROR_SUCCESS: operation succeed (2) ADS_WATCHDOG_ERROR_INV ALID_HANDLE: Invalid device...
  • Page 31 Return Values: (1) ADS_WATCHDOG_ERROR_SUCCESS: operation succeed (2) ADS_WATCHDOG_ERROR_INV ALID_HANDLE: Invalid device handle LONG WDT_GetStartupTime (LONG i_hHandle, LARGE_INTEGER * o_pSartupTime); Description: Get the watchdog enabled time Input Parameters: (1) i_hHandle: Handle of the watchdog driver (2) o_pSartupTime: The count of 100-nanosecond intervals that the watchdog is enabled.
  • Page 32 Return Values: (1) ADS_WATCHDOG_ERROR_SUCCESS: operation succeed (2) ADS_WATCHDOG_ERROR_INV ALID_HANDLE: Invalid device handle (3) ADS_WATCHDOG_ERROR_INV ALID_PARAMETER: Invalid timer span index LONG WDT_GetErrMsg ( LONG i_hHandle, LONG i_lErrCode, LPTSTR o_pErrMsg ); Description: Get the error description of the specified error code Input Parameters: (1) i_hHandle: Handle of the watchdog driver (2) i_lErrCode: The error code returned by a function call (3) o_pErrMsg: The pointer to a buffer to store the error message associ-...
  • Page 33 Example Call Flows...
  • Page 34: Chapter 4 Example Call Flows

    Chapter 4 Example Call Flows 4.1 ElapsedTme Path: C:\Program Files\ADV ANTECH\Watchdog\Example\Console\Elapsed- Time\Elapsedtime.cpp Purpose: Get the elapsed time of watchdog timer. UNO Watchdog Timer User Manual...
  • Page 35: Rebootmachine

    4.2 RebootMachine Path: C:\Program Files\ADV ANTECH\Watchdog\Example\Console\Rebootma- chine\Rebootmachine.cpp Purpose: Describe the process of reboot machine if enable watchdog timer. Chapter 4...
  • Page 36: Setlog

    4.3 Setlog Path: C:\Program Files\ADV ANTECH\Watchdog\Example\Console\Setlog\Set- log.cpp Purpose: Describe how to record the watchdog timer history in event log. UNO Watchdog Timer User Manual...
  • Page 37: Setmode

    4.4 Setmode Path: C:\Program Files\ADV ANTECH\Watchdog\Example\Console\Setmode\Set- mode.cpp Purpose: Describe how to switch the mode of watchdog timer, system mode or application mode. Chapter 4...
  • Page 38: Timerspan

    4.5 TimerSpan Path: C:\Program Files\ADV ANTECH\Watchdog\Example\Console\SetTimer- Span\Timerspan.cpp Purpose: Define how to set the time span of watchdog timer. UNO Watchdog Timer User Manual...
  • Page 39: Watchapplication

    4.6 WatchApplication Path: C:\Program Files\ADV ANTECH\Watchdog\Example\Console\WatchApplica- Purpose: Enable watchdog timer function under tion\EnableDisable.cpp Application Mode. Y ou can refer to the source code of “SetMode” to change mode to Application Mode. Chapter 4...
  • Page 40 UNO Watchdog Timer User Manual...
  • Page 41: Watchsystem

    4.7 WatchSystem Path: C:\Program Files\ADV ANTECH\Watchdog\Example\Console\WatchSystem\Enable- Purpose: Enable watchdog timer function under System Mode. Disable.cpp Y ou can refer to the source code of “SetMode” to change mode to System Mode. Chapter 4...
  • Page 42 UNO Watchdog Timer User Manual...

This manual is also suitable for:

Watchdog timer uno-2171Watchdog timer uno-205xe

Table of Contents