Revise index.html for AERIS-10 documentation site

Updated the HTML structure and content for the AERIS-10 documentation site, including new sections for engineering documentation and navigation links.
This commit is contained in:
NawfalMotii79
2026-04-02 01:42:50 +01:00
committed by GitHub
parent a343c856e3
commit 168b9b2ae0
+68 -642
View File
@@ -1,661 +1,87 @@
<!DOCTYPE html> <!doctype html>
<html lang="en"> <html lang="en">
<head> <head>
<meta charset="UTF-8"> <meta charset="utf-8">
<meta name="viewport" content="width=device-width, initial-scale=1.0"> <meta name="viewport" content="width=device-width, initial-scale=1">
<meta name="description" content="AERIS-10 - Open Source Pulse Linear Frequency Modulated Phased Array Radar System"> <title>AERIS-10 Engineering Docs</title>
<title>AERIS-10 | Open Source Phased Array Radar System</title> <link rel="stylesheet" href="assets/style.css">
<style>
/* Your existing CSS remains exactly the same */
* {
margin: 0;
padding: 0;
box-sizing: border-box;
}
body {
font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, 'Helvetica Neue', Arial, sans-serif;
line-height: 1.6;
color: #1a1a2e;
background: linear-gradient(135deg, #f5f7fa 0%, #e9ecef 100%);
}
.navbar {
background: #1a1a2e;
color: white;
position: sticky;
top: 0;
z-index: 1000;
box-shadow: 0 2px 10px rgba(0,0,0,0.1);
}
.nav-container {
max-width: 1200px;
margin: 0 auto;
padding: 1rem 2rem;
display: flex;
justify-content: space-between;
align-items: center;
flex-wrap: wrap;
}
.logo {
font-size: 1.5rem;
font-weight: bold;
color: #00d4ff;
}
.logo span {
color: white;
}
.nav-links {
display: flex;
gap: 2rem;
list-style: none;
flex-wrap: wrap;
}
.nav-links a {
color: white;
text-decoration: none;
transition: color 0.3s;
}
.nav-links a:hover {
color: #00d4ff;
}
.btn {
display: inline-block;
padding: 0.75rem 1.5rem;
border-radius: 5px;
text-decoration: none;
font-weight: 600;
transition: all 0.3s;
cursor: pointer;
}
.btn-primary {
background: #00d4ff;
color: #1a1a2e;
}
.btn-primary:hover {
background: #00b8e0;
transform: translateY(-2px);
box-shadow: 0 5px 15px rgba(0,212,255,0.3);
}
.btn-outline {
border: 2px solid #00d4ff;
color: #00d4ff;
}
.btn-outline:hover {
background: #00d4ff;
color: #1a1a2e;
}
.hero {
background: linear-gradient(135deg, #0f0c29, #302b63, #24243e);
color: white;
text-align: center;
padding: 4rem 2rem;
}
.hero h1 {
font-size: 3rem;
margin-bottom: 1rem;
}
.hero h1 span {
color: #00d4ff;
}
.hero p {
font-size: 1.2rem;
max-width: 800px;
margin: 0 auto 2rem;
opacity: 0.9;
}
.hero-badges {
display: flex;
justify-content: center;
gap: 1rem;
flex-wrap: wrap;
margin-bottom: 2rem;
}
.badge {
background: rgba(255,255,255,0.1);
padding: 0.5rem 1rem;
border-radius: 20px;
font-size: 0.9rem;
}
.container {
max-width: 1200px;
margin: 0 auto;
padding: 3rem 2rem;
}
.section-header {
text-align: center;
margin-bottom: 3rem;
}
.section-header h2 {
font-size: 2.5rem;
color: #1a1a2e;
margin-bottom: 1rem;
}
.section-header p {
color: #666;
max-width: 700px;
margin: 0 auto;
}
.cards-grid {
display: grid;
grid-template-columns: repeat(auto-fit, minmax(300px, 1fr));
gap: 2rem;
}
.card {
background: white;
border-radius: 10px;
padding: 1.5rem;
box-shadow: 0 5px 20px rgba(0,0,0,0.08);
transition: transform 0.3s, box-shadow 0.3s;
}
.card:hover {
transform: translateY(-5px);
box-shadow: 0 10px 30px rgba(0,0,0,0.12);
}
.card-icon {
font-size: 2.5rem;
margin-bottom: 1rem;
}
.card h3 {
margin-bottom: 1rem;
color: #1a1a2e;
}
.card p {
color: #666;
margin-bottom: 1rem;
}
.comparison-table {
background: white;
border-radius: 10px;
overflow-x: auto;
box-shadow: 0 5px 20px rgba(0,0,0,0.08);
}
.comparison-table table {
width: 100%;
border-collapse: collapse;
}
.comparison-table th,
.comparison-table td {
padding: 1rem;
text-align: left;
border-bottom: 1px solid #e9ecef;
}
.comparison-table th {
background: #1a1a2e;
color: white;
font-weight: 600;
}
.comparison-table tr:hover {
background: #f8f9fa;
}
.architecture {
background: #1e1e2e;
color: white;
border-radius: 10px;
padding: 2rem;
overflow-x: auto;
}
.architecture pre {
background: #2d2d3a;
padding: 1rem;
border-radius: 5px;
overflow-x: auto;
font-family: 'Courier New', monospace;
font-size: 0.8rem;
line-height: 1.4;
color: #00d4ff;
}
.status-grid {
display: grid;
grid-template-columns: repeat(auto-fit, minmax(250px, 1fr));
gap: 2rem;
}
.status-card {
background: white;
border-radius: 10px;
padding: 1.5rem;
text-align: center;
}
.status-working {
border-top: 4px solid #28a745;
}
.status-progress {
border-top: 4px solid #ffc107;
}
.status-working h3 {
color: #28a745;
}
.status-progress h3 {
color: #ffc107;
}
.contributors {
background: white;
border-radius: 10px;
padding: 2rem;
text-align: center;
}
.contributor-buttons {
display: flex;
justify-content: center;
gap: 1rem;
flex-wrap: wrap;
margin-top: 1rem;
}
/* NEW: Image styling */
.hero-image {
max-width: 100%;
margin: 2rem auto;
border-radius: 10px;
box-shadow: 0 10px 30px rgba(0,0,0,0.2);
}
.demo-image {
max-width: 100%;
margin: 2rem 0;
border-radius: 10px;
box-shadow: 0 5px 20px rgba(0,0,0,0.1);
}
.sponsor-image {
max-width: 200px;
margin: 1rem auto;
display: block;
}
.footer {
background: #1a1a2e;
color: white;
text-align: center;
padding: 3rem 2rem;
margin-top: 2rem;
}
.footer a {
color: #00d4ff;
text-decoration: none;
}
.social-links {
display: flex;
justify-content: center;
gap: 2rem;
margin-bottom: 2rem;
flex-wrap: wrap;
}
@media (max-width: 768px) {
.nav-container {
flex-direction: column;
gap: 1rem;
}
.nav-links {
justify-content: center;
}
.hero h1 {
font-size: 2rem;
}
.section-header h2 {
font-size: 2rem;
}
}
.badges-row {
display: flex;
justify-content: center;
gap: 1rem;
margin: 1rem 0;
flex-wrap: wrap;
}
.github-badge {
background: #24292e;
color: white;
padding: 0.5rem 1rem;
border-radius: 20px;
font-size: 0.9rem;
text-decoration: none;
display: inline-flex;
align-items: center;
gap: 0.5rem;
}
hr {
margin: 2rem 0;
border: none;
border-top: 2px solid #e9ecef;
}
.mt-4 {
margin-top: 2rem;
}
</style>
</head> </head>
<body> <body>
<nav class="navbar"> <header class="topbar">
<div class="nav-container"> <div class="container nav">
<div class="logo">AERIS-10<span>Radar</span></div> <a class="brand" href="index.html">AERIS-10 Docs</a>
<ul class="nav-links"> <nav>
<li><a href="#overview">Overview</a></li> <a href="architecture.html">Architecture</a>
<li><a href="#specs">Specifications</a></li> <a href="implementation-log.html">Implementation Log</a>
<li><a href="#architecture">Architecture</a></li> <a href="bring-up.html">Bring-Up</a>
<li><a href="#status">Status</a></li> <a href="reports.html">Reports</a>
<li><a href="#get-involved">Get Involved</a></li> <a href="release-notes.html">Release Notes</a>
<li><a href="https://github.com/NawfalMotii79/PLFM_RADAR" target="_blank">GitHub</a></li>
</ul>
</div>
</nav> </nav>
<section class="hero">
<h1>AERIS-10 <span>Open Source</span><br>Phased Array Radar</h1>
<p>A low-cost, hackable 10.5 GHz phased array radar system with Pulse LFM modulation. Designed for researchers, drone developers, and serious SDR enthusiasts.</p>
<!-- ADDED: Main radar image -->
<img src="img/radar-main.jpg" alt="AERIS-10 Radar System" class="hero-image" onerror="this.style.display='none'">
<div class="hero-badges">
<span class="badge">🔓 Open Source</span>
<span class="badge">📡 10.5 GHz</span>
<span class="badge">🎯 3km / 20km Range</span>
<span class="badge">🔄 Electronic Beam Steering</span>
</div> </div>
</header>
<div class="badges-row"> <main class="container page">
<a href="https://github.com/NawfalMotii79/PLFM_RADAR" class="github-badge"> <section class="hero">
<svg height="20" viewBox="0 0 16 16" width="20" fill="white"><path d="M8 0C3.58 0 0 3.58 0 8c0 3.54 2.29 6.53 5.47 7.59.4.07.55-.17.55-.38 0-.19-.01-.82-.01-1.49-2.01.37-2.53-.49-2.69-.94-.09-.23-.48-.94-.82-1.13-.28-.15-.68-.52-.01-.53.63-.01 1.08.58 1.23.82.72 1.21 1.87.87 2.33.66.07-.52.28-.87.51-1.07-1.78-.2-3.64-.89-3.64-3.95 0-.87.31-1.59.82-2.15-.08-.2-.36-1.02.08-2.12 0 0 .67-.21 2.2.82.64-.18 1.32-.27 2-.27.68 0 1.36.09 2 .27 1.53-1.04 2.2-.82 2.2-.82.44 1.1.16 1.92.08 2.12.51.56.82 1.27.82 2.15 0 3.07-1.87 3.75-3.65 3.95.29.25.54.73.54 1.48 0 1.07-.01 1.93-.01 2.2 0 .21.15.46.55.38A8.013 8.013 0 0016 8c0-4.42-3.58-8-8-8z"></path></svg> <p class="eyebrow">Open-Source Phased Array Radar</p>
Star on GitHub <h1>Engineering Documentation Site</h1>
</a> <p>This site tracks architecture, validated implementation baselines, constraint cleanup progress, and pre-hardware bring-up readiness for AERIS-10.</p>
<a href="https://github.com/NawfalMotii79/PLFM_RADAR/blob/main/README.md" class="github-badge" style="background:#00d4ff; color:#1a1a2e;">📖 Documentation</a> <div class="cta-row">
<a href="https://github.com/NawfalMotii79/PLFM_RADAR/issues" class="github-badge" style="background:#ff4757;">🐛 Report Bug</a> <a class="button" href="implementation-log.html">View Change Timeline</a>
<a class="button ghost" href="bring-up.html">Open Readiness Package</a>
</div> </div>
</section> </section>
<div class="container" id="overview"> <section class="stats-grid">
<div class="section-header"> <article class="card stat">
<h2>Project Overview</h2> <h2>Tracked Timing Baseline</h2>
<p>Democratizing radar technology through open-source hardware and software</p> <p class="metric">WNS +0.058 ns</p>
</div> <p class="muted">WHS +0.068, WPWS +0.684 after validated Build 16 XDC port</p>
</article>
<article class="card stat">
<h2>Regression Status</h2>
<p class="metric">MCU 15 / 15, FPGA 18 / 18</p>
<p class="muted">Host firmware regression plus FPGA unit and integration suites passing</p>
</article>
<article class="card stat">
<h2>Methodology State</h2>
<p class="metric">XDCB-5 = 0</p>
<p class="muted">Single documented TIMING-18 residue on `ft601_txe` async observation</p>
</article>
<article class="card stat">
<h2>Current Phase</h2>
<p class="metric">Pre-Hardware Readiness</p>
<p class="muted">Board-arrival smoke test, artifact inventory, and open-risk tracking prepared</p>
</article>
</section>
<!-- ADDED: Antenna array image --> <section class="grid-2">
<div style="text-align: center; margin-bottom: 2rem;"> <article class="card">
<img src="img/antenna-array.jpg" alt="AERIS-10 Antenna Array" style="max-width: 100%; border-radius: 10px;" onerror="this.style.display='none'"> <h2>What changed recently</h2>
</div> <ul>
<li>Ported the validated Build 16 production-target XDC cleanup into the tracked repository.</li>
<div class="cards-grid"> <li>Preserved positive post-route timing while clearing XDCB-5 and reducing methodology residue to a single documented item.</li>
<div class="card"> <li>Validated the tracked branch with MCU host regression and FPGA regression/integration suites.</li>
<div class="card-icon">🎯</div> <li>Refreshed the bring-up documentation into a pre-arrival readiness package for the FPGA module and carrier board.</li>
<h3>Purpose-Built</h3> <li>Kept upstream ADAR1000 bulk imports out of the baseline pending selective, justified reuse only.</li>
<p>Designed for researchers, drone developers, and SDR enthusiasts who need a capable, hackable radar platform.</p>
</div>
<div class="card">
<div class="card-icon">🔓</div>
<h3>100% Open Source</h3>
<p>Complete schematics, PCB layouts, firmware, and software available for modification and learning.</p>
</div>
<div class="card">
<div class="card-icon"></div>
<h3>Real-Time Processing</h3>
<p>FPGA-based signal processing for pulse compression, Doppler FFT, MTI, and CFAR detection.</p>
</div>
<div class="card">
<div class="card-icon">🌍</div>
<h3>GPS & IMU Integrated</h3>
<p>Real-time position tracking, attitude correction, and map visualization for geolocated targets.</p>
</div>
</div>
</div>
<div class="container" id="specs">
<div class="section-header">
<h2>Technical Specifications</h2>
<p>Two versions available to match your range requirements</p>
</div>
<div class="comparison-table">
<table>
<thead>
<tr>
<th>Specification</th>
<th>AERIS-10N (Nexus)</th>
<th>AERIS-10X (Extended)</th>
</tr>
</thead>
<tbody>
<tr><td><strong>Frequency</strong></td><td>10.5 GHz</td><td>10.5 GHz</td></tr>
<tr><td><strong>Max Range</strong></td><td>3 km</td><td>20 km</td></tr>
<tr><td><strong>Antenna Type</strong></td><td>8×16 Patch Array</td><td>32×16 Slotted Waveguide</td></tr>
<tr><td><strong>Beam Steering</strong></td><td>Electronic (±45°)</td><td>Electronic (±45°)</td></tr>
<tr><td><strong>Mechanical Scan</strong></td><td>360° (stepper motor)</td><td>360° (stepper motor)</td></tr>
<tr><td><strong>Output Power</strong></td><td>~1W×16</td><td>10W×16 (GaN amplifier)</td></tr>
<tr><td><strong>Processing</strong></td><td>FPGA + STM32</td><td>FPGA + STM32</td></tr>
</tbody>
</table>
</div>
</div>
<div class="container" id="architecture">
<div class="section-header">
<h2>System Architecture</h2>
<p>Modular design with specialized components for optimal performance</p>
</div>
<!-- ADDED: System diagram -->
<div style="text-align: center; margin-bottom: 2rem;">
<img src="img/system-diagram.png" alt="System Architecture Diagram" style="max-width: 100%; border-radius: 10px;" onerror="this.style.display='none'">
</div>
<div class="architecture">
<pre>
┌─────────────────────────────────────────────────────────────┐
│ Antenna Array │
│ (8x16 patch / 32x16 slotted waveguide) │
└─────────────────────┬───────────────────────────────────────┘
┌─────────────────────┴───────────────────────────────────────┐
│ Main Board │
│ ┌───────────────┐ ┌──────────────┐ ┌─────────────────┐ │
│ │ XC7A100T │ │ STM32F746 │ │ 16x ADTR1107 │ │
│ │ FPGA │ │ MCU │ │ Front End │ │
│ └───────────────┘ └──────────────┘ └─────────────────┘ │
│ ┌───────────────┐ ┌──────────────┐ ┌─────────────────┐ │
│ │ 4x ADAR1000 │ │ 2x ADF4382 │ │ 2x LT5552 │ │
│ │ Phase Shift │ │ Synthesizers│ │ Mixers │ │
│ └───────────────┘ └──────────────┘ └─────────────────┘ │
└─────────────────────┬───────────────────────────────────────┘
┌─────────────────────┴───────────────────────────────────────┐
│ Support Modules │
│ ┌───────────────┐ ┌──────────────┐ ┌─────────────────┐ │
│ │ AD9523-1 │ │ GPS Module │ │ GY-85 IMU │ │
│ │ Clock Gen │ │ │ │ │ │
│ └───────────────┘ └──────────────┘ └─────────────────┘ │
└─────────────────────────────────────────────────────────────┘
</pre>
</div>
<!-- ADDED: GUI Demo GIF -->
<div style="text-align: center; margin: 2rem 0;">
<img src="img/gui-demo.gif" alt="AERIS-10 GUI Demo" class="demo-image" onerror="this.style.display='none'">
</div>
<div class="cards-grid mt-4">
<div class="card">
<h3>📡 Power Management Board</h3>
<p>Supplies all necessary voltage levels with proper filtering and sequencing (controlled by microcontroller).</p>
</div>
<div class="card">
<h3>⏱️ Frequency Synthesizer Board</h3>
<p>High-performance AD9523-1 low jitter clock generator with phase-aligned references for RX/TX, DAC, ADC, and FPGA.</p>
</div>
<div class="card">
<h3>🔄 Main Board Components</h3>
<p>DAC for chirp generation, LT5552 mixers, ADAR1000 phase shifters (4x), ADTR1107 front-end chips (16x).</p>
</div>
<div class="card">
<h3>🎛️ XC7A100T FPGA</h3>
<p>Handles PLFM chirp generation, ADC data read, AGC, I/Q down-conversion, decimation, filtering, FFT, pulse compression, Doppler, MTI & CFAR processing.</p>
</div>
<div class="card">
<h3>⚙️ STM32F746 Microcontroller</h3>
<p>Power sequencing, FPGA communication, peripheral configuration (clock generator, synthesizers, phase shifters, GPS, IMU, barometer, stepper motor, sensors).</p>
</div>
<div class="card">
<h3>🔊 Power Amplifier Boards (10X only)</h3>
<p>10W QPA2962 GaN amplifier for extended range capability.</p>
</div>
</div>
</div>
<div class="container" id="status">
<div class="section-header">
<h2>Current Status</h2>
<p>Alpha prototype - Actively seeking contributors and beta testers</p>
</div>
<div class="status-grid">
<div class="status-card status-working">
<h3>✅ Working Features</h3>
<ul style="text-align: left; margin-top: 1rem; padding-left: 1.5rem;">
<li>Beam formation from 16×8 array</li>
<li>Electronic steering ±45° elevation</li>
<li>Pulse LFM generation and reception</li>
<li>Basic target detection to 1km</li>
<li>Full FPGA processing pipeline</li>
<li>Pulse compression & Doppler processing</li>
<li>MTI & CFAR detection</li>
</ul> </ul>
</div> </article>
<div class="status-card status-progress"> <article class="card">
<h3>🚧 In Progress</h3> <h2>Documentation Map</h2>
<ul style="text-align: left; margin-top: 1rem; padding-left: 1.5rem;"> <ul>
<li>Python GUI-based radar processing</li> <li><a href="architecture.html">System and FPGA Architecture</a></li>
<li>Multi-board synchronization</li> <li><a href="implementation-log.html">Detailed Engineering Change Log</a></li>
<li>Extended range testing</li> <li><a href="bring-up.html">Pre-Arrival Bring-Up Plan, Artifact Checklist, and Open Risks</a></li>
<li>Crowdfunding campaign</li> <li><a href="reports.html">Published reports, simulations, and artifact context</a></li>
<li>Documentation & assembly guides</li> <li><a href="release-notes.html">Release Notes by Key Commit</a></li>
</ul> </ul>
</div> </article>
</div> </section>
</div> </main>
<div class="container" id="get-involved">
<div class="section-header">
<h2>Get Involved</h2>
<p>Join the open-source radar revolution</p>
</div>
<div class="contributors">
<h3>🤝 We're Actively Seeking</h3>
<div class="contributor-buttons">
<span class="badge" style="background:#e9ecef; color:#1a1a2e;">🎓 University Researchers</span>
<span class="badge" style="background:#e9ecef; color:#1a1a2e;">🚁 Drone Startups</span>
<span class="badge" style="background:#e9ecef; color:#1a1a2e;">🔧 Advanced Makers</span>
<span class="badge" style="background:#e9ecef; color:#1a1a2e;">📡 RF Engineers</span>
<span class="badge" style="background:#e9ecef; color:#1a1a2e;">🖥️ FPGA Developers</span>
<span class="badge" style="background:#e9ecef; color:#1a1a2e;">🐍 Python/C++ Developers</span>
</div>
<hr>
<h3>📬 Connect With Us</h3>
<div class="contributor-buttons">
<a href="#" class="btn btn-outline">Discord Community</a>
<a href="#" class="btn btn-outline">GitHub Discussions</a>
<a href="#" class="btn btn-outline">Twitter @AERIS10Radar</a>
<a href="https://github.com/NawfalMotii79/PLFM_RADAR" class="btn btn-primary">Contribute on GitHub</a>
</div>
</div>
</div>
<div class="container">
<div class="section-header">
<h2>Documentation</h2>
<p>Everything you need to build, modify, and operate the AERIS-10 radar</p>
</div>
<div class="cards-grid">
<div class="card">
<h3>📘 Hardware Design Guide</h3>
<p>Schematics, PCB layouts, BOM, and assembly instructions.</p>
</div>
<div class="card">
<h3>💾 Firmware Development</h3>
<p>STM32 firmware and FPGA bitstream programming guide.</p>
</div>
<div class="card">
<h3>🔬 Signal Processing</h3>
<p>Detailed explanation of the FPGA processing pipeline.</p>
</div>
<div class="card">
<h3>🐍 Python SDK</h3>
<p>GUI and API reference for data visualization and control.</p>
</div>
<div class="card">
<h3>⚙️ Calibration Guide</h3>
<p>Step-by-step calibration procedures for optimal performance.</p>
</div>
<div class="card">
<h3>🛠️ Troubleshooting</h3>
<p>Common issues and solutions.</p>
</div>
</div>
<!-- ADDED: Sponsor logo -->
<div style="text-align: center; margin-top: 3rem;">
<img src="img/pcbway-logo.jpg" alt="PCBWay Sponsor" class="sponsor-image" onerror="this.style.display='none'">
</div>
</div>
<footer class="footer"> <footer class="footer">
<div class="social-links"> <div class="container">
<a href="https://github.com/NawfalMotii79/PLFM_RADAR">GitHub</a> <p>AERIS-10 documentation published via GitHub Pages from <code>/docs</code>.</p>
<a href="#">Discord</a>
<a href="#">Twitter</a>
<a href="https://github.com/NawfalMotii79/PLFM_RADAR/blob/main/README.md">Documentation</a>
<a href="#">Contact</a>
</div> </div>
<p>© 2025 AERIS-10 Project. Open source hardware and software.</p>
<p style="margin-top: 1rem; font-size: 0.9rem; opacity: 0.7;">Hardware: CERN-OHL-P | Software: MIT | Built with ❤️ for the open-source community</p>
</footer> </footer>
</body> </body>
</html> </html>