Toshiba V Series User Manual
  1. Manuals
  2. Brands
  3. Toshiba Manuals
  4. Controller
  5. V Series
  6. User manual
Toshiba V Series User Manual

Toshiba V Series User Manual

Integrated controller
Hide thumbs Also See for V Series:
Table of Contents

Advertisement

Quick Links

Download this manual
6F8C0945
nfomation and Control Network Module TC-net 100
PC Bus Card Support Software User's Manual

Advertisement

Table of Contents
loading

Related Manuals for Toshiba V Series

Summary of Contents for Toshiba V Series

  • Page 1 6F8C0945 nfomation and Control Network Module TC-net 100 PC Bus Card Support Software User's Manual...
  • Page 2 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.
  • Page 3 Safety Precautions This manual contains important information for the operator to operate this product safely 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 Indicates a potentially hazardous situation which, if not avoided, WARNING could result in serious injury or death.
  • Page 4 1. Checking the Warning Labels on the Main Unit Make sure warning markings are attached on the main unit. If any of them are missing or the wording is illegible, contact Toshiba's Service Department. 2. Precautions on Installation WARNING Mandatory Be sure to ground the equipment.
  • Page 5 3. Safety Precautions on Maintenance and inspection WARNING Mandatory Mandatory Turn off power removing any modules after Turn off power removing or connecting any installing. modules, boards, or devices. Otherwise, exposed conductive parts of wire Otherwise, it can cause electrical shock, or or on the rear of terminal blocks can cause machine damage.
  • Page 6 User's manual. beyond normal range or if failure is occurred in Otherwise, it can cause malfunction, machine the equipment. damage or fire due to overheat. Contact Toshiba for repairing. Operation under such situation can cause fire or electrical shock. CAUTION Forbidden...
  • Page 7 Forbidden Forbidden Do not disassemble or modify the equipment. Do not enter wire scrapes or other foreign Otherwise, it can cause malfunction or failure. debris into the equipment. Also, do not insert metal parts into them. They can cause fire or accidents. 6.
  • Page 8 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.
  • Page 9 Preface This manual describes the software that supports data transfer over the information and control network TC-net 100 using a PC/AT compatible computer equipped with the JTNI series PCI bus card for the information and control network TC-net 100. This support software can be installed on the following operating systems.
  • Page 10 If the ambient temperature or the internal temperature of the equipment has arisen too high, or if the equipment has developed a fault, stop using it, switch power off, and contact the nearest Toshiba service station. Do not open the case of the equipment while it is in operation except when setting the switches.

  • Page 11: Table Of Contents

    CONTENTS 1 Installation ......1 1.1 General ........1 1.2 Install sequence for WindowsNT4.0 .
  • Page 12 CONTENTS 4 Device Driver ..... . 31 4.1 Registry Information ......31 4.2 List of Events .

  • Page 13: Installation

    Chapter 1 Installation 1.1 General This software is supplied on CD or floppy disks. Before you can use this software, you must install it according to the following procedure: (1) Uninstall the earlier version (if an earlier version of this software is installed) (2) Execute setup.exe (3) Restart the system 6F8C0945...

  • Page 14: Install Sequence For Windowsnt4.0

    Chapter 1 Installation 1.2 Install sequence for WindowsNT4.0 1.2.1 Uninstalling an Earlier Version If an earlier version of this software is already installed, you must first uninstall it. If you have added or modified the content of the registry used by this software, jot down the content before you uninstall.

  • Page 15: Executing Setup.exe To Install

    Execute the setup.exe contained in the floppy disk. Follow the instructions on the screen and proceed with the installation. The install directory is set to "C:\Program Files\Toshiba\TCNET100" by default. Do not change this directory unless it is absolutely necessary. Figure 1-3 Selecting the Install Destination...

  • Page 16: Restarting The System

    Chapter 1 Installation 1.2.3 Restarting the System Restart the system when installation completes and a message asking you to restart the system appears. Figure 1-4 Restarting Windows 1.2.4 Starting this Software This software does not start automatically when the system is started. Select [Control Panel] →...

  • Page 17: Install Sequence For Windows2000

    1.3 Install sequence for Windows2000 1.3 Install sequence for Windows2000 1.3.1 Uninstalling an Earlier Version If an earlier version of this software is already installed, you must first uninstall it. If you have added or modified the content of the registry used by this software, jot down the content before you uninstall.
  • Page 18 Execute the setup.exe contained in the CD or floppy disk. Follow the instructions on the screen and proceed with the installation. The install directory is set to "C:\Program Files\Toshiba\TCNET100" by default. Do not change this directory unless it is absolutely necessary.

  • Page 19: Starting This Software

    1.3 Install sequence for Windows2000 1.3.3 Starting this Software Make a right click of [My Computer] on the desktop to select a property. Select the [Hardware] tab in the system’s property window, and click [Device Manager]. Select [Scan for hardware changes] on the device manager action menu. Figure 1-9 Device manager The JTNI card is searched for by Plug-and-Play.
  • Page 20 Chapter 1 Installation A message appears asking you about searching for driver files, so delete all the check marks in the check boxes, and proceed to the next step. Figure 1-11 Locate Driver Files Recognize the appropriate install files are searched for, proceed to the next step. Figure 1-12 Driver files Search Results TC-net 100 PCI Bus Card Support Software User’s Manual...
  • Page 21 1.3 Install sequence for Windows2000 When the system has been started normally, the JTNI card is registered in the device manager. Figure 1-13 Registered JTNI card 6F8C0945...

  • Page 22: Install Sequence For Windows Xp

    Chapter 1 Installation 1.4 Install sequence for Windows XP 1.4.1 Uninstalling an Earlier Version If an earlier version of this software is already installed, you must first uninstall it. If you have added or modified the content of the registry used by this software, jot down the content before you uninstall.
  • Page 23 Execute the setup.exe contained in the CD or floppy disk. Follow the instructions on the screen and proceed with the installation. The install directory is set to "C:\Program Files\Toshiba\TCNET100" by default. Do not change this directory unless it is absolutely necessary.

  • Page 24: Starting This Software

    Chapter 1 Installation 1.4.3 Starting this Software Make a right click of [My Computer] to select a property. Select the [Hardware] tab in the system’s property window, and click [Device Manager]. Select [Scan for hardware changes] on the device manager action menu. Figure 1-17 Device manager The dialogue asking to connect to Windows Update is opened, so select "No, not this time".
  • Page 25 1.4 Install sequence for Windows XP The JTNI card is searched for by plug-and-play. When the card is found, a message appears asking you about the install method desired for the software; then select [Install the software automatically]. Figure 1-19 Install Device Driver When the system has been started normally, the JTNI card is registered in the device manager.

  • Page 26: Install Sequence For Windows Server 2003

    Chapter 1 Installation 1.5 Install sequence for Windows Server 2003 1.5.1 Uninstalling an Earlier Version If an earlier version of this software is already installed, you must first uninstall it. If you have added or modified the content of the registry used by this software, jot down the content before you uninstall.
  • Page 27 Execute the setup.exe contained in the CD or floppy disk. Follow the instructions on the screen and proceed with the installation. The install directory is set to "C:\Program Files\Toshiba\TCNET100" by default. Do not change this directory unless it is absolutely necessary.

  • Page 28: Starting This Software

    Chapter 1 Installation 1.5.3 Starting this Software Make a right click of [My Computer] to select a property. Select the [Hardware] tab in the system’s property window, and click [Device Manager]. Select [Scan for hardware changes] on the device manager action menu. Figure 1-24 Device manager The dialogue asking to connect to Windows Update is opened, so select "No, not this time".
  • Page 29 1.5 Install sequence for Windows Server 2003 The JTNI card is searched for by plug-and-play. When the card is found, a message appears asking you about the install method desired for the software; then select [Install the software automatically]. Figure 1-26 Install Device Driver When the system has been started normally, the JTNI card is registered in the device manager.

  • Page 30: Install Sequence For Windows Vista

    Chapter 1 Installation 1.6 Install sequence for Windows Vista 1.6.1 Uninstalling an Earlier Version If an earlier version of this software is already installed, you must first uninstall it. If you have added or modified the content of the registry used by this software, jot down the content before you uninstall.
  • Page 31 Execute the setup.exe contained in the CD or floppy disk. Follow the instructions on the screen and proceed with the installation. The install directory is set to "C:\Program Files\Toshiba\TCNET100" by default. Do not change this directory unless it is absolutely necessary.

  • Page 32: Starting This Software

    Chapter 1 Installation 1.6.3 Starting this Software Open the [Device Manager], and select [Scan for hardware changes] on the device manager action menu. Figure 1-31 Device manager The dialogue asking to install the device driver is opened, so select "Locate and install driver software".
  • Page 33 1.6 Install sequence for Windows Vista The dialogue asking to verify the publisher is opened, so select "Install this driver software anyway". Figure 1-33 Verification of publisher When the system has been started normally, the JTNI card is registered in the device manager.

  • Page 34: Install Sequence For Windows Server 2008

    Chapter 1 Installation 1.7 Install sequence for Windows Server 2008 1.7.1 Uninstalling an Earlier Version If an earlier version of this software is already installed, you must first uninstall it. If you have added or modified the content of the registry used by this software, jot down the content before you uninstall.
  • Page 35 Execute the setup.exe contained in the CD. Follow the instructions on the screen and proceed with the installation. The install directory is set to "C:\Program Files\Toshiba\TCNET100" by default. Do not change this directory unless it is absolutely necessary. Figure 1-37 Selecting the Install Destination...

  • Page 36: Starting This Software

    Chapter 1 Installation 1.7.3 Starting this Software Open the [Device Manager], and select [Scan for hardware changes] on the device manager action menu. Figure 1-38 Device manager The dialogue asking to install the device driver is opened, so select "Locate and install driver software".
  • Page 37 1.7 Install sequence for Windows Server 2008 The dialogue asking to verify the publisher is opened, so select "Install this driver software anyway". Figure 1-40 Verification of publisher When the system has been started normally, the JTNI card is registered in the device manager.

  • Page 39: Overall Software Structure

    Chapter 2 Overall Software Structure This chapter describes the overall structure of this support software. This support software provides the functions indicated by the shaded area in Figure 2-1. Host PC Tool Window application Win32 Socket I/F Scan memory API Fenix API User space TCP/IP・UDP/IP...

  • Page 40: Available Functions

    Chapter 2 Overall Software Structure 2.1 Available Functions This software provides the following functions to the application program. Each function is provided as DLL so the library must be linked when creating the application program. • Scan memory access This is an interface for accessing the scan memory space provided by the JNTI card. In addition to reading from and writing into scan memory, you can also register scan talker block, clear scan healthy map1, and read scan talker map.

  • Page 41: Application Development Notes

    Chapter 3 Application Development Notes 3.1 Installation Directory C:/Program Files/Toshiba/TCNET100 This software is installed in the above directory by default (assuming Windows is installed in drive C). 3.2 Include Files (tcnlib.h) The include files referenced from programs when creating an application program are placed in the installation directory.

  • Page 42: Starting And Ending Use Of Functions

    Chapter 3 Application Development Notes 3.4 Starting and Ending Use of Functions • When using APIs contained in tcnetapi.dll Call TcnCreateFile to obtain the handles required by subsequent functions and release them with TcnCloseHandle at the end of processing. TcnCreateFile Set scan transmission cycle Register scan talker block (only when transmitting from local station)

  • Page 43: Device Driver

    Chapter 4 Device Driver 4.1 Registry Information This device driver reads the following registry information in the parameter registry key from the registry table and sets the device driver execution environment. Default values are used for unregistered values and abnormal values. Registry type is all REG_DWORD.

  • Page 44: List Of Events

    Chapter 4 Device Driver 4.2 List of Events Table 4-2 shows a list of events provided by this device driver. When an event occurs, it is recorded in the Windows event log. You can check the system log by selecting Start → Program →...

  • Page 45: Tool Window

    Chapter 5 Tool Window A tool window software (TcnetWin.exe) to verify that functions are working properly is provided with this support software. This software can run through any of the functions provided with API. (10) Exit button Get buttons Reset JTNI button Clear buttons Register button Set, Get data buttons...
  • Page 46 Chapter 5 Tool Window (1) Exit button Reset JTNI button (2) Resets the JTNI card. Fenix register settings are initialized. (3) Register button Reads Fenix registers. (4) Save button Saves the output result to a file. Select the line to output as shown in Figure 5-2 and then click this button to display the save file dialog box.
  • Page 47 (5) Read/write scan memory Reads/writes the content of scan memory. Select between read and write with the Read and Write radio buttons. The selected action is reflected in the label of the Access button. To perform a Write, enter the hexadecimal offset address in the Address: edit box, the hexadecimal data in the data: edit box, and the decimal size in the Size: edit box.
  • Page 48 Chapter 5 Tool Window (8) Set, Get data buttons The Set and Get buttons are used to set or get data selected from the pull-down list. Scan cycle, Scan talker block, and Linkage are available in the pull-down list. A. Scan cycle Select Scan cycle from the pull-down list and click the command button to open the dialog box shown in Figure 5-3 where you can set the scan cycle.
  • Page 49 B. Scan talker block Select Talker block from the pull-down list and click the command button to open the dialog box shown in Figure 5-4 where you can set the scan talker block. Figure 5-4 Scan Talker Block Setting Dialog Box The High, Middle, and Low radio buttons indicate high-, middle-, and low-speed scan respectively.
  • Page 50 Chapter 5 Tool Window D. Linkage Select Link control from the pull-down list and click the command button to open the dialog box shown in Figure 5-5 where you can set the linkage. Figure 5-5 Linkage Setting Dialog Box Select Automatic for automatic linkage, Manual A for Fixed to A system, and Manual B for Fixed to B system.

  • Page 51: Usage Guide

    Chapter 6 Usage Guide This chapter describes the system planning and program design considerations for connecting a normal PC/AT compatible machine to the information control network TC- net 100. Also described in this chapter is the procedure for using the support library when actually using the JTNI card.

  • Page 52: Scan Transmission

    Chapter 6 Usage Guide 6.2 Scan Transmission 6.2.1 Scan Transmission Setup The following setup must be performed in order to use scan transmission: • Set scan transmission cycle • Set scan healthy cycle (automatically set to three times the set scan transmission cycle) •...

  • Page 53: Data Receive And Read

    6.2 Scan Transmission Also note that you cannot issue TcnSccSetCycle or TcnScmSetTalkerBlk during scan transmission. Issuing them will not cause an error, but there is no guarantee that the setting will be reflected and in some cases, scan transmission may stop working properly. When resetting the scan transmission cycle or scan talker block, be sure to stop scan transmission first and then restart it after resetting.

  • Page 54: Ras Information Block Of Scan Transmission

    Chapter 6 Usage Guide +0 H +2 H +4 H • • • • +7E H 1023 1022 1021 1010 1009 1008 +FE H 2047 2046 2045 2033 2032 2031 Figure 6-1 Scan Healthy, Unhealthy Map Organization SA: Station address +0 H Scan block No.

  • Page 55: Using Station Information

    6.3 Using Station Information 6.3 Using Station Information 6.3.1 In Ring Map This map shows the status of station entered in a logical ring. Up to 254 stations can enter a logical ring. TcnSccGetInringMap is used to obtain the in ring map. Refer to the description of the TcnSccGetInringMap function in the function reference section for the organization of the in ring map.

  • Page 57: List Of Functions

    Chapter 7 List of Functions Table 7-1 List of tcnetapi.dll Functions TcnCloseHandle Release handle TcnScmRead Read scan data TcnScmReadWithHealthy Read scan data (with healthy map) TcnScmWrite Write to scan data TcnSccSetControl Start/stop scan transmission TcnSccGetControl Read scan transmission state TcnSccSetCycle Set scan transmission cycle TcnSccGetCycle Read scan transmission cycle...

  • Page 59: Function Reference

    Chapter 8 Function Reference TcnCreateFile Name TcnCreateFile - Get access handle Type #include <tcnlib.h> HANDLE TcnCreateFIle(IN DWORD mdlid, OUT TcnCardinfo *p); Description Obtains the file handle necessary to use the functions provided by this support software. Specify the logical number of the JTNI card as the first argument. Specify 0 if only one JTNI card is installed.
  • Page 60 Chapter 8 Function Reference Example #include <windows.h> #include "tcnlib.h" HANDLE hDev; TcnCardInfo cardInfo; BOOL result; hDev = TcnCreateFile( 0, &cardInfo); if( hDev ) { printf("NumberOfCards = %ld, cardNumber = %d", cardInfo.NumberOfCards, cardInfo.cardNumber ); } else { printf("File Create Error! Code=%ld",GetLastError()); exit(1);...
  • Page 61 TcnCloseHandle Name TcnCloseHandle - Release handle Type #include <tcnlib.h> BOOL TcnCloseHandle(IN HANDLE hDevice); Description Called using the handle obtained with TchCreateFile as argument to release the handle when the use of the function provided with the support software is finished. Return Code TRUE is returned in case of normal end.
  • Page 62 Chapter 8 Function Reference TcnScmRead Name TcnScmRead - Read scan memory Type #include <tcnlib.h> BOOL TcnScmRead(IN HANDLE hDevice, IN DWORD dwOffset, IN DWORD dwSize, OUT LPBYTE lpBuf); Description Reads data in scan memory. hDevice : File handle obtained with TcnCreateFile dwOffset : Specify the offset of the scan memory data to be read in byte units.
  • Page 63 TcnScmReadWithHealthy Name TcnScmReadWithHealthy - Read scan memory with healthy map Type #include <tcnlib.h> BOOL TcnScmReadWithHealthy(IN HANDLE hDevice, IN DWORD dwOffset, IN DWORD dwSize, OUT LPBYTE lpBuf, OUT LPBYTE lpHealthy); Description Reads data in scan memory together with healthy map. hDevice : File handle obtained with TcnCreateFile dwOffset : Specify the offset of the scan memory data to be read in byte units.
  • Page 64 Chapter 8 Function Reference Return Code TRUE is returned in case of normal end. FALSE is returned in case of abnormal end. The error detail can be obtained with GetLastError(). Example The following example reads data in scan block no. 1 together with scan healthy map.
  • Page 65 TcnScmWrite Name TcnScmWrite - Write to scan memory Type #include <tcnlib.h> BOOL TcnScmWrite(IN HANDLE hDevice, IN DWORD dwOffset, IN DWORD dwSize, IN LPBYTE lpBuf); Description Writes data in scan memory. hDevice : File handle obtained with TcnCreateFile dwOffset : Specify the offset of the scan memory data to be written in byte units.
  • Page 66 Chapter 8 Function Reference TcnSccSetControl Name TcnSccSetControl - Start/stop scan transmission Type #include <tcnlib.h> BOOL TcnSccSetControl (IN HANDLE hDevice, IN DWORD dwMode); Description Starts/stops scan. hDevice : File handle obtained with TcnCreateFile dwMode : 1 to start scan, 0 to stop scan Return Code TRUE is returned in case of normal end.
  • Page 67 TcnSccGetControl Name TcnSccGetControl - Read scan transmission state Type #include < tcnlib.h> BOOL TcnSccGetControl (IN HANDLE hDevice, OUT LPDWORD lpdwMode); Description Reads the scan transmission state. hDevice: File handle obtained with TcnCreateFile Return Code TRUE is returned in case of normal end. At the same time, 1 is stored in IpdwMode as scan start information or 0 is stored as scan stop information.
  • Page 68 Chapter 8 Function Reference TcnSccSetCycle Name TcnSccSetCycle - Set scan transmission cycle Type #include <tcnlib.h> BOOL TcnSccSetCycle (IN HANDLE hDevice, IN SccCycle *p); Description Sets the scan transmission cycle. hDevice: File handle obtained with TcnCreateFile The setting data storage area SccCycle is the following structure. The area must be at least as large as SccCycle size.
  • Page 69 Example The following example shows how to set scan transmission cycle to 10 ms for high-speed, 100 ms for middle-speed, and 1000 ms for low-speed. #include <windows.h> #include "tcnlib.h" HANDLE hDev; SccCycle cycle; // Set scan transmission cycle cycle.HScanCyc = 100;// 10ms cycle.MScanCyc = 100;// 100ms cycle.LScanCyc = 1000;// 1000ms cycle.MaxNodeDist = 8;...
  • Page 70 Chapter 8 Function Reference TcnSccGetCycle Name TcnSccGetCycle - Read scan transmission cycle Type #include <tcnlib.h> BOOL TcnSccGetCycle (IN HANDLE hDevice, OUT SccCycle *p); Description Reads the scan transmission cycle. hDevice : File handle obtained with TcnCreateFile The area SccCycle used to store the read data is similar to the structure used for TcnSccSetCycle.
  • Page 71 TcnScmSetTalkerBlk Name TcnScmSetTaklerBlk - Set scan talker block (transmission block) Type #include <tcnlib.h> BOOL TcnScmSetTaklerBlk (IN HANDLE hDevice, IN ScanTalkerBlk *p); Description Sets the scan talker block (transmission block). hDevice: File handle obtained with TcnCreateFile The setting data storage area ScanTalkerBlk is the following structure. The area must be at least as large as ScanTalkerBlk size.
  • Page 72 Chapter 8 Function Reference To add block 20 in above Example 1: ScanType = 1; BlkNum = 4; Blk[0] = 5; Blk[1] = 10; Blk[2] = 15; Blk[3] = 20; Return Code TRUE is returned in case of normal end. FALSE is returned in case of abnormal end.
  • Page 73 TcnScmGetTalkerBlk Name TcnScmGetTaklerBlk - Read scan talker block (transmission block) Type #include <tcnlib.h> BOOL TcnScmGetTaklerBlk (IN HANDLE hDevice, IN OUT ScanTalkerBlk *p); Description Reads the scan talker block (transmission block). hDevice : File handle obtained with TcnCreateFile The area ScanTalkerBlk used to store the read data is similar to the structure used for TcnScmSetTalkerBlk.
  • Page 74 Chapter 8 Function Reference TcnScmGetTalkerMap Name TcnScmGetTalkerMap - Read scan talker map Type #include <tcnlib.h> BOOL TcnScmGetTalkerMap (IN HANDLE hDevice, IN OUT ScanTalkerMap *p); Description Reads the scan talker map. hDevice : File handle obtained with TcnCreateFile The read data storage area ScanTalkerMap is the following structure. The area must be at least as large as ScanTalkerMap size.
  • Page 75 Example The following example reads 10 blocks of scan talker map from scan block no. #include <windows.h> #include "tcnlib.h" HANDLE hDev; ScanTalkerMap tlkMap; tlkMap.StartBlk = 50; // Read start block No. tlkMap.BlkNum = 10; // Number of blocks to read result = TcnScmGetTalkerMap( hDev, &tlkMap );...
  • Page 76 Chapter 8 Function Reference TcnScmClrTalkerMap Name TcnScmClrTalkerMap - Clear scan talker map duplicate block Type #include <tcnlib.h> BOOL TcnScmClrTalkerMap (IN HANDLE hDevice, IN DWORD dwMode); Description Clears the scan talker map duplicate block. hDevice: File handle obtained with TcnCreateFile dwMode: Set 1 to start clearing (always set this to 1) Return Code TRUE is returned in case of normal end.
  • Page 77 TcnScmGetHealthyMap Name TcnScmGetHealthyMap - Read scan healthy map Type #include <tcnlib.h> BOOL TcnScmGetHealthyMap ( IN HANDLE hDevice, OUT LPBYTE lpBbuf); Description Obtains the scan healthy map. hDevice : File handle obtained with TcnCreateFile lpBuf : Healthy map area storage area. This area must be at least as large as the healthy map area size.
  • Page 78 Chapter 8 Function Reference TcnScmClrUnHealthyMap Name TcnScmClrUnHealthyMap - Clear scan unhealthy map Type #include <tcnlib.h> BOOL TcnScmClrUnHealthyMap (IN HANDLE hDevice, IN DWORD dwMode); Description Clears the scan unhealthy map. The scan unhealthy map is set when unhealthy state is detected for each scan block.
  • Page 79 TcnSccGetInringMap Name TcnSccGetInringMap - Get in ring map Type #include <tcnlib.h> BOOL TcnSccGetInringMap ( IN HANDLE hDevice, OUT LPBYTE lpBbuf); Description Obtains the in ring map. hDevice : File handle obtained with TcnCreateFile lpBuf : In ring map area storage area. This area must be at least as large as the in ring map size.
  • Page 80 Chapter 8 Function Reference Example #include <windows.h> #include "tcnlib.h" HANDLE hDev; DWORD buf[8]; result = TcnSccGetInringMap( hDev, (LPBYTE)buf ); if( !result ) printf("TcnSccGetInringMap fail. Code=%ld\n",GetLastError()); See Also TcnCreateFile TC-net 100 PCI Bus Card Support Software User Manual...
  • Page 81 TcnScmGetStnInf Name TcnScmGetStnInf - Read station diagnostic information Type #include <tcnlib.h> BOOL TcnScmGetStnInf ( IN HANDLE hDevice, OUT StnInf *p); Description Obtains the station diagnostic information. hDevice: File handle obtained with TcnCreateFile The read data storage area StnInf is the following structure. The area must be at least as large as StnInf size.
  • Page 82 Chapter 8 Function Reference bit 0: A system normal (cumulative) Bstatus contains the following information: bit 7: B system receive size over/format error/send JAVA detected bit 6: B system receive CRC error detected/relay CRC error detected bit 5: B system receive alignment error detected bit 4: B system receive SFD/short error detected bit 3: B system receive PHY/collision/send collision detected bit 2: B system receive NCD error detected...
  • Page 83 TcnScmClrStnInf Name TcnScmClrStnInf - Clear station diagnostic information Type #include <tcnlib.h> BOOL TcnScmClrStnInf - (IN HANDLE hDevice, IN DWORD dwMode); Description Clears the station diagnostic information. When the station diagnostic information is cleared, it is created for the subsequent information. hDevice : File handle obtained with TcnCreateFile dwMode...
  • Page 84 Chapter 8 Function Reference TcnScmGetDualInf Name TcnScmGetDualInf - Read network dual diagnostic counter Type #include <tcnlib.h> BOOL TcnScmGetDualInf( IN HANDLE hDevice, OUT DualInf *p); Description Reads the network dual diagnostic counter. hDevice : File handle obtained with TcnCreateFile The read data storage area DualInf is the following structure. The area must be at least as large as DualInf size.
  • Page 85 TcnScmClrDualInf Name TcnScmClrDualInf - Clear network dual diagnostic counter Type #include <tcnlib.h> BOOL TcnScmClrDualInf(IN HANDLE hDevice, IN DWORD dwMode); Description Clears the network dual diagnostic counter. hDevice : File handle obtained with TcnCreateFile dwMode : Set 1 to start clearing (always set this to 1) Return Code TRUE is returned in case of normal end.
  • Page 86 Chapter 8 Function Reference TcnSccSetLinkControl Name TcnSccSetLinkControl - Linkage setting Type #include <tcnlib.h> BOOL TcnSccSetLinkControl (IN HANDLE hDevice, IN DWORD dwMode); Description Sets linkage. hDevice : File handle obtained with TcnCreateFile dwMode : 0 for auto linkage, 1 for fixed to A system, 2 for fixed to B system Return Code TRUE is returned in case of normal end.
  • Page 87 TcnSccGetLinkControl Name TcnSccGetLinkControl - Read linkage state Type #include <tcnlib.h> BOOL TcnSccGetLinkControl(IN HANDLE hDevice, OUT LPDWORD lpdwMode); Description Reads the linkage state. hDevice: File handle obtained with TcnCreateFile Return Code TRUE is returned in case of normal end. Also, 0 for auto linkage, 1 for fixed to A system, or 2 for fixed to B system is stored in IpdwMode.
  • Page 88 Chapter 8 Function Reference TcnGetCorrenspondence Name TcnGetCorrespondence - Get correspondence between rotary switch setting and logical card number Type #include <tcnlib.h> BOOL TcnGetCorrespondence ( OUT TcnCorrespondence *p ) Description Obtains the correspondence between the rotary switch setting and JTNI card logical number.
  • Page 89 TcnScmReportRasUsage Name TcnScmReportRasUsage - Register and set transmission of scan RAS block Type #include <tcnlib.h> BOOL TcnScmReportRasUsage (IN HANDLE hDevice, IN DWORD Flag); Description hDevice: File handle obtained with TcnCreateFile Flag: 1 to register RAS block, 0 to delete RAS block When this function is issued to declare the use of scan RAS block (hereafter referred to as RAS block), the scan block at 2048 minus station address (rotary switch setting) is registered as RAS block.
  • Page 90 Chapter 8 Function Reference TcnGetVer Name TcnGetVer - Read version information Type #include <tcnlib.h> BOOL TcnGetVer (IN HANDLE hDevice, OUT VerInf *p); Description Reads the version of device driver and API, and the hardware revision of JTNI card. hDevice: File handle obtained with TcnCreateFile Return Code TRUE is returned in case of normal end.
  • Page 91 The value of the revision is shown below. Value Revision Revision 0 Revision 1 Revision 2 Revision 3 Revision 4 Revision 5 Revision 6 Revision 7 FALSE is returned in case of abnormal end. The error detail can be obtained with GetLastError(). Example #include <windows.h>...
  • Page 92 Chapter 8 Function Reference TcnRstJtni Name TcnRstJtni - Reset JTNI card Type #include <tcnlib.h> BOOL TcnRstJtni (IN HANDLE hDevice, IN DWORD dwMode); Description Resets the JTNI card. hDevice: File handle obtained with TcnCreateFile dwMode: 1 (Reset start) When this function is issued, the various JTNI card settings (such as scan talker block, and start/stop event) must be reset by the application.
  • Page 93 TcnGetSwCfg Name TcnGetSwCfg - Read dip switch configuration Type #include <tcnlib.h> BOOL TcnGetSwCfg (IN HANDLE hDevice, OUT LPDWORD lpdwSw); Description Reads the configuration of dip switch. hDevice: File handle obtained with TcnCreateFile Return Code TRUE is returned in case of normal end. At the same time, the configuration of dip switch is stored in lower four bits of lpdwSw.

  • Page 95: Driver Event Details

    Chapter 9 Driver Event Details This chapter describes the details of the events provided by the device driver. The information in the data section of the event log is organized as follows with data for each event indicated from +28h (32 bit data). In the Data section of the following event description, 0 is the 32-bit data from +28h, 1 is the 32-bit data from +2ch, 2 is the 32-bit data from +30h and so on.
  • Page 96 Chapter 9 Driver Event Details Error: 8192 JTNI card detection error Message Can't detect JTNI cards.%n Data None Description JTNI card cannot be detected. Error: 8193 Device object creation error Message Can't create device object.%nDevice name: %2%n -%2: Device name Data 0: Device extension size Description...
  • Page 97 Error: 8198 Shutdown routine notification error Message Can't notify shutdown routine. (%1) %n %1: Device name Data None Description Shutdown routine notification error has occurred. Error: 8199 Memory parity error detected Message Parity error. Memory cleared. (%1) %n %1: Device name Data 0: Error address1: Error data (high end doubleword) 2: Error data (low end doubleword)
  • Page 98 Chapter 9 Driver Event Details Error: 8449 Event discarded due to event information storage buffer shortage Message Event buffer empty. (%1) %n %1: Device name Data 0: Data index of deleted event (descriptor number in the case of state change) Description Event was discarded due to event information buffer over- flow.

  • Page 99: Troubleshooting

    Chapter 10 Troubleshooting This chapter describes how to recover from abnormal condition and collect RAS information. 6F8C0945...

  • Page 100: Troubleshooting

    Chapter 10 Troubleshooting 10.1 Troubleshooting Table 10-1 Include Error Abnormal Condition Cause or Action Message indicating that the device This message appears when another application driver cannot be stopped appears. program is using the device driver when attempting to erase the support software. →Quit all application programs when erasing the support software.

  • Page 101: Ras Information Collection

    10.2 RAS Information Collection 10.2 RAS Information Collection RAS information is an important source of information that is necessary when recovering from an abnormal condition. When contacting the support desk to recover from an abnormal condition, you may be asked to supply the event log or collect RAS information from the Tool window.

  • Page 103: A Return Code

    Appendix A Return Code Table A-1 Return Code Functions Error Code Return valid TcnCreateFile ERROR_INVALID_PARAMETER 0x57 mdlid == 0, mdlid == 1 − TcnCloseHandle TcnScmRead ERROR_NO_ACCESS 0x3E6 access range error. TcnScmReadWithHealthy ERROR_INVALID_PARAMETER 0x57 ERROR_NO_ACCESS 0x3E6 access range error. TcnScmWrite ERROR_NO_ACCESS 0x3E6 access range error.
  • Page 105 Information and Control Network TC-net 100 PCI Bus Card Support Software User’s Manual 6th edition 18st January 2010 0945.6.1001 Transmission Distribution & Industrial Systems Company Industrial Systems Division TEL.: +81-3-3457-4894 1-1, Shibaura 1-chome, Minato-ku, Tokyo 105-8001, Japan © TOSHIBA Corporation 2001-2010 All Right Reserved.
  • Page 108 6F8C0945 nfomation and Control Network Module TC-net 100 PC Bus Card Support Software User's Manual 0945.6.1001...

Table of Contents