Misc proofreading edits

malcolm-sparkfun · malcolm-sparkfun · commit 18f95cebcd8e · 2025-06-17T14:13:58.000-06:00
diff --git a/content/SIK_Project1_CircuitA_Full.ipynb b/content/SIK_Project1_CircuitA_Full.ipynb
@@ -109,7 +109,7 @@
     "\n",
     "Select the \"Connect\" button at the bottom right of this screen and a panel is displayed\n",
     "\n",
-    "Select the \"Connect Device\" Button, and when the selection dialog appears, select the port with that displays ***Board in FS mode (...)*** or ***Board CDC (...)***\n",
+    "Select the \"Connect Device\" Button, and when the selection dialog appears, select the port that displays ***Board in FS mode (...)*** or ***Board CDC (...)***\n",
     "\n",
     "![Select a Port](images/sik-demo-select-port.png)\n",
     "\n",
diff --git a/content/SIK_Project1_CircuitB_Full.ipynb b/content/SIK_Project1_CircuitB_Full.ipynb
@@ -143,7 +143,7 @@
     "\n",
     "Select the \"Connect\" button at the bottom right of this screen and a panel is displayed\n",
     "\n",
-    "Select the \"Connect Device\" Button, and when the selection dialog appears, select the port with that displays ***Board in FS mode (...)*** or ***Board CDC (...)***\n",
+    "Select the \"Connect Device\" Button, and when the selection dialog appears, select the port that displays ***Board in FS mode (...)*** or ***Board CDC (...)***\n",
     "\n",
     "![Select a Port](images/sik-demo-select-port.png)\n",
     "\n",
diff --git a/content/SIK_Project1_CircuitC_Full.ipynb b/content/SIK_Project1_CircuitC_Full.ipynb
@@ -126,15 +126,15 @@
     "\n",
     "Select the \"Connect\" button at the bottom right of this screen and a panel is displayed\n",
     "\n",
-    "Select the \"Connect Device\" Button, and when the selection dialog appears, select the port with that displays ***Board in FS mode (...)*** or ***Board CDC (...)***\n",
+    "Select the \"Connect Device\" Button, and when the selection dialog appears, select the port that displays ***Board in FS mode (...)*** or ***Board CDC (...)***\n",
     "\n",
     "![Select a Port](images/sik-demo-select-port.png)\n",
     "\n",
-    "With the RedBoard connected, use the following MicroPython commands to blink the LED. \n",
+    "With the RedBoard connected, use the following MicroPython commands to read the value from your photoresistor. \n",
     "\n",
     "### Using MicroPython\n",
     "\n",
-    "The following MicroPython commands are entered to blink the LED on your board. \n",
+    "The following MicroPython commands are entered to read the value from your photoresistor. \n",
     "\n",
     "**REMEMBER** To enter a MicroPython command, hold down either the Control (on Windows) or Command (on Mac) key when pressing *Enter*\n",
     "\n",
@@ -144,7 +144,7 @@
     "\n",
     "#### Step 1 - Setup\n",
     "\n",
-    "To blink the LED, we need to enable the board pin **34** (the pin that the LED is connected to in the circuit).  \n",
+    "Like in previous cicuits, to operate the LED we need to enable the board pin **34** (the pin that the LED is connected to in the circuit).  \n",
     "\n",
     "To do this we **load the Pin definition for the board**"
    ]
diff --git a/content/SIK_Project1_CircuitD_Full.ipynb b/content/SIK_Project1_CircuitD_Full.ipynb
@@ -161,15 +161,15 @@
     "\n",
     "Select the \"Connect\" button at the bottom right of this screen and a panel is displayed\n",
     "\n",
-    "Select the \"Connect Device\" Button, and when the selection dialog appears, select the port with that displays ***Board in FS mode (...)*** or ***Board CDC (...)***\n",
+    "Select the \"Connect Device\" Button, and when the selection dialog appears, select the port that displays ***Board in FS mode (...)*** or ***Board CDC (...)***\n",
     "\n",
     "![Select a Port](images/sik-demo-select-port.png)\n",
     "\n",
-    "With the RedBoard connected, use the following MicroPython commands to blink the LED. \n",
+    "With the RedBoard connected, use the following MicroPython commands to write to the RGB LED. \n",
     "\n",
     "### Using MicroPython\n",
     "\n",
-    "The following MicroPython commands are entered to blink the LED on your board. \n",
+    "The following MicroPython commands are entered to write to the RGB LED on your board. \n",
     "\n",
     "**REMEMBER** To enter a MicroPython command, hold down either the Control (on Windows) or Command (on Mac) key when pressing *Enter*\n",
     "\n",
@@ -179,7 +179,7 @@
     "\n",
     "#### Step 1 - Setup\n",
     "\n",
-    "To blink the LED, we need to enable the board pin **34** (the pin that the LED is connected to in the circuit).  \n",
+    "To write to the RGB LED, we need to enable the board pins **32**, **30**, and **28** that the RGB's color leads are connected to. \n",
     "\n",
     "To do this we **load the Pin definition for the board**"
    ]
@@ -257,7 +257,8 @@
    "source": [
     "Next, lets create our own *functions* for controlling color. Functions contain several lines of code that we want to reuse often without typing all of them out every time. For example, we would love to set the led to \"blue\" without having to type three lines of code every time. By putting the lines of code in a function, we just have to type that function's name to call those three lines of code. \n",
     "\n",
-    "TODO: Maybe make this less verbose or remove it...\n",
+    "**TODO: Maybe make this less verbose or remove it...**\n",
+    "\n",
     "Functions also keep repeated code in the same place. Imagine we wanted to change something about the way our \"blue\" function behaved. If we had repeated the three lines of code in several places of our program, we would have to fix it for each of those places. But with a function, we would correct it once in our function and leave all the places that function was used untouched."
    ]
   },
diff --git a/content/SIK_Project2_CircuitA_Full.ipynb b/content/SIK_Project2_CircuitA_Full.ipynb
@@ -97,11 +97,11 @@
     "\n",
     "Select the \"Connect\" button at the bottom right of this screen and a panel is displayed\n",
     "\n",
-    "Select the \"Connect Device\" Button, and when the selection dialog appears, select the port with that displays ***Board in FS mode (...)*** or ***Board CDC (...)***\n",
+    "Select the \"Connect Device\" Button, and when the selection dialog appears, select the port that displays ***Board in FS mode (...)*** or ***Board CDC (...)***\n",
     "\n",
     "![Select a Port](images/sik-demo-select-port.png)\n",
     "\n",
-    "With the RedBoard connected, use the following MicroPython commands to move the servo. \n",
+    "With the RedBoard connected, use the following MicroPython commands to operate the buzzer. \n",
     "\n",
     "### Using MicroPython\n",
     "\n",
diff --git a/content/SIK_Project2_CircuitB_Full.ipynb b/content/SIK_Project2_CircuitB_Full.ipynb
@@ -85,21 +85,21 @@
    "source": [
     "## Using Buttons with the Buzzer\n",
     "\n",
-    "Now that your circuit is built, it's time to use the buzzer. This is done using MicroPython, which is running on the RedBoard.\n",
+    "Now that your circuit is built, it's time to use the buzzer and buttons. This is done using MicroPython, which is running on the RedBoard.\n",
     "\n",
     "The first step is to connect your RedBoard to a USB port on this computer.\n",
     "\n",
     "Select the \"Connect\" button at the bottom right of this screen and a panel is displayed\n",
     "\n",
-    "Select the \"Connect Device\" Button, and when the selection dialog appears, select the port with that displays ***Board in FS mode (...)*** or ***Board CDC (...)***\n",
+    "Select the \"Connect Device\" Button, and when the selection dialog appears, select the port that displays ***Board in FS mode (...)*** or ***Board CDC (...)***\n",
     "\n",
     "![Select a Port](images/sik-demo-select-port.png)\n",
     "\n",
-    "With the RedBoard connected, use the following MicroPython commands to move the servo. \n",
+    "With the RedBoard connected, use the following MicroPython commands to operate the digital trumpet. \n",
     "\n",
     "### Using MicroPython\n",
     "\n",
-    "The following MicroPython commands are entered to operate the buzzer. \n",
+    "The following MicroPython commands are entered to operate the buzzer and buttons. \n",
     "\n",
     "**REMEMBER** To enter a MicroPython command, hold down either the Control (on Windows) or Command (on Mac) key when pressing *Enter*\n",
     "\n",
diff --git a/content/SIK_Project2_CircuitC_Full.ipynb b/content/SIK_Project2_CircuitC_Full.ipynb
@@ -94,7 +94,7 @@
     "\n",
     "Select the \"Connect\" button at the bottom right of this screen and a panel is displayed\n",
     "\n",
-    "Select the \"Connect Device\" Button, and when the selection dialog appears, select the port with that displays ***Board in FS mode (...)*** or ***Board CDC (...)***\n",
+    "Select the \"Connect Device\" Button, and when the selection dialog appears, select the port that displays ***Board in FS mode (...)*** or ***Board CDC (...)***\n",
     "\n",
     "![Select a Port](images/sik-demo-select-port.png)\n",
     "\n",
diff --git a/content/SIK_Project3_CircuitA_Full.ipynb b/content/SIK_Project3_CircuitA_Full.ipynb
@@ -262,15 +262,15 @@
     "\n",
     "Select the \"Connect\" button at the bottom right of this screen and a panel is displayed\n",
     "\n",
-    "Select the \"Connect Device\" Button, and when the selection dialog appears, select the port with that displays ***Board in FS mode (...)*** or ***Board CDC (...)***\n",
+    "Select the \"Connect Device\" Button, and when the selection dialog appears, select the port that displays ***Board in FS mode (...)*** or ***Board CDC (...)***\n",
     "\n",
     "![Select a Port](images/sik-demo-select-port.png)\n",
     "\n",
     "With the RedBoard connected, use the following MicroPython commands to move the servo. \n",
     "\n",
     "### Using MicroPython\n",
     "\n",
-    "The following MicroPython commands are entered to blink the LED on your board. \n",
+    "The following MicroPython commands are entered to move the servo on your board. \n",
     "\n",
     "**REMEMBER** To enter a MicroPython command, hold down either the Control (on Windows) or Command (on Mac) key when pressing *Enter*\n",
     "\n",
diff --git a/content/SIK_Project3_CircuitB_Full.ipynb b/content/SIK_Project3_CircuitB_Full.ipynb
@@ -168,15 +168,15 @@
     "\n",
     "Select the \"Connect\" button at the bottom right of this screen and a panel is displayed\n",
     "\n",
-    "Select the \"Connect Device\" Button, and when the selection dialog appears, select the port with that displays ***Board in FS mode (...)*** or ***Board CDC (...)***\n",
+    "Select the \"Connect Device\" Button, and when the selection dialog appears, select the port that displays ***Board in FS mode (...)*** or ***Board CDC (...)***\n",
     "\n",
     "![Select a Port](images/sik-demo-select-port.png)\n",
     "\n",
-    "With the RedBoard connected, use the following MicroPython commands to move the servo. \n",
+    "With the RedBoard connected, use the following MicroPython commands to read the sensor. \n",
     "\n",
     "### Using MicroPython\n",
     "\n",
-    "The following MicroPython commands are entered to blink the LED on your board. \n",
+    "The following MicroPython commands are entered to read the distance sensor. \n",
     "\n",
     "**REMEMBER** To enter a MicroPython command, hold down either the Control (on Windows) or Command (on Mac) key when pressing *Enter*\n",
     "\n",
diff --git a/content/SIK_Project3_CircuitC_Full.ipynb b/content/SIK_Project3_CircuitC_Full.ipynb
@@ -33,7 +33,7 @@
     "\n",
     "![LinkageRod](images/sik-demo-prj3-cc-linkage-rod.jpg)\n",
     "\n",
-    "*Linkage rods are found on many RC airplanes which use servo motors to control the ailerons, elevators and rudder.\n",
+    "*Linkage rods are found on many RC airplanes which use servo motors to control the ailerons, elevators and rudder.*\n",
     "\n",
     "## Hardware Hookup\n",
     "If you have opted for the extra materials, use the following instructions to create the moving pop-up for your cat alarm.\n",
@@ -115,7 +115,7 @@
     "\n",
     "Select the \"Connect\" button at the bottom right of this screen and a panel is displayed\n",
     "\n",
-    "Select the \"Connect Device\" Button, and when the selection dialog appears, select the port with that displays ***Board in FS mode (...)*** or ***Board CDC (...)***\n",
+    "Select the \"Connect Device\" Button, and when the selection dialog appears, select the port that displays ***Board in FS mode (...)*** or ***Board CDC (...)***\n",
     "\n",
     "![Select a Port](images/sik-demo-select-port.png)\n",
     "\n",
diff --git a/content/SIK_Project4_CircuitA_Full.ipynb b/content/SIK_Project4_CircuitA_Full.ipynb
@@ -60,7 +60,7 @@
     "\n",
     "Select the \"Connect\" button at the bottom right of this screen and a panel is displayed\n",
     "\n",
-    "Select the \"Connect Device\" Button, and when the selection dialog appears, select the port with that displays ***Board in FS mode (...)*** or ***Board CDC (...)***\n",
+    "Select the \"Connect Device\" Button, and when the selection dialog appears, select the port that displays ***Board in FS mode (...)*** or ***Board CDC (...)***\n",
     "\n",
     "![Select a Port](images/sik-demo-select-port.png)\n",
     "\n",
diff --git a/content/SIK_Project4_CircuitB_Full.ipynb b/content/SIK_Project4_CircuitB_Full.ipynb
@@ -60,11 +60,13 @@
     "### Circuit Diagram\n",
     "\n",
     "TODO: Replace with new fritzing showing the qwiic conection between the OLED and the RedBoard RP2350\n",
+    "\n",
     "![Hookup](images/sik-docs-prj4-cb-hookup.jpg)\n",
     "\n",
     "**Note for Advanced Users**: If you know how to read datasheets and schematics, you can also refer to the schematic below as an alternative.\n",
     "\n",
     "TODO: Replace with new schematic showing the qwiic conection between the OLED and the RedBoard RP2350\n",
+    "\n",
     "![Schematic](images/sik-docs-prj4-cb-schem.jpg)\n",
     "\n",
     "### Hookup Table\n",
@@ -107,23 +109,23 @@
    "id": "1bd52930-d783-460a-923b-41a3c37d2f2b",
    "metadata": {},
    "source": [
-    "## Using the OLED.\n",
+    "## Using the OLED And Temperature Sensor.\n",
     "\n",
-    "Now that your circuit is built, it's time to write to the OLED. This is done using MicroPython, which is running on the RedBoard.\n",
+    "Now that your circuit is built, it's time to read from the temperature sensor and write to the OLED. This is done using MicroPython, which is running on the RedBoard.\n",
     "\n",
     "The first step is to connect your RedBoard to a USB port on this computer.\n",
     "\n",
     "Select the \"Connect\" button at the bottom right of this screen and a panel is displayed\n",
     "\n",
-    "Select the \"Connect Device\" Button, and when the selection dialog appears, select the port with that displays ***Board in FS mode (...)*** or ***Board CDC (...)***\n",
+    "Select the \"Connect Device\" Button, and when the selection dialog appears, select the port that displays ***Board in FS mode (...)*** or ***Board CDC (...)***\n",
     "\n",
     "![Select a Port](images/sik-demo-select-port.png)\n",
     "\n",
-    "With the RedBoard connected, use the following MicroPython commands to write to the OLED. \n",
+    "With the RedBoard connected, use the following MicroPython commands to operate your circuit. \n",
     "\n",
     "### Using MicroPython\n",
     "\n",
-    "The following MicroPython commands are entered to write to the OLED. \n",
+    "The following MicroPython commands are entered to read from the temperature sensor an write to the OLED. \n",
     "\n",
     "**REMEMBER** To enter a MicroPython command, hold down either the Control (on Windows) or Command (on Mac) key when pressing *Enter*\n",
     "\n",
diff --git a/content/SIK_Project4_CircuitC_Full.ipynb b/content/SIK_Project4_CircuitC_Full.ipynb
@@ -68,18 +68,21 @@
     "Remove the battery pack while building your circuit.\n",
     "\n",
     "TODO: Should we even have the below note?\n",
+    "\n",
     "NOTE: If you would like, feel free to get creative with some of the dual lock tape, the binder clip, screws, or any other method you see fit to attach the OLED to your baseplate. This is not mandatory, but is somewhat nice for holding the game up to your head while playing. NOTE: DO NOT WASTE ANYMORE THAN A 1\"x1\" SECTION OF DUAL LOCK TO ATTACH THE OLED. MOST OF THE DUAL LOCK IS USED FOR THE ROBOT IN PROJECT 5.\n",
     "\n",
     "Ready to start hooking everything up? Check out the circuit diagram and hookup table below to see how everything is connected.\n",
     "\n",
     "### Circuit Diagram\n",
     "\n",
     "TODO: Replace with new fritzing showing the qwiic conection between the OLED and the RedBoard RP2350\n",
+    "\n",
     "![Hookup](images/sik-docs-prj4-cc-hookup.jpg)\n",
     "\n",
     "**Note for Advanced Users**: If you know how to read datasheets and schematics, you can also refer to the schematic below as an alternative.\n",
     "\n",
     "TODO: Replace with new schematic showing the qwiic conection between the OLED and the RedBoard RP2350\n",
+    "\n",
     "![Schematic](images/sik-docs-prj4-cc-schem.jpg)\n",
     "\n",
     "### Hookup Table\n",
@@ -125,33 +128,35 @@
    "id": "1bd52930-d783-460a-923b-41a3c37d2f2b",
    "metadata": {},
    "source": [
-    "## Using the OLED.\n",
+    "## Running the Game\n",
     "\n",
-    "Now that your circuit is built, it's time to write to the OLED. This is done using MicroPython, which is running on the RedBoard.\n",
+    "Now that your circuit is built, it's time to run the \"Who am I?\" game. This is done using MicroPython, which is running on the RedBoard.\n",
     "\n",
     "The first step is to connect your RedBoard to a USB port on this computer.\n",
     "\n",
     "Select the \"Connect\" button at the bottom right of this screen and a panel is displayed\n",
     "\n",
-    "Select the \"Connect Device\" Button, and when the selection dialog appears, select the port with that displays ***Board in FS mode (...)*** or ***Board CDC (...)***\n",
+    "Select the \"Connect Device\" Button, and when the selection dialog appears, select the port that displays ***Board in FS mode (...)*** or ***Board CDC (...)***\n",
     "\n",
     "![Select a Port](images/sik-demo-select-port.png)\n",
     "\n",
-    "With the RedBoard connected, use the following MicroPython commands to write to the OLED. \n",
+    "With the RedBoard connected, use the following MicroPython commands to operate your circuit. \n",
     "\n",
     "### Using MicroPython\n",
     "\n",
-    "The following MicroPython commands are entered to write to the OLED. \n",
+    "The following MicroPython commands are entered to run the \"Who am I?\" game. \n",
     "\n",
     "**REMEMBER** To enter a MicroPython command, hold down either the Control (on Windows) or Command (on Mac) key when pressing *Enter*\n",
     "\n",
     "**Make sure for each notebook you run EVERY code cell presented and you run them in order.**\n",
     "\n",
     "An alternative is to click the \"Restart kernel and run all cells\" button at the top of the page (⏩). If you are connected to your board, this should automatically run every cell in order.\n",
     "\n",
+    "***NOTE:*** This is a special circuit that we will run from the battery pack. Start by running the cell below to save the code to your device while your USB-C cable is plugged into your device. Then, next time it is restarted (and powered from the battery pack) it will run the code. Nothing visible should happen this first time that you run the code before a restart. It is just saving the code to your board.\n",
+    "\n",
     "#### Saving Code to Your Board\n",
     "\n",
-    "This time we're going to do something a bit different, we are going to have all of our code in a single Jupyter Notebook cell so that it all gets saved to our board at once when we run it. We'll put together our buzzer functions from Project 2 the Qwiic OLED module we used in circuits 4A and 4B, along with some button control to make our own guessing game. Run the cell below to save this code to your board and then unplug it, plug in the battery pack and watch it go! \n",
+    "This time we're going to do something a bit different. We are going to have all of our code in a single Jupyter Notebook cell so that it all gets saved to our board at once when we run it. We'll put together our buzzer functions from Project 2 the Qwiic OLED module we used in circuits 4A and 4B, along with some button control to make our own guessing game. Run the cell below to save this code to your board and then unplug it, plug in the battery pack and watch it go! \n",
     "\n",
     "NOTE: If you'd rather run the game powered from a chord and in the Jupyter Notebook, you can remove the save line in the code below, not attach the battery pack, and run the code in the Jupyter Notebook like normal instead. "
    ]
diff --git a/content/SIK_Project5_CircuitA_Full.ipynb b/content/SIK_Project5_CircuitA_Full.ipynb
@@ -143,7 +143,7 @@
     "\n",
     "Select the \"Connect\" button at the bottom right of this screen and a panel is displayed\n",
     "\n",
-    "Select the \"Connect Device\" Button, and when the selection dialog appears, select the port with that displays ***Board in FS mode (...)*** or ***Board CDC (...)***\n",
+    "Select the \"Connect Device\" Button, and when the selection dialog appears, select the port that displays ***Board in FS mode (...)*** or ***Board CDC (...)***\n",
     "\n",
     "![Select a Port](images/sik-demo-select-port.png)\n",
     "\n",
diff --git a/content/SIK_Project5_CircuitB_Full.ipynb b/content/SIK_Project5_CircuitB_Full.ipynb
diff --git a/content/SIK_Project5_CircuitC_Full.ipynb b/content/SIK_Project5_CircuitC_Full.ipynb
