Board Setup Guide!

[edit this page]

PDF version

e-reader (epub)

Scope of this Document

This document describes the first steps to getting started to use the SERENITY prototype system. More details about the SERENITY board can be found here: SERENITY overview and technical specs.

All content is covered by the Serenity Collaboration Licence (CC BY-NC-ND 4.0).

• First Steps
  • Accessing the Daughter Card Sites:
  • Installation (SMASH & EMP)
  • Power up!
  • Uploading firmware to the daughter cards
  • Checking communication with the loaded firmware
  • Next Steps:
• Artix TTC
  • Configuring the TTC firmware
  • Checking the firmware version
• Cheatsheet for test stands (serenitybutler etc.)
  • Version checks
  • Power control
  • Reference clock and firefly configuration
  • Programming the daughter card FPGAs
  • Crosspoint switch
  • XVC server
  • Artix TTC
  • Test suite
  • Running docker containers
  • Changing the CPU frequency governor
• Troubleshooting and FAQ
  • Advanced Troubleshooting
  • Uncommon Issues
• Advanced procedures
  • Memory and Artix service firmware
    • Memory Devices
    • Create memory file
    • Programming the Artix
    • Bitfiles for Artix firmware
  • On-board computer: Adding CERN accounts
    • CERN accounts, Kerberos & AFS
    • SSH access for large groups of users
• Current software and firmware versions
  • Recommended versions
  • Checking versions: Recommended method
  • Checking versions: Alternate method

Status of this Document

First steps to using the SERENITY prototype system.

• Rev 1.0: First version - Alex Howard, 3rd April 2019.

• Rev 1.1: Second version - Alex Howard, 9th April 2019.

• Rev 1.2: Added latest smash functionality and XVC - Alex Howard, 28th June 2019.