// SAME Analog Modular Ecosystem
//
// / SPDX-FileCopyrightText: 2026 Denis Chevalier <perso@denischevalier.fr>
// / SPDX-License-Identifier: CC-BY-SA-4.0
// / SPDX-License-Identifier: CERN-OHL-S-2.0+
// / SPDX-License-Identifier: GPL-3.0-or-later
//
// The prose, explanatory text, rendered figures, tables, and mathematical
// content of this specification are licensed under CC BY-SA 4.0. If a later
// version of CC BY-SA is published, the author grants permission to distribute
// this work under that later version as well.
//
// Hardware designs contained herein (schematics, PCB layouts, mechanical
// drawings, and CAD models) are licensed under CERN-OHL-S-2.0+.
//
// All executable code, helper libraries (`lib/*`), metrology assertions, and
// embedded verification scripts throughout the source documents are licensed
// under the GNU General Public License v3.0 or later (GPL-3.0-or-later).

#import "lib/unify.typ": add-unit

// All units for the specification should be specified here
#add-unit("ppm", "ppm", "upright(\"ppm\")")
#add-unit("ppb", "ppb", "upright(\"ppb\")")
#add-unit("inch", "\"", "upright(\"inch\")", space: false)
#add-unit("micro inch", "u\"", "upright(mu \"\\\"\")", space: false)
#add-unit("digital voltage", "VD", "upright(\"VD\")")
#add-unit("volt peak-to-peak", "Vpp", "V_\"pp\"")
#add-unit("milli volt peak-to-peak", "mVpp", "\"mV\"_\"pp\"")
#add-unit("micro volt peak-to-peak", "uVpp", "mu V_\"pp\"")
#add-unit("dBc", "dBc", "upright(\"dBc\")") // decibels relative to the carrier
#add-unit("rack unit", "U", "upright(U)", space: false)
#add-unit("ounce", "oz", "upright(\"oz\")")
#add-unit("american wire gauge", "AWG", "upright(\"AWG\")")
#add-unit("volt AC", "VAC", "V_\"AC\"")
#add-unit("volt DC", "VDC", "V_\"DC\"")
#add-unit("uVrms", "uVrms", "mu V_\"rms\"")
#add-unit("decade", "dec", "upright(\"dec\")")
#add-unit("shertz", "sHz", "sqrt(upright(\"Hz\"))")
#add-unit("mil", "mil", "upright(\"mil\")")

#set document(
  title: [SAME Analog Modular Ecosystem],
  author: "Denis Chevalier",
  description: [SAME Analog Modular Ecosystem Specification],
  keywords: (),
  date: auto,
)

#set page(
  paper: "a4",
  header: context {
    if counter(page).get().first() > 1 {
      grid(
        columns: (1fr, 1fr),
        align(left, text(8pt)[SAME Analog Modular Ecosystem]),
        align(right, text(
          8pt,
        )[CC BY-SA 4.0 -- CERN-OHL-S-2.0+ -- GPLv3.0 or later]),
      )
    }
  },

  footer: context {
    let pg = counter(page).get().first()
    if pg > 1 {
      v(4pt)
      grid(
        columns: (1fr, 1fr, 1fr),
        align(left, text(8pt)[© 2026 Denis Chevalier]),
        align(center, text(8pt)[Page #pg]),
        align(right, text(8pt)[Draft]),
      )
    }
  },
)

#set heading(numbering: "1.")
#show heading.where(depth: 1): body => {
  pagebreak(weak: true)
  body
}

#set par(
  justify: true,
)

#show table.cell.where(y: 0): strong

// Title page
#title()

/ SPDX-FileCopyrightText: 2026 Denis Chevalier \<perso\@denischevalier.fr>
/ SPDX-License-Identifier: CC-BY-SA-4.0
/ SPDX-License-Identifier: CERN-OHL-S-2.0+
/ SPDX-License-Identifier: GPL-3.0-or-later

The prose, explanatory text, rendered figures, tables, and mathematical
content of this specification are licensed under CC BY-SA 4.0. If a later
version of CC BY-SA is published, the author grants permission to distribute
this work under that later version as well.

Hardware designs contained herein (schematics, PCB layouts, mechanical
drawings, and CAD models) are licensed under CERN-OHL-S-2.0+.

All executable code, helper libraries (`lib/*`), metrology assertions, and
embedded verification scripts throughout the source documents are licensed
under the GNU General Public License v3.0 or later (GPL-3.0-or-later).

// Toc
#outline(
  title: [Table of Contents],
  indent: auto,
)

#outline(
  title: [List of Tables],
  target: figure.where(kind: table),
)

#outline(
  title: [List of Figures],
  target: figure.where(kind: image),
)

#outline(
  title: [List of Listings],
  target: figure.where(kind: raw),
)

#include "introduction.typ"

#include "electrical-specifications.typ"

#include "mechanical-specifications.typ"

#include "module-design.typ"

= Compliance verification <compliance-verification>

== Foundational invariants <foundational-invariants>

=== The time invariant <the-time-invariant>

= Reference implementation <reference-implementation>

== Chassis <reference-implementation-chassis>

=== Interface modules <reference-implementation-interface-modules>

= Theory of operation <theory-of-operation>

= Applications <applications>