= 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] ||


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

== Quick Links ==
* [https://apollo-lhc.gitlab.io/ Apollo Manual]
* 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
* Monitoring at [https://edf.bu.edu/shelf_data/d/TWjb6eUZk/fantrays?orgId=1&refresh=30s BU]
* Mechanical Drawing: https://ohm.bu.edu/~hazen/APOLLO/APOLLO_MECH.pdf


== Remote Users ==
* [[Remote Access Instructions]]
* [https://github.com/apollo-lhc/CU_PCB_6089-103/blob/master/Docs/ApolloSM_inventory.md SM Inventory git ] -- Most accurate, but only SM modules 
* 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)]


== HW ==
* [[Apollo Inventory]] -- List of boards with location and status (including MAC/IP addresses)

== SM ==
* Hardware !GitHub:  https://github.com/apollo-lhc ([https://gitlab.com/apollo-lhc/apollosm-hw Service Module])
 * (historical) SVN:  http://gauss.bu.edu/svn/common-atca-blade.hardware (BU Service Module)

=== Rev 2a ===

 * [https://gitlab.com/apollo-lhc/apollosm-hw/-/blob/03de221c32f0bd3c494af8b6b18e334daf6975f3/pdf/carrier.pdf pdf]

=== Rev 2 ===
* [[Rev2 SoCs]] (list of compatible SoCs)
* [[ApolloKiraAdapter]] (sic) project to make an adapter for XIlinx "Kria" modules
* [[ServiceModuleRev2ECOList]] -- list of ECOs for the Rev 2 service module

* Rev 2 Schematics: 
 * Service module (Boston): [http://ohm.bu.edu/trac/edf/attachment/wiki/CommonATCA/carrier.pdf carrier.pdf]

=== Rev 1/A ===
* Rev 1 Schematics:
 * Service module (Boston): [http://gauss.bu.edu/svn/common-atca-blade.hardware/Blade/tags/RevA-AsBuilt/pdf/carrier.pdf carrier.pdf]
 * 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]
 * FacePlateMechanics
* Comments / ECOs
  * {{{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
  * [[ServiceModuleRevAECOList]] -- list of ECOs for the Rev A service module


== CM ==

 * Hardware: [https://github.com/apollo-lhc Github] (Cornell)
 * [[BuTestCM]] - 2022 development of new, simple CM for testing
 * [[CM-SM Dev]]


 
== IPMC ==
* [[ApolloIPMC]] -- Documentation on IPMC for Apollo (see also [https://cern-ipmc.web.cern.ch/ CERN IPMC] page)


== ATLAS ==
* 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]



== Purchasing ==
* [http://ohm.bu.edu/~hazen/Private/Latest%20Apollo%20FPGA%20delivery%20estimates%20from%20AVNET.eml.txt FPGAs]
* Others: [http://serenity.web.cern.ch/serenity/ Serenity] APX?
* [[TODOs]]


=== Info and Help ===
* [[Apollo SM recipes]]
* [[Apollo SM troubleshooting]]




== 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]
* [[ApolloSM Software ToDo]] -- ApolloSM Software To-Do-List  
== Firmware ==
* [[SM Zynq]] [[SM IPMC]]
* [[CMS CM Kintex]] [[CMS CM Virtex]] [[CMS CM uC]]
* [http://ohm.bu.edu/trac/edf/wiki/network%20boot net-boot notes]
== Aux boards ==
* [[ApolloClocksTestBreakout]] -- "PicoDTH" clocks breakout for ATCA J23
* [[DummyCommandModule]] -- Breakout/loopback for CM connectors

== 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
* [[Zynq eMMC]]
* [[device-tree]]

== 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