Tews Technologies TIP815-SW-12 Manuale utente

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.

Indice

Altri manuali Tews Technologies Hardware per computer

Tews Technologies

Tews Technologies TDRV003-SW-65 Manuale utente

Tews Technologies

Tews Technologies TPMC463 Manuale utente

Tews Technologies

Tews Technologies TMPE627 Manuale utente

Tews Technologies

Tews Technologies TPMC551-SW-95 Manuale utente

Tews Technologies

Tews Technologies TPMC321 Manuale utente

Tews Technologies

Tews Technologies TPCE261-10R Manuale utente

Tews Technologies

Tews Technologies TCP270 Manuale utente

Tews Technologies

Tews Technologies TAMC261 Manuale utente

Tews Technologies

Tews Technologies TA900 Manuale utente

Tews Technologies

Tews Technologies TAMC020-TM Manuale utente

Tews Technologies

Tews Technologies TXMC638 Manuale utente

Tews Technologies

Tews Technologies TMPE633 Manuale utente

Tews Technologies

Tews Technologies TVME201 Manuale utente

Manuali Hardware per computer popolari di altre marche

EMC2

EMC2 VNX Series Manuale del proprietario

Panasonic

Panasonic DV0PM20105 Manuale utente

Mitsubishi Electric

Mitsubishi Electric Q81BD-J61BT11 Manuale utente

Gigabyte

Gigabyte B660M DS3H AX DDR4 Manuale utente

Raidon

Raidon iT2300 Manuale utente

National Instruments

National Instruments PXI-8186 Manuale utente

Hauppauge

Hauppauge WinTV-HVR-2250 Manuale utente

Kontron

Kontron CP6002 Manuale utente

Manhattan

Manhattan 702843 Manuale utente

Aphex

Aphex 230 Manuale utente

AMD

AMD Phenom II Manuale operativo

Intel

Intel NUC 12 Pro Manuale utente

dbx

dbx Zone Pro 1260 Manuale utente

Galaxy

Galaxy GHDX2-2430S-24F4D Manuale utente

Intel

Intel AXXRMFBU4 Manuale utente

Kontron

Kontron DIMM-PC/MD Manuale utente

ST X-NUCLEO-SAFEA1B Istruzioni operative

STEINWAY LYNGDORF

STEINWAY LYNGDORF SP-1 Manuale utente