Merge branch 'development_Q2_2026' of https://github.com/NB-TUDelft/Electronic_Instrumentation into development_Q2_2026

Author: ashj25

book/_config.yml

@@ -85,6 +85,9 @@ sphinx:
     - sphinx_iframes 
     - sphinx_exercise 
     - teachbooks_sphinx_tippy 
+    - sphinx_accessibility
+    - sphinx_dropdown_toggle
+
   local_extensions:
     no_content_admonition: .
 
@@ -101,7 +104,7 @@ sphinx:
     iframe_aspectratio:    auto 2 / 1 # default value
     exclude_patterns: [.conda/**, .mamba/**, _build/**, "**/.ipynb_checkpoints", .venv/**]
     html_extra_path: []
-    language: en  # To identify the language. Change if appropriate
+    language: en  # To identify the language.
     html_js_files: 
     - https://cdnjs.cloudflare.com/ajax/libs/require.js/2.3.4/require.min.js 
     - warning.js 

book/_toc.yml

@@ -24,8 +24,9 @@ parts:
       - file: manuals/week2/_summary.ipynb
         sections:
           - file: manuals/week2/2.1_Whack_a_mole.ipynb
-        
-        
+          - file: manuals/week2/2.2_Timed_acquisitions.ipynb
+
+
   - caption: Miscellaneous
     chapters:
       - file: miscellaneous/appendix/_summary.ipynb

book/manuals/intros/Intro_to_Jupyter_Notebook.ipynb

@@ -483,12 +483,6 @@
     "    # but it removes the ugly line of \"<matplotlib.image.AxesImage at 0x13145a0d0>\""
    ]
   },
-  {
-   "cell_type": "markdown",
-   "id": "98a554d4",
-   "metadata": {},
-   "source": []
-  },
   {
    "cell_type": "markdown",
    "id": "03de3b7c",
@@ -600,4 +594,4 @@
  },
  "nbformat": 4,
  "nbformat_minor": 5
-}
+}

book/manuals/intros/intro_scope_Siglent.ipynb

@@ -186,7 +186,7 @@
    "cell_type": "markdown",
    "metadata": {},
    "source": [
-    "```{admonition} Deep dive (optional)\n",
+    "````{admonition} Deep dive (optional)\n",
     ":class: deep-dive\n",
     "### Probe compensation\n",
     "\n",
@@ -211,7 +211,7 @@
     "Watch the video below for the steps involved in adjusting the compensation capacitor. \n",
     "```{video} https://www.youtube.com/watch?v=XKVZbwOsdic\n",
     "```\n",
-    "```"
+    "````"
    ]
   }
  ],

book/manuals/week1/1.1_voltage_divider.ipynb

@@ -38,13 +38,13 @@
    "source": [
     "### Background \n",
     "\n",
-    "(Task_B1)=\n",
+    "(Task_B1_2_1)=\n",
     "#### Task B1: What is Whack-a-mole?\n",
     "Whack-a-mole is a popular arcade game in which the player uses a mallet/hammer to hit moles as they pop up from random holes. The player is scored based on their reaction time/how quickly they are able to hit the moles. \n",
     "\n",
-    "During this practical, you will be creating your own version of this game on the ALPACA. As the ALPACA does not have moles or a mallet, you will replace the moles with LEDs and the mallet with buttons. You will programme the LEDs to turn on at random and will use the buttons to turn the LEDs off, analogous to how the mallet is used to hit the moles in the arcade game. \n",
+    "During this practical, you will be creating your own version of this game on the ALPACA. As the ALPACA has neither moles nor a mallet, you will replace the moles with LEDs and the mallet with buttons. You will programme the LEDs to turn on at random and will use the buttons to turn the LEDs off, analogous to how the mallet is used to hit the moles in the arcade game. You will also measure the reaction time of the player.\n",
     "\n",
-    "(Task_B2)=\n",
+    "(Task_B2_2_1)=\n",
     "#### Task B2: Light emitting diodes (LEDs)\n",
     "A light emitting diode (LED) is a type of directional component that converts electricity into light. You will dive deeper into the concept of diodes and LEDs in future practicals, but for today, it is only important that you understand how to connect an LED. As seen in the figure below, to conduct electricity and emit light, the long leg of the LED (also referred to as the anode), should be connected to a higher potential than the short leg (also referred to as the cathode).\n",
     "\n",
@@ -65,16 +65,34 @@
     "Schematic of LEDs on the ALPACA, indicating the anode and cathode\n",
     "```\n",
     "\n",
-    "(Task_B3)=\n",
+    "(Task_B3_2_1)=\n",
     "#### Task B3: Digital input and output pins\n",
-    "The ALPACA contains both digital input and digital output pins. These pins are referred to as *digital*, as they are only able to be in one of two states, either HIGH (+5 V) or LOW (0 V). This is in contrast to analogue pins, which can read or output a continuous range of voltages. \n",
+    "The ALPACA contains both digital input and digital output pins. These pins are referred to as *digital*, as they are only able to be in one of two states, either high (5 V) or low (0 V). This is in contrast to analogue pins, which can read or output a continuous range of voltages. \n",
     "\n",
-    "Digital output pins output +5 V when set to True and output 0 V when set to False. Similarly, a digital input pin can determine whether +5 V or 0 V are connected. When +5 V are connected to a digital input pin, it will be assigned as True and when 0 V are connected, it will be assigned as False. \n",
+    "Digital output pins output 5 V when set to True and output 0 V when set to False. Similarly, a digital input pin can determine whether 5 V or 0 V are connected. When 5 V are connected to a digital input pin, it will be assigned as True and when 0 V are connected, it will be assigned as False. \n",
     "\n",
-    "To programme a digital input or output pin, you first need to import the Pin function from the machine module. This allows you to define pins. You then need to define a pin using the pin ID and state whether the pin is an output or input pin. Once a digital output pin is defined, it can be programmed as True to output +5 V, or as false to output 0 V and once a digital input pin is defined, it is possible to check whether it is connected to + 5V or 0 V. \n",
+    "To programme a digital input or output pin, you first need to import the Pin function from the machine module MicroPython. This allows you to define pins. You then need to define a pin using the pin ID and state whether the pin is an output or input pin. \n",
     "\n",
+    "```{tip}\n",
+    "Pin IDs digital output pins:\n",
+    "- 10\n",
+    "- 11\n",
+    "- 12\n",
+    "- 13\n",
     "\n",
-    "For example, pin 14 on the Pico-Pi is a digital output pin and pin 19 is a digital input pin. In the code cell below, you can see how these pins can be defined and programmed. \n",
+    "Pin IDs digital input pins:\n",
+    "- 14\n",
+    "- 15\n",
+    "- 16\n",
+    "- 17 \n",
+    "\n",
+    "You can also find the pin IDs in the ALPACA manual.\n",
+    "```\n",
+    "\n",
+    "Once a digital output pin is defined, it can be programmed as True to output 5 V, or as false to output 0 V and once a digital input pin is defined, it is possible to check whether it is connected to 5V or 0 V. \n",
+    "\n",
+    "\n",
+    "For example, pin 10 on the Pico-Pi is a digital output pin and pin 14 is a digital input pin. In the code cell below, you can see how these pins can be defined and programmed. \n",
     "\n",
     "```{note}\n",
     "The names Dout1 and Din1 were selected, as they are easy to remember. You can assign different names to the pins. \n",
@@ -90,21 +108,21 @@
    "source": [
     "from machine import Pin #Import the module used to define pins\n",
     "\n",
-    "Dout1 = Pin(14, Pin.OUT) #Give the pin a name. Define the pin using the pin ID (in this case, the ID is 14). State whether it is an input/output pin\n",
-    "Din1 = Pin(19, Pin.IN) #Give the pin a name. Define the pin using the pin ID (in this case, the ID is 19). State whether it is an input/output pin\n",
+    "Dout1 = Pin(10, Pin.OUT) #Give the pin a name. Define the pin using the pin ID (in this case, the ID is 10). State whether it is an input/output pin\n",
+    "Din1 = Pin(14, Pin.IN) #Give the pin a name. Define the pin using the pin ID (in this case, the ID is 14). State whether it is an input/output pin\n",
     "\n",
-    "Dout1.value(True) #Pin 14 will output +5 V\n",
-    "Dout1.value(False) #Pin 14 will output 0 V\n",
+    "Dout1.value(True) #The value of pin 10 is assigned as True, so it will output 5 V\n",
+    "Dout1.value(False) #The value of pin 10 is assigned as False, so it will output 0 V\n",
     "\n",
-    "isPressed = Din1.value() #The variable isPressed will be True when + 5V is connected to pin 19 and False when 0 V are connected to pin 19"
+    "isPressed = Din1.value() #The variable isPressed will be True when 5V is connected to pin 10 and False when 0 V are connected to pin 14"
    ]
   },
   {
    "cell_type": "markdown",
    "id": "4629d3db",
    "metadata": {},
    "source": [
-    "(Task_B4)=\n",
+    "(Task_B4_2_1)=\n",
     "#### Task B4: Switches and pull-up/pull-down resistors\n",
     "Analogous to the mallet which is used to hit the moles in the Whack-a-mole game, you will use switches to turn off the LEDs. A switch is a valuable electronic component which can be used to close or open a path for current flow. A button is a special type of switch that works when pushed. \n",
     "\n",
@@ -120,7 +138,89 @@
     "As you can see in this figure, the circuit containing the button also contains a 10 kΩ resistor. \n",
     "\n",
     "We have two different options for how we can connect the button with respect to the resistor. \n",
-    "\n"
+    "\n",
+    "In the figure shown below, the resistor is connected in such a way that we refer to it as a **pull-up resistor**.\n",
+    "\n",
+    "```{figure} images/Pull_up_resistor.svg\n",
+    "---\n",
+    "height: 200px\n",
+    "name: Pull up resistor\n",
+    "---\n",
+    "Pull-up resistor configuration\n",
+    "```\n",
+    "In this configuration, when the button is not pressed, the digital input pin will be connected to 5 V. This means that the value of the pin will be assigned as True by default. When the button is pressed, the digital input pin will be connected to ground (0 V). The 10 kΩ resistor is connected between the 5 V supply and ground to limit the flow of current, preventing a short circuit when the button is pressed.\n",
+    "\n",
+    "We can also connect the resistor as a **pull-down resistor**, as seen in the figure below.\n",
+    "\n",
+    "```{figure} images/Pull_down_resistor.svg\n",
+    "---\n",
+    "height: 200px\n",
+    "name: Pull down resistor\n",
+    "---\n",
+    "Pull-down resistor configuration\n",
+    "```\n",
+    "In this configuration, when the button is not pressed, the digital input pin will be connected to ground (0 V). This means that the value of the pin will be assigned as False by default. When the button is pressed, the digital input pin will be connected to 5 V. The 10 kΩ resistor is connected between the 5 V supply and ground to limit current flow when the button is pressed, preventing a short circuit. \n",
+    "\n",
+    "```{hint}\n",
+    "In summary:\n",
+    "- Pull-up resistor configuration: Default value of the digital input pin (when the button is not pressed) is 5 V or True. \n",
+    "- Pull-down resistor configuration: Default value of the digital input pin (when the button is not pressed) is 0 V or False.\n",
+    "- In both configurations, the 10 kΩ resistor limits the flow of current when the button is pressed, preventing a short circuit.\n",
+    "```"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "a9938ab6",
+   "metadata": {},
+   "source": [
+    "### Anticipate \n",
+    "\n",
+    "(Task_A1_2_1)=\n",
+    "#### Task A1: Connecting an LED to a switch in pull-up vs pull-down configuration\n",
+    "\n",
+    "Instead of connecting the output of a switch to a digital input pin, you can also connect it to an LED. This way, you can control the behaviour of the LED by pushing the button. \n",
+    "\n",
+    "We will begin by examining the effect of connecting the LED to a button in a pull-up configuration. \n",
+    "\n",
+    "Think back to [Task B4](Task_B4_2_1). What is the default output (when the button is not pressed) of a button in a pull-up configuration? What is the output when a button in a pull-up configuration is pressed?\n",
+    "\n",
+    "In the figure below, a button with a pull-up resistor is connected to an LED in two different configurations (A and B).\n",
+    "\n",
+    "```{figure} images/Pull_up_switch_LED_config.svg\n",
+    "---\n",
+    "width: 500px\n",
+    "name: Pull-up button connected to LED in two configurations\n",
+    "---\n",
+    "Schematic of a button with a pull-up resistor connected to an LED in two configurations\n",
+    "```\n",
+    "Consider [Task B2](Task_B2_2_1), for configuration A and configuration B, predict what the LED will do when the button is not pressed and when the button is pressed. \n",
+    "\n",
+    "Recall [Task B4](Task_B4_2_1). What is the default output (when the button is not pressed) of a button in a pull-down configuration? What is the output when a button in a pull-down configuration is pressed?\n",
+    "\n",
+    "In the figure below, a button with a pull-down resistor is connected to an LED in two different configurations (C and D).\n",
+    "\n",
+    "```{figure} images/Pull_down_switch_config.svg\n",
+    "---\n",
+    "width: 500px\n",
+    "name: Pull-down button connected to LED in two configurations\n",
+    "---\n",
+    "Schematic of a button with a pull-down resistor connected to an LED in two configurations\n",
+    "```\n",
+    "\n",
+    "Consider [Task B2](Task_B2_2_1), for configuration A and configuration B, predict what the LED will do when the button is unpressed and when the button is pressed. \n",
+    "\n",
+    "\n",
+    "\n",
+    "-----\n",
+    "\n",
+    "Compare connecting LED to switch in pull-up and pull-down config - validate in I&I1\n",
+    "Idea is that they understand when output is true and when output is false\n",
+    "\n",
+    "Explain that can't implement logic with this yet \n",
+    "\n",
+    "Look at connecting switch to digital input pin and connecting digital output pin to the LED\n",
+    "Explain that this then allows us to do logic: by setting hte output pin to true, we can turn on the LED. When we push the button, we will get a true/false signal (depending on whether have pull-up or pull-down config). Based on this, when get certain signal at input pin, can output something in response from output pin to make LED respond to whatever is happening with the switch "
    ]
   }
  ],