PicoQuantGmbH MultiHarpSoftwareV.3.1.0.0
WR Console Output
TheWRPCisinternallyrunninganembeddedsoftwarethatprovidesacommandconsolethatinprinciplebe
accessedlikeusingaterminal.ThecurrentimplementationintheMultiHarpfirmwareandsoftwaredoesnotal-
lowfullaccesstothisconsole.However,thegroupofcontrolsdescribedhereprovidesreadaccesstothecon-
soleoutput.IfthetickboxAuto-RefreshischeckedtheWRconsoleoutputisperiodicallyrefreshed.Note
thattheWRPC’sconsoleoutputisprovidingmeaningfulstatusinformationonlywhentheWRPCisrunningand
hasreceivedthecommandguiwhichstartstheWRPCmonitor.
6.8.2. Setting up White Rabbit Connections
Asoutlinedabove,usingWhiteRabbitasaclocksourcefortheMultiHarprequiresestablishingaWRconnec-
tion.Thefollowingdescribesthenecessarystepstosetupsuchaconnectionbytheexampleofapointtopoint
WRconnectionbetweentwoMultiHarpdevices.
AsafirststepitisalwaysnecessarytoswitchtheWRlinkon(startingtheembeddedWRPCsoftware).Thisis
donebyclickingthebuttonLinkOnintheWRdialogofbothdevices.Inordertoseeifthisissuccessfulitis
advisabletohavetheautomaticstatusrefreshenabled.Itmaytakeafewsecondsuntilthelinkisestablished.
NowyoucanselecttheWRmodeofonedeviceasmasterandtheotherasslave.ThenclickthebuttonSet
Modeineachdevice’sWRdialog.ObservethestatusdisplayandwaituntilthePTPstatusswitchestoMAS-
TERandSLAVErespectively.Theconsoleoutputshouldnowsay“LockedCalibrated”ingreenlettersonboth
sidesandontheslavesidetheservostateshouldeventuallyswitchto“TRACK_PHASE”.TheWRconnection
isnowestablishedandyoucaninspecttheconsoleoutput,e.g.,tocheckthetimingaccuracybetweenthetwo
devicesorotherconnectionstatistics.FordetailspleaserefertotheWRPCmanual.
AftertheWRconnectionisestablisheditispossibletosetthecurrenttimeofthemastersideasthecommon
timeformasterandslave.ThiscanbedonebyclickingthebuttonSetTimeatthemaster.Notethatthistime
isobtainedfromtheoperatingsystem(asUTC).Thisisonlyasaccuratew.r.t.trueUTCastheaccuracyofthe
master’sWindowsclocksetting.MoreaccuratetimecanbeobtainedbyusingtheGrandMastermode,which,
however,requiresanaccuratetimesourcesuchasaGPS/GLONASSreceiver,anatomicclockorsimilar,con-
nectedtotheMultiHarpviathe10MHzclockreferenceandPPSinputsatthebackofthehousing.Notehow-
ever,thatsuchfunctionalityisnotyetconvenientlysupportedbytheMultiHarpsoftware.Seriousworkinthisdi-
rectionshouldusetheMultiHarpprogramminglibraryandcustomsoftware.Inpracticeitisprobablymorecon-
venienttouseadedicatedcommercialgrandmasterintheWRnetwork.
WhentheWRconnectionisestablishedand(optionally)theWRtimehasbeenset,theWRdialogcanbe
closedandWRcanbeselectedasthereferenceclocksourcefortheMultiHarp.Notethatthechoiceofmaster
versusslaveintheclocksourceselectionmustmatchtheroleofmaster/slaveoftheWRconnection.
ForregularuseoftheWRconnectionitisrathercumbersometoperformthedescribedconnectionprocedure
manuallyeachtime.Instead,itispossibletoplaceanappropriateinitializationscriptinmasterandslavesothat
itisautomaticallyexecuteduponpower-up.Anexamplefortheslavesidemaylookasfollows:
ptpstop
sfpdetect
sfpmatch
modeslave
ptpstart
gui
Theonlydifferenceforthemastersideissettingmodemaster (or modegm forgrandmaster).Please
notethatthelastlineguiisnotstrictlynecessaryinagenericWRPCnode.However,duetotheMultiHarp‘s
currentimplementationitisrequiredbecausetheWRPCmonitoroutputisusedtoretrievestatusinformationfor
therelatedprogramminglibraryfunctionsandthestatusinformationprovidedintheWRdialog.Formoredetails
onthescriptcommandspleaserefertotheWRPCdocumentation.
Sofar,onlyapointtopointWRconnectionbetweentwoMultiHarpdeviceswasdiscussed.Itisalsopossibleto
connectaMultiHarpwithsomeotherWRnodeandacrossWRnetworkswitches.Sofarthiswastestedwiththe
“SPECboard”andtheWRswitchesfromSevenSolutions.PleasecontactusifyouwishtooperatetheMulti-
HarpwithotherWRhardwareorinamorecomplexnetworksothatwecanadviseorconsultwiththevendor.
Furthermore,someadvancedusesofWRsuchasremoteexperimentcontrolandjointactionofmultiplede-
vicesarenotyetfullyimplemented.Welookforwardtocollaboratewithinterestedusersaswellassuppliersin
ordertoextendandimprovetheMultiHarp‘sWRinteroperabilityandfunctionality.Pleasegetintouch.
Page76