UBISS2024
This course is designed as a week-long tutorial to engage with ubiquitous devices in the domain of smart environments and how to use machine learning to build smart devices. Here, we use an Arduino Nano RP2040 Connect.
Contents
Schedule
Day 1
- 16:00-17:00 Lecture: Introduction & Creating Interactive Smart Objects and Environments
- 17:00-17:45 Hands-On: Task 1: Getting Started Components, tools, and development environments
- 17:45-18:00 Lecture: Preview of the Tasks Ahead
Day 2
- 10:00-10:45 Lecture: Desiging and Implementing Sensor-Based Systems
- 10:45-11:00 ML Development Cycle: data collection, data cleaning, and labeling, selection of the AI/ML approach, hyper-parameter * selection and implementing the model, training the model/system, deploying the model, operations, re-training/continuous improvement
- 11:00-12:00 Hands-On: Task 2: Read Data (accelerometer and analog pin)
- 12:00-13:00 lunch break
- 13:00-14:00 Hands-On: Task 3: Record the accelerometer data for four different actions (labeled dataset), store it, and transfer it to PC using the Arduino IDE
- 14:00-14:30 Lecture: Rule-based Systems: how to design them, pros: explainability, cons: it is hard
- 14:30-15:00 Hands-On: Task 4: analyze the data in Excel/Google sheets and find rules for the 4 actions
- 15:00-15:45 Hands-On: Task 5: Implement your rule-based algorithm, optional include explanations of why the state is recognized using the Arduino IDE
- 15:45-16:00 get Coffee / break
- 16:00-17:00 Ideation and testing ideas
- 17:00-17:15 Present your ideas
- 17:15-18:00 Hands-On: Discussion and presenting the results of Task 4 and 5
Day 3
- 10:00-12:00 Lecture: Introduction to Jupyter Notebooks, training an ML model based on a given data and the self-recorded data set on the PC (* using Google Python Notebooks or personal installation)
- 12:00-13:00 Lunch break
- 13:00-15:00 Hands-On: Task 6: Getting Started with Jupyter Notebook Installing Jupyter Notebook for Micropython, controlling LED, reading data, storing data
- 15:00-15:30 Hands-On: Project specification, Ideation on Project Ideas
- 15:30-16:00 Coffee break
- 16:00-16:30 Hands-On: Presentation and discussion of project ideas, group forming (groups of 2 or 3)
- 16:30-17:00 Lecture: Introduction to ML Libraries (everywhereML)
- 17:00-18:00 Hands-On: Task 7: Deploy Machine Learning Models Implementing a basic model using everywhereML
Day 4
- 10:00-10:45 Hands-On: Definition of project, project outline
- 10:45-11:15 Hands-On: project presentation: 60 sec per team
- 11:15-12:00 Hands-On: project work
- 12:00-13:00 Lunch break
- 13:00-15:00 Hands-On: project work
- 15:00-15:30 Hands-On: stand-up meeting on project progress
- 15:30-16:00 Coffee break
- 16:00-17:30 Hands-On: project work
- 17:30-18:00 Lecture: How to Evaluate ML Solutions (talk and discussion)
Day 5
- 10:00-10:30 Hands-On: stand-up meeting — project challenges and solutions
- 10:30-11:30 Hands-On: project work
- 11:30-12:00 Lecture: Pitfalls and Challenges in Developing ML/AI for IoT
- 12:00-13:00 Lunch break
- 13:00-15:30 Hands-On: project work
- 15:30-16:00 Coffee break
- 16:00-16:30 Lecture: Testing and Reporting ML Performance (How to Test the Prototype? & How to Report Performance?)
- 16:30-17:30 Hands-On: Testing of prototype performance
- 17:30-18:00 Hands-On: Open issues for the presentation on Saturday, Feedback sessions
Day 6
- 13:15-18:15: Workshop Result Presentations
- 18:30-18:50: Debriefing
Tasks
Task 1: Getting Started
- Connect an Arduino Nano RP2040 Connect board, for this see Install the Arduino Nano RP2040 Connect Firmware
- if you use Linux/MacOS and there are issues, look for serial line permissions, e.g. https://www.xanthium.in/linux-serial-port-programming-using-python-pyserial-and-arduino-avr-pic-microcontroller and https://github.com/arduino/lab-micropython-editor/issues/64
- Install the Arduino Lab for MicroPython development environment, https://labs.arduino.cc/en/labs/micropython
- Task 1.1: Make the orange LED (pin 6) blink using micro python https://docs.arduino.cc/micropython/basics/digital-analog-pins/
- Task 1.2: Connect an external RGB LED (pin D2 = GPIO25, D3 = GPIO15, D4 = GPI=16) and control it (on, off, mix color, brightness), https://www.sketching-with-hardware.org/wiki/RGB_LED
- Task 1.3: Add the photo resistors to your board, read their values, and write them to the file; see the instructions for LDR.
- Task 1.4: Combine your LDR and the RGB_LED example to change the blinking interval with the light value measures.
Solution Task 1.1: LED Blinking
1 # Blinky example
2
3 import time
4 from machine import Pin
5
6 # This is the only LED pin available on the Nano RP2040,
7 # other than the RGB LED connected to Nano WiFi module.
8 led = Pin(6, Pin.OUT)
9
10 while (True):
11 led.on()
12 time.sleep_ms(250)
13 led.off()
14 time.sleep_ms(200)
Solution Task 1.2 Control external RGB
1 # RGB example
2
3 import time
4 from machine import Pin
5
6 # RGB LED connected to the RP2040
7 ledG = Pin(25, Pin.OUT)
8 ledR = Pin(15, Pin.OUT)
9 ledB = Pin(16, Pin.OUT)
10 print("start")
11
12 while (True):
13 print("*")
14 ledG.on()
15 ledR.off()
16 ledB.off()
17 time.sleep_ms(250)
18 ledG.off()
19 ledR.on()
20 ledB.off()
21 time.sleep_ms(250)
22 ledG.off()
23 ledR.off()
24 ledB.on()
25 time.sleep_ms(250)
Task 2: Read Data
- read data from the accelerometer and the gyro and print them (Arduino IDE) https://docs.arduino.cc/micropython/basics/board-examples/
- extend your program to write the data from the accelerometers to a file; see the instructions for FileIO.
- transfer the file to your computer
- optional: add the photo resistors to your board, read their values, and write them to the file; see the instructions for LDR.
Solution Task 2.1: Read Accelerometer and Gyro
1 import time
2 from lsm6dsox import LSM6DSOX
3
4 from machine import Pin, I2C
5 lsm = LSM6DSOX(I2C(0, scl=Pin(13), sda=Pin(12)))
6
7 while (True):
8 accel_data = lsm.accel()
9 print('Accelerometer: x:{:>8.3f} y:{:>8.3f} z:{:>8.3f}'.format(*accel_data))
10 gyro_data = lsm.gyro()
11 print('Gyroscope: x:{:>8.3f} y:{:>8.3f} z:{:>8.3f}'.format(*gyro_data))
12 print("")
13 time.sleep_ms(100)
Solution Task 2.2: Read analog values
A0 is the analog input with 16-bit resolution. It reads the analog value every second and print it to the console-
1 from machine import Pin, ADC
2 from time import sleep
3
4 analogPin = ADC(Pin(26))
5
6 while True:
7 analogVal16 = analogPin.read_u16()
8 print(analogVal16)
9 sleep(1)
Task 6: Getting Started with Jupyter Notebook
- Connect the board
- Install the Jupyter Notebook,
- Read the accelerometer and the gyro and show it in the notebook
Task 6.1: is it moved?
- read acceleration and gyro
- calculate the differences between values
- show an ouput when it is move
- create a file on the device that logs, when it is moved
Task 6.2: it was turned upside down?
- read acceleration and gyro
- make a rule based "AI" that records
- it was put upside down
- it was turned 360
- it was moved "quickly"
Task 7: Deploy Machine Learning Models
We will use https://github.com/eloquentarduino/everywhereml to detect the same gestures as in Task 2.2. For this, install everywhereml:
pip3 install -U everywhere
Using everywhereml we can train a model on a more powerful machine for deployment on a microcontroller. See https://eloquentarduino.com/posts/micropython-machine-learning for example for such a training process. Assuming that our ML model is trained and stored in variable clf then we can save the model to a file using
clf.to_micropython_file("MyModel.py")
The MyModel.py file can then be saved and called directly on the microcontroller. To run the model on the microcontroller, assume your data is stored in x and you trained a RandomForestClassifier. Then you can predict via the following code snippet
import MyModel
clf = MyModel.RandomForestClassifier()
clf.predict(x)
Task 8: Connect to WiFi
This is an optional task.
- Connect both boards to WIFI using Tutorial Network
- Use the Arduino Nano RP2040 Connect as output (showing a color)
- Use the Arduino Nano RP2040 Connect as input (recognize with rules 3 gestures)
Links
See the full list of links: UBISS2024-Links
Local Links
https://ubicomp.net/sw/db1/var2db.php? http://localhost:8888/notebooks/ArduinoNanoRP2040_v01.ipynb http://localhost:8888/doc/tree/create-ML-model01.ipynb
Reading
Required Reading before the course
- Albrecht Schmidt (2020) Interactive Human Centered Artificial Intelligence: A Definition and Research Challenges. In Proceedings of the International Conference on Advanced Visual Interfaces (AVI '20). Association for Computing Machinery, New York, NY, USA, Article 3, 1–4. https://doi.org/10.1145/3399715.3400873 https://uni.ubicomp.net/as/iHCAI2020.pdf (4p)
- Albrecht Schmidt and Kristof van Laerhoven (2021) How to build smart appliances? In IEEE Personal Communications, vol. 8, no. 4, pp. 66-71, Aug. 2001, https://doi.org/10.1109/98.944006 https://www.eti.uni-siegen.de/ubicomp/papers/sl_ieeepc2001.pdf (6p)
- Albrecht Schmidt (2017) Understanding and researching through making: a plea for functional prototypes. interactions 24.3, 78-81. https://doi.org/10.1145/3058498 https://www.sketching-with-hardware.org/files/functional3058498.pdf (4p)
- Huy Viet Le, Sven Mayer, and Niels Henze (2020) Deep learning for human-computer interaction. interactions 28, 1 (January - February 2021), 78–82. https://doi.org/10.1145/3436958 https://sven-mayer.com/wp-content/uploads/2021/01/huy2021deep.pdf (5p)
- Huy Viet Le, Sven Mayer, Max Weiß, Jonas Vogelsang, Henrike Weingärtner, and Niels Henze (2020) Shortcut Gestures for Mobile Text Editing on Fully Touch Sensitive Smartphones. In: ACM Trans. Comput.-Hum. Interact., vol. 27, no. 5, pp. 38. https://sven-mayer.com/wp-content/uploads/2020/09/le2020shortcuts.pdf (38p)
- Judith Hurwitz, and Daniel Kirsch (2018) Machine learning for dummies. IBM Limited Edition 75, 9780429196645-6. https://www.ibm.com/downloads/cas/GB8ZMQZ3 (Pages 3-18 and 29-47, this is Chapters 1 and 3) (35p)
- Chris Garrett. MicroPython: An Intro to Programming Hardware in Python https://realpython.com/micropython/ (14 pages)
- MicroPython Basics https://docs.arduino.cc/micropython/basics/micropython-basics/ (5 pages)
Recommended Reading before the course
- John D. Kelleher (2019) Deep Learning. https://mitpress.mit.edu/9780262537551/deep-learning/
- Yuli Vasiliev, Python for Data Science: A Hands-On Introduction, https://nostarch.com/python-data-science
- Tutorial on Jupyter Notebooks: https://www.datacamp.com/tutorial/tutorial-jupyter-notebook
- Alex Smola, and S. V. N. Vishwanathan (2008) Introduction to machine learning. Cambridge University, UK 32.34. https://alex.smola.org/drafts/thebook.pdf
Random Commands
pip install micropython-lsm6dsox
picotool.exe load -x C:\Users\ru42qak\AppData\Roaming\OpenMV\openmvide\firmware\ARDUINO_NANO_RP2040_CONNECT\firmware.bin
pip install jupyterlab
pip install everywhereml
python -m pip install jupyter
git clone https://github.com/goatchurchprime/jupyter_micropython_kernel.git
pip install -e jupyter_micropython_kernel
python -m notebook
python -m jupyter kernelspec list
C:\Users\ru42qak\AppData\Local\Packages\PythonSoftwareFoundation.Python.3.11_qbz5n2kfra8p0\LocalCache\local-packages\Python311\site-packages\jupyterlab>pip install -e jupyter_micropython_kernel
C:\Users\ru42qak\AppData\Local\Packages\PythonSoftwareFoundation.Python.3.11_qbz5n2kfra8p0\LocalCache\local-packages\Python311\site-packages\jupyterlab>python -m notebook