From 02e4a07905e8f6d6a2754b707f834561237e2361 Mon Sep 17 00:00:00 2001
From: Michael Hohenstein <michael@hohenste.in>
Date: Mon, 5 Feb 2024 16:57:16 +0100
Subject: [PATCH] [docs] created files for later documentation topics

---
 documentation/chap/firmware/chapter.tex    | 5 +++++
 documentation/chap/firmware/pc_link.tex    | 3 +++
 documentation/chap/firmware/scpi.tex       | 5 +++++
 documentation/chap/hardware/chapter.tex    | 1 +
 documentation/chap/hardware/schematics.tex | 4 ++++
 documentation/main.tex                     | 1 +
 6 files changed, 19 insertions(+)
 create mode 100644 documentation/chap/firmware/chapter.tex
 create mode 100644 documentation/chap/firmware/pc_link.tex
 create mode 100644 documentation/chap/firmware/scpi.tex
 create mode 100644 documentation/chap/hardware/schematics.tex

diff --git a/documentation/chap/firmware/chapter.tex b/documentation/chap/firmware/chapter.tex
new file mode 100644
index 0000000..f9fefd7
--- /dev/null
+++ b/documentation/chap/firmware/chapter.tex
@@ -0,0 +1,5 @@
+\chapter{Oscilloscope Firmware}
+
+\input{./chap/firmware/pc_link.tex}
+\input{./chap/firmware/scpi.tex}
+
diff --git a/documentation/chap/firmware/pc_link.tex b/documentation/chap/firmware/pc_link.tex
new file mode 100644
index 0000000..5193a3b
--- /dev/null
+++ b/documentation/chap/firmware/pc_link.tex
@@ -0,0 +1,3 @@
+\section{PC communication}
+
+\todo[inline]{write a chapter about the communication between the Raspberry Pi Pico and the PC: USB<->UART at extremely high baud rates}
diff --git a/documentation/chap/firmware/scpi.tex b/documentation/chap/firmware/scpi.tex
new file mode 100644
index 0000000..5ac82b0
--- /dev/null
+++ b/documentation/chap/firmware/scpi.tex
@@ -0,0 +1,5 @@
+\section{The SCPI Protocoll}
+
+\todo[inline]{explain the SCPI protocoll which will be evaluated on the Pico and used to transfer commands from the PC to the Oscilloscope}
+\todo[inline]{Explain how the state machine in the device looks like}
+
diff --git a/documentation/chap/hardware/chapter.tex b/documentation/chap/hardware/chapter.tex
index 0f53397..5836c1a 100644
--- a/documentation/chap/hardware/chapter.tex
+++ b/documentation/chap/hardware/chapter.tex
@@ -5,3 +5,4 @@ \chapter{Hardware Design}
 \input{./chap/hardware/voltage_divider.tex}
 \input{./chap/hardware/op-amp.tex}
 \input{./chap/hardware/misc_electronics.tex}
+\input{./chap/hardware/schematics.tex}
diff --git a/documentation/chap/hardware/schematics.tex b/documentation/chap/hardware/schematics.tex
new file mode 100644
index 0000000..1da14b3
--- /dev/null
+++ b/documentation/chap/hardware/schematics.tex
@@ -0,0 +1,4 @@
+\section{Designing the schematics}
+
+\todo[inline]{Explain how the schematics diagram works, how all values were calculated and why some test pins were placed on their locations. Maybe also write something about the pcb layout?}
+\todo[inline]{Design the PCB in a way that the backside has no electronic parts but a silk screen of all the schematics (mirrored) and all the test points should also be on this side}
diff --git a/documentation/main.tex b/documentation/main.tex
index 07825d6..2a7fdf1 100644
--- a/documentation/main.tex
+++ b/documentation/main.tex
@@ -28,4 +28,5 @@
 
 	% main content
 	\include{./chap/hardware/chapter.tex}
+	\include{./chap/firmware/chapter.tex}
 \end{document}