PandABox-tst

  1. Put SD card in reader attached to a PC

  2. Obtain the latest boot-x.x.zip for the rootfs build files from https://github.com/PandABlocks/PandABlocks-rootfs/releases (In dls they are unzipped in /dls_sw/work/targetOS/PandABox-sd-card)

  3. Unzip/copy these files to a blank microSD card

  4. Unmount SD card

  5. Put the microSD card into the panda

  6. 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). You need:

    1. panda-fpga@PandABox-fmc_lback-sfp_lback-x.x.zpg for the FPGA firmware from https://github.com/PandABlocks/PandABlocks-fpga/releases
    2. panda-server@x.x.zpg for the TCP server from https://github.com/PandABlocks/PandABlocks-server/releases
    3. panda-webcontrol@x.x.zpg for the web GUI from https://github.com/PandABlocks/PandABlocks-webcontrol/releases
    4. panda-config.txt for the fixed IP address for the test procedure from https://www.ohwr.org/project/pandabox/uploads/d791826d82328579cfe5683ef78803d8/panda-config.txt
    5. pandabox-hw__at__x.x.zpg from https://www.ohwr.org/project/pandabox-hw/wikis/Documents/Hardware-User-Guide
    6. optional authorized_keys file as described here: https://www.ssh.com/ssh/authorized_keys/
  7. Unmount the USB key

  8. Insert the USB key into the panda device

  9. 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 picture

  10. 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 present

  11. Insert the Control encoder boards (Yellow dot)

  12. Insert the FMC loop back card

  13. 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

  14. Connect the power cable and ethernet cable

  15. Power on the panda and watch the output on the serial console

    1. 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.
  16. 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

    1. 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.
  17. When the LEDS change back to ERR (front panel): Flashing red, then it is booted and ready for software installation

panda login: root
password: PandA

Contact

Chris Turner