Using the micro:bit to control a servo from the micro:bit phone app: https://youtu.be/UuGTBZRwC-8 (Includes a link to the Bitty Controller, an Android alternative to the iOS app)
Pre-workshop Prep
Please use a recent version of Google Chrome for all Workshop activities.
Many activities can be tested in a web browser but are more satisfying with hardware. Options for buying hardware are below. Note that:
Micro:bits come with a USB Type-A cable. If you have a machine with only USB-C, be sure you have an adapter (For example: Amazon).
One activity will demonstrate micro:bit to micro:bit radio communication, which can be done in the simulator or with two real micro:bits. I recommend getting two micro:bits, but it’s a small component of the workshop.
Purchasing hardware
You can either purchase a complete kit from me or buy parts individually:
To purchase a complete kit from me:
Please request a kit by Sept. 15th
Kits will be shipped approximately one week before the workshop (by Sept 18th).
I buy in quantity and/or at a discount from a local store, so kits may be cheaper than buying all parts individually.
Payment may be made by PayPal, Venmo, CashApp, or sending a personal check. Contact me at: bsiever@gmail.com for details.
There are two options:
Kit with 1 micro:bit Go and one set of clips/sensor/headphones (sufficient for about 90% of the workshop activities): $30
Kit with 2 micro:bit Gos and one set of clips/sensor/headphones: $45
This project was created in an effort to create a real-world example project for my introductory IoT courses.
Features
The mini-garage provides nearly the same features as a real garage door opener:
Motorized door mechanism
Safety feedback
Electric eye
Physical interruption/stall detection
Physical button to toggle door state
A light
Most importantly, it can be controlled by a Wi-Fi enabled platform, the Particle Photon.
Videos
The videos below shows the basic garage door control that developers (students) have to implement. They implement all control logic (direction of motor, when to start/stop, etc.). Some of the required behaviors include:
When the button is pressed the door opens/closes and the light activates.
The light turns off soon after the door motion is stopped.
Faults can be caused by either the electric eye’s beam being broken when closing or if the door physically stalls. In either case the door should stop (or reverse) and the light should blink. The door should be able to be restarted by pressing the button again.
Follow-up assignments implement internet-based control of and feedback from the door. These include features that aren’t feasible on traditional garage door openers, such as notifications if the door has been left open.
Garage door openers are relatively familiar devices.
The I/O is digital, so it doesn’t distract too much from other topics.
Like many more significant IoT projects, developers need to learn how to work with proxies for the hardware due to safety/space considerations. Moreover, APIs serve as contracts for hardware interaction.
The mechanical aspects and timing characteristics make for a richer project.
The scale is appropriate. Over the course of a semester it’s possible to put together a nearly commercial quality solution.
I also had some personal goals:
Learn CAD/CAM basics.
Practice using laser cutters.
Learn how to efficiently manufacture a small run of a product.
Implementation Issues and Choices
The intended purpose (classroom use), imposed some requirements on the mini-garages:
They should be easy to build (I wanted to build ~6-7 of them)
They should be cheap. (I wanted to build ~6-7 of them!)
They should be reasonably reliable. They’ll be used for a few semesters and poor performance undermines the experience.
They should be portable. Developers (i.e., students) will only have access while in the classroom and the garages will be carried from table-to-table.
They should be electrically and mechanically robust. Errors in code should not damage either the developer’s test platform (the student’s processors) or the mini-garages. Moreover, errors like this should be reported, rather than just quietly prevented.
Developers should be able to make their code interact with the hardware with minimal effort.
Given the requirements, I decided on something that’s approximately shoe-box size. A 1/24th scale was a good fit. The model is parameterized and many aspects of it will scale with a simple change to the scale parameter. The size of tabs on the box joints may need some adjustment and some elements, like the motors/gears/etc. are a set size and don’t scale. Consequently, modifications of scale often need some triage to get back to a working model and things go awry if the scale is significantly different than 1/24th.
I chose a two processor design to help protect hardware and to require compliance with an API. The students write code for a Particle Photon, which is then plugged into the garage hardware via a ZIF socket. It interacts with an Arduino Pro Micro, which does the real I/O. The only shared electrical connections from the Photon are power, ground, and RX/TX from a UART. This minimal interface helps avoid a wayward short-to-ground due to an accidentally misconfigured output. (RX/TX is relatively safe due to code review prior to using the hardware and because we don’t use that RX/TX for any other aspect of class. Circuits for other work only uses the DX and AX pins).
When developing and testing code without the garage, developers use stubs for the API. The stubs typically simulate the garage via LEDs and switches, which is sufficient for most testing. Some aspects of the assignments require meeting timing constraints, which requires code instrumentation as well.
The motors (steppers) were chosen partly due to size and, largely, due to price and availability. The choice of motors impacted both the technique for stall detection and the power requirements. Since it’s relatively difficult to detect stalls in steppers via changes in current, a mechanical rotary sensor on the front belt gear is used. If motion stops for a sufficiently long time it’s assumed that the door is stalled. This technique has some limitations if the mechanical strength of the motor/belt can damage the mini-garage prior to a stall being detected, but fortunately this doesn’t seem to be the case.
Typically the Arduino Pro Micro is connected via a USB cable to a PC, which monitors for errors. If the developer’s code attempts to overdrive hardware or misses timing constraints, it’s reported via a message. It was originally hoped that the USB cable could also satisfy all power requirements. Unfortunately the total current used by all components may exceed the current supplied by either of the Arduino Pro Micro’s on-board voltage regulators, which could lead to erratic performance. Rather than using a custom USB cable and additional power supply, I decided to just use an independent power supply for the motors (4AA batteries).
ULS VLS 4.60 Laser Cutter (via the now defunct TechShop, Inc….Hopefully soon to be replaced by Maker Studios)
Misc. standard tools (screwdrivers, sanders & sanding blocks, etc.)
Acknowledgements
Special thanks to Carly Lowe, who was a Dream Consultant at Tech Shop when I made these. Around 5pm one day I mentioned to Carly that I wanted to create a little model garage. There was a prototype building with sliding door assembled and waiting when I came in at 9am the next morning. She showed me the idea was feasible. Of course it took me about two months to recreate what she’d done as an evening project. (I wouldn’t have considered the windows/door/etching if I hadn’t seen Carly’s model. She also suggested the use of fabric for the door “hinge”)