aboutsummaryrefslogtreecommitdiff
path: root/docs/handover.adoc
diff options
context:
space:
mode:
Diffstat (limited to 'docs/handover.adoc')
-rw-r--r--docs/handover.adoc39
1 files changed, 13 insertions, 26 deletions
diff --git a/docs/handover.adoc b/docs/handover.adoc
index a3fd880..8c86e1b 100644
--- a/docs/handover.adoc
+++ b/docs/handover.adoc
@@ -85,7 +85,14 @@ communication.] | Software
| Thomas in 't Anker | Software
|===
-== Resources
+
+== A Note Before Reading
+The team of year 2023-2024 consisted of only software students, meaning no
+hardware was developed in this year. We were tasked with simplifying the
+software to the point where it would only have to be ported into the new hardware,
+which was designed in the year 2022-2023. The goal of this year would be to create
+a software framework which can be used to implement new puzzles and to make the
+development process of these puzzles easier.
Previous years' groups have put their predecessor's documents inside their own
project folder, which has resulted in what we called the 'Russian doll folder
@@ -97,31 +104,6 @@ require credentials to log in. Please note that this is very much unofficial,
and is not managed or endorsed by Avans. <<pn:blansch>> is the contact for
removal or transfer of these files.
-== Recommendations
-
-- The 22-23 design document already mentions that the application of the I^2^C
- bus is in a multi-master configuration, but does not mention that this only
- works when pull-up resistors are used on the SCL and SDA lines. The pull-up
- resistors are required, as omitting them makes the bus arbitration process
- very inconsistent which causes frames to be dropped entirely.
-
-include::share/footer.adoc[]
-
-
-:document: Handover
-include::share/meta.adoc[]
-
-== A Note Before Reading
-The team of year 2023-2024 consisted of only software students, meaning no
-hardware was developed in this year. We were tasked with simplifying the
-software to the point where it would only have to be ported into the new hardware,
-which was designed in the year 2022-2023. The goal of this year would be to create
-a software framework which can be used to implement new puzzles and to make the
-development process of these puzzles easier.
-
-At the moment of writing, the documentation of previous years can be found at the
-following link: 'https://media.pipeframe.xyz/puzzlebox'.
-
== Project State
The current project state is as follows: No new hardware has been designed
or developed this year. The software was completely revised, now consisting of a
@@ -195,5 +177,10 @@ need to be integrated.
connectivity possibilities.
* The RPI Pico W has programmable IO modules, making it possible to create an I^2^C driver
that allows multi-master communication while still being addressable as a slave.
+* The 22-23 design document already mentions that the application of the I^2^C
+bus is in a multi-master configuration, but does not mention that this only
+works when pull-up resistors are used on the SCL and SDA lines. The pull-up
+resistors are required, as omitting them makes the bus arbitration process
+very inconsistent which causes frames to be dropped entirely.
include::share/footer.adoc[]