From 2d449f0b617835d885617f911d4429a032dc53ec Mon Sep 17 00:00:00 2001
From: Laborratte5 <rirussi.rr@gmail.com>
Date: Fri, 17 May 2024 12:40:28 +0200
Subject: [PATCH] =?UTF-8?q?feat:=20Add=20section=20"Pin=20Zust=C3=A4nde=20?=
 =?UTF-8?q?einlesen"?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

- Add section about reading Pin values
- Add schematic and image to explain pull-up/pull-down resistors
---
 misc/PullUpWiderstand.kicad_sch | 1207 +++++++++++++++++++++++++++++++
 src/01_grundlagen.ipynb         |   75 ++
 src/img/pull-down-resistor.png  |  Bin 0 -> 9446 bytes
 3 files changed, 1282 insertions(+)
 create mode 100644 misc/PullUpWiderstand.kicad_sch
 create mode 100644 src/img/pull-down-resistor.png

diff --git a/misc/PullUpWiderstand.kicad_sch b/misc/PullUpWiderstand.kicad_sch
new file mode 100644
index 0000000..d2e4a6e
--- /dev/null
+++ b/misc/PullUpWiderstand.kicad_sch
@@ -0,0 +1,1207 @@
+(kicad_sch
+	(version 20231120)
+	(generator "eeschema")
+	(generator_version "8.0")
+	(uuid "010a0f2a-cf19-430b-ad46-7851a0b6c63a")
+	(paper "A4")
+	(lib_symbols
+		(symbol "PCM_Elektuur:S-make"
+			(pin_numbers hide)
+			(pin_names
+				(offset 0) hide)
+			(exclude_from_sim no)
+			(in_bom yes)
+			(on_board yes)
+			(property "Reference" "S"
+				(at 1.27 3.175 0)
+				(effects
+					(font
+						(size 1.27 1.27)
+					)
+					(justify left)
+				)
+			)
+			(property "Value" "S-make"
+				(at 1.27 -3.175 0)
+				(effects
+					(font
+						(size 1.27 1.27)
+					)
+					(justify left)
+				)
+			)
+			(property "Footprint" ""
+				(at 0 0 0)
+				(effects
+					(font
+						(size 1.27 1.27)
+					)
+					(hide yes)
+				)
+			)
+			(property "Datasheet" ""
+				(at 0 0 0)
+				(effects
+					(font
+						(size 1.27 1.27)
+					)
+					(hide yes)
+				)
+			)
+			(property "Description" "make/closing contact; switch, single pole, single throw, normally open (SPST-NO/A)"
+				(at 0 0 0)
+				(effects
+					(font
+						(size 1.27 1.27)
+					)
+					(hide yes)
+				)
+			)
+			(property "Sim.Pins" "3=1 3=2 3=3 4=4 4=5 4=6"
+				(at 0 0 0)
+				(effects
+					(font
+						(size 1.27 1.27)
+					)
+					(hide yes)
+				)
+			)
+			(property "Sim.Device" "SPICE"
+				(at 0 0 0)
+				(effects
+					(font
+						(size 1.27 1.27)
+					)
+					(hide yes)
+				)
+			)
+			(property "Sim.Params" "X"
+				(at 1.27 0 0)
+				(effects
+					(font
+						(size 1.27 1.27)
+					)
+					(justify left)
+					(hide yes)
+				)
+			)
+			(property "Rating" "V/A"
+				(at -1.27 -3.175 0)
+				(effects
+					(font
+						(size 1.27 1.27)
+					)
+					(justify right)
+					(hide yes)
+				)
+			)
+			(property "ki_keywords" "S X make closing contact switch single pole throw normally open SPST-NO A"
+				(at 0 0 0)
+				(effects
+					(font
+						(size 1.27 1.27)
+					)
+					(hide yes)
+				)
+			)
+			(symbol "S-make_1_1"
+				(circle
+					(center 0 -2.2606)
+					(radius 0.5334)
+					(stroke
+						(width 0.3556)
+						(type default)
+					)
+					(fill
+						(type outline)
+					)
+				)
+				(polyline
+					(pts
+						(xy -2.8956 2.413) (xy -0.381 -2.0574) (xy 0.0254 -1.8288) (xy -2.4892 2.6416) (xy -2.8956 2.413)
+					)
+					(stroke
+						(width 0.254)
+						(type default)
+					)
+					(fill
+						(type outline)
+					)
+				)
+				(circle
+					(center 0 2.2606)
+					(radius 0.5334)
+					(stroke
+						(width 0.3556)
+						(type default)
+					)
+					(fill
+						(type none)
+					)
+				)
+				(pin passive line
+					(at 0 -5.08 90)
+					(length 2.2352)
+					(name "3"
+						(effects
+							(font
+								(size 1.27 1.27)
+							)
+						)
+					)
+					(number "3"
+						(effects
+							(font
+								(size 1.27 1.27)
+							)
+						)
+					)
+				)
+				(pin passive line
+					(at 0 5.08 270)
+					(length 2.2352)
+					(name "4"
+						(effects
+							(font
+								(size 1.27 1.27)
+							)
+						)
+					)
+					(number "4"
+						(effects
+							(font
+								(size 1.27 1.27)
+							)
+						)
+					)
+				)
+			)
+			(symbol "S-make_1_2"
+				(circle
+					(center 0 -2.032)
+					(radius 0.5334)
+					(stroke
+						(width 0.3556)
+						(type default)
+					)
+					(fill
+						(type outline)
+					)
+				)
+				(polyline
+					(pts
+						(xy -0.3556 -1.8796) (xy 0.0508 -1.651) (xy -2.2352 2.413) (xy -2.6416 2.1844) (xy -0.3556 -1.8796)
+					)
+					(stroke
+						(width 0.254)
+						(type default)
+					)
+					(fill
+						(type outline)
+					)
+				)
+				(circle
+					(center 0 2.032)
+					(radius 0.5334)
+					(stroke
+						(width 0.3556)
+						(type default)
+					)
+					(fill
+						(type none)
+					)
+				)
+				(pin passive line
+					(at 0 -5.08 90)
+					(length 2.4638)
+					(name "3"
+						(effects
+							(font
+								(size 1.27 1.27)
+							)
+						)
+					)
+					(number "3"
+						(effects
+							(font
+								(size 1.27 1.27)
+							)
+						)
+					)
+				)
+				(pin passive line
+					(at 0 5.08 270)
+					(length 2.4638)
+					(name "4"
+						(effects
+							(font
+								(size 1.27 1.27)
+							)
+						)
+					)
+					(number "4"
+						(effects
+							(font
+								(size 1.27 1.27)
+							)
+						)
+					)
+				)
+			)
+			(symbol "S-make_1_3"
+				(circle
+					(center 0 -2.2606)
+					(radius 0.5334)
+					(stroke
+						(width 0.3556)
+						(type default)
+					)
+					(fill
+						(type outline)
+					)
+				)
+				(polyline
+					(pts
+						(xy -0.3556 -2.1082) (xy 0.0508 -1.8796) (xy -2.2352 2.1844) (xy -2.6416 1.9558) (xy -0.3556 -2.1082)
+					)
+					(stroke
+						(width 0.254)
+						(type default)
+					)
+					(fill
+						(type outline)
+					)
+				)
+				(circle
+					(center 0 2.2606)
+					(radius 0.5334)
+					(stroke
+						(width 0.3556)
+						(type default)
+					)
+					(fill
+						(type none)
+					)
+				)
+				(pin passive line
+					(at 0 -5.08 90)
+					(length 2.2352)
+					(name "3"
+						(effects
+							(font
+								(size 1.27 1.27)
+							)
+						)
+					)
+					(number "3"
+						(effects
+							(font
+								(size 1.27 1.27)
+							)
+						)
+					)
+				)
+				(pin passive line
+					(at 0 5.08 270)
+					(length 2.2352)
+					(name "4"
+						(effects
+							(font
+								(size 1.27 1.27)
+							)
+						)
+					)
+					(number "4"
+						(effects
+							(font
+								(size 1.27 1.27)
+							)
+						)
+					)
+				)
+			)
+		)
+		(symbol "PCM_Generic:P,+3.3"
+			(power)
+			(pin_numbers hide)
+			(pin_names
+				(offset 1.27) hide)
+			(exclude_from_sim no)
+			(in_bom yes)
+			(on_board yes)
+			(property "Reference" "#PWR"
+				(at 2.54 0 0)
+				(effects
+					(font
+						(size 2.54 2.54)
+					)
+					(justify left)
+					(hide yes)
+				)
+			)
+			(property "Value" "P,+3.3"
+				(at 0 2.54 0)
+				(effects
+					(font
+						(size 0.001 0.001)
+					)
+					(justify bottom)
+					(hide yes)
+				)
+			)
+			(property "Footprint" ""
+				(at 0 0 0)
+				(effects
+					(font
+						(size 2.54 2.54)
+					)
+					(hide yes)
+				)
+			)
+			(property "Datasheet" ""
+				(at 0 0 0)
+				(effects
+					(font
+						(size 2.54 2.54)
+					)
+					(hide yes)
+				)
+			)
+			(property "Description" "+3.3 positive potential/voltage (global DC power supply node)"
+				(at 0 0 0)
+				(effects
+					(font
+						(size 1.27 1.27)
+					)
+					(hide yes)
+				)
+			)
+			(property "ki_keywords" "P V + +3.3 3.3 positive potential voltage tension global DC power supply node label pin equipotential bonding"
+				(at 0 0 0)
+				(effects
+					(font
+						(size 1.27 1.27)
+					)
+					(hide yes)
+				)
+			)
+			(symbol "P,+3.3_1_1"
+				(polyline
+					(pts
+						(xy 0 0) (xy 0 1.8288)
+					)
+					(stroke
+						(width 0)
+						(type default)
+					)
+					(fill
+						(type none)
+					)
+				)
+				(polyline
+					(pts
+						(xy -1.0668 0) (xy 0 1.8288) (xy 1.0668 0)
+					)
+					(stroke
+						(width 0)
+						(type default)
+					)
+					(fill
+						(type none)
+					)
+				)
+				(text "+3.3"
+					(at 0 2.54 0)
+					(effects
+						(font
+							(size 2.54 2.54)
+						)
+						(justify bottom)
+					)
+				)
+				(pin power_in line
+					(at 0 0 0)
+					(length 0) hide
+					(name "+3.3"
+						(effects
+							(font
+								(size 2.54 2.54)
+							)
+						)
+					)
+					(number "0"
+						(effects
+							(font
+								(size 0 0)
+							)
+						)
+					)
+				)
+			)
+		)
+		(symbol "PCM_Generic:P,0"
+			(power)
+			(pin_numbers hide)
+			(pin_names
+				(offset 3.81)
+			)
+			(exclude_from_sim no)
+			(in_bom yes)
+			(on_board yes)
+			(property "Reference" "#PWR"
+				(at 3.81 3.81 0)
+				(effects
+					(font
+						(size 2.54 2.54)
+					)
+					(justify left)
+					(hide yes)
+				)
+			)
+			(property "Value" "P,0"
+				(at 3.81 0 0)
+				(effects
+					(font
+						(size 0.001 0.001)
+					)
+					(justify left)
+					(hide yes)
+				)
+			)
+			(property "Footprint" ""
+				(at 0 0 0)
+				(effects
+					(font
+						(size 2.54 2.54)
+					)
+					(hide yes)
+				)
+			)
+			(property "Datasheet" ""
+				(at 0 0 0)
+				(effects
+					(font
+						(size 2.54 2.54)
+					)
+					(hide yes)
+				)
+			)
+			(property "Description" "global node 0; simplified functional (equipotential) bonding (FB); simplified frame/chassis"
+				(at 0 0 0)
+				(effects
+					(font
+						(size 1.27 1.27)
+					)
+					(hide yes)
+				)
+			)
+			(property "ki_keywords" "P V 0 GND FB equipotential bonding earth earthing ground grounding simplified frame chassis potential voltage tension global DC power supply node label pin"
+				(at 0 0 0)
+				(effects
+					(font
+						(size 1.27 1.27)
+					)
+					(hide yes)
+				)
+			)
+			(symbol "P,0_1_1"
+				(polyline
+					(pts
+						(xy -2.54 0) (xy 2.54 0)
+					)
+					(stroke
+						(width 0.508)
+						(type default)
+					)
+					(fill
+						(type none)
+					)
+				)
+				(pin power_in line
+					(at 0 0 0)
+					(length 0) hide
+					(name "0"
+						(effects
+							(font
+								(size 2.54 2.54)
+							)
+						)
+					)
+					(number "0"
+						(effects
+							(font
+								(size 0 0)
+							)
+						)
+					)
+				)
+			)
+		)
+		(symbol "PCM_SL_Pin_Headers:PINHD_1x1_Male"
+			(exclude_from_sim no)
+			(in_bom yes)
+			(on_board yes)
+			(property "Reference" "J"
+				(at 0 6.35 0)
+				(effects
+					(font
+						(size 1.27 1.27)
+					)
+				)
+			)
+			(property "Value" "PINHD_1x1_Male"
+				(at 0 3.81 0)
+				(effects
+					(font
+						(size 1.27 1.27)
+					)
+				)
+			)
+			(property "Footprint" "Connector_PinHeader_2.54mm:PinHeader_1x01_P2.54mm_Vertical"
+				(at 1.27 -2.54 0)
+				(effects
+					(font
+						(size 1.27 1.27)
+					)
+					(hide yes)
+				)
+			)
+			(property "Datasheet" ""
+				(at 0 6.35 0)
+				(effects
+					(font
+						(size 1.27 1.27)
+					)
+					(hide yes)
+				)
+			)
+			(property "Description" "Pin Header male with pin space 2.54mm. Pin Count -1"
+				(at 0 0 0)
+				(effects
+					(font
+						(size 1.27 1.27)
+					)
+					(hide yes)
+				)
+			)
+			(property "ki_keywords" "Pin Header"
+				(at 0 0 0)
+				(effects
+					(font
+						(size 1.27 1.27)
+					)
+					(hide yes)
+				)
+			)
+			(property "ki_fp_filters" "Connector_PinHeader_2.54mm:PinHeader_1x01_P2.54mm*"
+				(at 0 0 0)
+				(effects
+					(font
+						(size 1.27 1.27)
+					)
+					(hide yes)
+				)
+			)
+			(symbol "PINHD_1x1_Male_0_1"
+				(rectangle
+					(start -1.27 1.27)
+					(end 1.27 -1.27)
+					(stroke
+						(width 0)
+						(type default)
+					)
+					(fill
+						(type background)
+					)
+				)
+				(polyline
+					(pts
+						(xy -1.27 0) (xy 0 0)
+					)
+					(stroke
+						(width 0.3)
+						(type default)
+					)
+					(fill
+						(type none)
+					)
+				)
+				(polyline
+					(pts
+						(xy -1.27 0) (xy 0 0)
+					)
+					(stroke
+						(width 0.5)
+						(type default)
+					)
+					(fill
+						(type none)
+					)
+				)
+			)
+			(symbol "PINHD_1x1_Male_1_1"
+				(pin passive line
+					(at -3.81 0 0)
+					(length 2.54)
+					(name ""
+						(effects
+							(font
+								(size 1.27 1.27)
+							)
+						)
+					)
+					(number "1"
+						(effects
+							(font
+								(size 1.27 1.27)
+							)
+						)
+					)
+				)
+			)
+		)
+		(symbol "PCM_SL_Resistors:Resistor"
+			(exclude_from_sim no)
+			(in_bom yes)
+			(on_board yes)
+			(property "Reference" "R"
+				(at 0 5.08 0)
+				(effects
+					(font
+						(size 1.27 1.27)
+					)
+				)
+			)
+			(property "Value" "Resistor"
+				(at 0 2.54 0)
+				(effects
+					(font
+						(size 1.27 1.27)
+					)
+				)
+			)
+			(property "Footprint" "Resistor_THT:R_Axial_DIN0207_L6.3mm_D2.5mm_P10.16mm_Horizontal"
+				(at 0.889 -4.318 0)
+				(effects
+					(font
+						(size 1.27 1.27)
+					)
+					(hide yes)
+				)
+			)
+			(property "Datasheet" ""
+				(at 0.508 0 0)
+				(effects
+					(font
+						(size 1.27 1.27)
+					)
+					(hide yes)
+				)
+			)
+			(property "Description" "1/4W Resistor"
+				(at 0 0 0)
+				(effects
+					(font
+						(size 1.27 1.27)
+					)
+					(hide yes)
+				)
+			)
+			(property "ki_keywords" "Resistor"
+				(at 0 0 0)
+				(effects
+					(font
+						(size 1.27 1.27)
+					)
+					(hide yes)
+				)
+			)
+			(property "ki_fp_filters" "Resistor_THT:R_Axial_DIN0207_L6.3mm_D2.5mm*"
+				(at 0 0 0)
+				(effects
+					(font
+						(size 1.27 1.27)
+					)
+					(hide yes)
+				)
+			)
+			(symbol "Resistor_0_1"
+				(rectangle
+					(start -2.286 0.889)
+					(end 2.286 -0.889)
+					(stroke
+						(width 0.24)
+						(type default)
+					)
+					(fill
+						(type none)
+					)
+				)
+			)
+			(symbol "Resistor_1_1"
+				(pin passive line
+					(at -3.81 0 0)
+					(length 1.5)
+					(name ""
+						(effects
+							(font
+								(size 1.27 1.27)
+							)
+						)
+					)
+					(number "1"
+						(effects
+							(font
+								(size 0 0)
+							)
+						)
+					)
+				)
+				(pin passive line
+					(at 3.81 0 180)
+					(length 1.5)
+					(name "~"
+						(effects
+							(font
+								(size 1.27 1.27)
+							)
+						)
+					)
+					(number "2"
+						(effects
+							(font
+								(size 0 0)
+							)
+						)
+					)
+				)
+			)
+		)
+	)
+	(junction
+		(at 83.82 46.99)
+		(diameter 0)
+		(color 0 0 0 0)
+		(uuid "6fc3c276-6af6-4d31-8c96-132131fe2450")
+	)
+	(wire
+		(pts
+			(xy 83.82 60.96) (xy 83.82 63.5)
+		)
+		(stroke
+			(width 0)
+			(type default)
+		)
+		(uuid "018b5cca-480f-4695-9664-18e715a6152c")
+	)
+	(wire
+		(pts
+			(xy 83.82 46.99) (xy 90.17 46.99)
+		)
+		(stroke
+			(width 0)
+			(type default)
+		)
+		(uuid "39da6c99-01a8-4f63-a658-9323f0ba7682")
+	)
+	(wire
+		(pts
+			(xy 83.82 41.91) (xy 83.82 46.99)
+		)
+		(stroke
+			(width 0)
+			(type default)
+		)
+		(uuid "578682bf-f149-4f84-a6ae-250565547f12")
+	)
+	(wire
+		(pts
+			(xy 83.82 46.99) (xy 83.82 50.8)
+		)
+		(stroke
+			(width 0)
+			(type default)
+		)
+		(uuid "6249429a-a85e-4da4-aa6d-52d6378bd6f8")
+	)
+	(wire
+		(pts
+			(xy 83.82 30.48) (xy 83.82 34.29)
+		)
+		(stroke
+			(width 0)
+			(type default)
+		)
+		(uuid "b1168a67-233d-46c1-95fb-70d9c7710013")
+	)
+	(symbol
+		(lib_id "PCM_Generic:P,+3.3")
+		(at 83.82 30.48 0)
+		(unit 1)
+		(exclude_from_sim no)
+		(in_bom yes)
+		(on_board yes)
+		(dnp no)
+		(fields_autoplaced yes)
+		(uuid "1e8ec80d-4366-481c-b67c-645043a87f75")
+		(property "Reference" "#PWR01"
+			(at 86.36 30.48 0)
+			(effects
+				(font
+					(size 2.54 2.54)
+				)
+				(justify left)
+				(hide yes)
+			)
+		)
+		(property "Value" "P,+3.3"
+			(at 83.82 27.94 0)
+			(effects
+				(font
+					(size 0.001 0.001)
+				)
+				(justify bottom)
+				(hide yes)
+			)
+		)
+		(property "Footprint" ""
+			(at 83.82 30.48 0)
+			(effects
+				(font
+					(size 2.54 2.54)
+				)
+				(hide yes)
+			)
+		)
+		(property "Datasheet" ""
+			(at 83.82 30.48 0)
+			(effects
+				(font
+					(size 2.54 2.54)
+				)
+				(hide yes)
+			)
+		)
+		(property "Description" "+3.3 positive potential/voltage (global DC power supply node)"
+			(at 83.82 30.48 0)
+			(effects
+				(font
+					(size 1.27 1.27)
+				)
+				(hide yes)
+			)
+		)
+		(pin "0"
+			(uuid "9cf1f902-753b-41eb-87ec-e474068802e2")
+		)
+		(instances
+			(project ""
+				(path "/010a0f2a-cf19-430b-ad46-7851a0b6c63a"
+					(reference "#PWR01")
+					(unit 1)
+				)
+			)
+		)
+	)
+	(symbol
+		(lib_id "PCM_SL_Pin_Headers:PINHD_1x1_Male")
+		(at 93.98 46.99 0)
+		(unit 1)
+		(exclude_from_sim no)
+		(in_bom yes)
+		(on_board yes)
+		(dnp no)
+		(fields_autoplaced yes)
+		(uuid "33835b67-806e-4bf5-b6f5-9e9ff05e6b8c")
+		(property "Reference" "EingangMikrocontroller"
+			(at 96.52 46.3549 0)
+			(effects
+				(font
+					(size 1.27 1.27)
+				)
+				(justify left)
+			)
+		)
+		(property "Value" "~"
+			(at 96.52 48.26 0)
+			(effects
+				(font
+					(size 1.27 1.27)
+				)
+				(justify left)
+			)
+		)
+		(property "Footprint" "Connector_PinHeader_2.54mm:PinHeader_1x01_P2.54mm_Vertical"
+			(at 95.25 49.53 0)
+			(effects
+				(font
+					(size 1.27 1.27)
+				)
+				(hide yes)
+			)
+		)
+		(property "Datasheet" ""
+			(at 93.98 40.64 0)
+			(effects
+				(font
+					(size 1.27 1.27)
+				)
+				(hide yes)
+			)
+		)
+		(property "Description" "Pin Header male with pin space 2.54mm. Pin Count -1"
+			(at 93.98 46.99 0)
+			(effects
+				(font
+					(size 1.27 1.27)
+				)
+				(hide yes)
+			)
+		)
+		(pin "1"
+			(uuid "994946d0-a1c6-4866-9675-f633cb593bfa")
+		)
+		(instances
+			(project ""
+				(path "/010a0f2a-cf19-430b-ad46-7851a0b6c63a"
+					(reference "EingangMikrocontroller")
+					(unit 1)
+				)
+			)
+		)
+	)
+	(symbol
+		(lib_id "PCM_Elektuur:S-make")
+		(at 83.82 55.88 0)
+		(unit 1)
+		(exclude_from_sim no)
+		(in_bom yes)
+		(on_board yes)
+		(dnp no)
+		(fields_autoplaced yes)
+		(uuid "7944eb49-3d5f-4b4f-a681-ffb843a90dd5")
+		(property "Reference" "FlashKnopf"
+			(at 86.36 55.2449 0)
+			(effects
+				(font
+					(size 1.27 1.27)
+				)
+				(justify left)
+			)
+		)
+		(property "Value" "~"
+			(at 86.36 57.15 0)
+			(effects
+				(font
+					(size 1.27 1.27)
+				)
+				(justify left)
+			)
+		)
+		(property "Footprint" ""
+			(at 83.82 55.88 0)
+			(effects
+				(font
+					(size 1.27 1.27)
+				)
+				(hide yes)
+			)
+		)
+		(property "Datasheet" ""
+			(at 83.82 55.88 0)
+			(effects
+				(font
+					(size 1.27 1.27)
+				)
+				(hide yes)
+			)
+		)
+		(property "Description" "make/closing contact; switch, single pole, single throw, normally open (SPST-NO/A)"
+			(at 83.82 55.88 0)
+			(effects
+				(font
+					(size 1.27 1.27)
+				)
+				(hide yes)
+			)
+		)
+		(property "Field-1" "X"
+			(at 85.09 55.88 0)
+			(effects
+				(font
+					(size 1.27 1.27)
+				)
+				(justify left)
+				(hide yes)
+			)
+		)
+		(property "Rating" "V/A"
+			(at 82.55 59.055 0)
+			(effects
+				(font
+					(size 1.27 1.27)
+				)
+				(justify right)
+				(hide yes)
+			)
+		)
+		(pin "4"
+			(uuid "9771e9f2-7155-4bd6-b66d-c889a6675e89")
+		)
+		(pin "3"
+			(uuid "d88f471e-3124-4b7f-8d07-aab6f6ca8851")
+		)
+		(instances
+			(project ""
+				(path "/010a0f2a-cf19-430b-ad46-7851a0b6c63a"
+					(reference "FlashKnopf")
+					(unit 1)
+				)
+			)
+		)
+	)
+	(symbol
+		(lib_id "PCM_Generic:P,0")
+		(at 83.82 63.5 0)
+		(unit 1)
+		(exclude_from_sim no)
+		(in_bom yes)
+		(on_board yes)
+		(dnp no)
+		(fields_autoplaced yes)
+		(uuid "b38519e5-22f2-4606-8424-ec7218544333")
+		(property "Reference" "#PWR02"
+			(at 87.63 59.69 0)
+			(effects
+				(font
+					(size 2.54 2.54)
+				)
+				(justify left)
+				(hide yes)
+			)
+		)
+		(property "Value" "P,0"
+			(at 87.63 63.5 0)
+			(effects
+				(font
+					(size 0.001 0.001)
+				)
+				(justify left)
+				(hide yes)
+			)
+		)
+		(property "Footprint" ""
+			(at 83.82 63.5 0)
+			(effects
+				(font
+					(size 2.54 2.54)
+				)
+				(hide yes)
+			)
+		)
+		(property "Datasheet" ""
+			(at 83.82 63.5 0)
+			(effects
+				(font
+					(size 2.54 2.54)
+				)
+				(hide yes)
+			)
+		)
+		(property "Description" "global node 0; simplified functional (equipotential) bonding (FB); simplified frame/chassis"
+			(at 83.82 63.5 0)
+			(effects
+				(font
+					(size 1.27 1.27)
+				)
+				(hide yes)
+			)
+		)
+		(pin "0"
+			(uuid "5f05c4d1-5c3a-4e59-896e-c3fabdebd5b1")
+		)
+		(instances
+			(project ""
+				(path "/010a0f2a-cf19-430b-ad46-7851a0b6c63a"
+					(reference "#PWR02")
+					(unit 1)
+				)
+			)
+		)
+	)
+	(symbol
+		(lib_id "PCM_SL_Resistors:Resistor")
+		(at 83.82 38.1 90)
+		(unit 1)
+		(exclude_from_sim no)
+		(in_bom yes)
+		(on_board yes)
+		(dnp no)
+		(fields_autoplaced yes)
+		(uuid "ceabd83b-6185-492b-8664-195069283e9e")
+		(property "Reference" "PullUpWiderstand"
+			(at 86.36 37.4649 90)
+			(effects
+				(font
+					(size 1.27 1.27)
+				)
+				(justify right)
+			)
+		)
+		(property "Value" "~"
+			(at 86.36 39.37 90)
+			(effects
+				(font
+					(size 1.27 1.27)
+				)
+				(justify right)
+			)
+		)
+		(property "Footprint" "Resistor_THT:R_Axial_DIN0207_L6.3mm_D2.5mm_P10.16mm_Horizontal"
+			(at 88.138 37.211 0)
+			(effects
+				(font
+					(size 1.27 1.27)
+				)
+				(hide yes)
+			)
+		)
+		(property "Datasheet" ""
+			(at 83.82 37.592 0)
+			(effects
+				(font
+					(size 1.27 1.27)
+				)
+				(hide yes)
+			)
+		)
+		(property "Description" "1/4W Resistor"
+			(at 83.82 38.1 0)
+			(effects
+				(font
+					(size 1.27 1.27)
+				)
+				(hide yes)
+			)
+		)
+		(pin "2"
+			(uuid "7a67dbc1-7ba2-4e85-9ba0-83acec6ef7c2")
+		)
+		(pin "1"
+			(uuid "78538a05-79fb-4d96-8092-83a2edba6db7")
+		)
+		(instances
+			(project ""
+				(path "/010a0f2a-cf19-430b-ad46-7851a0b6c63a"
+					(reference "PullUpWiderstand")
+					(unit 1)
+				)
+			)
+		)
+	)
+	(sheet_instances
+		(path "/"
+			(page "1")
+		)
+	)
+)
diff --git a/src/01_grundlagen.ipynb b/src/01_grundlagen.ipynb
index 859275d..71b42b1 100644
--- a/src/01_grundlagen.ipynb
+++ b/src/01_grundlagen.ipynb
@@ -593,6 +593,81 @@
     "    print(\"x ist größer als 5\")"
    ]
   },
+  {
+   "cell_type": "markdown",
+   "id": "b679354e-d020-4654-894d-38daeaa3a0c4",
+   "metadata": {
+    "editable": false,
+    "slideshow": {
+     "slide_type": ""
+    },
+    "tags": []
+   },
+   "source": [
+    "## Pin Zustände einlesen\n",
+    "\n",
+    "Als nächstes wollen wir den Zustand von Pins einlesen und eine entsprechende Meldung ausgeben.\n",
+    "GPIO 0 ist praktischerweise mit den \"FLASH\" Knopf auf der Platine des Mikrocontrollers verbunden, sodass wir für unseren Test keine extra Schaltung aufbauen müssen.\n",
+    "Als erstes initialisieren wir den Pin als Input Pin."
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "id": "41b849d5-8693-4f31-9496-13a903a3e72c",
+   "metadata": {
+    "editable": true,
+    "slideshow": {
+     "slide_type": ""
+    },
+    "tags": []
+   },
+   "outputs": [],
+   "source": [
+    "eingabe_pin = machine.Pin(0, machine.Pin.IN, machine.Pin.PULL_UP)\n",
+    "eingabe_signal = machine.Signal(eingabe_pin, invert=True)"
+   ]
+  },
+  {
+   "attachments": {},
+   "cell_type": "markdown",
+   "id": "245cb3e5-46e4-4fe6-ae54-0df98b41b35f",
+   "metadata": {
+    "editable": true,
+    "slideshow": {
+     "slide_type": ""
+    },
+    "tags": []
+   },
+   "source": [
+    "Hier übergeben wir noch einen dritten Parameter an die Pin Funktion.\n",
+    "Dieser dient dazu, die internen Pull-Up Widerstände des Mikrocontrollers für diesen Eingang zu aktivieren.\n",
+    "Neben `machine.Pin.PULL_UP` gibt es auch noch `machine.Pin.PULL_DOWN`, falls man Pull-Down Widerstände nutzen möchte.\n",
+    "Pull-Up und Pull-Down Widerstände sind dazu da, bei geöffnetem Schalter ein eindeutiges Signal an den Mikrocontroller so senden.  \n",
+    "![Pull-Down Widerstand Schaltplan](img/pull-down-resistor.png)\n",
+    "\n",
+    "Nun können wir mit der `value()` Methode es `eingabe_pin` Objekts den Wert des Pins auslesen bzw. mit der gleichen Methode des `eingabe_signals` den invertierten Eingang.\n",
+    "Wir invertieren den Pin in diesem Fall, weil der FLASH Knopf den Eingang des Mikrocontrollers mit Ground (dem Minuspol) verbindet, dadurch wird ein Aus-Signal (0) gelesen wenn der Knopf gedrückt ist.\n",
+    "Genau wie auch bei dem Umkehren der Zustände der LED ist dies auch bei dem einlesen von Pins durch ein `machine.Signal` möglich.  \n",
+    "**Wichtig:** Die nächste Zeile gibt den Zustand des Pins aus zum Zeitpunkt der Ausführung, ihr müsst den Kopf also schon vor der Ausführung drücken, falls ihr den gedrückten Zustand einlesen wollt."
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "id": "bf1cd20a-a878-449b-8692-527da8ec7800",
+   "metadata": {
+    "editable": true,
+    "slideshow": {
+     "slide_type": ""
+    },
+    "tags": []
+   },
+   "outputs": [],
+   "source": [
+    "print(eingabe_signal.value())"
+   ]
+  },
   {
    "cell_type": "markdown",
    "id": "f46a9e10-24ff-4d7f-a31b-3a1c5d47df61",
diff --git a/src/img/pull-down-resistor.png b/src/img/pull-down-resistor.png
new file mode 100644
index 0000000000000000000000000000000000000000..269fc2e04b4fb4009e815a246ec249d02aa9e494
GIT binary patch
literal 9446
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
KRNS!t?Y{u$Soqoi

literal 0
HcmV?d00001