Tews Technologies TIP675-SW-42 User manual

The Embedded I/O Company
TIP675-SW-42
VxWorks Device Driver
48 TTL I/O Lines with Interrupts
Version 1.2.x
User Manual
Issue 1.2.1
June 2008
TEWS TECHNOLOGIES GmbH TEWS TECHNOLOGIES LLC
Am Bahnhof 7
25469 Halstenbek, Germany
www.tews.com
Phone: [phone]
Fax: [phone]
e-mail: [e-mail]
9190 Double Diamond Parkway,
Suite 127, Reno, NV 89521, USA
www.tews.com
Phone: [phone]
Fax: [phone]
e-mail: usa[email protected]m

TIP675-SW-42 – VxWorks Device Driver Page 2 of 31
TIP675-SW-42
VxWorks Device Driver
48 TTL I/O Lines with Interrupts
Supported Modules:
TIP675
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.
2002-2008 by TEWS TECHNOLOGIES GmbH
Issue Description Date
1.0 First Issue September 12, 2002
1.1.0 IPAC Carrier Driver Support January 11, 2006
1.2.0 New Address TEWS TECHNOLOGIES LLC
ChangeLog.txt added to file list, new error code for tip675DevCreate() December 5, 2006
1.2.1 Carrier Driver description added June 24, 2008

TIP675-SW-42 – VxWorks Device Driver Page 3 of 31
Table of Contents
1 INTRODUCTION.........................................................................................................4
1.1 Device Driver ...................................................................................................................................4
1.2 IPAC Carrier Driver .........................................................................................................................5
2 INSTALLATION..........................................................................................................6
2.1 Include device driver in Tornado IDE project ..............................................................................6
2.2 System resource requirement .......................................................................................................7
3 I/O SYSTEM FUNCTIONS..........................................................................................8
3.1 tip675Drv() .......................................................................................................................................8
3.2 tip675DevCreate()..........................................................................................................................10
4 I/O FUNCTIONS .......................................................................................................13
4.1 open() .............................................................................................................................................13
4.2 close().............................................................................................................................................15
4.3 ioctl() ..............................................................................................................................................17
4.3.1 FIO_T675_SET_DIR..........................................................................................................19
4.3.2 FIO_T675_INSTALL_ISF...................................................................................................21
4.3.3 FIO_T675_REMOVE_ISF..................................................................................................24
4.3.4 FIO_T675_ENA_EXCLK....................................................................................................26
4.3.5 FIO_T675_DIS_EXCLK.....................................................................................................27
4.3.6 FIO_T675_READ...............................................................................................................28
4.3.7 FIO_T675_WRITE .............................................................................................................30

TIP675-SW-42 – VxWorks Device Driver Page 4 of 31
1Introduction
1.1 Device Driver
The TIP675-SW-42 VxWorks device driver software allows the operation of the TIP675 IP conforming
to the VxWorks I/O system specification. This includes a device-independent basic I/O interface with
open(), close() and ioctl() functions.
The TIP675 driver includes the following functions:
reading the input register
writing the output register
programming direction of every I/O line
configure simultaneous update feature
connect interrupt callback functions to every I/O line
The TIP675-SW-42 supports the modules listed below:
TIP675-10 48 TTL I/O Lines with Interrupts (IPAC)
To get more information about the features and use of the supported devices it is recommended to
read the manuals listed below.
TIP675 User manual
TIP675 Engineering Manual
CARRIER-SW-42 IPAC Carrier User Manual

TIP675-SW-42 – VxWorks Device Driver Page 5 of 31
1.2 IPAC Carrier Driver
IndustryPack (IPAC) carrier boards have different implementations of the system to IndustryPack bus
bridge logic, different implementations of interrupt and error handling and so on. Also the different byte
ordering (big-endian versus little-endian) of CPU boards will cause problems on accessing the
IndustryPack I/O and memory spaces.
To simplify the implementation of IPAC device drivers which work with any supported carrier board,
TEWS TECHNOLOGIES has designed a so called Carrier Driver that hides all differences of different
carrier boards under a well defined interface.
The TEWS TECHNOLOGIES IPAC Carrier Driver CARRIER-SW-42 is part of this TIP675-SW-42
distribution. It is located in directory CARRIER-SW-42 on the corresponding distribution media.
This IPAC Device Driver requires a properly installed IPAC Carrier Driver. Due to the design of the
Carrier Driver, it is sufficient to install the IPAC Carrier Driver once, even if multiple IPAC Device
Drivers are used.
Please refer to the CARRIER-SW-65 User Manual for a detailed description how to install and setup
the CARRIER-SW-42 device driver, and for a description of the TEWS TECHNOLOGIES IPAC Carrier
Driver concept.
How to use the carrier driver in the application program is shown in the programming example
tip675exa.c.
If the IPAC carrier driver isn’t used for the IPAC driver setup, the application software has to setup
carrier board hardware, mapping of device memory and interrupt level setup by itself.

TIP675-SW-42 – VxWorks Device Driver Page 6 of 31
2Installation
The following files and directories are located on the distribution media:
Directory path ‘./TIP675-SW-42/’:
tip675drv.c TIP675 device driver source
tip675def.h TIP675 driver include file
tip675.h TIP675 include file for driver and application
tip675exa.c Example application
include/ipac_carrier.h Carrier driver interface definitions
TIP675-SW-42-1.2.1.pdf PDF copy of this manual
Release.txt Release information
ChangeLog.txt Release history
2.1 Include device driver in Tornado IDE project
For Including the TIP675-SW-42 device driver into a Tornado IDE project follow the steps below:
(1) Copy the files from the distribution media into a subdirectory in your project path.
(For example: ./TIP675)
(2) Add the device drivers C-files to your project.
Make a right click to your project in the ‘Workspace’ window and use the ‘Add Files ...’ topic.
A file select box appears, and the driver files can be selected.
(3) Now the driver is included in the project and will be built with the project.
For a more detailed description of the project facility please refer to your Tornado User’s
Guide.

TIP675-SW-42 – VxWorks Device Driver Page 7 of 31
2.2 System resource requirement
The table gives an overview over the system resources that will be needed by the driver.
Resource Driver requirement Devices requirement
Memory < 1 KB < 1 KB
Stack < 1 KB ---
Semaphores --- ---
Memory and Stack usage may differ from system to system, depending on the used compiler
and its setup.
The following formula shows the way to calculate the common requirements of the driver and devices.
<total requirement> = <driver requirement> + (<number of devices> * <device requirement>)
The maximum usage of some resources is limited by adjustable parameters. If the application
and driver exceed these limits, increase the according values in your project.

TIP675-SW-42 – VxWorks Device Driver Page 8 of 31
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 tip675Drv()
NAME
tip675Drv() - installs the TIP675 driver in the I/O system
SYNOPSIS
#include “tip675.h”
STATUS tip675Drv(void)
DESCRIPTION
This function initializes the TIP675 driver and installs it in the I/O system.
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.
EXAMPLE
#include "tip675.h”
/*------ Initialize Driver -----*/
status = tip675Drv();
if (status == ERROR)
{
/* Error handling */
}
RETURNS
OK, or ERROR if the function fails.

TIP675-SW-42 – VxWorks Device Driver Page 9 of 31
ERROR CODES
The error codes are stored in errno and can be read with the function errnoGet().
The error code is a standard error code set by the I/O system (see VxWorks Reference Manual).
SEE ALSO
VxWorks Programmer’s Guide: I/O System

TIP675-SW-42 – VxWorks Device Driver Page 10 of 31
3.2 tip675DevCreate()
NAME
tip675DevCreate() – Add a TIP675 serial channel device to the VxWorks system
SYNOPSIS
#include “tip675.h”
STATUS tip675DevCreate
(char *name,
int devIdx,
int funcType,
void *pParam
)
DESCRIPTION
This routine adds the selected device to the VxWorks system. The device hardware will be setup and
prepared for use.
This function must be called before performing any I/O request to this device.
PARAMETER
name This string specifies the name of the device that will be used to identify the device, for example
for open() calls.
devIdxThis index number specifies the TIP675 minor device number to add to the system.
If modules of the same type are installed the device numbers will be advised in the order the
IPAC CARRIER ipFindDevice() function will find the devices.
For TIP675 devices there is only one devIdx per hardware module starting with devIdx = 0.
funcType
This parameter is unused and should be set to 0.