Table of Contents
Advertisement
Quick Links
Advertisement
Table of Contents
Related Manuals for Tews Technologies TDRV006-SW-82
Summary of Contents for Tews Technologies TDRV006-SW-82
- Page 1 Linux Device Driver 64 Digital Inputs/Outputs (Bit I/O) Version 2.0.x User Manual Issue 2.0.1 December 2017 TEWS TECHNOLOGIES GmbH Am Bahnhof 7 25469 Halstenbek, Germany Phone: +49 (0) 4101 4058 0 Fax: +49 (0) 4101 4058 19 e-mail: info@tews.com www.tews.com...
- Page 2 However TEWS TECHNOLOGIES GmbH reserves the right to change the product described in this document at any time without notice. TEWS TECHNOLOGIES GmbH is not liable for any damage arising out of the application or use of the device described herein.
- Page 3 Device Access Functions......................12 3.2.1 tdrv006Read ........................12 3.2.2 tdrv006Write ........................14 3.2.3 tdrv006WriteMasked......................16 3.2.4 tdrv006SetOutputLine.......................18 3.2.5 tdrv006ClearOutputLine ....................20 3.2.6 tdrv006OutputEnable......................22 Input Event Functions ........................24 3.3.1 tdrv006WaitForLowToHigh ....................24 3.3.2 tdrv006WaitForHighToLow....................26 3.3.3 tdrv006WaitForAnyTrans....................28 DIAGNOSTIC......................30 TDRV006-SW-82 - Linux Device Driver Page 3 of 31...
-
Page 4: Introduction
1 Introduction The TDRV006-SW-82 Linux device driver allows the operation of the TDRV006 compatible PMCs conforming to the Linux I/O system specification. The TDRV006-SW-82 device driver supports the following features: Reading input I/O value Writing to output buffers (masked and unmasked) ... -
Page 5: Installation
HAL library source file COPYING Copy of the GNU Public License (GPL) In order to perform an installation, extract all files of the archive TDRV006-SW-82-SRC.tar.gz to the desired target directory. The command ‘tar -xzvf TDRV006-SW-82-SRC.tar.gz’ will extract the files into the local directory. -
Page 6: Uninstall The Device Driver
Be sure that the driver is not opened by any application program. If opened you will get the response ``tdrv006drv: Device or resource busy`` and the driver will still remain in the system until you close all opened files and execute modprobe -r again. TDRV006-SW-82 - Linux Device Driver Page 6 of 31... -
Page 7: Change Major Device Number
This symbol specifies the size of the interrupt routine event record queue. If you have input event loss during multiple Input Event jobs, please double the certain value. TDRV006_MAX_EVENTWAIT_JOBS This symbol specifies the maximum number of concurrent jobs waiting for Input Events. TDRV006-SW-82 - Linux Device Driver Page 7 of 31... -
Page 8: Api Documentation
TDRV006 device is named /dev/tdrv006_0, the second /dev/tdrv006_1, and so on. EXAMPLE #include <tdrv006api.h> TDRV006_HANDLE hdl; ** open the specified device hdl = tdrv006Open(“/dev/tdrv006_0”); if (hdl == NULL) /* handle open error */ TDRV006-SW-82 - Linux Device Driver Page 8 of 31... - Page 9 A device handle, or NULL if the function fails. An error code will be stored in errno. ERROR CODES The error codes are stored in errno. The error code is a standard error code set by the I/O system. TDRV006-SW-82 - Linux Device Driver Page 9 of 31...
-
Page 10: Tdrv006Close
This value specifies the device handle to the hardware module retrieved by a call to the corresponding open-function. EXAMPLE #include <tdrv006api.h> TDRV006_HANDLE hdl; TDRV006_STATUS result; ** close the device result = tdrv006Close(hdl); if (result != TDRV006_OK) /* handle close error */ TDRV006-SW-82 - Linux Device Driver Page 10 of 31... - Page 11 On success, TDRV006_OK is returned. In the case of an error, the appropriate error code is returned by the function. ERROR CODES Error Code Description TDRV006_ERR_INVALID_HANDLE The specified device handle is invalid TDRV006-SW-82 - Linux Device Driver Page 11 of 31...
-
Page 12: Device Access Functions
This argument points to a buffer where the current value of I/O lines 32 up to 63 will be returned. Bit 0 returns the value of I/O line 32, bit 1 the value of I/O line 33, and so on. TDRV006-SW-82 - Linux Device Driver Page 12 of 31... - Page 13 On success, TDRV006_OK is returned. In the case of an error, the appropriate error code is returned by the function. ERROR CODES Error Code Description TDRV006_ERR_INVAL A NULL pointer is referenced for an input value TDRV006_ERR_INVALID_HANDLE The device handle is invalid TDRV006-SW-82 - Linux Device Driver Page 13 of 31...
-
Page 14: Tdrv006Write
This argument specifies the output value for I/O lines 32 up to 63. Bit 0 specifies the value of I/O line 32, bit 1 the value of I/O line 33, and so on. TDRV006-SW-82 - Linux Device Driver Page 14 of 31... - Page 15 On success, TDRV006_OK is returned. In the case of an error, the appropriate error code is returned by the function. ERROR CODES Error Code Description TDRV006_ERR_INVALID_HANDLE The device handle is invalid TDRV006-SW-82 - Linux Device Driver Page 15 of 31...
-
Page 16: Tdrv006Writemasked
A set bit (1) means the I/O line shall be set to the value specified by out31_0. A reset bit (0) means that the old output value will not be changed. TDRV006-SW-82 - Linux Device Driver Page 16 of 31... - Page 17 On success, TDRV006_OK is returned. In the case of an error, the appropriate error code is returned by the function. ERROR CODES Error Code Description TDRV006_ERR_INVALID_HANDLE The device handle is invalid TDRV006-SW-82 - Linux Device Driver Page 17 of 31...
-
Page 18: Tdrv006Setoutputline
This value specifies the device handle to the hardware module retrieved by a call to the corresponding open-function. outputLine This argument specifies a data bit that shall be set. Allowed values are 0 up to 63. TDRV006-SW-82 - Linux Device Driver Page 18 of 31... - Page 19 On success, TDRV006_OK is returned. In the case of an error, the appropriate error code is returned by the function. ERROR CODES Error Code Description TDRV006_ERR_INVAL An invalid line number is specified TDRV006_ERR_INVALID_HANDLE The device handle is invalid TDRV006-SW-82 - Linux Device Driver Page 19 of 31...
-
Page 20: Tdrv006Clearoutputline
This value specifies the device handle to the hardware module retrieved by a call to the corresponding open-function. outputLine This argument specifies data bit that shall be reset. Allowed values are 0 up to 63. TDRV006-SW-82 - Linux Device Driver Page 20 of 31... - Page 21 On success, TDRV006_OK is returned. In the case of an error, the appropriate error code is returned by the function. ERROR CODES Error Code Description TDRV006_ERR_INVAL An invalid line number is specified TDRV006_ERR_INVALID_HANDLE The device handle is invalid TDRV006-SW-82 - Linux Device Driver Page 21 of 31...
-
Page 22: Tdrv006Outputenable
This argument specifies the direction of I/O lines 32 up to 63. Bit 0 specifies the direction of I/O line 32, bit 1 the direction of I/O line 33, and so on. A set bit (1) configures the line for output, an unset bit (0) configures input (tri-state). TDRV006-SW-82 - Linux Device Driver Page 22 of 31... - Page 23 On success, TDRV006_OK is returned. In the case of an error, the appropriate error code is returned by the function. ERROR CODES Error Code Description TDRV006_ERR_INVALID_HANDLE The device handle is invalid TDRV006-SW-82 - Linux Device Driver Page 23 of 31...
-
Page 24: Input Event Functions
This argument specifies the time the function is willing to wait for the specified transition. If the specified time has passed the function will return with an error. The timeout is specified in milliseconds. A timeout value of ‘-1’ specifies that the function will never timeout. TDRV006-SW-82 - Linux Device Driver Page 24 of 31... - Page 25 ERROR CODES Error Code Description TDRV006_ERR_INVAL Invalid parameter specified TDRV006_ERR_BUSY The number of waiting processes exceeded the maximum number TDRV006_ERR_INVALID_HANDLE The device handle is invalid TDRV006_ERR_TIMEOUT Timeout occurred. TDRV006-SW-82 - Linux Device Driver Page 25 of 31...
-
Page 26: Tdrv006Waitforhightolow
This argument specifies the time the function is willing to wait for the specified transition. If the specified time has passed the function will return with an error. The timeout is specified in milliseconds. A timeout value of ‘-1’ specifies that the function will never timeout. TDRV006-SW-82 - Linux Device Driver Page 26 of 31... - Page 27 ERROR CODES Error Code Description TDRV006_ERR_INVAL Invalid parameter specified TDRV006_ERR_BUSY The number of waiting processes exceeded the maximum number TDRV006_ERR_INVALID_HANDLE The device handle is invalid TDRV006_ERR_TIMEOUT Timeout occurred. TDRV006-SW-82 - Linux Device Driver Page 27 of 31...
-
Page 28: Tdrv006Waitforanytrans
This argument specifies the time the function is willing to wait for the specified transition. If the specified time has passed the function will return with an error. The timeout is specified in milliseconds. A timeout value of ‘-1’ specifies that the function will never timeout. TDRV006-SW-82 - Linux Device Driver Page 28 of 31... - Page 29 ERROR CODES Error Code Description TDRV006_ERR_INVAL Invalid parameter specified TDRV006_ERR_BUSY The number of waiting processes exceeded the maximum number TDRV006_ERR_INVALID_HANDLE The device handle is invalid TDRV006_ERR_TIMEOUT Timeout occurred. TDRV006-SW-82 - Linux Device Driver Page 29 of 31...
-
Page 30: Diagnostic
Flags: medium devsel, IRQ 16 Memory at feb9fc00 (32-bit, non-prefetchable) [size=128] I/O ports at e880 [size=128] Memory at feb9f800 (32-bit, non-prefetchable) [size=256] Kernel driver in use: TEWS TECHNOLOGIES TDRV006 64 Digital Bit IO Kernel modules: tdrv006drv # cat /proc/devices Character devices:... - Page 31 80000000-ffffffff : PCI Bus 0000:00 80000000-801fffff : PCI Bus 0000:03 80200000-803fffff : PCI Bus 0000:03 … feb00000-febfffff : PCI Bus 0000:04 feb9f800-feb9f8ff : 0000:04:01.0 feb9f800-feb9f8ff : TDRV006 feb9fc00-feb9fc7f : 0000:04:01.0 … TDRV006-SW-82 - Linux Device Driver Page 31 of 31...
Need help?
Do you have a question about the TDRV006-SW-82 and is the answer not in the manual?
Questions and answers