Tews Technologies TDRV006-SW-82 Bedienungsanleitung

The Embedded I/O Company

TDRV006-SW-82

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

TDRV006-SW-82 - Linux Device Driver Page 2 of 31

TDRV006-SW-82

Linux Device Driver

64 Digital Inputs/Outputs (Bit I/O)

Supported Modules:

TPMC681

This document contains information, which is

proprietary to TEWS TECHNOLOGIES GmbH. Any

reproduction without written permission is forbidden.

TEWS TECHNOLOGIES GmbH has made any

effort to ensure that this manual is accurate and

complete. 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.

2005-2017 by TEWS TECHNOLOGIES GmbH

Issue Description Date

1.0.0 First Issue December 20, 2005

1.0.1 File list changed August 15, 2006

1.0.2 New Address TEWS LLC January 17, 2007

1.0.3 Address TEWS LLC removed June 24, 2010

1.0.4 General Revision May 4, 2011

1.1.0 Support of kernel versions 3.x February 2, 2012

2.0.0 API implemented, General Revision December 14, 2012

2.0.1 File-list modified December 1, 2017

TDRV006-SW-82 - Linux Device Driver Page 3 of 31

Table of Contents

1 INTRODUCTION.........................................................................................................4

2 INSTALLATION..........................................................................................................5

Build and install the Device Driver................................................................................................52.1 Uninstall the Device Driver ............................................................................................................62.2 Install Device Driver into the running Kernel...............................................................................62.3 Remove Device Driver from the running Kernel..........................................................................62.4 Change Major Device Number.......................................................................................................72.5 Configuration...................................................................................................................................72.6

3 API DOCUMENTATION .............................................................................................8

General Functions...........................................................................................................................83.1 3.1.1 tdrv006Open.......................................................................................................................8

3.1.2 tdrv006Close.....................................................................................................................10

Device Access Functions.............................................................................................................123.2 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 ..................................................................................................................243.3 3.3.1 tdrv006WaitForLowToHigh...............................................................................................24

3.3.2 tdrv006WaitForHighToLow...............................................................................................26

3.3.3 tdrv006WaitForAnyTrans..................................................................................................28

4 DIAGNOSTIC............................................................................................................30

TDRV006-SW-82 - Linux Device Driver Page 4 of 31

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)

Setting I/O bits individually

Waiting for input transition events

Configuring I/O direction

The TDRV006-SW-82 supports the modules listed below:

TPMC681 64 Digital Inputs / Outputs (Bit I/O) (PMC)

In this document all supported modules and devices will be called TDRV006. Specials for

certain devices will be advised.

To get more information about the features and use of the supported devices it is recommended to

read the manuals listed below.

TPMC681 User Manual

TDRV006-SW-82 - Linux Device Driver Page 5 of 31

2Installation

Following files are located on the distribution media:

Directory path ‘TDRV006-SW-82’:

TDRV006-SW-82-2.0.1.pdf This manual in PDF format

TDRV006-SW-82-SRC.tar.gz GZIP compressed archive with driver source code

ChangeLog.txt Release history

Release.txt Release information

For installation the files have to be copied to the desired target directory.

The GZIP compressed archive TDRV006-SW-82-SRC.tar.gz contains the following files and

directories:

Directory path ‘tdrv006’:

tdrv006.c Driver source code

tdrv006def.h Driver include file

tdrv006.h Driver include file for application program

makenode Script to create device nodes on the file system

Makefile Device driver make file

api/tdrv006api.c API source file

api/tdrv006api.h API include file

example/tdrv006exa.c Example application

example/Makefile Example application make file

include/config.h Driver independent configuration header file

include/tpmodule.h Driver and kernel independent library header file

include/tpmodule.c Driver and kernel independent library source file

include/tpxxxhwdep.h HAL library header file

include/tpxxxhwdep.c 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.

Login as root and change to the target directory

Copy tdrv006.h and api/tdrv006api.h to /usr/include

Build and install the Device Driver2.1

Login as root

Change to the target directory

To create and install the driver in the module directory /lib/modules/<version>/misc enter:

# make install

To update the device driver’s module dependencies, enter:

#depmod -aq

TDRV006-SW-82 - Linux Device Driver Page 6 of 31

Uninstall the Device Driver2.2

Login as root

Change to the target directory

To remove the driver from the module directory /lib/modules/<version>/misc enter:

# make uninstall

Install Device Driver into the running Kernel2.3

To load the device driver into the running kernel, login as root and execute the following

commands:

# modprobe tdrv006drv

After the first build or if you are using dynamic major device allocation it is necessary to create

new device nodes on the file system. Please execute the script file makenode to do this. If your

kernel has enabled a device file system (devfs or sysfs with udev) then you have to skip

running the makenode script. Instead of creating device nodes from the script the driver itself

takes creating and destroying of device nodes in its responsibility.

# sh makenode

On success the device driver will create a minor device for each compatible channel found. The first

PMC module can be accessed with device node /dev/tdrv006_0, the second module with device node

/dev/tdrv006_1 and so on.

The assignment of device nodes to physical PMC modules depends on the search order of the PCI

bus driver.

Remove Device Driver from the running Kernel2.4

To remove the device driver from the running kernel login as root and execute the following

command:

# modprobe -r tdrv006drv

If your kernel has enabled a device file system (devfs or sysfs with udev), all /dev/tdrv006_* nodes will

be automatically removed from your file system after this.

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 7 of 31

Change Major Device Number2.5

This paragraph is only for Linux kernels without dynamic device file system installed.

The TDRV006 driver uses dynamic allocation of major device numbers per default. If this isn’t suitable

for the application it’s possible to define a major number for the driver.

To change the major number edit the file tdrv006def.h, change the following symbol to appropriate

value and enter make install to create a new driver.

TDRV006_MAJOR Valid numbers are in range between 0 and 255. A value of 0 means

dynamic number allocation.

Example:

#define TDRV006_MAJOR 122

Be sure that the desired major number is not used by other drivers. Please check /proc/devices

to see which numbers are free.

Keep in mind that it is necessary to create new device nodes if the major number for the

TDRV006 driver has changed and the makenode script is not used.

Configuration2.6

To adjust application specific driver properties see tdrv006def.h and look for the following symbol

defines (#define <symbol> <value>):

TDRV006_MAX_EVENT_RECORDS

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 8 of 31

3API Documentation

General Functions3.1

3.1.1 tdrv006Open

NAME

tdrv006Open – open a device.

SYNOPSIS

TDRV006_HANDLE tdrv006Open

(char *DeviceName

)

DESCRIPTION

Before I/O can be performed to a device, a device descriptor must be opened by a call to this function.

PARAMETERS

DeviceName

This parameter points to a null-terminated string that specifies the name of the device. The first

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 9 of 31

RETURNS

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 10 of 31

3.1.2 tdrv006Close

NAME

tdrv006Close – close a device.

SYNOPSIS

TDRV006_STATUS tdrv006Close

(TDRV006_HANDLE hdl

)

DESCRIPTION

This function closes previously opened devices.

PARAMETERS

hdl 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 */

}

Inhaltsverzeichnis

Andere Tews Technologies E/A-System Handbücher

Tews Technologies

Tews Technologies TPMC810 Bedienungsanleitung

Tews Technologies

Tews Technologies TAMC640 Bedienungsanleitung

Tews Technologies

Tews Technologies TPMC632 Series Bedienungsanleitung

Tews Technologies

Tews Technologies TIP866-IO-10 Bedienungsanleitung

Tews Technologies

Tews Technologies TPMC533 Bedienungsanleitung

Tews Technologies

Tews Technologies TPMC851 Bedienungsanleitung

Tews Technologies

Tews Technologies TDRV004-SW-82 Bedienungsanleitung

Tews Technologies

Tews Technologies TPMC467-10R Bedienungsanleitung

Tews Technologies

Tews Technologies TPMC160 Bedienungsanleitung

Tews Technologies

Tews Technologies TIP810 Bedienungsanleitung

Tews Technologies

Tews Technologies TIP845 Bedienungsanleitung

Tews Technologies

Tews Technologies TIP670 Bedienungsanleitung

Tews Technologies

Tews Technologies TPMC671 Bedienungsanleitung

Tews Technologies

Tews Technologies TPCE636 Bedienungsanleitung

Tews Technologies

Tews Technologies TPMC634 Series Bedienungsanleitung

Tews Technologies

Tews Technologies TPMC310 Bedienungsanleitung

Beliebte E/A-System Handbücher anderer Marken

WAGO

WAGO 750-344 Bedienungsanleitung

Teknim

Teknim TWM-1887 Bedienungsanleitung

Intelligent Appliance

Intelligent Appliance IA-2662-E Bedienungsanleitung

BERGHOF

BERGHOF ECC DIO 16/16 Bedienungsanleitung

Advantech

Advantech PCM-27J3AU Installations- und Betriebshandbuch

Festo

Festo CP-E08-M12-CL Bedienungsanleitung

Measurement Computing

Measurement Computing PCI-DAS64/M1/16 Bedienungsanleitung

Hitachi

Hitachi HX-RIO3 Series Bedienungsanleitung

NUUO

NUUO SCB-A08 Bedienungsanleitung

M-system

M-system R3Y-RS8 Bedienungsanleitung

jablotron

jablotron JB-110N Bedienungsanleitung

Omron

Omron SYSMAC C200H Bedienungsanleitung

DOLD

DOLD SAFEMASTER M Bedienungsanleitung

ABB

ABB OPT-MF-001 Bedienungsanleitung

Omron

Omron SYSMAC C2000H Bedienungsanleitung

Helmholz

Helmholz TB20 Bedienungsanleitung

ICP DAS USA

ICP DAS USA tM-AD2 Bedienungsanleitung

Automationdirect.com

Automationdirect.com DL305 Bedienungsanleitung