
Querying the Availability of Connected Pods (-q option) Using the Achronix STAPL Player
PAGE 34
www.achronix.com Bitporter User Guide
With thisinformation, theuser would subsequently connectto either usb12345 or net12347,
viathe-pcommand‐lineoption.
Querying the Availability of Named Pods
Therearetwotypicalcaseswherea userwoulddesiretoquery thestateofspecificpodsby
name:
1. Theuserwishestoquerytheavailabilityofanon‐localpod (aBitporterconnectedtoa
differentEthernetsubnetthanthehostrunningtheSTAPLPlayer).
2. Therearemultiplepodsvisiblefrom
thehost,buttheuseronlywishestoqueryasub‐
setofthesepodsforperformancereasons.
Unlikeotherpodinteractionmodes(‐aand‐i),pod statusquerieswillcheckthestatus ofall
namedpods,andwillnotstopatthefirstsuccessfulconnection.
UnlikeAutodetectionmode,whenpods
arespecificallynamedwith‐p,theavailabilitystatus
tablewillincludeastatusentryforunavailableUSBpodsandnon‐localEthernetpods.Itwill
alsoincludeanerrorstatusforanypodnameswhichcouldnotbefound.
SimilartoAutodetectionmode,theavailabilityresultsarereturnedintabularform,with
the
first column containing the pod name, and the second column containing availability
information.Iftherewereerrorsdetectingtheavailabilityofapod,theerrorinformationwill
beincludedinthesecondcolumn.
Theavailabilityresultstablewillbesortedfirstbyavailability,thenbytheorderofthenames
givenby
theuser.Availablepodswillalwaysbelistedbeforeunavailablepods,whichwillin
turnbelistedbeforepodswhichcouldnotbefound.
Thefollowingpodstates canbeexpected:
USB pod names:
NamedUSBpodswillbeshowninoneoftwostates.
•Ifthepodissuccessfullyfound,thismeansitisavailable,anditsdetectedavailability
willbeshownas++AVAILABLE++.
•Otherwise, when the pod is not found, this means it is either not connected to the
host,oritis
inusebyanotherinstanceofacx_stapl_player. Inthiscase,thepodstatus
willbeshownas--in use or not connected--.
Ethernet pod names:
ThereareseveralpossiblestatesthatmaybeshownfornamedEthernetpods.
•If the pod is successfully detected and is available, the status shown will be
++AVAILABLE++.
•Ifthepodissuccessfullydetectedbutisnotavailable(itisalreadyinuse),thelisted
statuswillbe--in use, owner is <ip_address>--.TheIP
addressreported
willbetheaddressofthehostthatiscurrentlyutilizingthenamedBitporter.
•Ifthepodnamecontainsaserialnumber,andthepodisnotdetected,thestatuswill
be --No available Achronix Bitporter products with matching
serial number found on local subnet.--(Rememberthatpodnameswith
serialnumbersonlyreachthelocalEthernetsubnet;podsonadifferentsubnet
from
thehostmustbenamedusingtheirIPaddress.)
•IfthepodnamecontainedanIPaddress,andnothingwasfoundatthataddress,the
status will be --No available Achronix Bitporter product found at
supplied network address.--.
Comentários a estes Manuais