PyCon US 2024 - Introduction to MicroPython: getting started with BBC micro:bit

Slides for the tutorial Introduction to MicroPython: getting started with BBC micro:bit, presented during PyCon US 2024 in Pittsburgh, by Juliana Karoline de Sousa.

Link for the talk recording: https://www.youtube.com/watch?v=7g2YCygot5s

Transcript

1. INTRODUCTION TO MICROPYTHON GETTING STARTED WITH BBC MICRO:BIT Juliana Karoline de Sousa | @julianaklulo
2. JULIANA KAROLINE DE SOUSA | @JULIANAKLULO ➔ Bachelor of Computer Science | UFSCar ➔ PyLadies São Carlos | co-founder & organizer ➔ Grupy-Sanca | co-founder & organizer ➔ Omnivector | software engineer ➔ IoT, robotics, 3D printing & kitties :3
3. Please handle the equipment with care Be careful Disclaimers No sponsors This tutorial is not sponsored Have fun! Return Don’t forget to return the devices before leaving the room 1 2 3 4
4. Challenge MicroPython Examples Experimenting with the device’s components Battleship Build the single player version of the game 01. Overview about MicroPython BBC micro:bit Overview of the device and the specifications Python editor 02. 03. Using the Python editor and built-in simulator 04. 05. 06. Make the game multiplayer Agenda
5. MicroPython 01. Python for microcontrollers
6. What is MicroPython? Reimplementation of Python 3 targeted to microcontrollers
7. But what is a microcontroller?
8. Microcontroller Can store persistently user-defined code in memory Integrated Circuit Processor, memory and peripherals all on a single chip I/O Capabilities Built-in input/output ports to interact with sensors and actuators Programmable Low power consumption Suitable for battery powered applications
9. MicroPython Key points: • Re-implementation of Python 3, written in C • Contains a small subset of the standard library • Optimized for constrained environments Features: • Interactive prompt (REPL) • List comprehensions, generators, closures • Exception handling • Access to GPIO, PWM, ADC, UART and more Requirements: • 256k code space • 16k RAM
10. Microcontrollers with MicroPython PyBoard ESP8266 & ESP32 BBC micro:bit Raspberry Pi Pico Arduino Nano RP2040
11. BBC micro:bit 02. Pocket-sized computer for physical computing
12. What is the BBC micro:bit? Pocket-sized computer that introduces you to how software and hardware work together
13. Which components are included?
14. Which components are included?
15. Python editor 03. Easiest way to program the micro:bit
16. Online Python editor https://python.microbit.org
17. Workflow Plug micro:bit into computer Write .py file in the Python editor Click on “save to micro:bit” and select the micro:bit Automatically flash the .hex file to micro:bit Plug micro:bit into computer Write .py file in the Python editor Click on “save to micro:bit” to download .hex file to your machine Copy .hex file to micro:bit flash drive Supported browsers (Chrome) Other browsers (Firefox)
18. Examples 04. Experimenting with the device’s components
19. Code Resources https://tinyurl.com/micropython-tutorial Examples and cheat sheet are available in the repository at https://github.com/julianaklulo/pycon2024-intro-to-micropython
20. Using the Display 0-9: Brightness intensity
21. Using the Push Buttons Button A (left) and Button B (right)
22. Example 1: Buttons and Display
23. Using the Speaker
24. Example 2: Play melody
25. Using the Accelerometer
26. Example 3: Accelerometer Gestures
27. Example 4: Accelerometer values
28. Using the Radio
29. Example 5: Teleporting Duck
30. Battleship 05. Single-player version of the game
31. Battleship - Single Player
32. Battleship Breakdown Player Handles the logic to shoot on the sea and stores the shots fired Sea Stores the automatically generated ships and checks if a shot hit a ship Game Runs the game until the player hits all the ships
33. Sea How to populate the sea with ships?
34. Examples of Sea boards
35. The ship can’t overflow the board Location matters Size matters Place the biggest ships first No touching Each boat must be surrounded only by water 1 2 3 Rules to place the ships Valid placement Impossible to place the third ship
36. Sea Breakdown
37. Analyzing the code Open file battleship-single-player/template_1.py in the repository
38. Sea - Generate board ship sizes brightness
39. Sea - Indexing Index: [ROW][COL] Index: [COL][ROW] VS
40. Sea - Populate board reset the board if the ships don’t fit
41. Sea - Place Ship (part 1) select among the candidates coordinates fails if none of the coordinates work Each water coordinate is a candidate
42. Sea - Possible H: hold the row and increase the col V: increase the row and hold the col check for each part of the boat desired placement
43. Sea - Near Ships Example: (2, 2) non-inclusive exclude the coordinate
44. Sea - Place Ship (part 2) H: hold the row and increase the col V: increase the row and hold the col
45. Sea - Hit will be used once the player starts shooting
46. Sea - Show Board represents the brightness
47. Sea - Show Board create one string for each row then concatenate each string using :
48. Try it in the simulator Open battleship-single-player/template_1.py, paste it in the simulator and execute the code https://python.microbit.org
49. Player How to shoot the ships?
50. Player Breakdown
51. Analyzing the code Open file battleship-single-player/template_2.py in the repository
52. Player - Generate Shots Board start player in the center of the board same structure as the sea board
53. Player - Mark similar to the hit method
54. Player - How to Shoot
55. Player - Shoot Value to filter out small movements or noise in the accelerometer readings Alternate between the coordinate in the shot board and the current coordinate Threshold Blink While loop Run until Button A is pressed Update row Use accelerometer axis Y to update the row Update col Use accelerometer axis X to update the col 1 4 5 3 6 Show the board Show the shots board so the user knows where they’ve already shot 2
56. Writing the shoot method Edit file battleship-single-player/template_2.py in the repository
57. Player - Shoot
58. Try it in the micro:bit Upload battleship-single-player/template_2.py with your implementation to the micro:bit https://python.microbit.org
59. Game Control the logic of the game
60. Analyzing the code Open file battleship-single-player/template_3.py in the repository
61. Game Breakdown
62. Game - Init Sea and Player
63. Game - Win
64. Starting the Game
65. Game - Start and End Display a countdown to indicate that the game is about to start Countdown Greet the player Play sound and display image 1 3 Wait for input Keep blinking the image until the player press both buttons 2 Choose an appropriate sound Play an ending sound End game The game ends when all the ships have been hit 4 6 Display a positive image Happy face is a good choice 5
66. Writing start and end methods Edit file battleship-single-player/template_3.py in the repository
67. Game - Start and End
68. Game - Run Read the player’s shot Shoot the board Start the game Run the start routine 1 3 Loop until end Run the loop until the game ends with the player winning 2 Let the player know if the shot has hit or missed the ships Display the result Check hit and mark Check in the Sea instance if the shot hit any ships 4 6 Check win Check if the player has already hit all the ships and run the end routine if so 5
69. Writing the Game run method Continue editing file battleship-single-player/template_3.py in the repository
70. Game - Run
71. Try it in the micro:bit https://python.microbit.org Upload battleship-single-player/template_3.py with your implementation to the micro:bit
72. Challenge 06. Multiplayer version of the game
73. Battleship - Multiplayer
74. Multiplayer Breakdown Player No changes needed Sea No changes needed Game Handles the publisher and subscriber logic
75. Game Control the logic of the game
76. Analyzing the code Open file battleship-multiplayer/template_1.py in the repository
77. Game Breakdown
78. Game - Init Sea and Players same Player class for both players define the group with a partner and set the constant
79. Game - Start same as the single player version
80. Game - Lost only the player receiving the shot can check if they’ve lost the game
81. Game - End different endings depending on which player won the game
82. Choosing Players
83. Game - Choose Players Send a message after Player 1 pressed Button A, wait for response from Player 2 Player 1 - Button A Display boat image Show an image while waiting for the input from the players 1 3 Loop until press Wait for both players to be ready to start the game 2 PLayer 2 - Button B After Player 2 pressed Button B, wait for message from Player 1 and reply with acknowledgment message 4 Assign the players Store the player number to define who starts the turn 5
84. Writing the Choose Players method Edit file battleship-multiplayer/template_1.py in the repository
85. Game - Choose Players define the group with a partner and set the constant
86. Game - Send Shot Wait for the opponent to reply with the result of the shot Wait for response Run Shoot method Update the coordinates of the current player 1 3 Send message Send to the opponent the coordinates of the shot 2 Mark result Mark in the current player’s board the result of the shot 4 Check hit Celebrate if the current player’s shot hit a ship 5 Return value Returns True if the current player won 6
87. Writing the Send Shot method Continue editing the file battleship-multiplayer/template_1.py in the repository
88. Game - Send Shot
89. Game - Receive Shot Display in the board the coordinate that the opponent shot Blink the coordinate Show the board Display the sea board to the current user 1 3 Wait for message Wait for the opponent to make the shot 2 Check hit and mark Check if the opponent hit a ship in the sea board and mark the shot in the opponent’s board 4 5 Check lose Check if the opponent hit the last ship in the current player’s board 6 Send response Send message with result of the shot and if the opponent won the game 7 Show shot result Display the result of the shot to the current player 8 Return value Returns True if the current player lost
90. Writing the Receive Shot method Continue editing the file battleship-multiplayer/template_1.py in the repository
91. Game - Receive Shot
92. Game - Run Shoots first then receives a shot Player 1 Start the game Run the start routine 1 3 Choose players Decide who’s starting the game 2 The current player loses when receive_shot returns True Opponent win? Player 2 Receives the first shot and then shoots 4 6 Current player win? The current player wins when send_shot returns True 5
93. Writing the Run method Continue editing the file battleship-multiplayer/template_1.py in the repository
94. Game - Run
95. Try it in the micro:bit https://python.microbit.org Find a partner, decide the group number and upload battleship-multiplayer/template_1.py with your implementation to the micro:bit
96. Improvements • Track the score • Let the player place the ships manually • Mark in the player board the sunk ships What improvements would you make?
97. Thank you for attending! I hope you enjoyed it :)
98. For more games, watch my talk at PyCon US 2023 https://www.youtube.com/watch?v=teALLngESw0
99. @julianaklulo Reach out via social media
100. Reach out via social media I’ll post more details about the MicroPython open space