= Project APOLLO =

|| [[Image(http://ohm.bu.edu/~hazen/APOLLO/figs/apollo_200.png)]] || This is a project to develop a common ATCA blade which can be used for readout and triggering applications in LHC experiments.  It is named after the Apollo program CSM spacecraft which separated into Command and Service modules. || [[Image(http://ohm.bu.edu/~hazen/APOLLO/gallery/cm.jpg, link=[http://ohm.bu.edu/~hazen/APOLLO/gallery/])]] [http://ohm.bu.edu/~hazen/APOLLO/gallery Photos] ||

== Quick Links ==

* TWEPP 2019 paper: [http://arxiv.org/abs/1911.06452 arXiv:1911.06452] [http://gauss.bu.edu/svn/common-atca-blade/Meetings/2019-09-03_TWEPP/APOLLO-Hazen.pdf Talk]
* Document SVN:  http://gauss.bu.edu/svn/common-atca-blade
* Hardware SVN:  http://gauss.bu.edu/svn/common-atca-blade.hardware (BU Service Module)
* Firmware SVN:  http://gauss.bu.edu/svn/common-atca-blade.firmware
* Software SVN:  http://gauss.bu.edu/svn/common-atca-blade.software
* !GitHub:  https://github.com/apollo-lhc (Cornell Command Module)
* Rev 1 Schematics: 
 * Service module (Boston): [http://gauss.bu.edu/svn/common-atca-blade.hardware/Blade/tags/RevA-AsBuilt/pdf/carrier.pdf carrier.pdf]
 * Command module (Cornell): [http://ohm.bu.edu/~hazen/APOLLO/atca_mezz_ku15p_vu7p_30Aug2019.pdf atca_mezz_ku15p_vu7p_30Aug2019.pdf] (local copy)
 * FrontPanelBoard: [http://gauss.bu.edu/svn/common-atca-blade.hardware/Blade_FP/trunk/Blade_FP.pdf schematic] • [http://gauss.bu.edu/svn/common-atca-blade.hardware/Blade_FP/trunk/board.pdf pcb]
* DRAFT specification (ATLAS specific for now):  [http://gauss.bu.edu/svn/atlas-phase-2-muon-upgrade/Documents/Proto0_Blade/trunk/common_blade.pdf common_blade.pdf]
* FacePlateMechanics
* [http://ohm.bu.edu/~hazen/Private/Latest%20Apollo%20FPGA%20delivery%20estimates%20from%20AVNET.eml.txt FPGAs]
* [[Apollo Inventory]] -- List of boards with location and status (including MAC/IP addresses)
* [[ApolloIPMC]] -- Documentation on IPMC for Apollo (see also [https://cern-ipmc.web.cern.ch/ CERN IPMC] page)
* [[ServiceModuleRevAECOList]] -- list of ECOs for the Rev A service module
* Others: [http://serenity.web.cern.ch/serenity/ Serenity] APX?
* [[Apollo Bring-up]] -- Instructions for powering up and testing ECO'd SMs.
* [[TODOs]]


== Remote Users ==
* [[Apollo Inventory]] -- List of boards with location and status
* Blade IPs at the TIF [https://twiki.cern.ch/twiki/bin/viewauth/CMS/Ph2TrackerTIF here].
* [http://cmssun1.bu.edu/cgi-bin/index.cgi BU SM status (realtime)]
* [https://calendar.google.com/calendar/embed?src=bu.edu_rbojj49vehale4lgigeqmsf50o%40group.calendar.google.com&ctz=America%2FNew_York&mode=WEEK Remote Access Calendar]
* [[Remote Access Instructions]]
* [[Apollo SM recipes]]
* [[Apollo SM troubleshooting]]


== Debug Log ==
* [[Apollo RevA]] -- '''Please log all debugging activity here'''

== Software ==
* UIOuHAL [https://gauss.bu.edu/redmine/projects/common-atca-blade/repository/raw/Meetings/2019-08-19/Apollo-Update.pdf Slides 10-12] [https://github.com/dgastler/ipbus-software/tree/feature-UIOuHAL GITHUB UIOuHAL] 
* BUTool+ApolloSM single [https://github.com/apollo-lhc/ApolloTool checkout]
== Firmware ==
* [[SM Zynq]] [[SM IPMC]]
* [[CMS CM Kintex]] [[CMS CM Virtex]] [[CMS CM uC]]

== Aux boards ==
* [[ApolloClocksTestBreakout]] -- "PicoDTH" clocks breakout for ATCA J23
* [[DummyCommandModule]] -- Breakout/loopback for CM connectors

== Rev A Comments ==

* {{{EN_ONE_JTAG_CHAIN}}} should have a pull-up/down and/or jumper so something sensible happens when the IPMC is not installed or programmed.
* Serial comms between Zynq and CM should be possible without IPMC intervention.
* How to turn on payload power with no IPMC installed/running?
* JTAG (and other GPIO) signals must obey ENABLE/READY to avoid driving CM logic when not powered

== Reference Material

* ATLAS SoC URD [https://edms.cern.ch/document/2188675 EDMS]
* [http://ohm.bu.edu/~hazen/edf_joule/PICMG/PICMG-3.0-R3.0_withErrata001.pdf ATCA spec] (password)
* CMS ATCA use: [http://ohm.bu.edu/~hazen/CMS/TrackTrigger/IN2018_002.pdf IN2018_002.pdf] (update April 2019)
* CMS DTH spec: [http://ohm.bu.edu/~hazen/CMS/TrackTrigger/IN2018_001.pdf IN2018_001.pdf] (update April 2019)
* [https://gitlab.cern.ch/cms-tracker-phase2-backend-development-engineering CMS tracker repository]
* [[Carrier specs]]
* [[ZYNQ DBS]] - Zynq daughterboard information
* [http://ohm.bu.edu/~hazen/DataSheets/ATCA/ENG_DS_3-1773445-8_0707.pdf TE Connectivity ATCA brochure]
* [[JtagSVFProgramming]] -- collected notes on JTAG from SVF files

== Firmware Reference

* [https://ipbus.web.cern.ch/ipbus/ IPBus repository]
* [http://serenity.web.cern.ch/serenity/emp-fwk/ipbb-primer.html# IPBB Primer] (IPBus builder)

[[ApolloHistory]] -- older stuff