================================================================================
PAGE 21
================================================================================

Green Open
Yellow Alternating (CanbesetviaAlternate Contact action)
Gray Unavailable
Information
IftheGeViIO clientwasconnected torealDIOhardware, youcouldseetheinput
signals changing inrealtime.Setting oftheoutputs would result inswitching
realloads.


================================================================================
PAGE 22
================================================================================

Actions
SofaryouonlyusedGeViAPITestClient’sbuilt-infunctionality tointeractwithGeViServer.
InthischapteryouwilllearntouseGeViSoftactionstocontrolthesystem.
GeViSoftactionscanbesentbytypingthemintothetextboxinthelowermiddleoftheGeVi-
APITestClient’swindow.Youcanfindacompletelistofthepossibleactionsinthedoc-
umentation.
Hint
Youcaninteractively generate actions andlearnabouttheirparameters bycom-
posing theminGeViSet. Therefore, openGeViSet, andconnect totheserver.
Thennavigate toServer ->Named actions andpressAddinthewindow that
popsup.Inthewindow Named action settings youmaypressthebutton withthe
threedots(“…”)totakeyoutotheAction settings menu.
Thereyoucanchoose anyoftheimplemented actions andviewtheirparameters
andsettings. Tofiltertheactions bycategory choose oneofthecategories from
theupper leftlistbox.Hoover themouse overanyoftheparameters togeta
detailed description ofit.
Asanexample select Crossbar control asacategory andmovetoCrossSwitch to
seethemessage’s parameters ontherightside.
Thecomplete message is:
CrossSwitch (IDVideoInput, IDVideoOutput, Switchmode) .
CrossSwitching Video
1.Routevideofromaninputtoanoutput--Tosendthevideofrominput7tooutput3,do
thefollowing:

================================================================================
PAGE 23
================================================================================

a)TypethisactionintothetextboxinthelowermiddleoftheGeViAPITestClient
windowandsendit: CrossSwitch (7,3,0)
b)Makesurethatthesignalisroutedaccordingly bycheckingtheoutputinthetab
Video/DigIO
c)Routevideoinput3tooutputchannel2.(CrossSwitch (3,2,0))
2.Clearvideooutput2:ClearVideoOutput (2)

================================================================================
PAGE 24
================================================================================

Crossswitching video1

================================================================================
PAGE 25
================================================================================

Manipulating DigitalI/O
1.Opencontact1andclosecontact2--TheactionsOpenContact (ContactNumber) and
CloseContact (ContactNumber) canbeusedtosetthedigitaloutputsfromGeViSoft.
a)Toopencontact1sendtheaction:OpenContact (1)
b)IntheTabVideo/DigIO ofGeViAPITestClientmakesurethattheindicationof
outputonehasturnedtogreen
c)Toclosecontact2sendtheaction:CloseContact (2)
d)Makesurethattheoutputturnedred.
2.Simulateaclosingoftheinputcontact3andanopeningoftheinputcontact5
a)InputContact (3,true)
b)Makesurethatinput3issignaling closed(redindication)
c)InputContact (5,false)
d)Makesurethatinput5issignaling open(greenindication)
3.Alternating acontact --Simulateaflashlightonoutput8
a)Toalternateacontact,youcanusetheactionAlternateContact (ContactID,
BlinkPeriod_ in_ms,BlinkOnTime_ in_ms)
b)Sendthecommand toflashthelightwithafrequency of1Hzandadutycycleof
500ms: AlternateContact (8,1000,500)

================================================================================
PAGE 26
================================================================================

c)Checkthatthecontactisalternating –afterpressingtheRefreshbutton,theout-
put8stateshouldbealternating (yellow).

================================================================================
PAGE 27
================================================================================



================================================================================
PAGE 28
================================================================================

Manipulating digitalIO

================================================================================
PAGE 29
================================================================================

GETAS
InthischapteryouwilllearnaboutGETAS,theGeutebrück TelnetActionServer.The
GETAScomponent allowsyoutosendandreceiveGeViSoftactionsviatelnet.Multiple
clientscanconnecttooneGeViServer atatime.
Thetelnetinterfaceallowsyoutoeasilyintegratesimpleapplications intoyourGeViSoftinfra-
structure.Furthermore itoffersanoptiontoconnectnon-Windowsplatforms.
 CAUTION
Bydefault, GETASisnotactive.Toactivate GETAS, openGeViSet andnavigate toServer->
GETAS.IntheGETASsettings window, youcanthenactivate thecomponent bychecking Enable
TCPport.BydefaultGETASwilllistentoport7707.Leavetheothersettings unmodified and
pressOK.Sendthealteredsetuptotheserverafterwards (File->Setuptoserver).
 CAUTION
Toconnect toGETAS, youneedatelnetclient.YoucaneitherusetheWindows telnetclientora
thirdpartyapplication likeputty.
 ADVICE
IfyouareusingWindows 7,thetelnetclientisnotactivated bydefault. Toactivate itgotoStart
->Control Panel->Programs andFeatures andselecttheTelnetClientfromthelistbox.
NowyoucanconnecttoGeViServer andsendsomeactions.
BasicGETASUsage
1.ConnecttoGeViServer viaGETAS–Openacommand window(cmd.exe) andstart
telnet.Inacommand windowtype:telnetlocalhost 7707

================================================================================
PAGE 30
================================================================================

2.Makesurethatyourinputisechoedlocallybyentering setlocalecho
3.Youmaywanttopressenteroncetoclearyourscreenifnecessary.
4.MakesurethatyoustartedyourGeViAPITestClientandconnected ittotheGeV-
iServer
5.Sendanactiontotheserver:
a)CustomAction (42,"HelloGETAS")
b)Ifyoureceiveanechoofyouractionprecededbya4;fromtheGeViSoftserver,
yourconfiguration isworking
c)VerifythatyoucanalsoseetheactionintheGeViAPITestClient’scom-
munication log.Ifyoucannotseethemessage, makesureyouareconnected and
yourfiltersettingsinthetabFilterGeViSoftaresetcorrectly.Tobesure,setthe
filtertoacceptallmessages.
6.Monitoractionssentbyotherclientsinyourtelnetsession:
a)SendanactionfromGeViAPITestClient:CustomAction (23,"HelloGETAS
client")
b)Verifythatyoureceivedtheactioninyourtelnetwindow.
VideoandIOControlwithGETAS
1.NowcontrolyourvirtualVX3byusingGETAS–MakesurethatGeViAPITestClient
isrunningwhileyouissuecommands viatelnetandyoucanseetheVideo/DigIO tab.
YourGeViIO_01configuration shouldbethesameasinchapterSettingupGeViIO.