Add enter_bootloader

pslab/sciencelab.py

@@ -4,6 +4,7 @@
 if you need to use several at once the ScienceLab class provides a convenient
 collection.
 """
+import time
 from typing import Iterable, List
 
 import pslab.protocol as CP
@@ -126,6 +127,16 @@ def reset(self):
         self.send_byte(CP.COMMON)
         self.send_byte(CP.RESTORE_STANDALONE)
 
+    def enter_bootloader(self):
+        """Reboot and stay in bootloader mode."""
+        self.reset()
+        # The PSLab's RGB LED flashes some colors on boot.
+        boot_lightshow_time = 0.6
+        # Wait before sending magic number to make sure UART is initialized.
+        time.sleep(boot_lightshow_time / 2)
+        # PIC24 UART RX buffer is four bytes deep; no need to time it perfectly.
+        self.write(0xDECAFBAD.to_bytes(4, "little"))
+
     def rgb_led(self, colors: List, output: str = "RGB", order: str = "GRB"):
         """Set shade of a WS2812B RGB LED.