Home

Toshiba Computer Module C2/C3 Windows NT Version User`s Manual

1. Forbidden Do not disassemble or remodel the equipment module or a board Otherwise equipment safety may be lost and equipment malfunction or failure may potentially result Forbidden Do notinserta metal piece or drop a paper clip through a clearance in the equipment body A fire or other trouble may result 5 Safety Precautions During Transportation Storage and Scrapping CAUTION Mandatory Comply with ordinances or regulations of the local government in your area when discarding the product Forbidden When transporting or storing put the product in a conducting bag and pack it in a crated box Otherwise a failure may result CTi Automation Phone 800 894 0412 Fax 208 368 0415 Web www ctiautomation net Email info ctiautomation net 6F8C 0894 vV Limitation of Applications The eguipment has been designed and manufactured for use in an industrial environment However the eguipmentis notintended to be used for systems which can endanger human life Note 1 Consult Toshiba if you intend to use the equipment for a special application which involves human life and has great influence on the maintenance of the public function Note 2 This is why such application requires special care on the operation maintenance and control of the system Note 3 Note 1 The systems which can endanger human life are life maintenance systems
2. 44 3 2 6 RAS Message Receive Mail Slot Setting Command 46 3 2 7 Digital Signal Input Command 48 3 2 8 LED Indication Command 50 3 2 9 User RAS Memory Reading Command 51 3 2 10 User RAS Memory Writing Command 52 3 2 11 System RAS Memory Reading Command 53 3 2 12 WDT Setting Command 54 3 2 13 User WDT ResetCommand 55 3 2 14 User Shutdown Command 56 3 2 15 CPU Temperature Information Reading Command II a eh 57 3 2 16 CPU Peripheral Temperature Information Reading Command 58 3 2 17 Battery Information Reading Command 59 3 2 18 Switch Status Read 60 3 2 19 Hardware Revision Read 61 3 2 20 Main Unit LED Control 62 3 2 21 Main Unit LED Control 2 63 model 2000 3000 Computer Module C2 C CONTENTS 3 3 RAS Support Software Registering 64 3 3 1 Registry information of RAS drive 64 3 3 2 Registry information of RAS service 64 3 3 3 Registry information of RAS window 65 3 3 4 System WDT XRAS SystemWdt 65 3 3 5 Service Shutdown Diagnosis Time XRAS TimerService 65 3 3 6 User Shutdown Diagnosis Time XRAS TimerUSer 66 3 3 7 Shutdown Execution Diagnosi
3. 4 The IO information structure is externally looked up inside functions and a check is made whether or not errors have occurred with the modules 5 Return to 3 CTi Automation Phone 800 894 0412 Fax 208 368 0415 Web www ctiautomation net Email info ctiautomation net 1 8 model 2000 3000 Computer Module C2 C3 Windows NT Version 2 7 Batch Input Output 2 7 3 Service Registry Parameters that specify service scanning operations can be controlled by the registry HKEY_LOCAL_MACHINE S ystem C urrentC ontrolS et S ervices g3iosrv e Scan Operation Policy Specify whether data consistency warranty should be given the priority or the scan cycle time is given the priority before performing scanning Key Scan Policy Value 0 priority given to data consistency default or 1 priority given to cycle time e Scan Operation Cycle Specify a time to hibernate after finishing one scan A short hibernation time achieves carefully thought out I O but increases the CPU load thereby potentially affecting other processes and threads adversely Key ScanCycle Value An integer larger than 1 in millisecond default value 5 500msec 2 7 4 mutex Exclusive Control In case many processes or threads are requesting access the service or the function may not be able to secure mutex The time out times for them are fixed at G3WRITEWAIT and G3READWAIT If the service cannot secure Mutex files are not read or written durin
4. The time can be setin the range of 524ms set value1 to 2 minutes and 13 seconds set value255 in the units of 524ms If the set value is 0 WDT is prohibited WDT setting cannot be done after NMI occurrence or after shutdown starting If the bit 15 of the WDT setting information is 0 the RAS Support Software automatically reset the WDT by the timer interruption 500ms cycle but if the bit 15 is 1 no resetting is done by the RAS Support Software In such a case itis necessary for the user application program to periodically issue the user WDT reset command to reset the WDT 31 15 7 0 WDT time Resetting method 1 user resetting At the time of power on user WDT registered in the registry is operating In case a user WDT which was previously registered in the registry is time out WDT is disabled at the time power is on CTi Automation Phone 800 894 0412 Fax 208 368 0415 Web www ctiautomation net Email info ctiautomation net 54 model 2000 3000 Computer Module C2 C3 Windows NT Version 3 2 RAS Support Commands 3 2 13 User WDT Reset Command Syntax BOOL sts HANDLE hDevice sts XRasResetWDT hDevice Argument hDevice RAS driver open handle Returned value If the command is normally completed TRUE is returned When error occurs FALSE is returned Explanation Command to reset the WDT on the RAS board This command becomes effective whe
5. This is transmitted when the first NMI is detected after the system starts up NMI factor is set to IParam 31 5 4 3 2 1 O0 IParam Power Key Off Remote Initialize WDT occurrence After receiving this message the user must do internal shutdown processing and issue the user shutdown command XRasUserShutdown or the user power off command XR asUserP owerdown After NMI occurrence the messages of fan stop recovery temperature abnormality recovery DI change and mirroring disk abnormality are not transmitted CTi Automation Phone 800 894 0412 Fax 208 368 0415 Web www ctiautomation net Email info ctiautomation net 6F 8C 0894 45 Chapter 3 RAS Support Software 3 2 6 RAS Message Receive Mail Slot Setting Command Syntax BOOL sts flag HANDLE hDevice PHANDLE IpM ail sts XRasUserMailslot hDevice flag IpMail Argument hDevice RAS driver open handle flag Mail slot creating flag IpM ail Address to buffer in which created mail slot handle is stored Returned value If the command is normally completed TRUE is returned When error occurs FALSE is returned Explanation Like the RAS message receive window setting command this command is to make preparation for receiving messages from the RAS Support Software In the case of the RAS message receive window setting command the user application program to receive the messages must be a window progra
6. CTi Automation Phone 800 894 0412 Fax 208 368 0415 Web www ctiautomation net Email info ctiautomation net 6F8C0894 61 Chapter 3 RAS Support Software 3 2 20 Main Unit LED Control BOOL XRasSetLed HANDLE hDevice DWORD dwS tate This software controls lighting of the 4bit LEDs of the main unit Parameters hDevice The driver handle gotten by CreateFile dwS tate Specify the LED lighting status by the following format 3 e COL3 COL2 COL1 COLO LED3 LED2 LED1 LEDO LEDO Specify 1 LEDO lit 0 extinguished LED1 Specify 1 LED1 lit 0 extinguished LED2 Specify 1 LED2 lit 0 extinguished LED3 Specify 1 LED3 lit 0 extinguished COLO Specify 1 LEDO color red 0 green COL1 Specify 1 LED1 color red 0 green COL2 Specify 1 LED2 color red 0 green COL3 Specify 1 LED3 color red 0 green Caution LED 0 cannot be controlled while the RAS service is in operation CTi Automation Phone 800 894 0412 Fax 208 368 0415 Web www ctiautomation net Email info ctiautomation net 62 model 2000 3000 Computer Module C2 C3 Windows NT Version 3 2 RAS Support Commands 3 2 21 Main Unit LED Control 2 BOOL XRasSetLedE x HANDLE hDevice DWORD dwS tate DWORD dwMask This software controls lighting of the 4bit LEDs of the main unit individually Parameters hDevice The driver handle gotten by CreateFile dwS tate Specif
7. 2 5 Support Input Output Module model 3000 Support Module Table 2 3 Input Module Classification Model Specification points DC Input D1334 DC12 24V 32 points DI334H DC 12 24V high speed response type 32 points D1344 DC48V 32 points D1335 DC24V 64 points DI335H DC 24V high speed response type 64 points AC Input IN354 AC100V 32 points IN 364 AC200V 32 points Analog Input AD368 Voltage current input 8ch AD318 0 to 5V high speed type 8ch AD328 0 to 20mA high speed type 8ch AD338 10V high speed type 8ch Status Change CD332 DC12 24V 8 points Detection Pulse Input P1312 50kbps DC5 12V 2ch Table 2 4 Output Module Classification Model Specification points Transistor Output DO333 DC24V 16 points D0334 DC24V 32 points D0335 DC24V 64 points D0344 DC 48V 32 points Triac Output AC363 AC100 200V 16 points AC364 AC100 200V 32 points Contact Output R0364 AC250V DC 30V 32 points RO363S AC 250V DC 30V independent common 16 points Analog Output DA364 Voltage output Ach DA374 Current output Ach CTi Automation Phone 800 894 0412 Fax 208 368 0415 Web www ctiautomation net Email info ctiautomation net 6F 8C 0894 13 Chapter 2 1 0 Bus Support Software 2 6 API 2 6 1 Basic Processing Flow As a rule the I O bus support API is used in the following flow 1 Gets a file handle by CreateF ile WIN32 API 2 Ge
8. 3 2 RAS Support Commands 3 2 4 RAS Driver Error Information Reading Command Syntax BOOL sts HANDLE hDevice Pxrasp_GetDriverError IpE rror sts XRasGetDriverError hDevice IpError Argument hDevice RAS driver open handle IpError Address to the buffer in which the RAS driver error Returned value If the command is normally completed TRUE is returned When error occurs FALSE is returned Explanation Command to read the error information of the RAS driver The pointer to buffer in which the RAS driver error information is stored in the argument is the pointer to the structure shown below On the following pages the members are explained struct ULONG InzErrReg Registering error information ULONG InzErrAdr Converting error information ULONG InzErrRes Resource error information ULONG InzErrint Interruption error information ULONG InzErrNmi NMI error information BOOLEAN RasAlive RAS board error information ULONG RasService RAS service error information xrasp_GetDriverE rror typedef xrasp_GetDriverError Pxrasp_ GetDriverE rror CTi Automation Phone 800 894 0412 Fax 208 368 0415 Web www ctiautomation net Email info ctiautomation net 6F 8C 0894 41 Chapter 3 RAS Support Software e InzErrReg registering error information This indicates that the information registered in the registry was an abnormal value If the regi
9. By pressing the user memory correction button the window for writing the user RAS memory is displayed and the user RAS memory can be changed Batch write data Edit User RAS Memory EJ Write selection _ _ Batch Write 0414249444546 4 74 84 94 A B C D E F GOLIE OF F GOFF OSFFOOFFFFOOaf OOFFOOFFOO 0010 e ete ee ee Be Write by byte Write E eE aac Ty Ulue Index z Exit Present value Present Value Byte data Write button Address selection e Write select Button to select writing method of the user RAS memory Either batch writing or byte unit writing is selected e Batch data If writing is done in the user RAS memory by the batch writing method the data of all the user RAS memories can be written at once by entering the data in this area and pressing the write button e Address select When writing is done in the user RAS memory using the byte unit writing method the address of the target user RAS memory is entered in this item e Byte data When writing is done in the user RAS memory using the byte unit writing method the data to be written is entered in this item and the write button is pressed and then the data are actually written in the user RAS memory e Present value When writing is done in the user RAS memory using the byte unit writing method the value presently written in the user RAS memory Selected with the address select e Write butto
10. Email info ctiautomation net 10 model 2000 3000 Computer Module C2 C3 Windows NT Version 2 4 Precautions on Use of This Software 2 4 3 Comparison with S2 S3 The feature In case one scan processing time exceeds a preset time in fixed time scanning scanning will change to floating scan but will reset to fixed time scanning when the processing time returns in S2 S3 is not provided If this processing is needed it must be processed by an application program Modes corresponding to HALT HOLD and DEBUG in mode control processing provided by 2 S3 are not available Normally operated in a mode corresponding to RUN or RUN F The mode will change to the ERROR mode if a critical error occurs stopping the access feature Whether normal operations correspond to RUN or RUN F depends on coding of the application program User data is initialized by data setting by an application program A feature to latch user data in a power failure is not provided 2 4 4 Purchasing and Development Environment This software is authorized to be installed in one each application development machine and target machine only The user is requested to kindly purchase this software for each of target machines in case more than one target machine are used A C C development environment for Windows NT such as Visual C of Microsoft needs be purchased in developing application programs CTi Automation Phone 800 894 0412 Fax 208 368 0415 W
11. function lobusS endData and lobusR ecvData Input and output data is the data that is produced when the input and output registers of the I O modules are in a continual state e Operation on Input Side 1 The I O service accesses each input module through the I O driver and collects input data 2 Data collected from each input register is stored in an input file as byte streams 3 The applications issue Function lobusR ecvData 4 Exclusive processing mutex secure is performed inside the function to access an input file CTi Automation Phone 800 894 0412 Fax 208 368 0415 Web www ctiautomation net Email info ctiautomation net 17 6F 8C 0894 Chapter 2 1 0 Bus Support Software 5 Securing mutex data will be transferred from an input file to the user buffer 6 Simultaneous with transfer input module information is obtained 7 The applications return from the function e Operation on Output Side 1 The applications issue Function lobusR ecvData 2 Exclusive processing mutex secure is performed inside the function to access an output file 3 Securing mutex data will be transferred from the user buffer to an output file 4 The applications return from the function 5 The service reads data from the output file a a ee oa 6 Read data is written in the output module through the driver The service on the input side periodically stores input module data in the input file regardless of appl
12. Execution place Failed in WaitF orMultipleO bjectE x S etF ileP ointer s failed s File name Failed to set the file pointer of File s at top ReadFile s failed s File name Failed to read File s CreateE vent s failed s Event name Failed to generate Event s GetFileTime s failed s File name Failed to get File s update time e The device driver Source will be stored in g3iodrv and in System of the event log CTi Automation Phone 800 894 0412 Fax 208 368 0415 Web www ctiautomation net Email info ctiautomation net 6F 8C 0894 21 Chapter 2 1 0 Bus Support Software Table 2 8 Event Log Messages 0f G3 1 0 Device Driver Category Message Meaning Information Module has been suspended The module has been suspended lobusModS uspend executed Warning Module has been resumed RESET command executed Operation of the module has been resumed lobusModResume executed G3 I O bus resetting has been requested lobusDoRest executed Error Can t setup I O space Failed to initialize I O space Can t read registry Failed to get the Registry Can t setup memory space Failed to initialize memory space Can t setup symbolic link Failed to create symbolic link can t assign resources Failed to secure resources Can t control modules Invalid Slot Slot mounting position is illegal a
13. RAS library file install path InstP athLibrary REG_SZ No default 3 3 4 System WDT XRAS SystemWdt This specifies the time of system WDT of the RAS Support Software After NMI occurrence the RAS Support Software sets WDT to be reset with the RAS service software regardless of the present WDT state This WDT is called system WDT Should the system WDT be set the hardware will be reset and so due care must be taken The following shows the setting range The values are to be set in the units of 524ms 2 1048ms to 255 abt 2 minutes Default value is 60 abt 30 seconds 3 3 5 Service Shutdown Diagnosis Time XRAS TimerService This specifies the diagnosis time of service in shutdown After NMI is detected the RAS driver informs the RAS service of the NMI occurrence And the RAS service informs the RAS driver of the receiving This period is called service shutdown diagnosis time If the RAS service does not respond within this diagnosis time it is judged that the RAS service is unable to operate and the hardware will be reset and so due care must be taken when setting The following shows the setting range The values are to be set in the units of 500ms 2 1 second to 1200 10 minutes Default value is 60 30 seconds CTi Automation Phone 800 894 0412 Fax 208 368 0415 Web www ctiautomation net Email info ctiautomation net 6F8C0894 65 Chapter 3 RAS Support Software 3 3 6 User Shutdown
14. User WDT abnormality 8 User WDT disabled Messageld 2004 at start Factor Address converting error when RAS driver initializing is done Message lt lt lnitializing error information when Toshiba RAS driver starts gt gt I O address converting error occurred 1 2 3 4 5 Data nil 1 x0140 0x016f address converting error 2 0x0061 address converting error 3 0x0070 0x0071 address converting error 4 0x0178 0x017B or 0x0388 0x38B address converting error 5 gt 0xC140 0xC141 address converting error CTi Automation Phone 800 894 0412 Fax 208 368 0415 Web www ctiautomation net Email info ctiautomation net 96 model 2000 3000 Computer Module C2 C3 Windows NT Version 3 6 Event Log Information Messageld 2005 at start Factor Resource obtaining error when RAS driver initializing is done Message lt lt nitializing error information when Toshiba RAS driver is started gt gt Hardware resource obtaining error occurred 1 2 Data nil 1 Hardware resource obtaining error 2 Shutdown routine registering error Messageld 2006 at start Factor Interruption registering error when RAS driver initializing is done Message lt lt nitializing error information when Toshiba RAS driver is started gt gt Interruption handler registering error occurred 1 Data nil 1 gt Interruption registering error Messageld 2007 at start Factor NMI registering error when RA
15. in event comes back within specified time log during module access Module Error Diagnosis Module error status is Records error in module Option Can be set reset periodically checked management table This by AP 1 information can be fetched by API 2 8 2 Event Log This software records the following trouble information and alarm messages in the event log of Windows NT The event log can be checked using the event viewer e The service Source will be stored in g3iosrv and in Application of the event log Table 2 7 Event Log Messages of G3 1 0 Service Category Message Meaning Information detect unreaded message Detected that previous interrupt chan d unit d mod d information is not fetched in a function when an interrupt was generated from channel d unit d or module d gt Means that interrupt omission has occurred No s module founded An input module or output module does Yos Input or Output not exist Warning Can t set service version to driver Service driver cannot be registered in the driver gt It does not affect operation No Mailslot created An interrupt was generated from channel chan d unit d mod d d unit d or module d but Mailslot to notify to function is not created Invalid s value d Illegal value d was specified by Use default Registry Key s Use an implicit value CTi Automation Phone 800 894 0412 Fax
16. info ctiautomation net Important Information No patent liability is assumed by TOSHIBA Corporation with respect to use of information illustrations circuits equipment or examples of application in this publication TOSHIBA Corporation reserves the right to make changes and improvements to this publication and or related products at any time without notice No obligation shall be incurred other than as noted in this publication This publication is copyrighted and contains proprietary material No part of this book may be reproduced stored in a retrieval system or transmitted in any form or by any means electrical mechanical photocopying recording or otherwise without obtaining prior written permission from TOSHIBA Corporation PROSEC TOSLINE and TOSDIC are trademarks or registered trademarks of TOSHIBA Corporation IBM is a registered trademark of International Business Machines Corporation Microsoft MS DOS Windows and Windows NT are registered trademarks of Microsoft Corporation in the U S A and other countries Ethernet is a registered trademark of Xerox Corporation DeviceNet is a trademark of the Open DeviceNet Vender Association Inc TOSHIBA CORPORATION 2001 All rights reserved CTi Automation Phone 800 894 0412 Fax 208 368 0415 Web www ctiautomation net Email info ctiautomation net Safety Precautions This manual contains important information for the operator to operate this product s
17. o displayed Forced shutdown diagnosis time Setvalue of forced shutdown diagnosis time and actual time are displayed 3 5 7 DIO Window The DIO Window processes LED 0 display settings on the GUI level The other features are for extension and have no meanings DI DO Port No 0 Current OFF DOfDigital Output Setting A os os m OFF Dutput DI Digital Input Status AS os Yos Yos Yos Refresh Port No 6 m 2 3 DI Interrupt Setting ee se Disable Port No Current Ve m Disable Yo 2 Disable eee WA 3 Disable LED Color feu e a ot s HES 6F 8C 0894 CTi Automation Phone 800 894 0412 Fax 208 368 0415 Web www ctiautomation net Email info ctiautomation net 79 Chapter 3 RAS Support Software 3 5 8 LED Indication Color Setting Item to change the indication color of the power LED 0 on the front panel of equipment Selection LED Color Setting D LED set Selection information Setting e Select button By pressing the select button selecting the indication color of the LED 0 and pressing the set button the color of the LED is actually displayed e Selected information The indication color green red of the power LED selected by pressing the select button gt amp D Green gt Red e Set button By pressing the set bu
18. was obtained at the time of error occurrence Nil if not obtained Messageld 2503 at start Factor It is judged that RAS board did not normally operated in the last shutdown information survey routine Message lt lt Last shutdown information gt gt could not be logged for the following reason Itwas confirmed that Toshiba RAS board did not normally operated in the last system Data The last RAS memory content 112 bytes if RAS memory information was obtained at time of error occurrence Nil if not obtained Remarks The last shutdown information is logged only when Toshiba RAS service is started for the first time after the system is started Therefore no logging is done when the Toshiba RAS service is restarted CTi Automation Phone 800 894 0412 Fax 208 368 0415 Web www ctiautomation net Email info ctiautomation net 6F 8C 0894 101 Chapter 3 RAS Support Software Messageld 2600 at start during operation Factor Occurrence of error to disable the service to continue in service processing Message The service is forcefully completed Data nil Messageld 3000 Factor When Toshiba RAS service was stopped during system operation Message Toshiba RAS service was stopped during system operation Data nil Messageld 3001 Factor With a model supporting battery mechanism battery voltage shortage was detected at the time of service startup Message Battery volt
19. AAA 0010 00 66 66 66 66 66 66 OG OG OG 18 01 3c GO OS 88 icon 626 3c 66 68 61 58 62 64 OG FF FF OG OG OG OG 88 88 lt h X 0030 00 1e 66 66 66 66 66 OA OA OG 66 OG OG 88 88 88 0040 23 61 28 22 51 43 43 42 54 42 22 42 30 58 61 26 QCCBTB BOP 6056 62 61 44 61 28 37 21 42 30 47 02 01 26 36 82 81 D 7 tBGG 8 0060 20 62 61 42 66 66 66 OG OG 66 66 46 6076 5a 14 14 66 67 b2 e9 33 66 66 66 88 0080 00 66 66 66 66 66 66 83 32 66 16 46 6096 3c 66 68 61 58 62 64 OG FF FF OG 68 66a6 66 1e 66 66 66 66 66 OG OG 66 88 46 66b6 14 61 26 22 51 43 43 42 54 42 22 42 66c6 53 51 62 62 64 66 OG OG OG 66 66 46 66d6 66 66 66 66 66 66 66 OG 66 OG 66 46 CTi Automation Phone 800 894 0412 Fax 208 368 0415 Web www ctiautomation net Email info ctiautomation net 82 model 2000 3000 Computer Module C2 C3 Windows NT Version 3 5 RAS Windows e User RAS memory User RAS memory is displayed They correspond to OE Oh OFFh of the system RAS memory User RAS Memory 0 1 2 3 4 5 6 7 8 9 A B C D E F 0123456789abcdef 60660 cO FF OO FF O8 FF OG FF FF OO af 88 FF OG FF OO 6616 fe 66 FF OA FF 66 FF OG OA FF 88 FF OB FF GO FF e Refresh button By pressing the refresh button the display is updated to the display of the newest RAS memory information e Extension memory button With a system supporting the extension RAS memory the e
20. Fax 208 368 0415 Web www ctiautomation net Email info ctiautomation net 6F8C0894 51 Chapter 3 RAS Support Software 3 2 10 User RAS Memory Writing Command Syntax BOOL sts HANDLE hDevice DWORD dwAdr DWORD dwS ize LPUCHAR lpBuffer sts XRasWriteMemory hDevice dwAdr dwSize lpBuffer Argument hDevice RAS driver open handle dwAdr Leading address of system RAS memory dwSize Number of bytes to be written lpBuffer Address of buffer in which data written are stored Returned value If the command is normally completed TRUE is returned When error occurs FALSE is returned Explanation Command to read the data of the user RAS memory portion Since this system RAS memory is used by the RAS Support Software no writing can be done The leading address of the argument is in the range of 0 to Oxff and the number of bytes to be read must be specified within the range of 1 to 0x100 The addresses 0xe0 to Oxff correspond to 0x00 to 0x1f of user RAS memory and same contents can be read The leading address number of bytes to be read must not exceed 0x100 CTi Automation Phone 800 894 0412 Fax 208 368 0415 Web www ctiautomation net Email info ctiautomation net 52 model 2000 3000 Computer Module C2 C3 Windows NT Version 3 2 RAS Support Commands 3 2 11 System RAS Memory Reading Command Syntax BOOL sts HANDLE hDevice DWORD dwAdr DWORD d
21. ROM is assigned to Drive E specify E driver path name Floppy Disks Attached The floppy disks supplied with the equipment store modules of various features described in this manual Revision Upgrading When the version of the preinstalled Windows NT is upgraded the latest version of Windows NT has to be purchased separately The customer needs to purchase and install the Service Pack separately for revision upgrading The latest Service Pack can be purchased at cost through a Web site or from Microsoft CTi Automation Phone 800 894 0412 Fax 208 368 0415 Web www ctiautomation net Email info ctiautomation net 4 model 2000 3000 Computer Module C2 C3 Windows NT Version Chapter 2 I O Bus Support Software This chapter describes the I O bus support software This software supports data from the C2 C3 input to and output from the various I O modules connected to the I O bus This software enables direct access of the I O modules from Windows NT thereby easily accomplishing system construction with only the C2 C3 The following advantages can be derived by using this software Easy creation of an I O control application system merging screen control and network features This means that linkage with SCADA supervisory control and data acquisition software can be accomplished easily An enhanced development environment of Windows NT can be used when creating an I O access program Processing of a high parallel
22. Slot A ha tik er 3 1 3 Otherinformation 4 I O Bus Support Software 5 2 1 Software Installation 6 2 2 Hardware Configuration 7 2 3 Software Configuration 8 DIA PU ai Con mena N ASE Gaba E a naa ERAR E 8 23 2 SENICE WA AA 8 DI VOOM IA UA AA 8 2 3 4 G3 VO AI aa 9 2 4 Precautions on Use of This Software 10 2 4 1 Specification Limitations and Cautions 10 2 4 2 Programming Precautions 10 2 4 3 Comparison with S2 S3 11 2 4 4 Purchasing and Development Environment 11 2 5 Support Input Output Module 12 DOARP AA WBA E Wa a A E E E AE aai 14 2 6 1 Basic Processing Flow 14 2 6 2 WA UE WA ANA 16 2 7 Batchinput Output 17 2 7 1 Operating Principles 17 2 7 2 Application Creation 18 2 1 3 Service AA VA beh Ah Rnd ORs 19 2 7 4 mutex Exclusive Control 19 2 6 RAS Feature 5 cxts cel Beet aes eis wares 2G 20 2 8 1 Self Diagnosis 20 2 8 2 Event LOG AA IIIA AWA aa 20 29 API References enr oe ie AA Aa 23 2 9 1 CreateF ile afte te sae da Bea Gort e a Ka a EE EAN 23 2 9 2 CloseHa dle IWE eee aes 23 2 9 3 lobusGetMappedinfo 24 2 9 4 lobusSetDiag 24 2 9 5 lobusRes
23. and subsequent I O bus accesses will be disabled A diagnosis time can be set between 4us minimum and 60us maximum in increments of 4us Default is set at 32us The following settings can be executed by directly changing registry values using the registry editor e Execute non execute on startup of module diagnosis Whether or not to diagnose faults of the I O modules executed by the device driver should be executed beginning system startup can be specified Key DiagS tart Value 0 Non execute on start default or 1 Execute on start If execution is not started on start diagnosis can be started using the function lobusS etDiag e Module diagnosis time interval A time interval to execute the foregoing module diagnosis is specified Key DiagInterval Value An integer larger than 0 in seconds default value 5 e Number of retry sessions during module error detection The number of retries executed when an error occurs in module accessing is specified The driver tries accessing for the specified number If errors still continue the status of the module is set to error and this module will be excluded in subsequent accessing By increasing this value the resistance to temporary module errors increases However the input output speed will lower Key RetryCount Value An integer larger than 0 in cycles default value 5 2 3 4 G31 0 Driver A G3 I O access driver that functions as an I O driver of Windows NT The d
24. bob ete EIA ees de 72 3 5 1 MainWindow 73 3 5 2 Status WIindOW 75 BIS IM ra a o aa ER ee oe es 77 xi CONTENTS 3 5 4 Application 77 3 5 5 Sensor Detection 78 3 5 6 Operation Environment 79 3 5 7 DIO Window 79 3 5 8 LED Indication Color Setting 80 3 5 9 WDT WINO Wa wis Ia aa Wa Eea 81 3 5 10 Alarm Window 81 3 5 11 RAS Memory Window 82 3 5 12 Event Log Window 85 3 5 13 Refresh button 85 3 5 14 Event log information 86 3 5 15 Registry Window 87 3 5 16 Driver Related Button 87 3 5 17 Window Related Button 89 3 5 18 Mini WiINdoOW 90 3 5 19 Window buttons 91 3 6EventLoginformation 92 3 6 1 Logging Information When RAS Service Starts 92 3 6 2 Logging Information during Operation of RAS SEVICE AA eee od yeaa ase 92 3 6 3 Logging Information at End of RAS Service 93 3 64EventLogList 93 3 6 5 EventLogDetail 94 xii model 2000 3000 Computer Module C2 C Chapter 1 Windows NT This chapter describes cautions and othe
25. ctiautomation net 6F8C0894 3 Chapter 1 Windows NT 1 3 Other Information Driver Storage Positions The device drivers and other applications are stored under the following directories during preinstallation This directory configuration is the same as thatin the backup CD ROM i386 A device driver supported by Windows NT as a standard provision DRVLIB A device driver by driver distribution service of CompuServe of the United States manufactured by a third party DRVLIBJ A device driver manufactured by a third party in apan Japanese version only SUPPORT USPRNDRV A printer driver supplied with Windows NT of the US version as a standard provision TOSHIBA A network driver graphic driver for Ethernet port of the main unit SP6a Service Pack 6a contains QFE A path for the driver storage directory needs be specified when installing a driver or other application If the CD ROM cannot be used when E i386 or other data is displayed execute by specifying C i386 in the field for path name specification These directories store drivers needed in driver installation during a system configuration change or in other instances These drivers can be deleted without affecting Windows NT operation if system configuration changes are not required These directories will not be created when the customer reinstalls Windows NT Specify driver paths for directories needed for driver installation to read from the CD ROM Ifthe CD
26. e User diagnosis time User shutdown diagnosis time is set e Execution diagnosis time Shutdown execution diagnosis time is set e Service priority RAS service thread execution priority is set e Message ID RAS message ID window message is set e Mail slot name RAS mail slot name is set e Mail slot diagnosis time RAS mail slot receiving diagnosis time is set For infinite waiting FOREVER is set e Forced diagnosis time Forced shutdown diagnosis time is set e Default button All the registry set information is set to the default value e Set button By pressing the set button the registry information is actually registered CTi Automation Phone 800 894 0412 Fax 208 368 0415 Web www ctiautomation net Email info ctiautomation net 88 model 2000 3000 Computer Module C2 C3 Windows NT Version 3 5 RAS Windows 3 5 17 Window Related Button When you push window buttons the window appears in which you can set the registry information of the RAS window Toshiba RAS Window Environment Setting Startup Style Specify the environment for operating Toshiba RAS Window Bes Default to display default se tijigs SE A p Contimue to do next operation RAS Window Object Name Main Window Pos x eh 5 m Main Window Pos y Startup Style Norma1 da RAS Window Object Nane XRASWINDOW o Normal Window Pos x 9 II Normal Window Pos y n m E l Mini Window Display Level TopHost Bg mow Di
27. normal 0 1 fan sensor abnormal 1 normal 0 2 fan sensor abnormal 1 normal 0 3 fan sensor abnormal 1 normal 0 Messageld 2102 during operation Factor Detection of internal temperature abnormality Message Equipment internal temperature abnormality was detected Data Abnormal sensor detail information 1 byte in case of a RAS board having sensor abnormality detail information 0 temperature sensor abnormal 1 normal 0 1 temperature sensor abnormal 1 normal 0 2 temperature sensor abnormal 1 normal 0 3 temperature sensor abnormal 1 normal 0 Messageld 2104 during operation Factor Unknown MI detected Message Wrong MI was detected Data nil Messageld 2105 during operation Factor Overflow of message buffer of RAS driver Message Service informing message buffer of Toshiba RAS driver overflowed Data nil CTi Automation Phone 800 894 0412 Fax 208 368 0415 Web www ctiautomation net Email info ctiautomation net 98 model 2000 3000 Computer Module C2 C3 Windows NT Version 3 6 Event Log Information Messageld 2110 in operation Factor A single bit error of the system memory Message A single bit error occurred in the system memory Bank 1 Data None 1 Indicates the bank number of the system memory where the single bit error occurred For more information on bank numbers refer to the section for multi bit errors in the notification of previous shutdown i
28. occurrence the messages of fan stop recovery temperature abnormality recovery DI change and mirroring disk abnormality are not transmitted CTi Automation Phone 800 894 0412 Fax 208 368 0415 Web www ctiautomation net Email info ctiautomation net 6F 8C0894 47 Chapter 3 RAS Support Software 3 2 7 Digital Signal Input Command Syntax BOOL sts HANDLE hDevice LPDWORD IpDI sts XRasDI hDevice IpDI Argument hDevice RAS driver open handle IpDI Address to the buffer in which the DI information is stored Returned value Ifthe command is normally completed TRUE is retumed When error occurs FALSE is returned Explanation Command to read the state of the digital input signal of the RAS board The following figure shows the contents of the DI information stored in the buffer DW 26 DW MH 2h MF 222 pi p J g J J DIPO stata DI 1 sota DIY 2 mota DIP Iaa Fon imormdian 1 tan sap Temperature imormetion 1 temperct ure obnomalty Of on sensor int ormetion l fon sensor im ormetion 2 on sensor int cemetion 3ton sensor im ormetion 0 femperct ures ers of intornetion F 1 tempers ures es of ingjarmeation 2ten Pert ures am ce intommetion Jtemperct ures ers of intormetion POf sensor ecive 1 fon sensor of active 2ton sensor o ective 33 sensor edie Otemperct ures em or Bed tempercturesemcr etective 2temperc
29. system error or voltage decrease the information is left in the RAS memory and the hardware is reset 2 The RAS driver informs the RAS service of the NMI message It starts to monitor the service shutdown diagnosis time TimerS ervice 3 The RAS service informs the RAS driver that the NMI message was received Then the RAS driver clears the service shutdown diagnosis time and starts to monitor the user shutdown diagnosis time TimerUser if there is the RAS message receiving user or the shutdown execution diagnosis time TimerS hutdown if there is no user Also the RAS service moves to the processing of 7 if there is no RAS message receiving user 4 The RAS service informs the RAS message receiving user of the NMI occurrence message 5 The RAS message receiving user performs post processing in the program and issues the user shutdown command XRasUserS hutdown or the user power off command XRasUserP owerdown 6 When the user shutdown command is issued or the user shutdown diagnosis time time out occurs the RAS driver informs the RAS service of the shutdown execution message Also it starts to monitor the shutdown execution monitor time TimerS hutdown 7 The RAS service executes the shutdown in the method to inform the application of the shutdown Also it starts to monitor the forced shutdown diagnosis time TimerF orceS hutdown 8 After the time out of the forced shutdown diagnosis time the shutdown is forceful
30. to operate and the hardware is reset and so due care must be taken when setting To make this diagnosis time invalid set OxFFFFFFFF This is effective when it is desired to stop the system in the shutdown state desired not to reboot the system It can be utilize when the UPS function is used The following shows the setting range The values are to be setin the units of 500ms 2 1 second to 1200 10 minutes Default value is 600 5 minutes 3 3 8 RAS Service Thread Priority XRASService ServicePriority This specifies the execution priority of the RAS service thread The values which can be set are shown below Set value Priority TimeCritical 31 High 26 Normal default value 24 Low 13 CTi Automation Phone 800 894 0412 Fax 208 368 0415 Web www ctiautomation net Email info ctiautomation net 66 model 2000 3000 Computer Module C2 C3 Windows NT Version 3 3 RAS Support Software Registering 3 3 9 RAS Message ID XRASService MessagelD This specifies the RAS message value to be sentto the user application program by the RAS Support Software This value is added to WM USER and informed to the window procedure of the user application program The following shows the setting range 0 to Ox7BFF Default value is 0x1000 WM_USER 0x1000 The above range is applied when WM_USER is 0x0400 and actually the total of WM_USER and set value is to be in the range of Ox7FFF or lower The program
31. will appear on the backside of the external terminal board potentially causing an electric shock Mandatory Place a conducting mat or a conducting bag bag containing a spare board or other part on a grounded table and puta board or the module removed from a unit or a base unit on the table Otherwise parts may be damaged by static Mandatory Discharge static electricity charged on human body by touching a grounded metal before touching the equipment or a board Otherwise static electricity may cause equipment malfunction or a failure electricity or other phenomenon Mandatory Clean equipment a module or board dirtiness using a softcloth Use a cloth moistened with water and wringed if dirtiness is stiff The equipment the module or a board left dirty may cause a wrong decision or malfunction Forbidden Do not use benzine thinner or other solvent when cleaning a module or a board Otherwise a panel module or board may deform or discolor CTi Automation Phone 800 894 0412 Fax 208 368 0415 Web www ctiautomation net Email info ctiautomation net 6F 8C 0894 3 Safety Precautions in Replacing Parts with Ended Life gt WARNING Mandatory Make certain to set the switch of any equipment to the OFF position before replacing a power fuse or an alarm fuse installed in the equipment Otherwise an electric shock or a fire may res
32. 1381 Service Pack 6 This is the version as of May 29 2000 The Service Pack version may vary depending on the release status of Microsoft Corporation The Service Pack is stored in the hard disk as C SP 6a QFE Quick Fix Engineering also is stored under SP6a Be sure to install QFE also after installing SP 6a Registered User Name administrator No password Guest No password User managementis executed by User Manager inside Control Tool Group after logging on by administrator when adding a new user or setting or changing a password Network No software setting When using the 10BASE T porton the C2 C3 main unit use the network driver supplied as an accessory instead of a Windows NT CD ROM driver Make certain to reinstall the Service Pack after setting the network Graphic Standard VGA Driver Using the graphic driver supplied as an accessory NeoMagic MagicGraph 128 Z ZV the C2 C3 accomplishes screen display with a resolution of 1024 x 768 and 65 536 color pallet colors The driver can be installed as follows Control Panel gt Screen Display Setting gt Display Type gt select Change in Adapter Type gt select NeoMagic in Manufacturer gt specify Disk Used A correction program to avoid specified faults and problems which are not contained in the Service Pack supplied by Microsoft CTi Automation Phone 800 894 0412 Fax 208 368 0415 Web www ctiautomation net Email info
33. 208 368 0415 Web www ctiautomation net Email info ctiautomation net 20 model 2000 3000 Computer Module C2 C3 Windows NT Version 2 8 RAS Feature Table 2 7 Event Log Messages of G3 I O Service Category Message Meaning Error Behind each message a character string for error cause will be stored For complete information see GetLast rror StartS erviceC triDis patcher failed Failed in service start SetS erviceS tatus failed Failed to set service status in Service Control Manager CreateFile s faild s Device name file name etc lobusG etMappedinfo failed Failed to open s Failed to get I O module mapping information CreateThread s failed s Thread name Failed to create a thread CreateMailslot failed chan d unit d mod d Failed to create Mailslot of chan d unit d and mod d DeviceloC ontrol s failed s IOCTL code Failed in DeviceloC ontrol WriteF ile s failed s Mailslot or file Failed in WriteF ile RegOpenKeyE x failed Failed to open the registry RegQueryValueE x s failed s Registry name Failed to get Registry key s malloc s failed s Execution place Failed in malloc dynamic area secure CreateMutex s failed s mutex name Failed to create Mutex CreateF ileMapping s failed s File name Failed in File Yos mapping WaitF orMultipleO bjectE x s failed s
34. 3 5 16 Driver Related Button By pressing the driver related button the window to set the registry information of the RAS device driver and RAS service is displayed Interrupt number Environment Setting Driver Service u Detection 1RQ Healthy Detection LED System WDT System WDT x524msec User WDT User WDT 8 x524msec Service Response Timeout User Shutdown Timeout User Shutdown Timeout 36 x5 66msec Shutdown Timeout Shutdown Timeout 6 x566msec RAS Service Priority Normal A Po Service Response Timeout 69 x5 06msec RAS Service Priority RAS Message 1D 6x1 605 RAS Message ID RAS Mailslot Name KRASMSG RAS Mailslot Name RAS Mailslot Read Timeout 69906 msec Force Shutdown Timeout 246 x5 98msec Default Apply Exit Default button Apply button RAS Mailslot Timeout Force Shutdown Timeout CTi Automation Phone 800 894 0412 Fax 208 368 0415 Web www ctiautomation net Email info ctiautomation net 6F8C0894 87 Chapter 3 RAS Support Software e Interruption No Interruption No to be used by the RAS board is set Numbers other than 5 cannot be set e Healthy signal Healthy signal outputted by the RAS Support Software is set e System WDT System WDT time is set e User WDT User WDT time at starting is set e Service diagnosis time Service shutdown diagnosis time is set
35. 368 0415 Web www ctiautomation net Email info ctiautomation net 6F 8C 0894 29 Chapter 2 I O Bus Support Software 2 9 12 lobusGetDiaginfo BOOL lobusGetDiaginfo HANDLE hDevice LPWORD IPWR esults Gets results of module diagnosis Parameters hDevice The driver handle gotten by CreateFile IPWR esults Arrangement area to store diagnostic results Results one word per unit are stored in the following sequence Basic UnitO CH1 Unitl CH1 Unit2 CH1 Unit7 CH2 Unitl CH3 Unitl CH4 Unit7 In each word Bit 1 shows information for Module 1 and information of Bit 0 to Module 0 is stored 15 1 0 Mod15 Modi Modo Modo to Mod15 0 normal 1 abnormal including not mounted yet CTi Automation Phone 800 894 0412 Fax 208 368 0415 Web www ctiautomation net Email info ctiautomation net 30 model 2000 3000 Computer Module C2 C3 Windows NT Version 2 9 API References 2 9 13 lobusDoBusReset BOOL lobusDoBusReset HANDLE hDevice Sends a reset signal to the G3 I O bus Parameters hDevice The driver handle gotten by CreateF ile 2 9 14 lobusModuleSuspend BOOL lobusModuleS uspend HANDLE hDevice CHAR cCh CHAR cUnit CHAR cMod Inhibits access of modules specified by cCh cUnit and cMod This feature is used when inhibiting access prior to exchange when changing an I O module in an online state This feature will have n
36. 8 bytes contain the CMOS information and the following part stores the PCI bus information configuration address and configuration data lt lt E rror Events gt gt Messageld 2000 at start during operation Factor RAS device opening failure Message Device opening failed Toshiba RAS driver is not normally installed Data nil Messageld 2001 at start during operation Factor Error return of I O processing request to the driver Message I O processing request 1 to Toshiba RAS driver failed Data IOCTL command 1 gt IOCTL command Messageld 2002 at start Messageld RAS board not installed Message Toshiba RAS board is not installed Data nil CTi Automation Phone 800 894 0412 Fax 208 368 0415 Web www ctiautomation net Email info ctiautomation net 6F8C0894 95 Chapter 3 RAS Support Software Messageld 2003 at start Factor Registry registering error when RAS driver initializing is done Message lt lt lnitializing error information when Toshiba RAS driver starts gt gt Information registered in the registry is abnormal Toshiba RAS driver starts using the default value 1 2 3 4 5 6 7 8 Data nil 1 Interruption No abnormality 2 Service shutdown diagnosis time abnormality 3 gt User shutdown diagnosis time abnormality 4 Shutdown execution diagnosis time abnormality 5 gt System WDT abnormality 6 Healthy detection means abnormality 7 gt
37. DLL Dynamic Link Library DLL to make interface between RAS device driver and user application program VC etc User application program RAS window VC etc Message RAS service y y User mode l Kernel mode Security Process i I O manager manager memory manager Device driver Reference monitor i Network driver RAS driver Kernel Hardware abstraction layer HAL Hardware RAS board Figure 3 1 Functions of RAS Software Processing CTi Automation Phone 800 894 0412 Fax 208 368 0415 Web www ctiautomation net Email info ctiautomation net 6F8C0894 35 Chapter 3 RAS Support Software 3 2 RAS Support Commands The following shows the list of RAS support commands which can be used by the user application programs VC etc The following pages describes the syntax argument returned value and explanation for each command Command name Outline CreateF ile Win32 Open command CloseHandle Win32 Close command XRasGetVersion RAS support software version reading command XRasGetDriveE rror RAS driver error information reading command XRasUserW indow RAS message receive window setting command XRasUserMailslot RAS message receive mail slot setting command XRasDI Digital signal input command XRasDO Digital signal output command XRasDilnt DI interruption setting command XRasP owerLed Power LED in
38. Diagnosis Time KRAS TimerUser This specifies the diagnosis time of the user in shutdown After NMI occurrence the RAS Support Software sends the NMI occurrence message to the user window set with the RAS message receiving window setting command XRasUserWindow The user window receiving the message must do its internal shutdown processing data saving etc issue the user shutdown command XRasUserS hutdown and instruct the RAS Support S oftware to shut down the WindowsNT After the message is sent the RAS Support Software monitors the time until the user shutdown command is issued This time is called user shutdown diagnosis time If the user shutdown command is not issued within this diagnosis time itis judged that the user window program is unable to operate and the RAS Support Software shutdown processing will proceed as if the user shutdown command was automatically issued The following shows the setting range The values are to be setin the units of 500ms 2 1 second to 1200 10 minutes Default value is 360 3 minutes 3 3 7 Shutdown Execution Diagnosis Time XRAS TimerShutdown This specifies the diagnosis time in the shutdown of WindowsNT The RAS Support S oftware monitors the time from the start of WindowsNT shutdown processing to the end of actual shutdown This is called shutdown execution diagnosis time If the shutdown is not completed within this diagnosis time it is judged that the WindowsNT is unable
39. Errint and InzErrNmi are normal If the RAS board is not inserted the operation of the RAS Support Software is restricted like the converting error e RasService RAS service error information This indicates if the RAS service is started If the RAS service is started a value other than 0 is set or if itis started 0 is set This information becomes valid when InzErrAdr InzErrRes InzErrint and InzErrNmi are normal and the RAS board is inserted If the RAS service is not started the operation of the RAS Support Software is restricted like the converting error Xrasp_GetDriveE rror structure Pxrasp_GetDriverE rror pointer type and described constant IE xxx_ Xxx are defined in xrasdll h CTi Automation Phone 800 894 0412 Fax 208 368 0415 Web www ctiautomation net Email info ctiautomation net 6F 8C 0894 43 Chapter 3 RAS Support Software 3 2 5 RAS Message Receive Window Setting Command Syntax BOOL sts HANDLE hDevice HWND hWnd sts XRasUserWindow hDevice hWnd Argument hDevice RAS driver open handle hWnd User window handle Returned value If the command is normally completed TRUE is returned When error occurs FALSE is returned Explanation Command for setting the user window to receive messages from the RAS Support Software The following shows messages to be transmitted by the RAS Support Software Since WM_USER RAS message ID r
40. F8C0894 99 Chapter 3 RAS Support Software Messageld 2205 at start during operation Factor Service status updating failure Message Toshiba RAS service status updating failed Data nil Messageld 2206 at start Factor Abnormality is recognized with KEYWORD of RAS memory Message Unconformity occurred with RAS memory Itis considered that Toshiba RAS board is abnormal 1 2 3 Data RAS memory content 112 bytes 1 gt The abnormal RAS memory address 2 Write data 3 Read data Messageld 2300 during operation Factor Opening failure of message informing mail slot Message Message informing mail slot opening failed RAS message is destroyed Data nil Messageld 2301 during operation Factor Failure of message writing in message informing mail slot Message To write RAS message in the message informing mail slot failed RAS message destroyed is 1 Data Destroyed RAS message 1 The RAS message is inserted Messageld 2302 during operation Factor Failure of informing message to RAS window or user RAS window Message To inform RAS message to 1 failed RAS message 2 was destroyed Data Window handle and destroyed RAS message 1 Character string of RAS window or user RAS window is inserted 2 The RAS message is inserted Messageld 2400 at end Factor Failure of shutdown execution Message Shutdown execution failed Data nil Messageld 2401 at end Factor Whe
41. L lobusS endData HANDLE hDevice WORD wLength WORD wOffset LPWORD lpwData Data is output in batch to the output register Parameters hDevice The driver handle gotten by CreateF ile wLength Output data length unit word wOffset Offset beginning from first data segment of the output register to access unit word IpwData Pointer to output data Data is written as continuation of output register data Return Values When normally ended a value other than 0 is returned for this function When abnormally ended return 0 and call GetLastE rror to know error details An ERROR_TIMEOUT generates if mutex cannot be secured during accessing CTi Automation Phone 800 894 0412 Fax 208 368 0415 Web www ctiautomation net Email info ctiautomation net 6F 8C0894 27 Chapter 2 1 0 Bus Support Software 2 9 10 lobusRecvDataDirect BOOL lobusR ecvDataD irect HANDLE hDevicew CHAR cChw CHAR cUnitw CHAR cModw CHAR cOffsetw WORD wLengthw LPWORD IpwData A wLength length is directly input to data pwData from an address specified by cCh cUnit cMod or cOffset A check is not made whether or nota module actually exists or an input device exists at the specified address This has to be confirmed by an application An area sufficient to store the data length specified by wLength must be provided in lpwData Data is inputin a unit of word Parameters hDevice The driver handle gotten by CreateFile cC
42. Mod Module No 0 to F CTi Automation Phone 800 894 0412 Fax 208 368 0415 Web www ctiautomation net Email info ctiautomation net 6F8C0894 25 Chapter 2 I O Bus Support Software 2 9 7 lobusRecvData BOOL lobusR ecvData HANDLE hDevice WORD wLength WORD wOffset LPWORD lpwData Data is input in batch from the input register The area specified by pwData must be an area sufficient to store input data Parameters hDevice The driver handle gotten by CreateFile wLength Input data length unit word wOffset Offset beginning from first data segment of the input register to access unit word IpwData Pointer to input data Data is handled as continuation of input register data Return Values When normally ended a value other than 0 is returned for this function When abnormally ended return 0 and call GetLastError to know error details AnERROR_TIMEOUT generates if mutex cannot be secured during accessing 2 9 8 Remark The module data when data is read by issuing this function can be checked by looking up Symbol ModuleS tatus ModuleStatus is in word arrangement as in arguments used in Function lobusGetDiagInfo See lobusGetDiagInfo for the complete information of the data CTi Automation Phone 800 894 0412 Fax 208 368 0415 Web www ctiautomation net Email info ctiautomation net 26 model 2000 3000 Computer Module C2 C3 Windows NT Version 2 9 API References 2 9 9 lobusSendData BOO
43. S driver initializing is done Message lt lt nitializing error information when Toshiba RAS driver is started gt gt NMI non maskable interruption handler registering error occurred 1 Data nil 1 NMI non maskable interruption handler registering error Messageld 2008 at start Factor An interrupt of the RAS board is not notified to the driver Message No interrupt can be received from the Toshiba RAS board A collision may have occurred with the interrupt from any other extended boards 1 Data None 1 The interrupt number setto the RAS board Messageld 2100 during operation Factor Detection of NMI other than AC fail memory parity Message NMI was detected Factor 1 Data nil 1 gt NMI factor is inserted initialize key off remote initialize request WDT occurrence Remarks Logging of this event is performed only during initial start of the Toshiba RAS service Thus logging is disabled when the service is resumed while the system is operating CTi Automation Phone 800 894 0412 Fax 208 368 0415 Web www ctiautomation net Email info ctiautomation net 6F8C0894 97 Chapter 3 RAS Support Software Messageld 2101 during operation Factor Fan stopping detected Message Fan stopping was detected Data Abnormal sensor detail information 1 byte in case of a RAS board having the sensor abnormality detail information Bit 0 fan sensor abnormal 1
44. TO S fH l B A 6F8C0894 Integrated Controlle series lt MENU model 2000 3000 Computer Module C2 C3 Windows NT Version User s Manual BERBER ERR REE EREREEREREREREEREEREERSE BERBER REE REESE REREEREREREEEEEREERSE BEBE ERE EERE EREREEEEREEEEEREESE BEEBE REESE ERREREEEEEEEEEEESE EEA ma EREREEREREEEREEEEEREEREEEREERSE BERR AA AA BA Ba AD AD Aa aa Aa aa Aa Ma Ma Aa Ai BEB AA AA AA AB BD AD aa AD Da ba aa Aa aa aa Ma Aa Aa Ai uu aa aa aa BERR AA AA AA BA ay AD AD aa aa aa aa aa aa Aa aa Aa Ma Ma Ma SE AE E E ay Ay BB DA ay aa aa aa aa aa aa Aa aa Ma Ma Ma Aa Aa Ma Ai BA AA BD AD Ay ay aa aa aa aa aa aa aa Aa aa aa Aa aa Ma SE BA By AB ay By aa Aa Aa aa Aa Aa Aa aa Aa Aa aa Ma Aa Ma Ma GD E E ay Ay BB aa aa aa aa aa Aa Aa Aa aa Ma Ma EEE GS BA AB AA ay aa aa Aa Aa aa Aa Aa Ma Aa Aa Ma Aa Aa Aa Ma Ma GS BA aa ay By AB Ba aa aa aa aa aa aa Aa Aa Ma Ma Aa Aa Aa Ma Ma Ma GS BA Ay AB aa Aa aa aa aa Aa Aa aa Aa Aa GD E By By Aa Aa aa aa aa aa aa Aa Aa Aa Aa aa MA MA Aa Ma Ma Na BA BB By By aa aa aa aa aa aa aa aa Aa Aa Aa aa Aa Aa Aa Ma Ma Ma Aa BA AB Aa ay AA Aa aa Aa Aa Aa aa Aa Aa aa Aa Ma Aa Aa Aa Aa Aa Aa Aa Na Na Ai BI Ba Ba RRR RRR REE Aa Aa Aa Aa Aa RRR EEE BA AB RRR RRR RRR Aa Aa Aa Aa Aa Aa Aa Aa Aa Ma Ma Aa NA NA Aa BB aa Aa Aa Aa Aa Aa Aa Aa Aa Aa Aa Aa Aa MA Na Na Na Ni BB Ma Aa Ma aa Ma aa aa Aa Aa Aa Aa Aa Aa Aa Aa MA MA NA Na NA Ni CTi Automation Phone 800 894 0412 Fax 208 368 0415 Web www ctiautomation net Email
45. TRIBUTES Ipsa DWORD fdwC reate DWORD fdwAttrsAndF lags HANDLE hTemplateF ile IpszName XRAS fdwAccess GENERIC_READ GENERIC_WRITE fdwShareMode FILE SHARE READ FILE SHARE WRITE Ipsa NULL fdwCreate OPEN EXISTING fdwAttrsAndFlags 0 hTemplateFile NULL hDevice CreateFile IpszName fdwAccess fdwShareMode Ipsa fdwC reate fdwAttrsAndF lags hTemplateFile Argument IpszN ame Driver name address Set the name of RAS driver XRAS fdwAccess Access mode Set the combination of GENERIC_READ and GENERIC_WRITE fdwS hareMode Shared mode Set the combination of FILE SHARE READ and FILE_SHARE_WRITE Ipsa Address of security descriptor Set NULL as itis not used fdwCreate Creating method SetOPEN EXISTING fdwAttrsAndFlags File descriptor Set0 as itis not used hTemplateF ile Handle of file with attribute for copying Set NULL as itis notused CTi Automation Phone 800 894 0412 Fax 208 368 0415 Web www ctiautomation net Email info ctiautomation net 6F8C0894 37 Chapter 3 RAS Support Software Returned value If the device could be normally opened the open handle of the RAS driver is returned When error occurred INVALID HANDLE VALUE is returned Explanation Command to open the RAS driver CTi Automation Phone 800 894 0412 Fax 208 368 0415 Web www ctiautomation net Email info ctiautomation net 38 model 2000 3000 Comp
46. Windows NT Using this tool the following settings can be executed and information can be displayed 1 Individual mapping The tool sets the types of mounting slots and modules of the I O modules Specify mounting slots by a channel number unit or a position inside a unit Specify module types by selecting from X Y X Y iX iY and iX Y The set information will be stored in the registry and will be looked up when the driver starts up CTi Automation Phone 800 894 0412 Fax 208 368 0415 Web www ctiautomation net Email info ctiautomation net 8 model 2000 3000 Computer Module C2 C3 Windows NT Version 2 3 Software Configuration Individual mapping information which is specified once can be cancelled and automatic mapping can be executed 2 Display of result of automatic mapping In case individual mapping is not specified the driver will execute automatic mapping when the system is started The tool displays results of automatic mapping 3 1 0 bus mapping address change Addresses of a memory space to be used by the I O bus can be changed A change is not required in normal operations A change is needed only if an address conflicts when a PC card is used The following two addresses can be selected A 0xD0000 0xD7FFF Default B 0xD8000 0xDF FFF 4 Setting I O bus time out diagnosis time An I O bus time out diagnosis time is set If ACK is not returned within a preset time a hardware error will be declared
47. afely and correctly and avoid bodily injury and property damage Grasp the meanings of the following marks and their descriptions before reading this manual Hazard Classifications D WA R N N G Indicates a potentially hazardous situation which if not avoided could result in serious injury or death Indicates a potentially hazardous situation which if nota avoided AN C A U T O N can result in minor or moderate injury or property damage It can also be used to alert against unsafe practices Note 1 Serious injury means loss of sight injury burns high temperature low temperature electrical shock fracture or intoxication which leaves aftereffects or requires hospitalization or need to go to the hospital for a long time 2 Injury means hurt burn or electrical shock which does not require hospitalization or going to the hospital for a long time 3 Property damage means extended breakdown of assets and materials Notation of Markings Lh Indicates a may not mark S P ro h ib ited The concrete forbiddance is indicated with a pictograph or wording Indicate a mandatory action that you should never fail to do Q M a n d a to ry The concrete content is indicated inside or near the circle with a pictograph or wording C ti Indicates a caution auulon The concrete content is indicated inside or near the triangle Note The description of forbiddance mandatory and caution mark
48. age is short Replace the battery Data nil Messageld 3100 Factor RAS Start File Write Error Message Cannot write the content of the RAS memory to the start file Data None Messageld 3101 Factor RAS Down File Write Error Message Cannot write the content of the RAS memory to the down file Data None CTi Automation Phone 800 894 0412 Fax 208 368 0415 Web www ctiautomation net Email info ctiautomation net 1 02 model 2000 3000 Computer Module C2 C3 Windows NT Version
49. alue Start style Normal default value Normal window Mini Mini window RAS Window Object Name XRASWindow ObjectName This specifies the object name of the object to be used for double start prevention by the RAS window The object name specified here must be a name not used by other program within the system As the default the name XRASWINDOW is set Normal Window Position X KXRASWindow NormalPos x This specifies the window position of X axis of the normal window The window position shown differs depending on the setting of the display The default value is 0 ultimate left side Normal Window Position Y KRASWindow NormalPos y This specifies the window position of Y axis of the normal window The default value is 0 highest side Mini Window Display Level KRASWindow MiniLevel This specifies the display level of the mini window Set value Display level Top Arranged at the highest level of Z sequence TopMost default value Arranged always as the front window even when non active Mini Window Position X KRASWindow MiniPos x This specifies the window position of X axis of the mini window The default value is 0 ultimate left side Mini Window Position Y KRASWindow MiniPos y This specifies the window position of Y axis of the mini window The default value is 0 highest side RAS Include File Install Path KRASWindow InstPathInclude The path name which
50. ation is stored Returned value If the command is normally completed TRUE is returned When error occurs FALSE is returned Explanation Command to read the CPU peripheral temperature information of a model which supports the CPU peripheral thermometer The information read indicates the temperature of 55 C to 125 C in the units of 0 5 C CPU peripheral temperature CPU peripheral information read temperature Ox000000FA 125 0 C 0x00000033 25 5 C 0x00000000 0 C OxFFFFFFFF 0 5 C OxFFFFFFCE 25 0 C This command is effective only for models which support the CPU peripheral temperature mechanism error occurs for other models CTi Automation Phone 800 894 0412 Fax 208 368 0415 Web www ctiautomation net Email info ctiautomation net 58 model 2000 3000 Computer Module C2 C3 Windows NT Version 3 2 RAS Support Commands 3 2 17 Battery Information Reading Command Syntax BOOL sts HANDLE hDevice LPLONG IpBattery sts KRasBattery hDevice IpBattery Argument hDevice RAS driver open handle IpBattery Address to buffer in which battery information is stored Returned value If the command is normally completed TRUE is returned When error occurs FALSE is returned Explanation Command to read the battery information on the RAS board 31 7 0 Battery information 1 vol
51. cessing In addition to the hardware processing of the RAS board this Support S oftware has RAS window functions to display and set these RAS information making it possible to monitor and control the operatin status of the system Also ithas interfaces for user application programs and itis possible to create user application programs to cope with system abnormalities etc using the RAS function processing commands or methods By means of these user functions it is possible to construct systems with higher reliability CTi Automation Phone 800 894 0412 Fax 208 368 0415 Web www ctiautomation net Email info ctiautomation net 34 model 2000 3000 Computer Module C2 C3 Windows NT Version 3 1 Overview of RAS Support Software 3 1 8 Software Configuration This Support Software is a program to operate under the WindowsNT environment and consists of the following 5 modules e RAS device driver This device driver operates under the control of the I O manager of WindowsNT Executive and itis a driver program to process access to the RAS board interruption from the RAS board and request from the user application program RAS service Service program to perform processing of messages from the RAS device driver event log processing and shutdown processing RAS window Window program to display the information of the RAS board and change the registry information of the RAS Support S oftware e RAS Support Software
52. d realtime Display Content Internal temperature is normal thermo Normal Internal temperature is abnormal thermo 9 Error RAS board is not installed or RAS driver is not installed CTi Automation Phone 800 894 0412 Fax 208 368 0415 Web www ctiautomation net Email info ctiautomation net 6F 8C 0894 91 Chapter 3 RAS Support Software 3 6 Event Log Information The RAS Support Software logs the RAS information such as startup information shutdown information abnormality information in the event log of WindowsNT with the RAS service program The event log control information is stored under the Eventlog key of the configuration registry data base 3 6 1 Logging Information When RAS Service Starts The RAS service logs the following information in the event log when the system starts e Error information when RAS service starts In case of error occurrence such as no installation of the RAS driver abnormal registry information or faulty setting of service thread priority the event log on the error is logged Error information when RAS driver starts In case of error occurrence such as no inserting of RAS board abnormal registry information or failure to install the driver normally the event log on the error is logged e Last shutdown information When WindowsNT starts shutdown processing it cannot log the event log For this reason with the RAS Support Software t
53. de invalid and the windows cannot be opened The button of the alarm window is made invalid and the window cannot be opened Alarm test window button RAS memory window button WDT window button Event log window button DIO window button Registry window button Status window oes ie window button Suma TOSHIBA Be thermo R A S ormal is Normal E 9 Hbg one Power supply s fan information Mirroring disk information Inside temperature information CTi Automation Phone 800 894 0412 Fax 208 368 0415 Web www ctiautomation net Email info ctiautomation net 90 model 2000 3000 Computer Module C2 C3 Windows NT Version 3 5 RAS Windows 3 5 19 Window buttons By pressing each window button the window is opened S Status window DIO window WDT window 1 Alarm window RAS memory window Event log window Q A Registry window e Main window button By pressing the main window button the mini window is closed and the main window is opened e Power fan information The power fan information is displayed real time In case of a system not supporting the sensor detection invalid display is made Display Content P ower fan is normally running fan Normal Powerfan is stopped fan Error RAS board or power fan is not installed or RAS driver is not fa installed e Internal temperature information The information of the temperature in the equipment is displaye
54. designer of the window to receive the RAS message must set a window message ID not used 3 3 10 RAS Mail Slot Name XRASService MailslotName This specifies the name of the mail slot to be created with the RAS message receiving mail slot setting command For the mail slot name to be specified here a name not used by other program within the system must be described As the default the name XRASMSG is set 3 3 11 RAS Mail Slot Receiving Diagnosis Time XRASService MailslotReadTimeOut This specifies the diagnosis time of the receiving command ReadF ile to the mail slot created with the RAS message receiving mail slot setting command In case of time out of the receiving command the error information obtaining command GetLastError returns ERROR_SEM_TIMEOUT The values are to be setin the units of ms and as the default 60000 60 seconds is set If 0 is set as the set value the receiving command immediately ends if there is no message If the set value is Oxffffffff it waits until the message is sent 3 3 12 Forced Shutdown Diagnosis Time XRASService TimerForceShutdown This specifies the diagnosis time in the forced shutdown of WindowsNT As the WindowsNT shutdown method the RAS Support S oftware takes two steps Firstly it tries to shut down the WindowsNT while informing the application of the shutdown If there exists any process which does not respond the shutdown is temporarily stopped dialogue box is d
55. dication command XRasAlarmMemory User RAS memory reading command XRasWriteM emory User RAS memory writing command XRasReadsS ysMemory System RAS memory reading command XRasWDT WDT setting command XRasResetWDT User WDT reset command XRasUserS hutdown User shutdown command XRasThermometer CPU temperature information reading command XRasThermometerE x CPU peripheral temperature information reading command XRasBattery Battery information reading command XRasGetsS witchS tat Switch status Read XRasGetHardwareR evision Har dware Revision Read XRasSetLed Main Unit LED Control XRasSetLedEx Main Unit LED Control The data types explained in the following sections are those defined by WindowsNT and for the application program it is necessary to include windows h and winioctl h Since the data types constants etc defined by the RAS Support Software are described in xrasdll h the user application program must include this header file as well For linking the user application itis necessary to link XRasDLL lib RAS DLL library These xrasdll h and XRasDLL lib exist under the directory specified when installing CTi Automation Phone 800 894 0412 Fax 208 368 0415 Web www ctiautomation net Email info ctiautomation net 36 model 2000 3000 Computer Module C2 C3 Windows NT Version 3 2 RAS Support Commands 3 2 1 Open Command Syntax HANDLE hDevice LPCTSTR IpszN ame DWORD fdwAccess DWORD fdwS hareMode LPSECURITY_ AT
56. e time of next startup e RAS service stop information If the RAS service is stopped during system operation from the control panel etc the RAS Support Software does not normally function and so the service stopping is logged in the event log 3 6 4 Event Log List The following shows the list of events bo be logged by the RAS Support Software Severity Messegeld Explanation Information 1000 Service start informing Information 1100 Information of last shutdown Information 1200 Recovery from fan stop Information 1201 Recovery from internal temperature abnormality Information 1300 NMI trigger information Error 2000 RAS device open error Error 2001 I O processing error Error 2002 RAS board not installed Error 2003 Driver initializing registry error Error 2004 Driver initializing address error Error 2005 Driver initializing resource error Error 2006 Driver initializing interruption error Error 2007 Driver initializing NMI error Error 2008 RAS board interruption receive error Error 2100 NMI detection power key remote initialize warning Error 2101 Fan stopping Error 2102 Internal temperature abnormality Error 2104 Wrong MI detected Error 2105 Driver message buffer flow Error 2110 System memory single bit error Error 2200 Error of thread connection to control manager Error 2201 Registry information obtaining error Error 2202 S
57. e whole of the window can be checked by moving the window by selecting the movement of the system control menu through the keyboard tg Toshiba RAS Window Selection Mini Window Help Menu c Status window button TOSHIBA RAS Window RAS memory window button gt Status ras Memory DIO window buttonn __ Event log Eee ig event tog window button WDT window button __ Registry window WDT GB Eovronment button Alarm Test Mini Window Alarm test window ea Mini window button button RAS window end button e Menu The menu consists of 3 items SELECT MINI WINDOW and Other and each has the following function SELECT This menu item is to selecta RAS window and each window name is displayed and by selecting it the specified window can be opened MINI WINDOW This menu item is to set the operation of the mini window and the following two items can be checked No check Check Highest level display Display is made at the highest level only when active Always displayed at the highest level Mini window start Main window is displayed when RAS window is started Mini window is displayed when RAS window is started 73 Chapter 3 RAS Support Software OTHER When you Select the version information the version of the RAS window is displayed as shown in the figure below By selecting Help you can
58. eb www ctiautomation net Email info ctiautomation net 6F 8C 0894 11 Chapter 2 1 0 Bus Support Software 2 5 Support Input Output Module The input and output modules supported by this software are listed below For the complete information of each module see related information of the I O modules model 2000 Support Module Table 2 1 Output Module Classification Model Specification Points Transistor Output DO633 DC5 24V 16 points D0634 DC5 24V 32 points D0635 DC5 24V 64 points DO633P DC 12 24V source output 16 points Triac Output AC 663 AC100 240V 12 points Contact Output R0663 AC240V DC24V 16 points RO662S AC 240V DC 24V independent common 8 points Analog Output DA622L 8bit 4 to 20mA 1 to 5V 0 to 10V 2ch DA622 12bit 4 to 20mA 1 to 5V 15 12bit 10V 2ch DA672 12bit 10V 2ch Table 2 2 Input Module Classification Model Specification points DC AC Input D1633 DC AC 12 24V 16 points DC Input D1634 DC24V 32 points D1635 DC24V 64 points DI335H DC 24V high speed response type 64 points AC Input IN653 AC100 120V 16 points IN663 AC200 240V 16 points Analog Input AD624L 8bit 1 to 5V Ach AD624 12bit 1 to 5V 4ch AD634L 8bit 0 to 10V 4ch AD338 12bit 10V 4ch CTi Automation Phone 800 894 0412 Fax 208 368 0415 Web www ctiautomation net Email info ctiautomation net 1 2 model 2000 3000 Computer Module C2 C3 Windows NT Version
59. egistered in registry is used for the message to be transmitted operation to a window using this message ID cannot be guaranteed In such a case the registering of the RAS message ID should be changed For the window set with this command shutdown processing must be done when the NMI message is received For this reason when the window is deleted itis necessary to issue the command with NULL setto the user window handle e Fan stop wParam RASMSG_FAN_STOP This is transmitted when the fan stop is detected e Fan recovery wParam RASMSG_FAN_STOP_RECOVER This is transmitted when recovery is made after fan stop is detected e Temperature abnormality wParam RASMSG_OVER_THERMO This is transmitted when temperature abnormality is detected e Temperature recovery wParam RASMSG_OVER_THERMO_RECOVER This is transmitted when recovery is made after temperature abnormality is detected e DI change wParam RASMSG_DI0 RASMSG DI1 RASMSG_DI2 RASMSG_DI3 RASMSG_DI2 RASMSG DI3 This is transmitted when DI change is detected CTi Automation Phone 800 894 0412 Fax 208 368 0415 Web www ctiautomation net Email info ctiautomation net 44 model 2000 3000 Computer Module C2 C3 Windows NT Version 3 2 RAS Support Commands e Mirroring disk abnormality wParam RASMSG _ILLEGAL_MIRRORDISKO RASMSG ILLEGAL MIRRORDISK1 This is transmitted when abnormality is detected when the mirroring disk is connected e NMI occurrence wWParam RASMSG_NMI
60. en an interrupt generates in a specified module Calling this function will create a thread to queue for an interrupt to generate An interrupt will create other new thread which will execute the function Func The thread which called this function will reset immediately Data by interrupt can be selected by looking up the InterruptedData structural arrangement which is an internal variable of DLL The InterruptedData structure is a structure consisting of the following members To look up this structural arrangement use the Keyword _declspec keyword of the extended attribute syntax and declare by using the storage class attribute dllimport unique to Microsoft typedef struct InterruptData DWORD TimeStamp WORD KW WORD Reserved InterruptData_t The application to use this function will be the Multithread Application The link of the C Run Time Library libcmt lib compatible to multithread will be needed Specify Option MT D or X86_ when executing the CL Command When Visual C is used specify the Multithread Run Time Library in the Dialog Box Project Options When creating threads in other place by an application that uses this function use _beginthread or beginthreadex Do not use CreateThread or ExitThread For the complete information see the section which describes _beginthread Parameters Func Function to be started cCh Channel No 0 to 4 0 Basic unit cUnit Unit No 0 to 7 0 Basic unit c
61. ending on how the priority is set by application operation of this software may delay by operations of other Windows applications If I O module accessing causes a time out scan execution period by the service will delay 2 4 2 Programming Precautions Application programs are created as Win32 applications The application programs call functions supplied by this support software and access the I O modules Fixed cycle interrupts can be implemented by using a feature provided by Win32API In both floating scanning and fixed time scanning the control structure such as repeating has to be described by an application itself The startup timing of application programs that use the features of this software is the same as in Starting ordinary Win32 applications Execution of a program without releasing the CPU will deteriorate the response of the entire system Functions can be started up by interrupts such as CDDIs These functions are executed as threads and a library libcmt lib compatible to multithreads must be linked during coding For the complete information see the API reference lobusR egCallbackF unc Function ending and data sending to an actual device of batch output functions in this support software are not synchronized Data is stored by output operation of the service For the complete information see 2 7 Batch Input Output CTi Automation Phone 800 894 0412 Fax 208 368 0415 Web www ctiautomation net
62. equipment installed in the surgery and other medical equipment Note 2 The systems which involve human life and have great influence on the maintenance of the public function mean the main control system of a nuclear power plant safety and protection system of a nuclear power facility transport operation and control systems for mass transportation control systems of aviation and space systems and other systems and subsystems where safety is critical Note 3 Special care means to build a safety system foolproof design fail safe design redundancy design etc in full consultation with Toshiba s engineers Immunity Toshiba is not liable for any loss caused by fire earthquake action by a third party or other accidents or the operator s intentional or accidental misuse incorrect use or use under abnormal condition Toshiba is not liable for any incidental loss caused by the use or non use of this product such as loss of business profits suspension of business or loss or change of data on memory Toshiba is not liable for the loss caused by an operation contradictory to any of the instructions stated in this manual Toshiba is not liable for the loss caused by an incorrect operation in combination with other equipment Toshiba is not liable for the loss caused by a malfunction in combination with an application program made by the customer cables and I O bus cable Otherwise the system can malfunction Use cellular phon
63. ersion Chapter 3 RAS Support Software 3 1 Overview of RAS Support Software This support software supports features that enhance the RAS reliability availability and serviceability performance of the Integrated Controller Computer Module 3 1 1 Features of RAS Hardware Processing This support software has the following RAS features related to hardware processing by the RAS hardware e LED lighting control e RAS memory read and write e Internal trouble or error detection Fan stop abnormal temperature e NMI detection WDT or INZ switch pressed shutdown request low voltage e System reset Hardware reset e CPU thermometer e Low battery voltage detection The RAS hardware uses the following I O areas and interrupts and must be set to avoid competition with other expansion boards If the RAS hardware competes with other expansion board operation of the software cannot be guaranteed I O Areas e 0x0140 0x016F Basic RAS I O e 0x0061 0x0070 0x0071 NMI control I O I O on the main board e 0xC140 0xC141 CPU thermometer I O Interrupts e IRQ5 is used Aside from hardware processing of the RAS board this support software has the following features 3 1 2 Function to Inform User of Interruption This informs the user application program of the interruption signal The interruption signal is classified into the following two types e Maskable interruption This becomes an interruption signal when itis regis
64. ervice thread generating error Error 2203 Process priority setting error Error 2204 Thread priority setting error Error 2205 Service status updating error Error 2206 RAS memory abnormality Error 2300 Mail slot opening error Error 2301 Main slot writing error Error 2302 Message transmitting error Error 2400 Shutdown processing error Error 2401 Forced shutdown informing CTi Automation Phone 800 894 0412 Fax 208 368 0415 Web www ctiautomation net Email info ctiautomation net 6F8C0894 93 Chapter 3 RAS Support Software Severity Messegeld Explanation Error 2500 Last shutdown informing error RASMEM Error 2501 Last shutdown informing error last driver status abnormality Error 2502 Last shutdown informing error error occurrence at service start Error 2503 Last shutdown informing error RAS board abnormality Error 2600 Forced ending of service Warning 3000 Service stopping during system operation Warning 3001 Battery voltage shortage Warning 3100 RAS start file write error Warning 3101 RAS down file write error 3 6 5 Event Log Detail The following shows the detail of the events logged by the RAS Support S oftware lt lt Information events gt gt Messageld 1000 at start Factor service start informing when service normally starts Message Toshiba RAS service was started Data nil Messageld 1100 at start Factor informing of last shutdown information Mes
65. es and PHSs at least one meter away from the working equipment transmission CTi Automation Phone 800 894 0412 Fax 208 368 0415 Web www ctiautomation net Email info ctiautomation net vi model 2000 3000 Computer Module C2 C3 Windows NT Version Preface The Structure of This Manual This manual describes Windows NT the operating system of Microsoft Corporation installed in the Computer Modules C2 C3 of the Integrated Controller with a focus on the features added or extended to the operating system The reader is invited to read manuals of Microsoft for the full information on Windows NT This manual is composed of the following chapters Chapter 1 Windows NT Chapter 1 describes initial settings of Windows NT which is preinstalled and other matters Chapter 2 I O Bus Support Software The C2 C3 can directly control the parallel bus I O modules This chapter describes the I O bus support features which control the modules and API Chapter 3 RAS Support Software This chapter describes the RAS features of the C2 C3 and usage of them CTi Automation Phone 800 894 0412 Fax 208 368 0415 Web www ctiautomation net Email info ctiautomation net 6F8C0894 vii CTi Automation Phone 800 894 0412 Fax 208 368 0415 Web www ctiautomation net Email info ctiautomation net CONTENTS 1 Windows NT nnaana 1 TI Precautions baa thani eea eee eb aa dea teal ns 2 LZ Initialization saaa a ae e id
66. etDiag 24 2 9 6 lobusRegCallbackFUNC 25 2 9 7 lobusRecvData 26 2 9 6 REMAK III eRe eK 26 2 9 9 lobusSe ndD ata 27 2 9 10 lobusRecvDataDirect 28 CONTENTS 2 9 11 lobusSendDataDirect 29 2 9 12 lobusGetDiaginfo 30 2 9 13lobusDoBusReset 31 2 9 14 lobusModuleSuspend 31 2 9 15 lobusModulResume 32 3 RAS Support Software 33 3 1 Overview of RAS Support Software 33 3 1 1 Features of RAS Hardware Processing 33 3 1 2 Function to Inform User of Interruption 33 3 1 3 Automatic Shutdown Function 34 3 1 4 RAS Information Processing Function 34 3 1 5 Get DIP Switch State 34 3 1 6 LED Lighting Control 34 3 1 7 Functions of RAS Software Processing 34 3 1 8 Software Configuration 35 3 2 RAS Support CommandS 36 3 2 1 OpenCommand 37 3 2 2CloseCommand 39 3 2 3 RAS Support Software Version Reading Command 40 3 2 4 RAS Driver Error Information Reading Command 41 3 2 5 RAS Message Receive Window Setting Command
67. ftware IF 741 PaA IF721 m IF351 IF351 IF351 IF351 IF351 IF351 IF351 Basic Unit 576 Points Basic Base BU719 224567391414 aek 2 34582810 piepe Expansion Units 1 1 to 1 7 Maximum Number of Points for Two Systems 10432 points When expansion base for 11 boards is used 0i gt elo lo 5962 points When expansion base for 6 boards is used Maximum Number of Points for Up To Three Systems 15360 points When expansion base for 11 boards is used 8640 points When expansion base for 6 boards is used Expansion Units 1 1 to 1 7 Expansion Units 1 1 to 1 7 Maximum Number of Points for Up To Four Systems 20288 points When expansion base for 11 boards is used 11328 points When expansion base for 6 boards is used t it i 1280 points When expansion base for 11 boards is used 960 points When expansion base for 6 boards is used H ee e unabisudamo basa sere net Expansion Unit 0 1 01 1984 points When expansion base for 11 boards is used 1344 points When expansion base for 6 boards is used i i I deed Expansion Unit 02 2688 points When expansion base for 11 boards is used i 1728 points When expansion base for 6 boards is used 45678910 3392 points When expansion base for 11 boards is used 2112 points When expansion base for 6 boards is used 23 ji 4096 points When expansion base for 11 boards is used 2496 points When expansion base for 6 b
68. g this cycle and next scan operation is processed If the lobuxSendData lobusR ecvData function cannot secure Mutex the function will make an error return allowing fetching of ERROR TIMEOUT by GetLast rror In case the foregoing event occurs the function can retry However the access frequency should be adjusted to prevent such time outs CTi Automation Phone 800 894 0412 Fax 208 368 0415 Web www ctiautomation net Email info ctiautomation net 6F 8C 0894 19 Chapter 2 1 0 Bus Support Software 2 8 RAS Feature 2 8 1 Self Diagnosis As partofthe RAS features ofthis software a driver and hardware self diagnostic feature is implemented Table 2 5 Self Diagnosis Items When driver is loaded Operation When Trouble is Diagnosis Item Diagnosis g g Detected Access Authority Check Check is made whether or not Records No access authority in own controller can access the I O event log All subsequent data modules input output requests from applications will become errors 1 0 Collation Check If individual mapping is specified Records Information mismatch mapping information and in eventlog All subsequent data implementation status are input output requests from collated applications will become errors Table 2 6 Self Diagnosis Items When application is executed PIO IA Aa AE Operation When Trouble is 9 9 Detected MIF Time Out Check is made if response Records MIF time out
69. h Channel specification 0 Basic unit 1 Channel 1 2 Channel 2 3 Channel 3 4 Channel 4 cUnit Unit No in each channel Counted beginning 0 cMod Module No in each unit Counted beginning 0 cOffset Offset inside a module in unit of word wLength Length of data input in unit of word IpwData Pointer to input data CTi Automation Phone 800 894 0412 Fax 208 368 0415 Web www ctiautomation net Email info ctiautomation net 28 model 2000 3000 Computer Module C2 C3 Windows NT Version 2 9 API References 2 9 11 lobusSendDataDirect BOOL lobusS endDataDirect HANDLE CHAR CHAR CHAR CHAR WORD LPWORD hDevice cCh cUnit cMod cOffset wLength lpwData Data pwData is directly output to an address specified by cCh cUnit cMod or cOffset for the wLength length A check is not made whether or nota module actually exists at the specified address or the device can output This has to be confirmed by an application Data is output in a unit of word Parameters hDevice cCh cUnit cMod cOffset wLength lpwData The driver handle gotten by CreateFile Channel specification 0 Basic unit 1 Channel 1 2 Channel 2 3 Channel 3 4 Channel 4 Unit No in each channel Counted beginning 0 Module No in each unit Counted beginning 0 Offset inside a module in unit of word Length of data output in unit of word Pointer to output data CTi Automation Phone 800 894 0412 Fax 208
70. he information is left in the RAS memory at the shutdown and logged in the event log at the time of next startup e RAS Support Software start information The fact that the RAS Support Software is installed and started is logged 3 6 2 Logging Information during Operation of RAS Service The RAS service logs the following information in the event log during system operation e Power fan stop recovery information When the power fan stop or recovery is detected the information is logged in the event log e Equipment internal temperature abnormality recovery information When the internal temperature abnormality or recovery is detected the information is logged in the event log e RAS Support Software error information If any error e g abnormality of communication between driver and service occurs with the RAS Support Software during system operation the information is logged in the event log CTi Automation Phone 800 894 0412 Fax 208 368 0415 Web www ctiautomation net Email info ctiautomation net 92 model 2000 3000 Computer Module C2 C3 Windows NT Version 3 6 Event Log Information 3 6 3 Logging Information at End of RAS Service The RAS service logs the following information in the event log at the time of system shutdown e NMI information In case of shutdown due to NMI occurrence the RAS Support Software logs the NMI factor in the eventlog For NMI of parity error or voltage decrease the logging is done at th
71. ication operations The service on the output side queues for updating of file data from the application and transfers data to the output module when updating is confirmed Completing one cycle each of operation for input and output the service pauses for ScanCycle 100ms and proceeds to the next operation cycle In case 1 is specified in Registry Value Scan Policy the service can neither secure mutex nor perform file exclusive control in file accessing As the number of application processes increases the time to secure mutex also increases As a result the operation cycle sometimes lengthens This setting avoids phenomena of operation cycles becoming unstable Nevertheless elimination of exclusive control may result in data which is being accessed exchanged with a function and data consistency cannot be guaranteed The service starts and processes different threads on the READ and WRITE sides 2 7 2 Application Creation Applications that use batch input and output proceed as follows 1 Gets the number of input and output modules and totals of word numbers on the input and output sides using lobusMappedinfo and verifies that the numbers agree with the system configuration 2 The input and output sides secure buffers that satisfy the total size of the number of words on both the input and output sides The buffers may be secured dynamically or Statically 3 Data is input and output using lobusSendData and lobus RecvData
72. installed the include file xrasdll h of the RAS Support Software is recorded This information is used when uninstalling is done RAS include file install path name XRAS BAS CTi Automation Phone 800 894 0412 Fax 208 368 0415 Web www ctiautomation net Email info ctiautomation net 68 model 2000 3000 Computer Module C2 C3 Windows NT Version 3 3 RAS Support Software Registering 3 3 21 RAS Library File Install Path KRASWindow InstPathLibrary The path name which installed the library file KRasDLL lib of the RAS Support Software is recorded This information is used when uninstalling is done 3 3 22 Option XRAS Option This is a set value for future use and 0 must be set CTi Automation Phone 800 894 0412 Fax 208 368 0415 Web www ctiautomation net Email info ctiautomation net 6F8C0894 69 Chapter 3 RAS Support Software 3 4 RAS Shutdown Processing 3 4 1 Shutdown Operation The RAS Support Software has the function to automatically shut down the WindowsNT when NMI excluding voltage decrease system memory parity error multi bit error and PCI bus system error is detected The automatic shutdown operation differs depending on whether the user application program is receiving the RAS messages with the RAS message receiving window setting command XRasUserWindow 1 NMI occurrence The RAS driver sets the system WDT If the NMI factor is system memory parity error multi bit error PCI bus
73. irectory to Show S 4 Add C P rogram Files TOSHIBA G 310 include to the new path 5 Click OK to complete setting Options HEI Editor Tabs Debug Compatibility Build Directories Platform Show directories for win32 v include files v Directories C Program Files Microsoft Visual Studio VC98 INCLUDE C Program Files Microsoft Visual Studio Y C98 MFC INCLUBDE C Program F isual Studio C9IB ATLAINCLUDE 310 Ninclude e Library Setting 1 Select Set S in the Project P Menu 2 Select Link Tab and add g3iolib lib to Object Library Module L Project Settings 21x Settings For Jwina2 Debug v General Debug C C Link Resourci pg EA Category General Heset Dutput file name Jo ebug diag exe Object library modules 2 lib oleaut32 lib uuid lib odbc32 lib odbecp32 lib g3iolib lit IV Generate debug info P Ignore all default libraries I Link incrementally Generate mapfile Tl Enable profiling Project Options kermel32 lib user32 lib gdi32 lib winspool lib comdlg32 lib advapi32 lib shell32 lib ole32 lib oleaut32 lib uuid lib odbe 32 lib odbecp32 lib kernel32 lib user32 lib gdi32 lib vi Cancel CTi Automation Phone 800 894 0412 Fax 208 368 0415 Web www ctiautomation net Email info ctiautomation net 6F8C0894 15 Chapter 2 1 0 Bus Support Software 2 6 2 List of APIs The APIs provided by this sup
74. ism by using multi process and multi thread The same machine can develop and execute programs References The reader is recommended to read the following documents also after reading this manual Sequence Controller S3 Main Unit Instruction Manual 6E8C3783 Parallel 1 0 Instruction Manual 6E 8C 3785 Pulse Input Module Instruction Manual P1312 6E 8C 3968 Analog Input Module Instruction Manual 6E 8C 3969 Sequence Controller S2 Hardware Manual 6E 8C 3857 CTi Automation Phone 800 894 0412 Fax 208 368 0415 Web www ctiautomation net Email info ctiautomation net 6F8C0894 5 Chapter 2 1 0 Bus Support Software 2 1 Software Installation This software is supplied in floppy disks When reinstalling this software in a machine in which this software is already installed temporarily uninstall delete the software and install it again as follows START Menu gt Program gt Select Uninstall in the holder Toshiba G310 Support S oftware After uninstalling restart the system Execute setup exe stored in the first floppy disks Then operate by following guidance messages displayed on the screen CTi Automation Phone 800 894 0412 Fax 208 368 0415 Web www ctiautomation net Email info ctiautomation net 6 model 2000 3000 Computer Module C2 C3 Windows NT Version 2 2 Hardware Configuration 2 2 Hardware Configuration figure 2 lshows the maximum hardware configuration of C3 supported by this so
75. isplayed and key input is waited for leading to the situation that a system of unmanned operation etc cannot normally complete the shutdown To avoid such a situation the RAS Support S oftware provides the diagnosis time and at time out it forcefully shuts down the WindowsNT forcefully ends the application program This diagnosis time is called forced shutdown diagnosis time Since the shutdown execution diagnosis time TimerS hutdown is started from the start of the first shutdown this forced shutdown diagnosis time must be set shorter than the diagnosis time to make it effective If the shutdown execution diagnosis time is shorter the equipment is reset before the forced shutdown is made If this diagnosis time is too short the forced shutdown will be executed in the midst of shutdown and WindowsNT may not normally be shut down For the detail see the restrictions of 3 4 RAS Shutdown Processing The following shows the setting range The values are to be setin the units of 500ms 2 1 second to 1200 10 minutes Default valve is 240 2 minutes CTi Automation Phone 800 894 0412 Fax 208 368 0415 Web www ctiautomation net Email info ctiautomation net 6F8C0894 67 Chapter 3 RAS Support Software 3 3 13 3 3 14 3 3 15 3 3 16 3 3 17 3 3 18 3 3 19 3 3 20 RAS Window Start Style KRASWindow Startup This specifies the start style Normal window mini window of the RAS window Set v
76. l starting User window is not set Unknown RAS driver is notinstalled e User mail slot handle Display Content User mail slot handle User mail slot is created Not used User mail slot is not created Unknown RAS driver is not installed Alarm window Invalid display is made CTi Automation Phone 800 894 0412 Fax 208 368 0415 Web www ctiautomation net Email info ctiautomation net 6F 8C0894 77 Chapter 3 RAS Support Software 3 5 5 Sensor Detection For the sensor detection item the following information related to internal abnormality detection is displayed In case of a model not supporting each sensor mechanism respective invalid display is made e Temperature inside equipment Display Content Normal Temperature in equipment is normal Abnormal Temperature in equipment is abnormal Unknown RAS driver is not installed e Fan operation status Display Content Normal P ower fan is normally running Stopped P ower fan is stopped Unknown RAS driver is not installed e CPU peripheral temperature CPU temperature and CPU peripheral temperature are displayed In case of a model not supporting this function C is displayed in invalid character e Battery information Battery information is displayed Display Content Normal Battery voltage is normal Short Battery voltage is shor Unknown RAS driver is not installed CTi Auto
77. lting in a major accident Forbidden Do not block the ventilation port or suction exhaust port of the equipment Otherwise overheating or other phenom ena may cause a fire or a failure Mandatory Noncompliance with the installation conditions described in this manual during system installation or wiring may disable the controller to demonstrate its design performance and may cause equipment malfunction or failures Mandatory Always install the module after turning the external power supply off Otherwise the module failure or an electric shock may result CTi Automation Phone 800 894 0412 Fax 208 368 0415 Web www ctiautomation net Email info ctiautomation net model 2000 3000 Computer Module C2 C3 Windows NT Version 2 Safety Precautions during Maintenance Servicing or Checks WARNING Mandatory Always turn the power off when plugging or unplugging a module or a board or when connecting equipment Otherwise an electric shock accident or equipment failure may result CAUTION Forbidden Exercise reasonable care and do not drop col lide with other article or apply a strong shock to the equipment or a board Otherwise a failure may result Mandatory Make certain that the external power is turned off before mounting or dismounting the module after installing cables in it Otherwise an electric pole
78. ly done CTi Automation Phone 800 894 0412 Fax 208 368 0415 Web www ctiautomation net Email info ctiautomation net 70 model 2000 3000 Computer Module C2 C3 Windows NT Version 3 4 RAS Shutdown Processing 3 4 2 Restrictions on WindowsNT shutdown in the RAS Support Software 1 If the RAS Support Software is started and then stopped uninstall etc the power cannot be turned off even if the power key is set to OFF This phenomenon is caused by temporarily setting the RAS board circuit In case the RAS support software is stopped shut down Windows NT manually then temporarily turn the power off by switching off the power switch located on the backside By this the power is turned off by switching off the switch beginning next operation Windows NT is not shut down 2 If the forced shutdown functions and the shutdown is executed in the midst of the shutdown processing of WindowsNT the shutdown may not normally be executed CTi Automation Phone 800 894 0412 Fax 208 368 0415 Web www ctiautomation net Email info ctiautomation net 6F 8C0894 71 Chapter 3 RAS Support Software 3 5 RAS Windows With the RAS Support Software the following RAS windows are prepared These windows are developed from the main window ofthe RAS window This makes it possible to process the RAS information display and RAS command execution at the GUI level RAS window Description Status windo
79. m but if this command is used even a user application program not having such window handle as console application can receive the messages By executing this command the mail slot to receive messages from the RAS Support S oftware is created deleted If TRUE is set to the mail slot creating flag of the argument the mail slot is created or if FALSE is set itis deleted To receive the message firstly create the mail slot with this command and issue the receive command of Win32 API ReadFile to the mail slot handle of the returned value Then when the user application receiving the message ends issue this command and delete the mail slot As the priority for transmitting the RAS messages the RAS Support S oftware firstly checks if there exists the mail slot created with this command If it exists it transmits the messages only to the mail slot If the mail slot does not exist then it checks if the receiving window exists Thus even if the receiving window is set the message is not transmitted to the receiving window if the receiving mail slot is set Like the RAS message receive window setting command the application program set with this command requires shutdown processing when the NMI message is received For this reason when the application program ends itis necessary to delete the mail slot by issuing this command Message data which can be read by using the receive command ReadFile are 8 bytes consisting of message ID a
80. mation Phone 800 894 0412 Fax 208 368 0415 Web www ctiautomation net Email info ctiautomation net 78 model 2000 3000 Computer Module C2 C3 Windows NT Version 3 5 6 Operation Environment 3 5 RAS Windows For the operation environment item the information of the present operation environment is displayed If the RAS service is not started unknown is displayed for the RAS service related information RAS service thread priority RAS message ID RAS mail slot name RAS mail slot receiving diagnosis time forced shutdown diagnosis time or if the RAS driver is not started unknown is displayed for all the information Display item Content Interruption No Interruption No used by RAS board is displayed Healthy detection means Healthy signal output means of RAS Support Software is displayed System WDT time User WDT time Service shutdown diagnosis time are displayed pL IAU User shutdown diagnosis time Shutdown execution diagnosis time Setvalue of each time and actual time RAS service thread priority Priority of RAS service thread is displayed RAS message ID Window message ID used in RAS message informing u is displayed S RAS mail slot name Mail slot name used for RAS mail slotis displayed 7 RAS mail slot receiving diagnosis RAS mail slot receiving diagnosis time is displayed If a time the receiving diagnosis time is infinite FOREVER is
81. mation net 23 Chapter 2 I O Bus Support Software 2 9 3 lobusGetMappedinfo BOOL lobusGetMappledinfo HANDLE hDevice struct IOMAP iomap Gets results of I O automatic mapping by the driver Parameters hDevice Driver handle gotten by CreateF ile iomap Pointer to IOMAP structure arrangement The arrangement should be 3D arrangement of NCHANNEL X NUNIT X NMODULE 2 9 4 lobusSetDiag BOOL lobusS etDiag HANDLE hDevice Specifies 1 0 module diagnosis execute Execution of this function is equivalent to I O error map create function of T3 T3H I O module diagnosis checks the module error status when accessing a module Execution of this feature therefore increases overhead Detected module errors can be gotten by Function lobusGetDiagInfo Parameters hDevice Driver handle gotten by CreateF ile 2 9 5 lobusResetDiag BOOL lobusResetDiag HANDLE hDevice Resets I O module diagnosis execute specified by lobusS etDiag or the registry This function can be called any time Parameters Parameters hDevice Driver handle gotten by CreateF ile CTi Automation Phone 800 894 0412 Fax 208 368 0415 Web www ctiautomation net Email info ctiautomation net 24 model 2000 3000 Computer Module C2 C3 Windows NT Version 2 9 API References 2 9 6 lobusRegCallbackFunc BOOL lobusR egCallbackF unc VOID __cdecl Func void CHAR cCh CHAR cUnit CHAR cMod Specifies a function to be called wh
82. n By pressing the write button the input data are written in the user RAS memory CTi Automation Phone 800 894 0412 Fax 208 368 0415 Web www ctiautomation net Email info ctiautomation net 84 model 2000 3000 Computer Module C2 C3 Windows NT Version 3 5 RAS Windows 3 5 12 Event Log Window The event log window displays the event log information logged by the RAS Support Software In this window makimum 256 events are displayed More old events can be checked through the event viewer Toshiba RAS Eyent Log x Event Log on SEKIGOGO Date Time Type EventID 68 67 97 20 35 25 Info 1166 M 68 67 97 26 35 25 Info 1666 68 67 97 26 31 19 Info 1168 68 67 97 26 31 19 Info 1660 68 67 97 20 27 37 Info 1168 68 67 97 26 27 37 Info 1660 68 67 97 26 25 37 Warning 2168 68 67 97 26 26 11 Info 1166 68 67 97 26 26 11 Info 1066 68 67 97 26 17 56 Warning 2166 68 67 97 20 13 25 Info 1168 68 67 97 26 13 25 Info 1668 63 21 97 14 12 58 Warning 2100 63 21 97 14 12 50 Info 2561 63 21 97 14 12 56 Info 1668 63 21 97 14 12 66 Warning 3666 63 21 97 14 11 10 Info 1168 63 21 97 14 11 69 Info 1660 63 21 97 14 65 24 Info 2561 A2 21 97 14 05 24 Infn 4AAA zl Refresh OK Event log information lt Refresh button 3 5 13 Refresh button By pressing the refresh button the display of the event log window is updated to the newest information CTi Automation Phone 800 894 0412 Fax 208 368 0415 Web www c
83. n forced shutdown is executed Message Forced shutdown is executed File data not saved etc are destroyed Data nil CTi Automation Phone 800 894 0412 Fax 208 368 0415 Web www ctiautomation net Email info ctiautomation net 1 00 model 2000 3000 Computer Module C2 C3 Windows NT Version 3 6 Event Log Information Messageld 2500 at start Factor Unconformity occurrence with RAS memory in last shutdown information survey routine Message lt lt Last shutdown information gt gt could notbe logged for the following reason Unconformity occurred with RAS memory Itis considered that Toshiba RAS board was removed inserted or battery is exhausted Data Last RAS memory content 112 bytes Messageld 2501 at start Factor In the last shutdown information survey routine the RAS driver could not normally operate in the last system or RAS driver was not intalled Message lt lt Last shutdown information gt gt could not be logged for the following reason In the last system Toshiba RAS driver was not normally started Data Last RAS memory content 112 bytes Messageld 2502 at start Factor Last shutdown information could not be logged due to error occurrence in startup processing Message lt lt Last shutdown information gt gt could not be logged for the following reason Error occurred when Service starting was done Data Last shutdown memory content 112 bytes if RAS memory information
84. n selected after the user application program reset the WDT with the WDT setting command It cannot be used after NMI occurrence CTi Automation Phone 800 894 0412 Fax 208 368 0415 Web www ctiautomation net Email info ctiautomation net 6F8C0894 55 Chapter 3 RAS Support Software 3 2 14 User Shutdown Command Syntax BOOL sts HANDLE hDevice sts XRasUserShutdown hDevice Argument hDevice RAS driver open handle Returned value If the command is normally completed TRUE is returned When error occurs FALSE is returned Explanation Command to instruct the RAS Support Software to execute the shutdown If the NMI occurrence message is received with the RAS message receive window setting command XRasUserWindow the user application program must do its own shutdown processing and issue this command or the user power off command KRasUserP owerdown When this command is issued the RAS Support Software starts the shutdown of WindowsNT If this command was not issued with the NMI message despite the fact that the user s window was set with the RAS message receive window setting command the shutdown of WindowsNT is automatically started assuming that this command was issued after the elapse of the user shutdown diagnosis time registered with the registry CTi Automation Phone 800 894 0412 Fax 208 368 0415 Web www ctiautomation net Email i
85. nd modules cannot be controlled Can t connect interrupt Failed to register interrupt Module check failed Module collation produced mismatch Detect illegal interrupt Illegal interrupt has occurred CTi Automation Phone 800 894 0412 Fax 208 368 0415 Web www ctiautomation net Email info ctiautomation net 22 model 2000 3000 Computer Module C2 C3 Windows NT Version 2 9 API References 2 9 1 CreateFile HANDLE CreateF ile LPCSTR DWORD DWORD IpszName fdwAccess fdwS hareMode LPSECURITY_ATTRIBUTElpsa DWORD DWORD HANDLE fdwC reate fdwAttrsAndF lags hTemplateF ile Driver file handle get Parameters IpszN ame fdwAccess fdwShareMode Ipsa fdwC reate fdwAttrsAndF lags hTemplateF ile 2 9 2 CloseHandle BOOL CloseHandle HANDLE Handle reset Parameters hDevice 6F 8C 0894 Driver name address Specify g3io Access mode 2 9 API References Specify OR of GENERIC_READ and GENERIC_WRITE Shared mode Specify OR of FILE SHARE_READ and FILE SHARE WRITE Address of security descriptor Notused Specify NULL File creating method Specify OPEN_EXISTING File descriptor Not used Specify 0 zero File handle with attribute to be copied Notused Specify NULL hDevice Driver handle gotten by CreateFile CTi Automation Phone 800 894 0412 Fax 208 368 0415 Web www ctiautomation net Email info ctiauto
86. nd detailed data They are stored in the buffer as shown below CTi Automation Phone 800 894 0412 Fax 208 368 0415 Web www ctiautomation net Email info ctiautomation net 46 model 2000 3000 Computer Module C2 C3 Windows NT Version 3 2 RAS Support Commands 0 Message ID ULONG 4 Detailed data ULONG e Fan stop message ID RASMSG FAN STOP This is transmitted when fan stop is detected e Fan recovery message ID RASMSG FAN STOP RECOVER This is transmitted when recovery is made after fan stop is detected e Temperature abnormality message ID RASMSG OVER THERMO This is transmitted when temperature abnormality is detected e Temperature recovery message ID RASMSG_OVER_THERMO_ RECOVER This is transmitted when recovery is made after temperature abnormality is detected e DI change message ID RASMSG DIO RASMSG _DI1 RASMSG_DI2 RASMSG_ DI3 This is transmitted when DI change is detected e NMI occurrence message ID RASMSG NMI This is transmitted when the first NMI is detected after the system starts up The NMI factor is set to the detailed data portion The following shows the content of the detailed data portion 31 5 43 2 1 0 Detailed data Power Key Off Remote Initialize WDT occurence After receiving this message the user must do the internal shutdown processing and issue the user shutdown command XRasUserS hutdown or the user power off command XRasUserP owerdown After NMI
87. nfo ctiautomation net 56 model 2000 3000 Computer Module C2 C3 Windows NT Version 3 2 RAS Support Commands 3 2 15 CPU Temperature Information Reading Command Syntax BOOL sts HANDLE hDevice LPLONG IpThermo sts XRasThermometer hDevice IpThermo Argument hDevice RAS driver open handle IpThermo Address to buffer in which CPU temperature information is stored Returned value If the command is normally completed TRUE is returned When error occurs FALSE is returned Explanation Command to read the CPU temperature information of a model which supports the CPU thermometer The information read indicates the temperature of 55 C to 125 C in the units of 0 5 C econ CPU temperature O0x000000FA 125 0 C 0x00000033 25 5 C 0x00000000 0 C OxFFFFFFFF 0 59C OxFFFFFFCE 25 0 C This command is effective only for models with the mechanism of CPU thermometer error occurs for other models CTi Automation Phone 800 894 0412 Fax 208 368 0415 Web www ctiautomation net Email info ctiautomation net 6F8C0894 57 Chapter 3 RAS Support Software 3 2 16 CPU Peripheral Temperature Information Reading Command Syntax BOOL Sts HANDLE hDevice LPLONG IpThermo sts XRasThermo hDevice IpThermo Argument hDevice RAS driver open handle IpThermo Address to buffer in which CPU peripheral temperature inform
88. nformation Messageld 1100 If this event is frequently logged replace the memory with the bank number and operate the system Messageld 2200 at start Factor Failure of main thread connection service to service control manager Message Service main thread connection to service control manager failed Data nil Messageld 2201 at start Factor Failure of obtaining the registry information for service operation environment Message To obtain the registry information of the service operation environment failed Toshiba RAS service continues the startup processing under the environment of default Data nil Messageld 2202 at start Factor Failure of generating service supply thread Message Service supply thread generating failed Data nil Messageld 2203 at start Factor Failure of setting service main process thread specifying priority Message Service main process priority setting failed Start processing is continued at the priority 1 of default Data nil 1 gt Value of default priority is inserted Messageld 2204 at start Factor Failure of setting service supply thread specifying priority Message Service supply thread priority setting failed Start processing is continued at the priority 1 of default Data nil 1 The value of default priority is inserted CTi Automation Phone 800 894 0412 Fax 208 368 0415 Web www ctiautomation net Email info ctiautomation net 6
89. nvironment IRQ 5 OP Time Healthy Detection Use LED System WDT 66 31446 msec User WDT Prohibit Service Response Timeout 66 36666 msec User Shutdown Timeout 366 186666 msec i i Shutdown Timeout 688 366066 msec Refresh RAS Service Thread Priority 24 i j RAS Message ID WM USER 6x1666 RAS Hailslot Name XRASHSG RAS Mailslot Read Timeout 69668 msec OK Force Shutdown Timeout 246 126666 msec Simulator CTi Automation Phone 800 894 0412 Fax 208 368 0415 Web www ctiautomation net Email info ctiautomation net 6F8C0894 75 Chapter 3 RAS Support Software By pressing the DETAIL button detailed information of the RAS device driver can be displayed Driver Status Detail Dal Bi A 3 Fi oTe s Detail on registry information obtaining is Registry Information Acquisition shown Interrupt Normal Normal obtaining Service Response Timeout Normal Registry information could be read User Shutdown Timeout Normal correctly Shutdown Timeout Normal Obtaining eror System WDT Normal Registry infomation could not be read User WDT Normal correctly User WDT startup state Normal Healthy Detection Normal I 0 Address Conversion Detail on I O address converting is shown Normal converting RAS Board Basic Addr Normal Address could be converted Sys Ctrl Register Addr Normal NMI Mask Register Addr Normal Commenting eror RAS Board Alarm Addr No
90. o meaning if it is executed with a module already in a suspend state This function becomes an error if a specified I O module does not exist Parameters hDevice The driver handle gotten by CreateF ile cCh Channel specification 0 Basic unit 1 Channel 1 2 Channel 2 3 Channel 3 4 Channel 4 cUnit Unit No in each channel Counted beginning 0 cMod Module No in each unit Counted beginning 0 CTi Automation Phone 800 894 0412 Fax 208 368 0415 Web www ctiautomation net Email info ctiautomation net 6F 8C 0894 31 Chapter 2 1 0 Bus Support Software 2 9 15 lobusModulResume BOOL lobusModuleResume HANDLE hDevice CHAR cCh CHAR cUnit CHAR cMod Resets access inhibit of modules specified by cCh cUnitand cMod This feature is used when resuming access by software after completing an I O module change in an online state This feature will have no meaning if itis executed with a module already in a accessible state This function becomes an error if a specified I O module does not exist Parameters hDevice The driver handle gotten by CreateFile cCh Channel specification 0 Basic unit 1 Channel 1 2 Channel 2 3 Channel 3 4 Channel 4 cUnit Unit No in each channel Counted beginning 0 cMod Module No in each unit Counted beginning 0 CTi Automation Phone 800 894 0412 Fax 208 368 0415 Web www ctiautomation net Email info ctiautomation net 32 model 2000 3000 Computer Module C2 C3 Windows NT V
91. oards is used a ansion Unit 0 5 O12 PS Figure 2 1 Maximum Hardware Configuration of C3 2 Basic Unit CTi Automation Phone 800 894 0412 Fax 208 368 0415 Web www ctiautomation net Email info ctiautomation net 6F 8C 0894 7 Chapter 2 1 0 Bus Support Software 2 3 Software Configuration Win32 Application Security Subsystem User Mode Kernel Mode G3 I O I F DLL System Service Security Process Local Virtual O Manager Monitor Manager Procedure Memory G3 I O Driver Call Manager Kernel Hardware Abstraction Layer HAL HARDWARE Figure 2 2 G3 I O Support Software Configuration 2 3 1 API The API needed for an application to access an I O module is mounted as DLL The file name of DLL is g3iolib dll The API provides interfaces for data input and output various initializations module error information acquisition and other purposes 2 3 2 Service The service manages startup function registration when interrupts from the application are generated In case an I O module specified for startup is interrupted the user function registered in advance is executed The service manages batch input output data between the driver and application The parameters to specify operations by the batch input output feature are stored in the registry For the complete information see 2 7 Batch Input Output 2 3 3 Tool The tool is a GUI tool that operates on
92. port software are listed below CreateF ile W in32 e Getfile handle CloseHandle W in32 e Release file handle lobusGetMappedinfo e Getresult of automatic mapping lobusS etDiag e Specify execution of module diagnosis Equivalent to I O error map create fea ture lobusResetDiag e Reset module diagnosis execute lobusR egCallbackF unc e Specify callback function when interrupt is generated lobusRecvData e Batch input of data lobusS endData e Batch output of data lobusR ecvDataDirect e Direct data input lobusSendDataDirect e Direct data output lobusG etDiagInfo e Getresult of module diagnosis lobusDoBusReset e Issue bus reset command lobusModuleS uspend e Setaccess disable of I O modules lobusModulResume e Resetaccess disable of I O modules CTi Automation Phone 800 894 0412 Fax 208 368 0415 Web www ctiautomation net Email info ctiautomation net 1 6 model 2000 3000 Computer Module C2 C3 Windows NT Version 2 7 Batch Input Output 2 7 Batch Input Output This section describes operating principles of batch input and output in this support software and useful information for creating application programs ae me G3 1 0 Driver Input File uoneoddy Output File oS z uoneoddy Figure 2 3 Configuration of Batch Input Output Software 2 7 1 Operating Principles Batch input and output is accomplished by interaction among the I O driver g3iodrv sys I O service g3iosrv exe
93. r matters in using Windows NT4 0 on the Computer Modules of the Integrated Controller The reader is invited to read manuals published by Microsoft and books sold in bookstores for the full information on Windows NT CTi Automation Phone 800 894 0412 Fax 208 368 0415 Web www ctiautomation net Email info ctiautomation net 6F8C0894 1 Chapter 1 Windows NT 1 1 Precautions Power Supply Turning the power off before normal ending of Windows NT may damage the file system and important files In the worst case Windows NT cannot potentially be started Make certain to execute finish processing of Windows NT before turning the power off Also make certain to supply the power that is always stable Detection of Abnormal Temperature If the operating environment is not suitable the inside temperature of the main unit may exceed the specified value which potentially presents a hazard of a system fault due to equipment malfunction The C2 C3 monitors the CPU temperature through the RAS feature and generates an alarm in case the temperature exceeds a preset value currently 55 C to notify a trouble Itis strongly recommended that application systems incorporate a program that detects this alarm The program should inform the operator about a trouble and stop the system till the cause for a temperature error is removed when it receives such notice See the XrasUserWindow Command in RAS Support Software in chapter 3 fora method
94. re could not be obtained This error like the converting error restricts the operation of the RAS Support Software The following shows the definition of bits to correspond to the information IERES_RES Hardware resource acquisition abnormality bit IERES_ SHUTDOWN Shutdown routine registering abnormality bit e InzErrint interruption error information This indicates that the interruption handler of the RAS Support Software could not be registered This error like the converting error restricts the operation of the RAS Support S oftware The following shows the definition of bit to correspond to the information IEINT CONNECT Interruption registering abnormality bit e InzErrNmi NMI error information This indicates that the NMI handler of the RAS Support S oftware could not be registered This error like the converting error restrics the operation of the RAS Support S oftware The following shows the definition of bit to correspond to the information IENMI DESCRIPTOR NMI registering abnormality bit CTi Automation Phone 800 894 0412 Fax 208 368 0415 Web www ctiautomation net Email info ctiautomation net 42 model 2000 3000 Computer Module C2 C3 Windows NT Version 3 2 RAS Support Commands e RasAlive RAS board error information This indicates ifthe RAS board is inserted If the RAS board is inserted TRUE is set or if itis notinserted FALSE is set This information becomes valid when InzErrAdr InzErrRes Inz
95. reen 1 red The indication may be used by the healthy signal of the RAS Support S oftware and in such a case care must be taken The indication when power is turned on is green CTi Automation Phone 800 894 0412 Fax 208 368 0415 Web www ctiautomation net Email info ctiautomation net 50 model 2000 3000 Computer Module C2 C3 Windows NT Version 3 2 RAS Support Commands 3 2 9 User RAS Memory Reading Command Syntax BOOL sts HANDLE hDevice DWORD dwAdr DWORD dwS ize LPUCHAR lpBuffer sts XRasReadMemory hDevice dwAdr dwSize lpBuffer Argument hDevice RAS driver open handle dwAdr User RAS memory leading address dwSize Numberof bytes to be read lpBuffer Address of buffer in which data read are stored Returned value If the command is normally completed TRUE is returned When error occurs FALSE is returned Explanation Command to read the data of the user RAS memory portion Since the RAS Support Software does not operate this user RAS memory the user can use it freely The following table shows the range of leading address and the range of the number of bytes to be read of the argument The leading address number of bytes to be read must not exceed the size of the user RAS memory Range of leading Range of number of ERAS MEMON size address bytes to be read 65312 bytes 0 65311 1 256 CTi Automation Phone 800 894 0412
96. river processes data input output from applications via API and initialize requests Operations of this driver are transparent to the application program CTi Automation Phone 800 894 0412 Fax 208 368 0415 Web www ctiautomation net Email info ctiautomation net 6F8C0894 9 Chapter 2 I O Bus Support Software 2 4 Precautions on Use of This Software This software implements the features provided by S3 and S2 designed exclusively for 1 O module control The integrated controller basically differs from the so called PLC in hardware and software and an application system must be designed heeding to the following when constructing an application system 2 4 1 Specification Limitations and Cautions In case more than one controller are installed in the same basic unit only one controller installed in Slot 0 can control the I O modules The interrupt response time may vary depending on the system environment hardware and software configurations and other elements Intervals of interrupts from modules that may generate interrupts such as CDDIs and intervals of timer interrupts by software must be designed taking the load of the entire system into consideration If intervals are too short the response performance of the entire system may be lowered A feature equivalent to the fixed time scan feature in S3 can be implemented using Win32API The interval accuracy depends on the features and performance provided by Windows NT Dep
97. rmal Address could not be converted Thermo meter Addr Normal Other H W Resource Acquire Normal SUSI LEU ee Detail on starting information of the driver Registration Normal ic houn Interrupt Handler IS Be ack i Registration Normal Nonmal obtaining registering NMI Handler Registration Normal Could be normally obtained registered O biaining registering error Could not normally be btained registered CTi Automation Phone 800 894 0412 Fax 208 368 0415 Web www ctiautomation net Email info ctiautomation net 76 model 2000 3000 Computer Module C2 C3 Windows NT Version 3 5 RAS Windows 3 5 3 Service For the service item the following information related to the RAS service is displayed e Version The version information of the RAS service is displayed e Status The start information of the RAS service is displayed Display Content Normal RAS service is normally operating Not started RAS service is not started Unknown RAS driver is not installed 3 5 4 Application For the application related item the following information related to message informing is displayed e RAS window Display Content User window caption and window User window is set handle Not started RAS service is not started Unknown RAS driver is not installed e User window Display Content RAS window caption and window RAS window is normally operating handle Not norma
98. s Time XRAS TimerShutdown 66 3 3 8 RAS Service Thread Priority XRAS Service ServicePriority 66 3 3 9 RAS Message ID XRASService MessagelD 67 3 3 10 RAS Mail Slot Name XRAS Service Mailslotname 67 3 3 11 RAS Mail Slot Receiving Diagnosis Time XRAS Service MailslotReadTimeOut 67 3 3 12 Forced Shutdown Diagnosis Time XRAS Service TimerForceShutdown 67 3 3 13 RAS Window Start Style XRAS Window Startup 68 3 3 14 RAS Window Object Name XRASWindow ObjectName 68 3 3 15 Normal Window Position X XRAS Window NormalPos x 68 3 3 16 Normal Window Position Y XRASWindow NormalPos y 68 3 3 17 Mini Window Display Level XRAS Window MiniLevel 68 3 3 18 Mini Window Position X XRAS Window MIniPoOsS K 68 3 3 19 Mini Window Position Y XRASWindow MIniPOS y 68 3 3 20 RAS Include File Install P ath XRAS Window InstPathInclude 68 3 3 21 RAS Library File Install Path XRAS Window InstPathLibrary 69 3 3 22 Option XRAS Option 69 3 4 RAS Shutdown Processing 70 3 4 1 Shutdown Operation 70 3 4 2 Restrictions on WindowsNT shutdown in the RAS Support Software 71 3 5 RAS WINGOWS lt 4
99. s are subject to change depending on the labels on the main unit CTi Automation Phone 800 894 0412 Fax 208 368 0415 Web www ctiautomation net Email info ctiautomation net 6F8C 0894 I 1 Safety Precautions during Installation WARNING Mandatory Make certain to ground the transmission paths by grounding with 100E or less ground resistance exclusively for each segment Ground at one point Noncompliance may cause transmission errors Noncompliance may cause an electric shock or a fire CAUTION Mandatory Avoid installing or storing the controller in the following environment e A dusty place A place in which a corrosive gas SO gt H2S or combustible gas generates A place subjected to vibration or shocks exceeding permissible values A place that causes condensation due to sudden temperature changes Low or high temperature outside of installation conditions High humidity outside of installation conditions Direct sunshine e Near equipment that emits a strong radio wave or magnetic field Mandatory Do not impress high voltage to a connector or a terminal board exceeding rated voltage such as 100V AC Always connect to correct polarity Incorrect polarity may cause an elec tric shock ora fire Mandatory Install the equipment in a place affording easy maintenance servicing and checks Otherwise a trouble may be caused during a failure resu
100. sage lt lt last shutdown information gt gt Shutdown trigger 1 Reset occurrence cause 2 3 Data last RAS memory content 112 bytes 1 Cause for triggering the shutdown is inserted Initialize key off remote initialize etc 2 When resetting occurs the cause is inserted AC fail system WDT system memory abnormal PCI bus system error etc 3 gt When system down due to panic occurrence is detected the fact is inserted This event is logged only when the Toshiba RAS service is started for the first time Therefore no logging is done when the service is restarted during system operation Messageld 1200 during operation Factor recovery from fan stopping Message Recovery was made from fan stop state Data nil CTi Automation Phone 800 894 0412 Fax 208 368 0415 Web www ctiautomation net Email info ctiautomation net 94 model 2000 3000 Computer Module C2 C3 Windows NT Version 3 6 Event Log Information Messageld 1201 during operation Factor recovery from the state of internal temperature abnormality Message Normal recovery was made from abnormal state of internal temperature Data nil Messageld 1300 at start Factor NMI occurs while the NMI Trigger Information Function is running Message lt lt Previous NMI trigger information gt gt Data NMI trigger information In NMI trigger information the first 16 bytes is the header of the NMI trigger information the next 12
101. splay Layer Mini Window Pos x 8 p Mini Window Pos x Mini Window Pos y 6 Mini Window Pos y Default Continue Default button Apply button New Environment Setting e Start style The start style of the RAS window is set e Object name Object name to be used by the RAS window is set e Main position X Y The position of the main window is set e Mini display level The display level of the mini window is set e Mini position X Y The position of the mini window is set e Default button All the registry set information is set to the default value e Set button By pressing the set button the registry information is actually registered CTi Automation Phone 800 894 0412 Fax 208 368 0415 Web www ctiautomation net Email info ctiautomation net 6F8C0894 89 Chapter 3 RAS Support Software 3 5 18 Mini Window The mini window is an icon version of the main window and from this window development can be made to various windows And it displays real time the power fan information and internal temperature information If the lower half area RAS logo portion power fan information portion internal temperature information portion of the mini window is moved while pressing with the left button of the mouse the mini window moves following the mouse cursor If the RAS board is not installed or the RAS device driver is not installed the buttons of DIO window WDT window and alarm window are ma
102. stering was abnormal bit to correspond to that information is set In such a case the default value is used for the registered value for starting up The following shows the definition of bits to correspond to information IEREG_INTERRUPT Interruption No abnormality error IEREG_ SERVICE Service shutdown diagnosis time abnormality bit IEREG_USER User shutdown diagnosis time abnormality bit IEREG_SHUTDOWN Shutdown execution diagnosis time abnormality bit IEREG_SWDT System WDT abnormality bit IEREG_ HEALTHY Healthy signal abnormality bit e InzErrAdr converting error information This indicates that the I O address used by the RAS Support S oftware could not be converted to the address controlled by WindowsNT If this error occurs the RAS Support Software cannot normally operate and no interruption processing is done if Power key is turned power is turned off What can be used is only the open close version reading and driver error information reading commands The following shows the definition of bits to correspond to the information IEADR_RAS 0x0140 to 0x016F converting disability bit IEADR_SYSCON 0x0061 converting disability bit IEADR_NMI 0x0070 to 0x0071 converting disability bit IEADR_OPL 0x0178 to 0x017B or 0x0388 to 0x038B converting disability bit IEADR_THM 0xC 140 to 0x141 converting disability bit e InzErrRes resource error information This indicates that the hardware resource to be used by the RAS Support Softwa
103. t is necessary to register all the following registry information they are automatically registered by installing the RAS Support S oftware If the registered value of each entry of parameter is abnormal it operates using the default value Registry information of RAS drive Under HKEY_LOCAL_MACHINE SYSTEM CurrentC ontrolS et S ervice XRAS registry key Value entry name Type Default value ErrorC ontrol REG_DWORD 0x01 Group REG SZ Extended Base Start REG_DWORD 0x02 Type REG_DWORD 0x01 Version REG_SZ Version No of this Support S oftware Under HKEY_ LOCAL _MACHINE SYSTEM CurrentC ontrolS et S ervice X RAS YP aram eters registry key Name Value entry name Type Default value Interruption No Interrupt REG_DWO RD 0x05 Healthy signal HealthyDo REG_DWORD 0x04 System WDT SystemW dt REG_DWORD 60 User WDT UserWdt REG_DWORD 0 Service shutdown diagnosis time TimerService REG_DWORD 60 User shutdown diagnosis time TimerUser REG_DWORD 360 Shutdown execution diagnosis time TimerS hutdown REG_DWORD 600 Option Option REG_DWORD 0x00 3 3 2 Registry information of RAS service CTi Automation Phone 800 894 0412 Fax 208 368 0415 Web www ctiautomation net Email info ctiautomation net 64 Under HKEY_LOCAL_MACHINE SYSTEM CurrentC ontrolS et S ervice X RAS Service registry key Value entry name Type Default val
104. tage normal 0 voltage short CTi Automation Phone 800 894 0412 Fax 208 368 0415 Web www ctiautomation net Email info ctiautomation net 6F8C0894 59 Chapter 3 RAS Support Software 3 2 18 Switch Status Read BOOL XRasGetS witch tati HANDLE hDevice LPDWORD IpdwS witch Gets the status of the 4bit DIP switch of the main unit Parameters hDevice The driver handle gotten by CreateFile lpwSize Shows status of the DIP switch 1 ON 0 OFF 31 eee 3 2 1 0 eee eee SW4 SW3 SW2 SW1 SW1 Status of Switch 1 SW2 Status of Switch 2 SW3 Status of Switch 3 SW4 Status of Switch 4 CTi Automation Phone 800 894 0412 Fax 208 368 0415 Web www ctiautomation net Email info ctiautomation net 60 model 2000 3000 Computer Module C2 C3 Windows NT Version 3 2 RAS Support Commands 3 2 19 Hardware Revision Read BOOL XRasGetHardwareR evision HANDLE hDevice LPDWORD IpdwR evision ii Gets the hardware revision information Parameters hDevice The driver handle gotten by CreateF ile IpdwR evision Shows the hardware revision by the following format 31 F B A 8 7 4 3 0 Peripheral Board Main Board ceceo Revision Number of Revision N umber of revisions revisions The information is composed of the version and number of revisions for the main and peripheral boards Revisions are increased in number 0 for Version A 1 for Version B and 2 for Version C
105. tered with the registry The interruption No is 5 e Non maskable interruption WDT Power Supply off AC voltage decrease or Sys tem memory parity error Multi bit error becomes the interruption signal CTi Automation Phone 800 894 0412 Fax 208 368 0415 Web www ctiautomation net Email info ctiautomation net 6F8C 0894 33 Chapter 3 RAS Support Software 3 1 3 Automatic Shutdown Function When the non maskable interruption occurs the automatic shutdown processing is done In the following cases however hardware resetting is done e When AC voltage decrease system memory parity error multi bit error or PCI bus system error was detected e When the non maskable interruption continues for about 2 seconds or longer 3 1 4 RAS Information Processing Function RAS information when starting during operation and when ending is logged in the WindowsNT eventlog Itis also possible to write in and read from the non volatile memory 3 1 5 Get DIP Switch State This feature reads the ON OFF state of the 4bit DIP switch installed on the front panel of the equipment 3 1 6 LED Lighting Control This software controls LED 0 which is installed as a standard provision as follows Extingu RAS Service Start Recovery from Abnormality has abnormal condition occurred Temperature trouble e recovery NMI has occurred Fan stop recovery Temperature error Fan stop 3 1 7 Functions of RAS Software Pro
106. tiautomation net Email info ctiautomation net 6F8C0894 85 Chapter 3 RAS Support Software 3 5 14 Event log information The event log information logged by the RAS Support Software is displayed seguentially from the newest information By double clicking on each event of the event log information with the mouse the detailed information of the eventis displayed Time Event type EventID Computer name Date Event description Event source 2 as SS Se Date 68 67 97 EventID 1166 Time 20 27 37 Source FA3166RAS Computer SEKIGOGO Type Info Description lt lt Previous Shutdown Information gt gt Trigger of Down Initialize Key off 3 h 5 6 7 8 A B C D E F 6000 5a 14 14 88 6b af e9 33 b1 b e9 33 b3 b e9 33 6010 01 66 66 61 61 61 66 61 3a 88 16 OG 3c 98 05 88 6626 3c 66 68 61 58 62 O4 OA FF FF O2 44 01 86 O8 66 6030 00 1f 66 66 66 66 66 HA OG 66 HA OG OO 66 88 AG gt i Next i 5 123 Previous event button Next event button Event count Event data Date Date of this event log logged is displayed e Time Time of this event log logged is displayed e Computer name The computer name which logged this event log is displayed e EventID The event message identifier of the RAS Support Software is displayed e Event source The indentifier of the event log logged by the RAS Support Software is displayed e Event type The type information warning error of this event is displayed e Event explana
107. tion The explanation of this event log is displayed e Event data Data attached to this event log are displayed e Preceding event button For moving to a newer event than this event log e Next event log For moving to an older event than this event log e Event count The count value of the event log displayed in this window is displayed In case of 1 256 display there are 256 events in total and of them the newest event is displayed CTi Automation Phone 800 894 0412 Fax 208 368 0415 Web www ctiautomation net Email info ctiautomation net 86 model 2000 3000 Computer Module C2 C3 Windows NT Version 3 5 RAS Windows 3 5 15 Registry Window The registry window is to set the registry information of the RAS Support Software When the registry window is opened the present set information is displayed It should be noted that this registry information is not necessarily same as the information under the environment of the RAS Support Software now operating the environment presently in operation can be checked through the status window This setting becomes valid when WindowsNT is shut down once and then restarted Environment Setting Ed Select Environment Driver related button Window related button Window a Extended function T Expansion RAS memory functions button If the log in user does not have the right to rewrite the registry all the settings through this window are made invalid
108. to detect a temperature error by a specific application program File Backing Up Back up important files from time to time by copying files into backup files Important files cannot be restored in case they are lost by an unanticipated accident unless they are stored in backup files Changing Registry Value Changes of the registry which stores set values and registration information of Windows NT require very careful execution If an error is made in making a change system startup may be disabled Service Pack Installation Reinstall the Service Pack when the system configuration is added or changed such as network protocol addition Caution for setting memory space addresses for PCMCIA card Note that memory addresses 0xC 8000 to OxCA000 cannot be used for a PCMCIA card or other card when mounting a card to use memory spaces in PCMCIA slots This is not shown in the Windows NT resource display but a graphic chip also uses these addresses 1 A collection of Windows NT bug correction modules supplied by Microsoft The Service Pack is stored in the root directory of Drive C in SP 6a or other name CTi Automation Phone 800 894 0412 Fax 208 368 0415 Web www ctiautomation net Email info ctiautomation net 2 model 2000 3000 Computer Module C2 C3 Windows NT Version 1 2 Initialization 1 2 Initialization When shipped from the factory Windows NT is set as follows Version Windows NT4 0 Workstation Build
109. ts results of automatic mapping by lobusGetMappedinfo Option 3 Registers callback function for interrupts by lobusRegCallbackFunc Option 4 Specifies module diagnosis during I O execution by lobusSetDiag Option 5 5 Issues lobus R ecvData S endData R ecvDataDirect S endDataDirect and executes batch data input and output and direct input and output Executes registration functions when an interrupt generates or ata fixed cycle 6 Repeats Step 5 fora necessary number of operations 7 Releases the file handle gotten in Step 1 by CloseHandle WIN32 API and ends the flow Functions are provided by g3iolib dll and g3iolib lib and these functions are prefixed lobus When using each function include Header File g3iolib h The files will be stored in the following positions C P rogram Files TO SHIBA G 310 bin g3iolib dll C P rogram Files TO SHIBA G 310 include g3iolib h C P rogram Files TO SHIBA G 310 lib g3iolib lib CTi Automation Phone 800 894 0412 Fax 208 368 0415 Web www ctiautomation net Email info ctiautomation net 1 4 model 2000 3000 Computer Module C2 C3 Windows NT Version 2 6 API Directories and libraries are set as follows in Visual C 445 0 and subsequent versions of Microsoft e Directory Setting Seta directory to search header files and library files 1 Select Option O in the Tool T Menu 2 Select Directory Tab 3 Select Include File in D
110. tton the indication color of the LED 0 selected with the select button is actually displayed in the LED of the front panel of the equipment CTi Automation Phone 800 894 0412 Fax 208 368 0415 Web www ctiautomation net Email info ctiautomation net 80 model 2000 3000 Computer Module C2 C3 Windows NT Version 3 5 RAS Windows 3 5 9 WDT Window WDT window can process atthe GUI level the setting of WDT supported by the RAS Support Software When the WDT window is opened the present set information is displayed If the RAS board is notinstalled or RAS device driver is not installed the main window and mini window buttons are made invalid and this window cannot be opened User WDT xi Reset selection User WDT l Setting button button System Reset cj User Reset jProhibit Count WDT count ie nse c Reset 1 Count 524msec Reset button WDT time e Reset select button Button to select the resetting method of WDT Either system reset or user reset is selected WDT count Item to set the count value of WDT It can be set in the range of 2 to 255 counts 1 count 524ms If 0 is set WDT is prohibited e WDT time The time of the WDT count setis displayed If WDT is prohibited nothing is displayed e Set button By pressing the set button the WDT information set with the reset select button and WDT count is actually set e Reset button This is valid onl
111. ue DisplayName REG_SZ Toshiba RAS Service ErrorC ontrol REG_DWORD 0x01 ImageP ath REG_EXPAND_SZ S ystemR oot system32 XR assrv exe ObjectName REG_DWORD LocalS ystem Group REG_SZ Extended Base Start REG DWORD 0x02 Type REG_DWORD 0x110 model 2000 3000 Computer Module C2 C3 Windows NT Version Under 3 3 RAS Support Software Registering HKEY_LOCAL_MACHINE SYSTEM CurrentC ontrolS et S ervice XRAS S erviceYP ara meters registry key Name Value entry name Type Default value RAS service thread priority ServiceP riority REG_SZ Normal RAS message ID MessagelD REG_DWORD 0x1000 RAS mail slot name MailslotName REG_SZ XRASMSG RAS mail slot receiving diagnosis MailslotReadTimeOut REG_DWORD 60000 time Forced shutdown diagnosis time TimerForceShutdown REG_DWORD 240 3 3 3 Registry information of RAS window Under HKEY_LOCAL_MACHINE SYSTEM CurrentC ontrolS et C ontrol XR AS Windowregistry key Name Value entry name Type Default value RAS window start style Startup REG_SZ Normal RAS window object name ObjectName REG_SZ XRASWINDOW Normal window position X NormalP os x REG_DWORD 0 Normal window position Y NormalPos y REG_DWORD 0 Mini window display level MiniLevel REG_SZ TopMost Mini window position X MiniP os x REG_DWORD 0 Mini window position Y MiniP os y REG_DWORD 0 RAS include file install path InstP athInclude REG_SZ No default
112. ult 4 Safety Precautions in Daily Operation amp WARNING Mandatory Make certain to check that the power supply capacity frequency voltage and regulation meet the equipment specification Otherwise the controller will not be able to demonstrate its design performance and may cause equipment damage a fire due to overheating or other trouble iv Mandatory In case the ambient or internal temperature of the equipment increases abnormally or the equipment fails stop operating and turn the power off to the equipment Then contact the Toshiba distributor in your area Continuing to operate the equipment without taking any action may result in a fire due to overheating or other trouble CTi Automation Phone 800 894 0412 Fax 208 368 0415 Web www ctiautomation net Email info ctiautomation net model 2000 3000 Computer Module C2 C3 Windows NT Version Z CAUTION Forbidden Do not touch the ICs terminals connectors solder surfaces or other parts inside the modules except the operation section setting switches inside the module Otherwise ICs LSIs or other devices may be destroyed by static electricity resulting in a failure An injury by the terminal of a parts lead wire or a burn by a high temperature part may result Forbidden Do not bend pull or twist the power cord or cable too strongly This may cause wire breakage or heating
113. ures em or atie Stemperct ures om or eMective CTi Automation Phone 800 894 0412 Fax 208 368 0415 Web www ctiautomation net Email info ctiautomation net 48 model 2000 3000 Computer Module C2 C3 Windows NT Version 3 2 RAS Support Commands In C2 C3 DI DO information does not have any meaning Detailed trouble information of each sensor can be read in Bits 31 to 16 of a read value e Bits 31 to 24 Data whether each sensor is effective 1 or not effective 0 is stored e Bits 23 to 16 Status of each sensor 0 normal 1 abnormal is stored Bit 24 0 fan sensor 25 26 27 28 0 temperature sensor 29 30 31 CTi Automation Phone 800 894 0412 Fax 208 368 0415 Web www ctiautomation net Email info ctiautomation net 6F 8C 0894 49 Chapter 3 RAS Support Software 3 2 8 LED Indication Command Syntax BOOL sts HANDLE hDevice DWORD dwLed sts XRasPowerLed hDevice dwLed Argument hDevice RAS driver open handle dwLed Power LED indication information Returned value If the command is normally completed TRUE is returned When error occurs FALSE is returned Explanation Command to make green red the indication color of LED on the front of equipment The following figure shows the contents of the LED indication information of the argument 31 0 __ Indication color 0 g
114. uter Module C2 C3 Windows NT Version 3 2 RAS Support Commands 3 2 2 Close Command Syntax BOOL sts HANDLE hDevice sts CloseHandle hDevice Argument hDevice RAS driver open handle Returned value If the device could be normally closed TRUE is returned When error occurred FALSE is returned Explanation Command to close the RAS driver CTi Automation Phone 800 894 0412 Fax 208 368 0415 Web www ctiautomation net Email info ctiautomation net 6F8C0894 39 Chapter 3 RAS Support Software 3 2 3 RAS Support Software Version Reading Command Syntax BOOL sts HANDLE hDevice LPDWORD IpVersion sts XRasGetVersion hDevice IpVersion Argument hDevice RAS driver open handle IpVersion Address to the buffer in which the version is stored Returned value If the command is normally completed TRUE is returned When error occurs FALSE is returned Explanation Command to read the version of the RAS Support S oftware The following shows the format to be stored in the buffer 31 16 15 8 7 0 Revision No Version No Reserved In case of V0I 02 0x01 is entered for the version and 0x02 for the revision CTi Automation Phone 800 894 0412 Fax 208 368 0415 Web www ctiautomation net Email info ctiautomation net 40 model 2000 3000 Computer Module C2 C3 Windows NT Version
115. view the online help which is equivalent to this manual About Toshiba RAS Window x Sis Toshiba RAS Window XRasWin exe U61 64 FN Copyright C 1996 97 TOSHIBA Corporation All Rights Reserved e Window button Each window is opened by pressing each window button status DIO WDT RAS memory event log registry e Mini window button By pressing the mini window button the main window is closed and the mini window is opened e RAS window end button By pressing the RAS window end button the RAS window is ended CTi Automation Phone 800 894 0412 Fax 208 368 0415 Web www ctiautomation net Email info ctiautomation net 74 model 2000 3000 Computer Module C2 C3 Windows NT Version 3 5 RAS Windows 3 5 2 Status Window The status window is to display the status information of the RAS Support Software By pressing the REFRESH button the information displayed is updated Status x Board 7 Status Normal Machine Type FA3166Amode17166 Inc RAS Mirroring Disk Support Using Standard Disk RAID Mirroring Disk Status Driver Version 61 6A Status Normal Detail Version 81 8A Status Normal Service Application RAS Window Toshiba RAS Window 6x 6669 66b4 User RAS Window Not Used RAS Mailslot Handle Not Used Alarm Window Sensor Detection Inside Temp Normal CPU Temp 36 6 C Battery Normal Fan Status Normal CPU Ex Temp 28 5 C Trend E
116. w Window to display the information of RAS Support Software DIO window Window for setting DI information display DO output and DI interruption WDT window Window to display present WDT state and set WDT Alarm window Window to output alarm sound RAS memory window Window for reading writing of user RAS memory and displaying system RAS memory Event log window Window to display event information on RAS Support S oftware Registry window Window to display and change registry information on RAS Support S oftware DIO window Status window WDT window Main window Standard size Small size Alarm window Event log window CTi Automation Phone 800 894 0412 Fax 208 368 0415 Web www ctiautomation net Email info ctiautomation net 72 model 2000 3000 Computer Module C2 C3 Windows NT Version 3 5 1 CTi Automation Phone 800 894 0412 Fax 208 368 0415 Web www ctiautomation net Email info ctiautomation net 6F 8C 0894 Main Window 3 5 RAS Windows The main window is the basic window of the RAS window and from this window development is made to various windows If the RAS board is not installed or RAS device driver is not installed the buttons of DIO window WDT window alarm window and RAS memory window are made invalid and they cannot be opened If the desk top area is made smaller or font size is made larger the whole of the RAS window may not be displayed on the screen In such a case th
117. wS ize LPUCHAR lpBuffer sts XRasReadSysMemory hDevice dwAdr dwSize lpBuffer Argument hDevice RAS driver open handle dwAdr Leading address of system RAS memory dwSize Number of bytes to be written lpBuffer Address of buffer in which data written are stored Returned value If the command is normally completed TRUE is returned When error occurs FALSE is returned Explanation Command to read the data of the user RAS memory portion Since this system RAS memory is used by the RAS Support Software no writing can be done The leading address of the argument is in the range of 0 to Oxff and the number of bytes to be read must be specified within the range of 1 to 0x100 The addresses 0xe0 to Oxff correspond to 0x00 to 0x1f of user RAS memory and same contents can be read The leading address number of bytes to be read must not exceed 0x100 CTi Automation Phone 800 894 0412 Fax 208 368 0415 Web www ctiautomation net Email info ctiautomation net 6F8C0894 53 Chapter 3 RAS Support Software 3 2 12 WDT Setting Command Syntax BOOL sts HANDLE hDevice DWORD dwWDT sts KRasWDT hDevice dwWDT Argument hDevice RAS driver open handle dwWDT WDT setting information Returned value If the command is normally completed TRUE is returned When error occurs FALSE is returned Explanation Command to set Watchdog Timer WDT
118. xtension portion of the user RAS memory can be displayed edited by pressing the extension memory button With a system not supporting the extension RAS memory the button is made invalid and clicking cannot be done Ex RAS Memory Address 00009 0 1 2 3 4 5 6 7 8 9 a th c d e f 0123456789abcdef fd 40 e7 08 5d al cf 08 7f 01 cf 00 d3 00 ff Ib 00 7d 40 be 31 fb Ob fe 00 ff 20 e9 18 cf 00 30 1 7f 00 f9 50 6f 00 da 01 de 05 fe e0 fb 04 di d ff 42 7f 42 5e 90 ff 31 ff b3 Sf 02 ff 08 7b e6 B ff O1 ff 61 Sf 00 fe 80 fd 81 ff 12 ff Oc df cf ff 22 bd 00 fd 10 ff 19 f7 58 ae 09 ff 06 f7 fe ff 00 bf 05 ff 40 9b 28 ee 08 b5 90 ff 00 ee e df 00 f fd 04 f 2 tf ff 00 ff 13 CECO A BEA 205bi 062 ter tr araor eale a ff 05 3 00 e 08 7d 85 ef 50 ff 07 ff ce 62 fb 43 73 00 7f Oc df 70 bb 20 f6 05 f7 0 ff 04 58 00 6e 40 ff 03 bd 00 f 08 7f 90 7f bf K ff 08 ac 28 fb 46 f7 03 bb 00 b 10 5f 20 bb 78 F ff 10 df 43 7a 49 f7 24 ff 08 7f 40 df 02 ff Of ff 55 ff 00 ff e8 ff 20 bf 02 f7 40 ef 40 ff 3f U ff 50 ff 00 7f 00 b 00 fe 66 7f 00 5f 18 fb ch ff 41 bf 60 ff f0 f5 10 af 28 8f 10 fb 08 ff 7e AA Write Address 00000 Data xtd Write OK CTi Automation Phone 800 894 0412 Fax 208 368 0415 Web www ctiautomation net Email info ctiautomation net 6F8C 0894 83 Chapter 3 RAS Support Software User memory correction button
119. y the LED lighting status by the following format 3 e COL3 COL2 COL1 COLO LED3 LED2 LED1 LEDO LEDO Specify 1 LEDO lit 0 extinguished LED1 Specify 1 LED1 lit 0 extinguished LED2 Specify 1 LED2 lit 0 extinguished LED3 Specify 1 LE D3 lit 0 extinguished COLO Specify 1 LEDO color red 0 green COLI Specify 1 LED1 color red 0 green COL2 Specify 1 LED2 color red 0 green COL3 Specify 1 LED3 color red 0 green dwMaskS pecify whether or not LED operation is required by the following mapping If Specified lighting of the LED is controlled in accordance with specification by dwState If Not specified the state before this function is issued will be maintained regardless of dwS tate setting MASK3 MASK2 MASK1 MASKO MASKO Specify 1 LEDO lit 0 extinguished MASK1 Specify 1 LED1 lit 0 extinguished MASK2 Specify 1 LED2 lit 0 extinguished MASK3 Specify 1 LED3 lit 0 extinguished Caution LED 0 can be controlled while the RAS service is in operation The difference with the xRASSetLed function is that this software can control individual LEDs CTi Automation Phone 800 894 0412 Fax 208 368 0415 Web www ctiautomation net Email info ctiautomation net 6F8C0894 63 Chapter 3 RAS Support Software 3 3 RAS Support Software Registering 3 3 1 For the RAS Support Software i
120. y when the WDT resetting method is the user reset and by pressing this button WDT resetting can be done 3 5 10 Alarm Window The buttons of the main and mini windows are made invalid CTi Automation Phone 800 894 0412 Fax 208 368 0415 Web www ctiautomation net Email info ctiautomation net 6F 8C 0894 81 Chapter 3 RAS Support Software 3 5 11 RAS Memory Window The RAS memory window can process at the GUI level the reading writing of the user RAS memory and reading of the system RAS memory supported by the RAS Support Software If the RAS board is not installed or the RAS device driver is not installed the main window and mini window buttons are made invalid and this window cannot be opened If the extended RAS memory functions Operating Time Monitoring Thermometer Trend and NMI Trigger Information are being executed the area in the extended memory which is available to the user becomes smaller Ex RAS Memory x Ex RAS Memory Address MAT User available area 00009 Oxdaif 8123456789abcdef Sina Maa 6123456789 lt gt 7 ABCDEFGHIJ Up KLMNOPQRSTUUWKY2 _ abcdefghij k1lmnopgrstuyuxyz Address 9x 9908 Data oxob Write OK e System RAS memory 000h to ODFh of the system RAS memory are displayed OE Oh OFFh are omitted because of the user RAS memory System RAS Memory F 6123456789abcdef 6666 5a 14 14 OG fd b2 e9 33 66 OG 66 66 OG 88 88 66 2 Li

Toshiba Computer Module C2/C3 Windows NT Version User`s Manual

Contents

Download Pdf Manuals

Related Search

Related Contents