Tews Technologies TPMC500-SW-42 Bedienungsanleitung

The Embedded I/O Company

TPMC500-SW-42

VxWorks Device Driver

32 Channel 12 Bit ADC

Version 2.0.x

User Manual

Issue 2.0.0

October 2004

TEWS TECHNOLOGIES GmbH

Am Bahnhof 7 25469 Halstenbek / Germany

e-mail: [email protected] www.tews.com

TEWS TECHNOLOGIES LLC

1 E. Liberty Street, Sixth Floor Reno, Nevada 89504 / USA

Phone: +1 (775) 686 6077 Fax: +1 (775) 686 6024

e-mail: [email protected] www.tews.com

TPMC500-SW-42 - VxWorks Device Driver Page 2 of 19

TPMC500-SW-42

32 Channel 12 Bit ADC

VxWorks Device Driver

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.

1999-2004 by TEWS TECHNOLOGIES GmbH

IndustryPack is a registered trademark of SBS Technologies, Inc

Issue Description Date

1.0 First Issue November 1999

1.1 General Revision November 2003

2.0.0 New Device Initialization Parameters, File list modified,

Support for Intel x86 added October 29, 2004

TPMC500-SW-42 - VxWorks Device Driver Page 3 of 19

Table of Contents

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

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

2.1 Hardware dependent Configuration..............................................................................................5

2.2 Including the driver in VxWorks....................................................................................................5

2.3 Special installation for Intel x86 based targets............................................................................6

3I/O SYSTEM FUNCTIONS..........................................................................................7

3.1 tp500Drv() ........................................................................................................................................7

3.2 tp500DevCreate().............................................................................................................................8

4I/O INTERFACE FUNCTIONS..................................................................................10

4.1 open() .............................................................................................................................................10

4.2 close().............................................................................................................................................12

4.3 read() ..............................................................................................................................................13

4.4 ioctl() ..............................................................................................................................................15

4.4.1 FIOSTARTSEQ Setup and start the sequencer ................................................................16

4.4.2 FIOSTOPSEQ Stop the sequencer ...................................................................................16

4.4.3 ioctl() example.....................................................................................................................17

5APPENDIX................................................................................................................19

5.1 Predefined Symbols......................................................................................................................19

5.2 Error Codes ...................................................................................................................................19

TPMC500-SW-42 - VxWorks Device Driver Page 4 of 19

1 Introduction

The TPMC500-SW-42 VxWorks device driver software allows the operation of the TPMC500

32 Channel 12-bit ADC PMC conforming to the VxWorks I/O system specification. This includes a

device-independent basic I/O interface with open(), read() and ioctl() functions.

The TPMC500 driver includes following functions:

!read the actual input value

!start and setup the input sequencer

!stop the input sequencer

TPMC500-SW-42 - VxWorks Device Driver Page 5 of 19

2Installation

Following files are located on the distribution media:

tp500drv.c TPMC500 Device Driver Source

tp500def.h TPMC500 Local Include File

tpmc500.h TPMC500 Application Include File

tp500pci.c TPMC500 PCI MMU mapping for Intel x86 based targets

tpxxxhwdep.c Collection of hardware dependent functions

tpxxxhwdep.h Include for hardware dependent functions

tp500exa.c Example Application

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

2.1 Hardware dependent Configuration

The driver is written to be used on TEWS carrier boards and others, but sometimes it is necessary to

adapt the software. The following points have to be guaranteed:

!full access to the PMC I/O area of the card

!full access to PMC memory area of the card (correction data address space)

!interrupt must be connected

Most systems should work without any changes, but it may be necessary to setup address offsets or

an offset between interrupt level and vector. Information for these values should be available in you

BSP manual and/or CPU board manual. If such an adaptation is necessary you will get a warning

while compilation.

The values that have to be modified can be found in tpxxxhwdep.h. There are three values that will be

explicitly undefined after installation. To use these values, you have to define them with an appropriate

value.

USERDEFINED_MEM_OFFSET This value defines the offset between CPU-bus and

PCI-bus address for memory accesses.

USERDEFINED_IO_OFFSET This value defines the offset between CPU-bus and

PCI-bus address for 16-bit I/0 accesses.

USERDEFINED_LEV2VEC This value defines the value that should be added

to the interrupt level number to get the interrupt

vector number.

If everything works fine while the values are undefined, and warnings are generated, you can define

these values with a value of 0;

2.2 Including the driver in VxWorks

How to include the device drive in the VxWorks system is described in the VxWorks and Tornado

manuals.

TPMC500-SW-42 - VxWorks Device Driver Page 6 of 19

2.3 Special installation for Intel x86 based targets

The TPMC500 device driver is fully adapted for Intel x86 based targets. This is done by conditional

compilation directives inside the source code and controlled by the VxWorks global defined macro

CPU. If the contents of this macro is equal to I80386, I80386 or PENTIUM special Intel x86

conforming code and function calls will be included.

The second problem for Intel x86 based platforms can’t be solved by conditional compilation

directives. Due to the fact that some Intel x86 BSP’s doesn’t map PCI memory spaces of devices

which are not used by the BSP, the required PCI memory spaces can’t be accessed.

To solve this problem a MMU mapping entry has to be added for the required TPMC500 PCI memory

spaces prior the MMU initialization (usrMmuInit()) is done.

Please examine the BSP documentation or contact the BSP Vendor whether the BSP perform

automatic PCI and MMU configuration or not. If the PCI and MMU initialization is done by the BSP the

function tp500PciInit() won’t be included and the user can skip to the following steps.

The C source file tp461pci.c contains the function tp461PciInit(). This routine finds out all TPMC461

devices and adds MMU mapping entries for all used PCI memory spaces. Please insert a call to this

function after the PCI initialization is done and prior to MMU initialization (usrMmuInit()).

If the Tornado 2.0/2.2 project facility is used, the right place to call the function tp500PciInit() is at the

end of the function sysHwInit() in sysLib.c (can be opened from the project Files window).

Be sure that the function is called prior to MMU initialization otherwise the TPCM500 PCI spaces

remains unmapped and an access fault occurs during driver initialization.

Please insert the following call at a suitable place in either sysLib.c or usrConfig.c:

tp500PciInit();

The function tp500PciInit() is designed for and tested on generic Pentium targets. If another

BSP is used, please refer to BSP documentation or contact the technical support for required

adaptation.

If strange errors appeared after system startup with the new build system please carrying out a

VxWorks build clean and build all.

TPMC500-SW-42 - VxWorks Device Driver Page 7 of 19

3I/O system functions

This chapter describes the driver-level interface to the I/O system. The purpose of these functions is to

install the driver in the I/O system, add and initialize devices.

3.1 tp500Drv()

NAME

tp500Drv() - installs the TPMC500 driver in the I/O system and initializes the driver.

SYNOPSIS

STATUS tp500Drv(void)

DESCRIPTION

This function installs the TPMC500 driver in the I/O system, allocates driver resources and initializes

them.

The call of this function is the first thing the user has to do before adding any device to the system or

performing any I/O request.

RETURNS

OK or ERROR (if the driver cannot be installed)

SEE ALSO

VxWorks Programmer’s Guide: I/O System

TPMC500-SW-42 - VxWorks Device Driver Page 8 of 19

3.2 tp500DevCreate()

NAME

tp500DevCreate() - adds a TPMC500 device to the system and initializes device hardware.

SYNOPSIS

STATUS tp500DevCreate

(

char *name, /* name of the device to create */

int glbModNo, /* TPMC500 module number */

unsigned long type /* device type [TPMC500_nn] */

)

DESCRIPTION

This routine is called to add a device to the system that will be serviced by the TPMC500 driver. This

function must be called before performing any I/O request to this driver.

PARAMETER

The name of the device is selected by the string, which is deployed by this routine in the parameter

name.

The argument glbModNo specifies the index of the TPMC500 that should be set up. For the first

found TPMC500 glbModNo must be set to 0, for the second to 1, and so on.

The argument type specifies the module type mounted to the address. There are predefined symbols

for this argument in tpmc500.h. Allowed values are TPMC500_10, TPMC500_11, TPMC500_12,

TPMC500_13, TPMC500_20, TPMC500_21, TPMC500_22 and TPMC500_23.

TPMC500-SW-42 - VxWorks Device Driver Page 9 of 19

EXAMPLE

#include "tpmc500.h"

...

/*-------------------------------------------------------

Create the device "/tpmc500" for the first found TPMC500

The mounted module is a TPMC500-10

-----------------------------------------------------------*/

status = tp500DevCreate ("/tpmc500",

TPMC500_10);

...

RETURNS

OK or ERROR (if the driver is not installed or the device already exists or any other error occurred

during the creation)

TPMC500-SW-42 - VxWorks Device Driver Page 10 of 19

4I/O interface functions

This chapter describes the interface to the basic I/O system.

4.1 open()

NAME

open() - opens a device or file.

SYNOPSIS

int open

(

const char *name, /* name of the device to open */

int flags, /* not used for TPMC500 driver, must be 0 */

int mode /* not used for TPMC500 driver, must be 0 */

)

DESCRIPTION

Before I/O can be performed to the TPMC500 device, a file descriptor must be opened by invoking the

basic I/O function open().

PARAMETER

The parameter name selects the device which shall be opened.

The parameters flags and mode are not used and must be 0.

EXAMPLE

...

/*-----------------------------------------------------------

Open the device named "/tpmc500" for I/O

-----------------------------------------------------------*/

fd = open("/tpmc500", 0, 0);

...

Inhaltsverzeichnis

Andere Tews Technologies Steuereinheit Handbücher

Tews Technologies

Tews Technologies TPMC371-10 Bedienungsanleitung

Tews Technologies

Tews Technologies TPMC462 Bedienungsanleitung

Tews Technologies

Tews Technologies TIP867 Series Bedienungsanleitung

Tews Technologies

Tews Technologies TPMC461 Bedienungsanleitung

Tews Technologies

Tews Technologies TCP872 Bedienungsanleitung

Tews Technologies

Tews Technologies TAMC532 Bedienungsanleitung

Tews Technologies

Tews Technologies TIP606 Bedienungsanleitung

Tews Technologies

Tews Technologies TPMC917-10 Bedienungsanleitung

Tews Technologies

Tews Technologies TPMC118-SW-95 Bedienungsanleitung

Tews Technologies

Tews Technologies TPMC816 Bedienungsanleitung

Tews Technologies

Tews Technologies TPMC316 Bedienungsanleitung

Tews Technologies

Tews Technologies TPMC316 Bedienungsanleitung

Tews Technologies

Tews Technologies TIP866-TM-10 Bedienungsanleitung

Tews Technologies

Tews Technologies TPMC866-TM-20 Bedienungsanleitung

Tews Technologies

Tews Technologies TIP866-TM-20 Bedienungsanleitung

Tews Technologies

Tews Technologies TIP255 Bedienungsanleitung

Beliebte Steuereinheit Handbücher anderer Marken

Festo

Festo Compact Performance CP-FB6-E Stücklistenhandbuch

Elo TouchSystems

Elo TouchSystems DMS-SA19P-EXTME Bedienungsanleitung

JS Automation

JS Automation MPC3034A Bedienungsanleitung

JAUDT

JAUDT SW GII 6406 Series Kurzanleitung

Spektrum

Spektrum Air Module System Bedienungsanleitung

BOC Edwards

BOC Edwards Q Series Bedienungsanleitung

KHADAS

KHADAS BT Magic Bedienungsanleitung

Etherma

Etherma eNEXHO-IL Bedienungsanleitung

PMFoundations

PMFoundations Attenuverter Bedienungsanleitung

GEA

GEA VARIVENT Bedienungsanleitung

Walther Systemtechnik

Walther Systemtechnik VMS-05 Bedienungsanleitung

Altronix

Altronix LINQ8PD Montageanleitung

Eaton

Eaton Powerware Series Bedienungsanleitung

WAGO

WAGO 750-407/040-000 Bedienungsanleitung

Sony

Sony CCU-590 Bedienungsanleitung

Graco

Graco 25D614 Bedienungsanleitung

Task Force Tips

Task Force Tips YE-RF-900 Programmierhandbuch

Shini

Shini SPV-U Series Bedienungsanleitung