You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
|[Introduction](##Introduction)| More information about the PyBadge, including what's on the board. |
13
-
| [Programming with MakeCode](##Getting-a-MakeCode-program-on-the-PyBadge) | A quick overview on how to program the Pybadge with MakeCode with troubleshooting tips and resources.
14
-
| [Suggested Learning Path](##Suggested-Learning-Path) | This section provides a brief curriculum with project-based resources for art, games, and sensors.
15
-
13
+
|[Introduction](#Introduction)| More information about the PyBadge, including what's on the board. |
14
+
| [Programming with MakeCode](#Getting-a-MakeCode-program-on-the-PyBadge) | A quick overview on how to program the Pybadge with MakeCode with troubleshooting tips and resources.
15
+
| [Suggested Learning Path](#Suggested-Learning-Path) | This section provides a brief curriculum with project-based resources for art, games, and sensors.
16
16
17
17
## Introduction
18
+
18
19
Congratulations, you've got yourself a PyBadge! The PyBadge is device called a *microcontroller,* a simple computer that we can program to do all sorts of fun things, like custom video games, music boxes, and more!
19
20
20
21
We can write instructions, called programs, for the PyBadge using Microsoft MakeCode Arcade which is a block-based coding platform similar to Scratch. Read on to learn more about the board and what you can make with it!
21
22
22
23
### What's on the board
23
-
* Color screen display (1.8" 160x128 Color TFT Display)
24
-
* 8 x Game/Control Buttons
25
-
* Light sensor (on front)
24
+
25
+
* Color screen display (1.8" 160x128 Color TFT Display)
26
+
* 8 x Game/Control Buttons
27
+
* Light sensor (on front)
26
28
* Buzzer mini-speaker
27
29
* Triple-axis accelerometer (motion sensor)
28
30
* 5 x NeoPixels (lights that can change colors!)
@@ -36,6 +38,7 @@ We can write instructions, called programs, for the PyBadge using Microsoft Make
36
38
For the full list of features, [visit this site](https://www.adafruit.com/product/4200).
37
39
38
40
## Getting a MakeCode program on the PyBadge
41
+
39
42
<img src="https://github.com/microsoft/PybadgeResources/blob/main/MakeCode/assets/Arcade-ChooseHardware1.png" alt = "MakeCode Arcade choose hardware screenshot"
40
43
width = 600>
41
44
1. Download the program:
@@ -45,84 +48,91 @@ width = 600>
45
48
46
49
<img src="https://github.com/microsoft/PybadgeResources/blob/main/MakeCode/assets/PyBadgeBootMode.jpg" alt = "PyBadge bootloader mode"
47
50
width = 400>
48
-
1. Put the device into bootloader mode:
51
+
1. Put the device into bootloader mode:
49
52
* Double-tap the PyBadge reset button to get it to appear as a device on the computer, much like a USB drive.
50
53
* When the board is in bootloader mode you'll see a screen similar to the above one show up.
51
54
* Now that the board is in bootloader mode, you should see a BADGEBOOT drive show up on your computer. Drag the arcade game .uf2 file onto the drive.
52
55
4. Once the file is copied over the board will restart and launch the program!
53
56
54
57
### General Resources
58
+
55
59
*[Navigating MakeCode Arcade](https://learn.adafruit.com/how-to-make-games-on-makecode-arcade/navigating-makecode-arcade): an overview of the MakeCode interface
56
60
*[Arcade Game Maker Guide](https://arcade.makecode.com/skillmap): A multi-tutorial guide for learning how to make games in MakeCode Arcade. Includes certificates for completed tutorials.
57
61
58
-
59
62
### Troubleshooting
63
+
60
64
1. Make sure you're using a data transfer USB cable (one of the most common blockers w/ hardware functioning properly).
61
65
1. You may need to update the bootloader on the PyBadge, particularly if you're working on a Mac. If you notice your board is titled "ARCADE-D51" or "BADGEBOOT", [follow this tutorial](https://learn.adafruit.com/adafruit-pybadge/updating-the-bootloader).
62
66
2. Troubleshooting help:
63
67
-[Latest Arcade topics - Microsoft MakeCode](https://forum.makecode.com/c/Share-your-Arcade-projects-here/5)
64
68
-[Adafruit customer service forums: MakeCode](https://forums.adafruit.com/viewforum.php?f=64)
65
69
66
70
## Suggested Learning Path
71
+
67
72
### Lesson 0: Test Program
68
-
> Estimated time: 30 - 45 minutes.
69
73
74
+
> Estimated time: 30 - 45 minutes.
70
75
> Recommended ages: All!
71
76
72
-
This lesson introduces students to MakeCode Arcade and shows them how to load MakeCode programs onto the PyBadge.
77
+
This lesson introduces participants to MakeCode Arcade and shows them how to load MakeCode programs onto the PyBadge.
73
78
74
-
1. Start by giving students some time to explore MakeCode Arcade and create a creature or character.
75
-
2. Show students how to download the program and load onto the PyBadge.
76
-
3. Depending on students' experience, include 10 - 15 minutes for loading a first test program.
77
-
4. If students finish early, encourage them to start adding to their test program by making the character move, adding a background, or exploring the on-board sensors.
78
-
5. Encourage students to share their creations, what worked well, what was surprising, and any mysteries or questions they have.
79
+
1. Start by giving participants some time to explore MakeCode Arcade and create a creature or character.
80
+
2. Show participants how to download the program and load onto the PyBadge.
81
+
3. Depending on participants' experience, include 10 - 15 minutes for loading a first test program.
82
+
4. If participants finish early, encourage them to start adding to their test program by making the character move, adding a background, or exploring the on-board sensors.
83
+
5. Encourage participants to share their creations, what worked well, what was surprising, and any mysteries or questions they have.
79
84
80
85
### Lesson 1: Open-ended exploration
81
-
> Estimated time: 60 - 90 min, longer as needed
82
86
87
+
> Estimated time: 60 - 90 min, longer as needed
83
88
> Recommended ages: 8+
84
89
85
-
Provide students an open-ended prompt and allow them to design and build a solution using MakeCode Arcade and the PyBadge.
90
+
Provide participants an open-ended prompt and allow them to design and build a solution using MakeCode Arcade and the PyBadge.
86
91
87
92
It may be helpful to start with a short lesson on the **Design Thinking Process**. [Here's a helpful resource created by the Stanford D School](https://kissingergroup.com/wp-content/uploads/2020/06/An-Introduction-to-Design-Thinking.pdf).
88
93
89
-
If students are unsure what to make, suggest they write down their values, or things they care about, and use one to motivate a project.
94
+
If participants are unsure what to make, suggest they write down their values, or things they care about, and use one to motivate a project.
90
95
91
96
**Sample prompts**
97
+
92
98
* Make something for someone you love
93
99
* Make something inspired by nature
94
100
* Design a solution for an everyday problem
95
101
* Invent an instrument
96
-
* Design a game (for 2 or more people)
97
-
* Explore other prompts based on students' interests!
98
-
102
+
* Design a game (for 2 or more people)
103
+
* Explore other prompts based on participants' interests!
99
104
100
105
### Lessons 2 and onward: Build a project!
101
-
> Estimated time: 60 min
102
106
107
+
> Estimated time: 60 min
103
108
> Recommended ages: 8+
104
109
105
110
#### Art & Games
111
+
106
112
**Beginner**
113
+
107
114
* Check out the tutorials in [MakeCode Arcade](https://arcade.makecode.com/)!
108
115
*[Pixel Art](https://learn.adafruit.com/makecode-arcade-pixel-art-sprites): A fantastic guide to making pixel art in MakeCode Arcade.
109
116
*[Name Badge](https://learn.adafruit.com/making-a-name-tag-in-makecode-arcade/starting-your-name-tag): Make a custom name badge!
110
117
*[Sparky Invaders](https://learn.adafruit.com/makecode-arcade-sparky-invaders): Learn how to make a game inspired by Space Invaders!
111
118
112
119
**Intermediate to Advanced**
120
+
113
121
*[Making Platform Games](https://learn.adafruit.com/makecode-arcade-platform-level): learn how to make scrolling platformer games like Super Mario Bros for NES!
114
122
*[Re-Making Classics: Arkanoid](https://learn.adafruit.com/re-makecode-the-classics-arkanoid): A tutorial showing you the logic and blocks for making the classic Arkanoid game.
115
123
*[my lil' ai](https://youtu.be/kNZUletw9lg): A digital pet that teaches the basics of machine learning (ML), or AI.
116
124
*[Adding features to games](https://learn.adafruit.com/next-level-makecode-arcade-games): Learn how to enhance graphics, add background music, and use neopixels to track in-game stats.
117
125
*[Adding custom color palettes](https://learn.adafruit.com/custom-color-palettes-for-makecode-arcade-games): Learn how to add custom color palettes to MakeCode Arcade.
118
126
119
127
#### Sensors and Beyond!
128
+
120
129
**Beginner**
130
+
121
131
*[PyBadge Plant Monitor](https://learn.adafruit.com/plantagotchi-pybadge-plant-monitor): Using just the PyBadge (and a plant on-hand), program a plant monitor in MakeCode Arcade.
122
132
*[Marble Labyrinth Game](https://learn.adafruit.com/pygamer-marble-labyrinth-in-makecode-arcade): Use the accelerometer to simulate a marble labyrinthe maze game.
123
133
*[Digital Sand](https://learn.adafruit.com/pixeldust-digital-sand-demos-for-arcada): Learn how to create motion-activated effects for the PyBadge
124
134
125
135
**Intermediate to Advanced**
136
+
126
137
*[Sensors in MakeCode](https://learn.adafruit.com/sensors-in-makecode): Learn how to use sensors in MakeCode!
127
138
* (Note: this tutorial focuses on the Circuit Playground Express but may be adapted for the PyBadge)
0 commit comments