Prepare a blank USB key with relevant z-packages, optional ssh keys,
and panda-config.txt. ZPKG files and panda-config.txt can be
downloaded from open hardware and GitHub (In
dls they are cached in /dls_sw/work/targetOS/PandABox-usb-stick).
Make sure switches on the picoZ and carrier board are in the correct
position. They should all be set to 1 (all 'up') as in the following
The JP26 Jumper is located near the USB port in the back left of the
board on the USB circuit (see following picture). Make sure this is
NOT connected. *If left connected it will cause the picozed to keep
rebooting when a USB key is
Insert the Control encoder boards (Yellow dot)
Insert the FMC loop back card
Connect the PandA unit to the serial port and open a serial terminal
(screen) with the following command, then hit 'Enter' screen /dev/ttyS0 115200
*NOTE: to exit from screen use "CTRL + \ + a" and then ":" and
write "quit" followed by rtn
Connect the power cable and ethernet cable
Power on the panda and watch the output on the serial console
If you are reinstalling packages on a previously set up panda,
the MAC address stored in the /qspi directory on the Panda will
be used and there will be no prompt to enter a new MAC.
The boot process takes a couple of minutes. When booted the front
panel ERR LED will change to flashing red and there will be a prompt
to enter the appropriate MAC address. This is case sensitive and
should be entered in the following format: XX:XX:XX:XX:XX:XX
If the MAC was entered incorrectly, or a mistake has been made,
simply put some extra digits on the end (to give it an incorrect
format) and hit Enter. This will cause the validation to fail
and you will be prompted to enter it again.
When the LEDS change back to ERR (front panel): Flashing red, then
it is booted and ready for software installation
In dls you can just cd /dls_sw/work/targetOS/PandABox-tst
Execute the following command: python run_tests.py 192.168.0.100
Follow the script instructions. If a test fails, you will be
prompted to check the connectors and try again. There is only
When finished, the script will prompt you if you want to view
the log. Logs are also stored in the 'log' directory.
After the hardware tests are complete; power off the PandA and
remove the loop back connectors, USB key, and FMC loopback card.
Install the appropriate encoder daughter cards beamline use
Install the appropriate FMC card for beamline use
Install the appropriate z-packages for beamline use, if no FMC card, use panda-fpga@PandABox-no-fmc-x.x.zpg
Screw on lid
Put a sticker with the MAC address on the front panel underneath
the Ethernet port
TEST CONFIG SETUP
The test script is able to be configured to test different
components as desired. The default is to test everything unplugged
and plugged, however, when debugging a specific area it might be
useful to only test one component.
Tests are configured by editing the config file (PandATests/config)
by specifying a test followed by a block number if relevant.
Comments are defined by a '#'. See the following example: