Tews Technologies TIP815-SW-12 Bedienungsanleitung

TIP815--SW--12

OS--9 Device Driver

for TIP815 ARCNETInterfaceIP

Version1.4

Revision1.1

22 June 1999

TEWSDATENTECHNIKGmbH

AmBahnhof7

D--25469 Halstenbek

Germany

Tel.:+49 (0)4101 4058 0

Fax:+49 (0)4101 4058 19

EMail:Support@tews.com

Web:http://www.tews.com

TIP815--SW--12

ARCNETInterfaceIP

OS--9DeviceDriver

Thisdocumentcontainsinformation,whichisproprietaryto TEWSDATENTECHNIKGmbH.Any

reproduction withoutwrittenpermission isforbidden.

TEWSDATENTECHNIKGmbHhasmade anyeffort toensurethat thismanual isaccurate and

complete.HoweverTEWSDATENTECHNIKGmbHreservestheright tochangetheproduct

describedinthisdocumentatanytimewithoutnotice.

Thisproducthasbeendesignedtooperatewith TEWSDATENTECHNIKGmbH’sTIP815ARCNET

InterfaceIndustryPackrcompatiblemodule.

TEWSDATENTECHNIKGmbHisnotliableforanydamagearisingoutoftheapplicationoruseofthe

softwaredescribedherein.

e1999 byTEWSDATENTECHNIKGmbH

IndustryPack isaregisteredtrademarkof GreenSpringComputers,Inc

1.Introduction 3.........................................

2.Installation 4..........................................

3.I/Ointerfacefunctions 5.................................

3.1.t815_open() 5..............................................

3.2.t815_close() 6..............................................

3.3.t815_read() 7...............................................

3.4.t815_write() 9..............................................

3.5.t815_cntrl() 11...............................................

4.DeviceDescriptor 15.....................................

5.Appendix 16............................................

5.1.Predefined Symbols16........................................

5.2.Statusand ErrorCodes17.....................................

1. Introduction

TheTIP815--SW--12 OS--9devicedriverallowstheoperation oftheTIP815 ARCNETIPwitha

device--independentinterfacewitht815_open,t815_read,t815_writeandt815_cntrlfunctions.

AfterinstallationofthedevicedriverintheI/Osystemmessagescanbetransmittedtoandreceived

fromtheARCNETInterfacebycallingthet815_write() ort815_read() functions.

SpecialI/Ooperation thatdo notfit tothestandardI/Ocallswill beperformed bycallingthe

t815_cntrl() function withaspecificfunction code andan optionalfunction--dependentargument.

Thisdriverinvokeamutualexclusionandqueuingmechanismtopreventsimultaneousrequestsby

multipleusersfrominterferingwitheach other.

2.Installation

TheTIP815--SW--12 OS--9driversoftwareisdeliveredon a 3.5” floppydisc.

Thefloppyhasfollowingcontents:

/d0/tip815/t815driv.cTIP815 devicedriverCsource

/d0/tip815/t815adriv.aTIP815 devicedriverassemblertoC interface

/d0/tip815/t815cif.aTIP815 devicedriverapplication call interface

/d0/tip815/t815stat.aTIP815 devicestaticstorage allocation

/d0/tip815/t815A.aTIP815 devicedescriptorIP- -slotA(MVME162)

/d0/tip815/t815B.aTIP815 devicedescriptorIP- -slotB(MVME162)

/d0/tip815/t815C.aTIP815 devicedescriptorIP- -slotC(MVME162)

/d0/tip815/t815D.aTIP815 devicedescriptorIP- -slotD(MVME162)

/d0/tip815/tip815.hTIP815 application programinclude

/d0/tip815/local.hTIP815 devicedriverinclude

/d0/tip815/ipchip.hMVME162 IPchip definitions

/d0/tip815/arcnet.hARCNETcontrollerprogrammingmodel

/d0/tip815/makefileMakefiletobuildthedriver

Thedistribution containspredefined devicedescriptorsforthefourIP slotsoftheMVME162.

DescriptorAddress VectorLevel

t815A0xfff58000 0x80 1

t815B0xfff58100 0x81 1

t815C0xfff58200 0x82 1

t815D0xfff58300 0x83 1

Afteryou’vecopiedall filesfromthedisk,you havetochoosetheversion ofyourOS--9.Edit the

Makefile andenablethelinesettingtheflagsforyourOS--9version:

$eMakefile

Afteryou choosetheusedOS--9version, thedrivercanbebuildwiththefollowingcommand:

$make

Thedriveranditscorrespondingdevicedescriptorscanbeloadedintotherunningsystemwiththe

command:

$load--dt815drvt815At815Bt815Ct815D

Thedevicedrivermustbeinitializedforeachdevicedescriptorwithacommandlike:

$inizt815A...

AllTIP815I/Osystemcalls(t815_open(),t815_close()andt815_cntrl())canbecalleddirectlyoutof

theC--code application programbyusingtheCcall interface.

To dothisitisnecessarytolinktherelocatableobjectt815cif.rwiththe application program.

Forexample:$cc ... program.ct815cif.r...

3.I/O interface functions

ThischapterdescribestheinterfacetotheI/Osystemusedforcommunication overtheARCNET

Interface.

3.1. t815_open()

NAME

t815_open() - - openapathtoaTIP815 device

SYNOPSIS

int t815_open(DeviceName,PathNr )

char*DeviceName;/*nameofthedeviceto open*/

int*PathNr;/*path number returned bythiscall */

DESCRIPTION

BeforeI/OcanbeperformedtotheTIP815 deviceitmustbeopened byinvokingtheI/O function

t815_open().

Thepath numberisusedtoidentifythedeviceinsubsequentservicerequests.

EXAMPLE

...

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

openthedevicenamed”/t815A” forI/O

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

result=t815_open(”/t815A”,&path);

....

RETURNS

returnsE_NOERR(0)ifthedevicewassuccessfulopened,oranappropriateerrorcodeifthedevice

doesnotexist.

SEE ALSO

I/Osystemcall I$Close

3.3. t815_read()

NAME

t815_read() - - readamessagefromspecifiedTIP815 device

SYNOPSIS

int t815_read(PathNr,io_flags,MsgBuf)

intPathNr;/* Path number*/

intio_flags;/*I/O flags:[T815_FLUSH|T815_NOWAIT]*/

T815_MSG*MsgBuf;/* Pointertothemessagebuffer*/

DESCRIPTION

Once a TIP815 devicehasbeen opened, taskscanreadmessagesfromthedevice.

Becausemoreinformationsasthepuredatabytesarerequiredforthereadrequestwehave

designedaspecialI/Odatastructure(T815_MSG).

ThisdatastructurecontainsthereceivedDataPacketwithsource and destination ID,message

lengthandmessagedata.

typedefstruct{

unsignedcharSID;/*Source ID*/

unsignedcharDID;/*DestinationIDor0forbroadcasts */

unsignedshortlen;/*Messagedatalength*/

unsignedchardata[MAX_LONG_MSG];/*Messagedata*/

/*253 bytesforshortpackets */

/*508 bytesforlong packets */

}T815_MSG;

IftheI/OflagT815_FLUSHisset, aflushofthereadringbufferwillbeperformedbeforeactivationof

thereadrequest.

Ifthedeviceisblockedbyanotherreadrequestornomessageisavailableinthereadbufferandthe

I/O flagT815_NOWAITisnotset, therequestingtaskwill beblockeduntil amessagewasread.

Aftersuccessfulcompletion ofareadrequestSIDcontainstheSourceID,DIDcontainsthe

Destination ID,len thenumberofdatabytesanddata[] thereceivedmessage.

EXAMPLE

#include”tip815.h”

{T815_MSGrcvbuf;

intstatus;

intpath;

status=t815_open(”/t815A”,&path);

/*readamessagefromopenedTIP815 device.

oflushtheinputring bufferbeforereading

oreturnimmediatelyifthereisno message available

status=t815_read(path,T815_FLUSH|T815_NOWAIT,&rcvbuf);

if(status== E_NOERR){

/*process message*/

}

else{

/*handledevice error*/

}

RETURNS

E_NOERR ifreadwas successfuloranappropriate errorcode

INCLUDEFILE

tip815.h

3.4. t815_write()

NAME

t815_write() - - write a messagetospecifiedTIP815 device

SYNOPSIS

int t815_write(PathNr,io_flags,MsgBuf)

intPathNr;/* Path number*/

intio_flags;/*I/O flags:[T815_NOWAIT]*/

T815_MSG*MsgBuf;/* Pointertothemessagebuffer*/

DESCRIPTION

Thisroutinewrite a messagetothespecifiedTIP815 device.

Becausemoreinformationsasthepuredatabytesarerequiredforthewriterequestwehave

designedaspecialI/Odatastructure(T815_MSG).

ThisdatastructurecontainstheDataPacketwithsource and destination ID,messagelengthand

messagedata.

typedefstruct{

unsignedcharSID;/*Source ID*/

unsignedcharDID;/*DestinationIDor0forbroadcasts */

unsignedshortlen;/*Messagedatalength*/

unsignedchardata[MAX_LONG_MSG];/*Messagedata*/

/*253 bytesforshortpackets */

/*508 bytesforlong packets */

}T815_MSG;

TheparameterSID isnotused.

TheparameterDIDspecifiestheDestination ID(Destination nodehardware address).

Theparameterlenspecifiesthenumberofdatabytes(data[])tobetransferred.Thenumberofdata

bytesislimitedto253 bytesforshortpacketsand508 bytesforlong packets.

TheonlyvalidI/O flagsetinio_flagsisT815_NOWAIT.If thisflagis set, t815_write() returns

immediatelyafterstartingtransmission,otherwiset815_write()waituntilthemessageistransmitted

andacknowledgedoranerroroccur.

If thedeviceisblocked byan otherwriterequest, therequestingtaskwill beblockeduntil the

transmitterbecomefree ortherequest timesout.

Inhaltsverzeichnis

Andere Tews Technologies Computerhardware Handbücher

Tews Technologies

Tews Technologies TPMC321 Bedienungsanleitung

Tews Technologies

Tews Technologies TAMC020-TM Bedienungsanleitung

Tews Technologies

Tews Technologies TA900 Bedienungsanleitung

Tews Technologies

Tews Technologies TMPE627 Bedienungsanleitung

Tews Technologies

Tews Technologies TPMC551-SW-95 Bedienungsanleitung

Tews Technologies

Tews Technologies TMPE633 Bedienungsanleitung

Tews Technologies

Tews Technologies TAMC261 Bedienungsanleitung

Tews Technologies

Tews Technologies TVME201 Bedienungsanleitung

Tews Technologies

Tews Technologies TPCE261-10R Bedienungsanleitung

Tews Technologies

Tews Technologies TDRV003-SW-65 Bedienungsanleitung

Tews Technologies

Tews Technologies TXMC638 Bedienungsanleitung

Tews Technologies

Tews Technologies TCP270 Bedienungsanleitung

Tews Technologies

Tews Technologies TPMC463 Bedienungsanleitung

Beliebte Computerhardware Handbücher anderer Marken

EMC2

EMC2 VNX Series Betriebsanleitung

Panasonic

Panasonic DV0PM20105 Bedienungsanleitung

Mitsubishi Electric

Mitsubishi Electric Q81BD-J61BT11 Bedienungsanleitung

Gigabyte

Gigabyte B660M DS3H AX DDR4 Bedienungsanleitung

Raidon

Raidon iT2300 Bedienungsanleitung

National Instruments

National Instruments PXI-8186 Bedienungsanleitung

Hauppauge

Hauppauge WinTV-HVR-2250 Bedienungsanleitung

Kontron

Kontron CP6002 Bedienungsanleitung

Manhattan

Manhattan 702843 Bedienungsanleitung

Aphex

Aphex 230 Bedienungsanleitung

AMD

AMD Phenom II Betriebshandbuch

Intel

Intel NUC 12 Pro Bedienungsanleitung

dbx

dbx Zone Pro 1260 Bedienungsanleitung

Galaxy

Galaxy GHDX2-2430S-24F4D Bedienungsanleitung

Intel

Intel AXXRMFBU4 Bedienungsanleitung

Kontron

Kontron DIMM-PC/MD Bedienungsanleitung

ST X-NUCLEO-SAFEA1B Betriebsanleitung

STEINWAY LYNGDORF

STEINWAY LYNGDORF SP-1 Bedienungsanleitung