MagPi86 Magazine

BUY IN PRINT WORLDWIDE MAGPI.
CC/STORE
Issue 86 October 2019 magpi.cc The official Raspberry Pi magazine
10 RETRO
GAMING KITS
L
The best arcade controllers,
F U
kits and consoles
POW E R
R R Y P I
R AS PBE
J E C T S
P RO g builds for
rewardin l makers
25 masterf
u
LEARN TO
SPOOKIFY YOU
R CODE WITH
H A L LO W E E N SCRATCH 3
COSTUME Easy programming with this
block-based language
£5.99
BUILD AN INTERACTIVE MAKE 8-BIT GAMES WITH

ROLE-PLAYING TABLE RETRO MUSIC & SOUND FX magpi.cc/store
3 ISSUES
FOR £5
Subscribe by phone: 01293 312193

Subscribe online: magpi.cc/subscribe
Email: magpi@subscriptionhelpline.co.uk
WELCOME
WELCOME
to The MagPi 86
W
e like to think we’re a pretty welcoming bunch to
newcomers here at Raspberry Pi Towers. After all, our
favourite computer was designed to help students (of all
ages) to learn computing skills. Everybody has to start somewhere, and
there’s nowhere better than The MagPi. This magazine, like every issue, Lucy
EDITOR
is packed with great tutorials and projects for the absolute newbie. Hattersley
If that sounds like you, stop reading now and head over to our Lucy is editor of
The MagPi. Now
Scratch 3 tutorial (page 40). In it, Sean McManus will show you how to Apple-free for
the first time in 20
code with the latest version of the ultra-friendly visual coding tool. years and feels
slightly strange
Right! Everybody else. There comes a point where every Raspberry about it. Annoys
Pi owner wants to get their teeth into something with more bite. A big people by talking
about camper vans
ol’ project that needs time, tools, and tenacity. So, this month our lead constantly. Still
wants a pet dog.
feature is Powerful Projects for Raspberry Pi (page 26). We’ve asked the magpi.cc
community to let us know what ultra-powerful projects they’ve heard
about, been testing out, and what they want to make next.
The result is 25 of the biggest, baddest, most breathtaking projects
in existence. From space ballooning and soccer robots to networked GET A
knitting machines, intelligent RASPBERRY
cucumber sorters, and classic toy- ZERO W KIT
hacks, right up to hydroponics.
PJ has interviewed the makers and
PAGE 68
got tips and advice. All you need is
the get-up-and-go to get started. So
dive into our feature, and let us know
what you’re going to make.
Lucy Hattersley Editor
magpi.cc 03
CONTENTS
Contents
> Issue 86 > October 2019
Cover Feature
26 25 Advanced
Maker Projects
E R F U L
Regulars
P O W RY P I
06 World of Raspberry Pi
RA S P B E R
S
92 Your letters
97 Next month
98 Final word
P RO J E C T
Project Showcases
10 MudPi
26
14 Dride Zero
18 Stonehenge Skyscape
18
20 Magic Wand
22 Night Vision
10
MudPi Stonehenge Skyscape
DISCLAIMER: Some of the tools and techniques shown in The MagPi magazine are dangerous unless used with skill, experience, and appropriate personal protection equipment. While
we attempt to guide the reader, ultimately you are responsible for your own safety and understanding the limits of yourself and your equipment. Children should be supervised. Raspberry
Pi (Trading) Ltd does not accept responsibility for any injuries, damage to equipment, or costs incurred from projects, tutorials or suggestions in The MagPi magazine. Laws and regulations
covering many of the topics in The MagPi magazine are different between countries, and are always subject to change. You are responsible for understanding the requirements in your
jurisdiction and ensuring that you comply with them. Some manufacturers place limits on the use of their hardware which some projects or suggestions in The MagPi magazine may go
beyond. It is your responsibility to understand the manufacturer’s limits.
04 magpi.cc
CONTENTS
40 60
Tutorials
36 Interactive tabletop RPG table
40 Throttle & Tilt Scratch 3 racer
44 Build a low-cost robot, part 3
48 The Photon Lab
Throttle & Tilt Make music in PICO-8
56 Tree views with C and GTK
76 60 Add game music in PICO-8
64 VNC with Raspberry Pi
The Big Feature

70
PecanPi Halloween costume projects!
84
Reviews
76 PecanPi
78 NanoSTEM IOT Weather Kit
80 Top 10 gaming accessories
82 Learn Scratch 3
Community
84 Sean Raser interview
86 This month in Raspberry Pi
Sean Raser interview 90 Events
WIN ROCKYBORG 95
ONE OF
FIVE ROBOTS!
magpi.cc 05
THE WORLD OF RASPBERRY PI
Raspberry Pi
hosts Scratch
Conference Europe
The cute coding cat is all grown up and plays a pretty big role
in education, explains conference attendee Rosie Hattersley
T
he UK hosted the Scratch Conference
Europe for the first time this August,
welcoming 300 delegates and visitors
from all over Europe and beyond.
There were 40 talks and 30 workshops, plus
keynote speeches from MIT Media Lab’s Mitchel
Resnick and Raspberry Pi Foundation CEO Philip
Colligan, among others.
The two-day conference focused on creative
ways that educators and Code Club and CoderDoJo
Teenage volunteer volunteers can inspire others using the visual
Thomas Southwell
explains his role coding platform. In part, it was a showcase for Educators in Japan are getting primary school
helping in the students programming
the possibilities of Scratch 3 – newly released in a
Scratch Bugs and
Glitches forum dedicated Raspbian Buster version this summer.
Mitchel Resnick talked about how both Scratch
and Raspberry Pi had evolved from being “a
little fringe activity” of interest to kids with
an interest in technical careers. Embraced by
governments and schools, both are now available
to “more children from more backgrounds to
design, create, experiment, explore, and learn
through coding”.
Mitchel presented the example of high school
graduate CrazyNimbus, who credited Scratch
with introducing her “to something she’s truly
passionate about” and has hopes of making
computer science a key part of her career.
Fascinating workshops
Elsewhere at the Scratch Conference, there were
presentations and workshops about overcoming
common coding and learning barriers, but also
about how to take Scratch and coding knowledge
to the next level – becoming a Scratch Ninja and
mentor for whole schools.
06 magpi.cc Raspberry Pi hosts Scratch Conference Europe

ore children from more backgrounds

M
design, create, experiment, explore, and
learn through coding
We saw Scratch being used as a tool for Joek von Montfort
uses Turtlestitch
learning different languages with visual to customise his
vocabulary prompts, and Catrobat’s Pocket Code conference swag bag
app for iOS and Android that enables users of all MIT’s Mitchel Resnick
ages to develop and then share their own mobile talks about the future
of Scratch
games and animations.
One fascinating workshop showed the Snap!-
based embroidery design tool at work. Using
Turtlestitch’s Scratch-like Snap! interface,
you can create geometric patterns, write words
and phrases using a range of fonts, or make
free-form designs. The instructions are then
saved to a USB and printed out on a compatible
embroidery machine.
Keynote speeches from the Scratch Conference
Europe are online at magpi.cc/rGwxnx.
Raspberry Pi hosts Scratch Conference Europe magpi.cc 07

Shaun the Sheep

enters space race
Aardman Animations has invited Raspberry Pi and Code Club on board
its latest feature-length space mission, delighting Rosie Hattersley
I
n a rather fantastic turn of events, of a worldwide challenge for youngsters to create
Raspberry Pi has become the Educational their own mini animation, telling the story of
Partner for the Oscar-winning animation Shaun the Sheep and his new alien-friend
studio’s latest film launch, A Shaun the Sheep Lu-La’s space adventures.
Movie: Farmageddon. The global Code Club competition is split
Both Aardman Animations and Raspberry into two age categories: 11-and-under and
Pi inspire young imaginations, so it seems 12-and-above. The Scratch-based challenge asks
appropriate that the partnership takes the form entrants to tell the story of Lu-La and Shaun the
Sheep. Entries will be judged on storytelling,
creativity and coding, and must follow the rules
of the competition.
An intergalactic challenge
Shaun the Sheep: Mission to Space is a
project‑based competition designed to be
completed over approximately two Code Club
sessions, resulting in an animation of up to
Aardman Studios and 59 seconds long.
Raspberry Pi have teamed
Instructions and resources are provided in
up to run a project-
based competition eight different languages. You’ll be competing
08 magpi.cc Shaun the Sheep enters space race

Shaun encounters
Lu-La, an adorable
alien with
magical powers
Shaun takes his

extra-terrestrial
friend on a road
trip to Mossingham
Forest to find her
lost spaceship
for the prestige of having your animation hosted

on the website, goody-bags, and a video message
ompete for the prestige of having your
C
from Aardman.
The submission deadline is 25 October
animation hosted on the website
and entries can be submitted by individuals
or groups of up to three children. The ten
winning animations will be announced in early
November on the Code Club blog, and on Twitter
and Facebook.
Code Club exclusive

The competition is open exclusively to registered
Code Clubs across the world. If you’re interested
in starting a Code Club in your community,
register to get involved. Head to codeclub.org
if you’re based in the UK, USA or Republic of
Ireland, or to codeclubworld.org to start a club in
the rest of the world.
Character chase
Of course, as fans will know, Aardman has prior
experience of space travel: in 1999, Wallace and
Gromit jetted off to the moon in search of cheese
in A Grand Day Out. The new film, A Shaun the
Sheep Movie: Farmageddon, is due to hit cinemas
this autumn.
Shaun the Sheep enters space race magpi.cc 09

PROJECT SHOWCASE
MudPi
Want to automate a garden that grows
delicious veg? Rob Zwetsloot gets out his
gardening gloves to see how to do it
A
couple of months ago, we looked at a
Smart Herb Garden, a smaller version of
the automated garden concept. A concept
that we love here at The MagPi, so it was a delight to
hear from Eric Davisson about his MudPi system.
“MudPi is an automated garden system, built
open-source, that helps me grow the produce I
love with less time, resources, and effort,” Eric
Eric
MAKER
explains. “The system controls the irrigation to

Davisson the garden and takes sensor readings to determine
Eric is a web
growing conditions. Soil moisture, temperature,
developer who humidity, and rain data is all collected and used to
also has a small manage watering control.”
software and
It’s highly customisable and scalable as well, to How did a system like MudPi come about? Well,
graphic design
company that suit your garden and changing requirements during it turns out that Eric is a very keen gardener. “I
he’s building with its lifespan. And it all runs on a Raspberry Pi. have a passion for gardening and each year have
his wife. expanded my garden with additional raised beds
mudpi.app and growing areas,” he tells us. “Maintaining and
keeping the garden up is a task that quickly grows
in demand. While looking for solutions to reduce
It became apparent that

automating the watering
would be my first goal
Warning! my workload, it became apparent that automating
Mains electricity the watering would be my first goal.”
He started off with a cheap hose timer. However,
This project uses mains the lack of remote control and no way of sensing
power. Be careful if you Sensors keep an eye on all the important environmental
plan to recreate it aspects like soil moisture and rain whether or not it was raining didn’t get him far.
10 magpi.cc MudPi
PROJECT SHOWCASE
Automate gardening Sensors are placed

and growing produce around the garden and
in the soil to keep an
eye on the environment
Quick FACTS
> Eric’s Raspberry Pi
was originally used
Controlling irrigation for retro gaming
helps save water and
grow better plants > MudPi has been in
development for
nearly two years
> It works for indoor

hydroponics as well
> Proper
implementation
saves water
and time
> People are already

starting their own
MudPi gardens
Irrigation hoses are

controlled via pumps
connected to the MudPi
Raspberry Pi
MudPi magpi.cc 11
PROJECT SHOWCASE
Indoor hydroponics can also be controlled by MudPi
“I’ve had a Raspberry Pi sitting around that my

wife bought for me and thought this would be the
time to try and use it for this project,” he says.
“What started with just a simple task of turning on
a pump has grown into a much more robust
solution of helping maintain my garden that
ost of the resources I

M
learn from are driven by
communities of creative
people supporting
one another
others could benefit from too. Most of the
resources I learn from are driven by communities
of creative people supporting one another. MudPi
is a great opportunity for me to give back to
those communities.”
Proof is in the parsnips

According to Eric, the project has been in
development for just under two years and has
ric has a big garden that is constantly growing bigger
E already been a great solution to reduce the
12 magpi.cc MudPi
PROJECT SHOWCASE
Build MudPi
Plan your garden – specifically, how you plan

01 to irrigate it. Once you understand that, you
can sort a system out however you wish, as MudPi will
interact with the pump and solenoids to control it.
The MudPi software can be found on GitHub

This MudPi system is
02 (magpi.cc/zNOfgk) and installed straight to a
amount of time and water the garden needs. hooked up to the mains Raspberry Pi running Raspbian by just downloading
“Each year a new raised bed has been added and – please be careful if you a zip of the archive and extracting it all. You can then
plan to make one yourself!
it was really easy to make another sensor unit attach any components and extra sensors.
to go along with it,” he elaborates. “I spend less
time having to water and weed the garden every
year, which has been a joy. Not only does this
work on my garden outside, but I have a grow
shelf inside were another MudPi setup controls
LED lights and small pumps. The benefit of
the design is I can run a setup as minimal as a
single temperature/humidity sensor for weather
readings, all the way up to a setup with many
attached units and components.”
Feel a bit inspired yourself? There are detailed
guides and project info on the MudPi website,
Once everything is connected and set up
mudpi.app, where Eric has created the resources
03 externally, you then need to add them all to
he had a tough time finding when he started the
the configuration file for MudPi. With that all done,
project. There will even be kits available in the
you can run the main script, sort out scheduling,
future. We hope you have a bit of fun in your
and (mostly) sit back and watch.
garden thanks to MudPi.
MudPi magpi.cc 13
PROJECT SHOWCASE
Press a single button to

share captured dash-cam
footage to your Dride.io
cloud storage area
The adjustable-angle
dash-cam attaches to
a windscreen or mirror
Dride Zero
for Raspberry Pi
Dride Zero is a video-sharing dash-cam you can set up yourself
and run from a Raspberry Pi. Intriguing, says Rosie Hattersley
S
cary footage of vehicular near misses, Engineer and developer Yossi Neiman, and
crazily inattentive driving, and partner Shiran Tasa, sensed a place for a ‘fusion
unfortunate encounters with wildlife, dash-cam and safety system’ that has a social
stray car parts and extreme weather events… video-sharing element while also alerting others
Dash-cam footage has brought a new perspective to poor driving etiquette and road dangers. There’s
to the everyday commute. It has also highlighted a driving alert feature that kicks in when Dride
just how tenuous some people’s control of their Zero senses something crazy is happening, and it
vehicles and sense of proportion can be. duly records it. Pressing a single button shares the
Yossi
MAKER
‘driving event’ on the owner’s designated storage

Neiman
area, from where it can be shared on social media.
Yossi Neimann is a While you can buy the Dride Zero product from
full stack software dride.io, there’s also the option of creating your
engineer and own Dride Zero with a Raspberry Pi. Both versions
developer based
in San Francisco can be connected to Android and iOS apps. The
and Israel, primarily startup company actively sought community
focused on Linux. feedback during development, and community
He’s a big fan of
members contributed code to the dash-cam’s OS.
open-source and
credits the open- DrideOS uses a customised version of Raspbian
source community Jessie. Originally, the commercial version of Dride
with helping to
Zero was based on Raspberry Pi Zero – and was
improve Dride from
its first iteration. intended to link up with Alexa which, back in 2016
when the project began, was being fêted for its in-
dride.io You can attach your Dride Zero behind the rear-view mirror, so
that it doesn’t obscure your vision car possibilities. Alexa has since been booted out.
14 magpi.cc Dride Zero for Raspberry Pi

PROJECT SHOWCASE
Quick FACTS
> Yossi’s Linux
experience made
Raspberry Pi the
obvious choice for
You can make your own
the project
dash-cam powered by
a Raspberry Pi Zero W
> The original Dride
Zero product was
based on Raspberry
Pi Zero W
The Dride Zero can be > Yossi hand-soldered

every one of the first
connected to Android and 150 Dride Zero units
iOS apps > The original

crowdfunding video
rather goofy and
Neiman cheerfully admits that his ten years features a horse
in software development working primarily in (magpi.cc/yCyAuH)
Linux didn’t fully prepare him for the world of
hardware manufacturing. He soon realised that > A Dride Modem that
with hardware you need to be “a million times connects a dash-cam
directly to the cloud
more focused” than you do with software. And
is due to launch in
sometimes there are things you just can’t fix.
early 2020
Dride on time
We first covered Dride back in 2017, when it was an
Alexa project (magpi.cc/yCyAuH). We’re pleased to
see how far it’s come on. he Dride Kit enables you to build your own dash-cam
T
Dride Zero for Raspberry Pi magpi.cc 15

PROJECT SHOWCASE
Share your ride
Install the DrideOS to a microSD card using

01 Etcher to flash the image file.
The Dride Universal app

enables dash-cam footage
to be shared by other
dash-cam models
T hese days the units are built at a

02
Connect your Raspberry Pi Camera Module to
Raspberry Pi 3 or Raspberry Pi Zero W with the
manufacturing plant in China before being
blue and white strip facing upwards.
shipped worldwide
Feedback about the original prototype during
the crowdfunding phase focused on the limitations
of the video resolution: 4 fps just wasn’t going
to cut it. “There are zero things you can do to fix
frame rate,” says Yossi. However, the launch of
Raspberry Pi Zero W in February 2017 changed
everything. “A few days after the launch of Zero W
it clicked,” he says. “We need Zero W and we need
to make this as fast as possible.”
The wireless LAN-enabled Dride Zero with
a sharing capability has proved a success and
dovetails neatly with the Dride Universal iPhone
and Android app, which can be paired with
Solder the Dride HAT to Raspberry Pi and insert
03 the unit into your 3D-printed Dride case.
around 16 different models of dash-cam so they
too can share video clips of near misses and
inattentive drivers.
16 magpi.cc Dride Zero for Raspberry Pi

PROJECT SHOWCASE
With the Dride Zero

Yossi particularly recalls the first 150 Dride dash-cam on your
HATS: “I soldered every single one myself.” windscreen, you can
record and share
These days the units are built at a manufacturing video footage
plant in China before being shipped worldwide. The startup company
Customers still buy as backers on the created a mascot to get
the message across
crowdfunding platform, choosing between an
£80 Dride Zero with a single 1.4MP camera or the
£121 model that also has a rear camera. However,
paying is not the only option…
Pimp your Dride

You can 3D-print and make your own Dride Zero
with Raspberry Pi. Full details of Dride’s OS, API,
and how to SSH into the system can be found
on the documentation page (magpi.cc/Dtiapg).
Warning!
To create your own Dride Zero, you’ll need a
Raspberry Pi Zero or Raspberry Pi 3 and a Dride Dash-cams are legal on
HAT (magpi.cc/hQrxNc). Download the DrideOS UK roads, but you must
ensure you have a clear
and use Etcher to write it to an up to 32GB field of vision when driving.
A dash-cam must be
microSD card. You’ll need to 3D-print your own fitted behind the rear-view
case using the GitHub file (magpi.cc/pkqydY) – a mirror so it’s in the centre
of your windscreen, but
boon if you’re keen to avoid the standard black not obtrusive to your line
case of the original Dride Zero. At some stage, of sight.
Dride may sell the case separately. magpi.cc/MzBaGy
Dride Zero for Raspberry Pi magpi.cc 17

PROJECT SHOWCASE
Stonehenge
Skyscape
You can see how the skies above Stonehenge affect
the iconic stones via a web browser thanks to a
Raspberry Pi computer, as David Crookes discovers
S
tonehenge is Britain’s greatest monument
and it currently attracts more than 1.5 million
visitors each year. It’s possible to walk around
the iconic stone circle and visit the Neolithic houses
outside the visitor centre. Yet, worries about potential
damage have forced preservationists to limit access. This Raspberry Pi was also fitted with a Pimoroni
With that in mind, Eric Winbolt, Interim Head Enviro pHAT containing atmospheric, air pressure,
Mark of Digital/Innovation at English Heritage, had a and light sensors. Captured light values from the
MAKER
Griffiths brainwave. “We decided to give people an idea of sky image were then used to alter the colour values
what it’s like to see the sunrise and sunset within of the master image of the stones so that the light
Mark is the owner of the circle, and allow them to enjoy the skies over on Stonehenge, as seen via the web, reflected the
The Bespoke Pixel
Stonehenge in real-time without actually stepping ambient light of the sky.
which operates
from Fareham, inside,” he explains.
Hampshire and has This could have been achieved by permanently What can you see?
created award-
positioning a camera within the stone circle, but this “What it does is give a view of the stones as it looks
winning digital
creations for art, was ruled out for fear of being too intrusive. Instead, right now, or at least within a few minutes,” says
music, and science. Eric and developers from The Bespoke Pixel agency Eric. “It also means the effect doesn’t look like two
magpi.cc/uZGDZz snapped a single panoramic shot of the circle’s images simply Photoshopped together.”
hat it does is give a live view of the stones as

W
it looks right now, or at least within a few minutes
interior using a large 8K high-res, 360-degree camera Indeed, coder Mark Griffiths says the magic all
when the shadows and light were quite neutral. runs from Node.js. “It uses a Python shell to get
“We then took the sky out of the image with the sensor data and integrates with Amazon’s AWS
the aim of capturing an approximation of the view and an IoT messaging service called DweetPro to tie
without impacting on the actual stones themselves,” all the events together,” he adds.
Eric says. There was also a lot of experimentation. “We
used the HAT via the I2C connectors so that we
Stone me could mount it away from the main board to
By taking a separate hemispherical snapshot of the get better temperature readings,” says Mark,
sky from a nearby position and merging it with the “We also tried a number of experiments with
master photograph of the stones, the team discovered different cameras, lenses, and connections and it
they could create a near real-time effect for online became clear that just connecting the camera via
visitors. They used an off-the-shelf, upwards- USB didn’t allow access to the full functionality
pointing, 220-degree fish-eye lens camera connected and resolutions.”
to a Raspberry Pi 3 Model A+ computer, taking images Mark reverse-engineered the camera’s WiFi
once every four minutes. connection and binary protocol to work out how to
18 magpi.cc Stonehenge Skyscape

PROJECT SHOWCASE
Placed within a
protective acrylic dome,
the camera takes an
image of the sky every
four minutes; this
is blended with the
Stonehenge photo on
the website
By day, you see
Stonehenge as it would
appear to real-life visitors;
at night, a computer-
generated model of the
sky is depicted with the live
location of the stars and
the five visible planets An ADSL line allows the sky images and
the HAT data to be sent to the cloud,
to an application called Stonehenge
Skyscape which drives the website
communicate with it via Raspberry Pi so that full-

quality images could be taken and downloaded.
“We also found the camera’s WiFi connection
would time out after several days,” reveals Mark,
“so we had to use a relay board connected via the
GPIO pins.”
With such issues resolved, the team then created
an easy-to-use online interface that lets users
click boxes and see the view over the past 24 hours.
They also added a computer model to depict the A Raspberry Pi inside this
box gathers data about the
night sky.
sky from the camera and the
“Visitors can go to the website day and night
atmospheric, air pressure,
and allow the tool to pan around Stonehenge or
and light sensors on the HAT
pause it and pan manually, viewing the stones as and sends it to an application
they would be at the time of visiting,” Eric says. in the cloud
“It can look especially good on a smart television.
It’s very relaxing.”
Quick FACTS
To protect the equipment, > The hardware cost

a Raspberry Pi computer around £500 in total
is safely housed inside a
weatherproof box attached
to a wall of Stonehenge’s > Marzipano was
security hub used for the
The setup is powered by 360-degree viewer
solar panels (what else?)
and it is hooked up with an
ADSL line so that the sky > Open-source
images and HAT data can projects including
be sent to the cloud
Node.js are utilised
> Suncalc2 and

Ephemeris provide
astronomical data
> The site had 80,000

unique visitors on
its first day
Stonehenge Skyscape magpi.cc 19

PROJECT SHOWCASE
Magic Wand with

Computer Vision
What wizarding fan wouldn’t want a wand that actually, really, properly makes
something move? Nicola King explores a simply magical idea
F
ollowing a trip to Universal Studios (Japan)
by his brother, who was able to perform
some ‘magical’ tricks with a retroreflector-
tipped wand while he was there, maker Jasmeet
Singh was inspired to explore what he could do
with a replica wand. “I have been highly inspired
by tech portrayed in sci-fi movies – be it some cool
gadget owned by a superhero, or wands that can
Jasmeet
MAKER
cast incredible charms,” he reveals. “That was the

Singh time I was exploring the field of computer vision
An electronics and machine learning. Hence, I saw this as just the
student from New right opportunity to use the wand and create my
The project’s Raspberry Pi NoIR Camera Module is
Delhi, Jasmeet own version of the ‘wizarding experience’ using surrounded by a ring of infrared LEDs
enjoys expanding
computer vision and some basic electronics.”
his knowledge with
hands-on projects. So, how does it work exactly? Jasmeet elaborates,
He also has a keen A wave of the wand “My main goal for this project was to give its user
interest in the field
Jasmeet’s project involves creating a motion a real wizarding experience with a wand, and
of AI, and wants
to bring the cool capture system which enables him to open a that could only be achieved by attaching as little
tech of movies to box with a flick of his wand. To achieve this, electronics as possible on the wand. The wands
real life. he used a night-vision camera (Raspberry Pi used at Universal Studios achieve this by using a
magpi.cc/MsBprC NoIR Camera Module), a Raspberry Pi, some retroreflector attached at the tip of the wand.”
electronics, a Python program using OpenCV, and Jasmeet continues, “When the retroreflector at
machine learning. the tip of the wand is illuminated using an infrared
light source, it can be seen as a bright circular
blob in the real-time video from the [Raspberry
Pi NoIR Camera Module]. Then, using a Python
script running on Raspberry Pi with some basic
functions of the OpenCV computer vision module,
the path taken by the wand is traced after the tip
of the wand’s blob has entered a starting point in
the frame. The person now has to draw the letter,
which ends at the ending point, and then the last
frame with the drawn letter is passed on to a trained
machine-learning model which predicts the letter
drawn. Depending on the prediction, Raspberry Pi
commands a servo to open/close a box.”
Jasmeet used this

original Universal Stellar speller
Studios wand, but Wizarding aficionados will be aware that
you can make
your own ‘Alohomora’ is a spell that allows the opening of
20 magpi.cc Magic Wand with Computer Vision

PROJECT SHOWCASE
Jasmeet’s
homemade box
opens using a servo
The OpenCV computer

vision library is used
to detect the letters
traced by the wand
The retroreflector tip of
the wand is detected
by the infrared camera
Quick FACTS
> The project took
Jasmeet around
two months
to complete
locks. So, appropriately, if someone draws a letter

‘A’, Raspberry Pi commands the servo to open the
I saw this as just the right > It was his first using
Raspberry Pi
box. By the same token, if someone draws a letter opportunity to create my
‘C’ (for close), the box will close. > You can use
Jasmeet used a dataset from Kaggle to train the own ‘wizarding experience’ any stick with
machine-learning algorithm and, as it contained retroreflector tape
a large number of images for each letter, the using computer vision and or paint on the end
accuracy of predictions is an impressive 99%. In
addition, he says, “Since the setup of the project
some basic electronics > Jasmeet plans
to add a wizard
uses a night-vision camera for detecting the
duelling capability…
wand in real time, it can work without any errors
in a darkened room, as well as with an additional
> …with a second
source of visible light.” wand and night-
Unsurprisingly, the feedback Jasmeet has vision headsets!
received from friends and family has been
very positive, as has the response from the
Instructables and Hackster platforms where his
written tutorial is available. All in all, it’s a very fun
and inspiring project, especially when you consider
that Jasmeet was completely new to the fields of
computer vision and machine learning when he
started his wand-waving idea. Proof that having
a go at something new can really pay dividends
– “Project-based learning is the best and most Jasmeet printed
out images to stick
efficient way to get yourself acquainted with new
on an old box – use
technologies,” he tells us. your creativity
Magic Wand with Computer Vision magpi.cc 21

PROJECT SHOWCASE
Night Vision
Unlike eating carrots, this ingenious infrared camera really does enable
you to see in the dark. Phil King stops munching veg to take a look
I
t’s late at night and all the lights are out in with IR LEDs for night-time ‘illumination’. The
the house, but someone is sneaking around… live camera view can be shown on a Pimoroni
Don’t worry, it’s just Dan Aldred testing out HyperPixel 4-inch TFT touchscreen, which is also
Dan his latest Raspberry Pi-powered invention, a used for a graphical user interface.
MAKER
Aldred portable infrared camera enabling him to see in For the housing, Dan upcycled a handheld
total darkness. camera flash unit. “The original plan was to use
Raspberry Pi As a child, Dan was a fan of the Splinter Cell an old-fashioned camera and make a camera that
enthusiast, NCCE
stealth shooter video game. “The iconic image took photos in the dark, but when I went to a car
facilitator, teacher,
and coder who from the game is the night-vision goggles that boot sale, all I found was the pivoting flash – it cost
enjoys creating new Sam Fisher wears,” he recalls. “I have always a pound, which was a bargain.”
projects and hacks been fascinated by the idea that you can see in the As well as being large enough to house a
to inspire others to
start learning. Still dark, and this formed the foundation of my idea Raspberry Pi Zero, IR camera, and screen, the flash
trying to get a Kinect to build a portable handheld night vision piece unit has the bonus of a tilting handle, enabling the
360, Python, and of equipment.” user to angle the camera to the desired position.
Raspberry Pi working
One of the hardest challenges was that Dan
with each other.
Success by stealth wanted Night Vision to be standalone, portable,
magpi.cc/rwepTs
Sam’s Night Vision project features a Raspberry and bootable, with minimum interaction from the
Pi Zero and a ZeroCam infrared camera equipped user to get it running. “The obvious solution was
The camera is housed

in an old flash unit
with a pivoting handle
A ZeroCam infrared A touchscreen GUI offers

camera with IR LEDs a selection of options,
can see in the dark including a live camera view
22 magpi.cc Night Vision

PROJECT SHOWCASE
Dan accidentally cracked the

corner of the touchscreen, but
the GUI offers numerous options
to use a crontab, but this did not load the GUI,” he

reveals. “I spent about two weeks trying to find
a solution. In the end I opted for a desktop icon
which when you click it the program runs and the
GUI loads.”
T he flash unit has the

bonus of a tilting handle,
enabling the user to angle
the camera Quick FACTS
From vision to reality Photos taken by the camera in the dark, revealing a treasure > The GUI is created in
While Dan planned out what he needed to do trove of Raspberry Pi goodies
Python using guizero
before he started putting the camera together,
not everything went to plan. “There were several > Dan has
points at which I had to take a break and reassess experimented with
how to find a solution to a problem,” he admits. object detection
“All was going well until I ran the program and using Google Video AI
realised that the camera image displayed back on

> Night Vision is
the HyperPixel was upside down! Luckily at this
powered using
point I was using elastic bands to hold the case and a portable
hardware together, so I could flip it around. But the phone charger
IR LEDs were secured in, and breaking the Sugru
might damage or split the plastic. As a stroke > It would be ideal for
of fate, the IR LEDs are mounted into holders detecting vampires/
and guess what, you can pop the LEDs out of the werewolves
holder. So, I popped them out and then rotated the at Halloween…
camera unit and then popped it back into place!”
> …Or a large bearded
More trouble was to follow when Dan
man in a red suit
accidentally cracked the touchscreen. “The whole
at Christmas
project was working and perfect, so I was left with
the conundrum of either replacing the screen and
risking all the inner hardware not fitting back
in, or just ‘make do and mend’. I settled for the The ZeroCam and
its IR LEDs were
latter, so the ten-second button does not work, mounted in drilled
holes of a piece of
but who wants to see in the dark for only ten
clear plastic and
seconds anyway!” secured with Sugru
Night Vision magpi.cc 23

O W E R F U L
P R Y P I
R AS PBE R
O J E C T S
PR
PJ E V A N S
H E M A K E
MEETS T S TO THE NEXT L
I N G
RS TAK EVEL
R A S PBERR Y PI
PROJECT
I
t’s common to do a bit of head-scratching when you get
your first Raspberry Pi. Sure, it’s a cool bit of technology
at an amazing price, but what to do with it?
Here at The MagPi, we work hard to stuff your imagination
full of ideas that are hopefully accessible to all our readers.
Still, we thought it might be fun to take a look at what
happens when a maker gets ambitious and decides to go
all‑out on their new project. We present some of our favourite
advanced Raspberry Pi makes…
FEATURE
ADVANCED
PHOTO GAMING BUILDS
PROJECTS Strictly for fun, these masterful makes
Take amazing shots with put a smile on your face
Raspberry Pi
HEVERLEE SJOELEN
Maker Grant Gibson | magpi.cc/DQiGwQ
When Belgium beer brand Heverlee
approached prolific maker Grant
Gibson for promotional ideas, he was
reminded of Sjoelen, a shuffleboard
game popular in Germany and Belgium.
The result was a Raspberry Pi-powered
physical game and vending machine
mash-up that dispensed cold cans of
beer to the winners.
DROP PI
Maker David Hunt | magpi.cc/fvNmeA
THE CLAW
Take incredible shots of water droplets,
Maker Ryan Walmsley | magpi.cc/aqtCxF
using a Raspberry Pi as a controller for a Ryan’s ever-popular claw machine
solenoid valve and camera trigger. The is often seen at Raspberry Pi events
valve is hooked up to the GPIO pins and throughout the UK. An upcycled
a small piece of code opens the valve and bar-top ‘grabber’ game, this one
triggers the camera. The code is timed can be played over the internet.
for a valve 40 cm above the surface of Use your computer or mobile
the water. It’s a great example of how phone to try to grab Babbage the
Raspberry Pi can be used to control an Bear (gently) as the results are
environment and camera, plus a good live-streamed to you.
excuse to learn how to control valves.
STEREOPI
Maker Eugene Pomazov | magpi.cc/pGvBAp
Since 2014, Raspbian has offered built-in
support for stereoscopic photography.
With two cameras attached to a Raspberry
Pi, you can create 3D photographs and
record 3D video. You’ll need a Raspberry Pi
Compute Module
(which has support
for two Camera OUTRUN BAR-TOP
Modules). The
compact and light
Maker Matt Brailsford (aka Circuitbeard) | magpi.cc/TjjVMH
nature of StereoPi What separates Matt from the crowd is his exquisite attention
makes it particularly to detail. This OutRun Deluxe bar-top features fully working
useful for attaching controls, such as gear shifting and a steering wheel. Add the
to drones and robots. pedals, repurposed from an wheel controller, and custom
bodywork and this is a classy project.
Powerful Raspberry Pi Projects magpi.cc 27

FEATURE
CREATIVE PURSUITS
Physical computing and the arts are a very
good match, and here’s why
ETCH-A-SKETCH ART WITH PYTHON

Maker Sunny Balasubramanian | magpi.cc/UvGhfe
A classic toy featuring in many people’s childhoods, the Etch-
a-Sketch allows you to draw pictures without making a mess,
then wipe the board with a satisfying shake. Sunny used servos
and a Raspberry Pi to take control of the dials, then used edge-
finding image filters to create an Etch-a-Sketch ‘camera’.
NETWORK KNITTING MACHINE

Maker Sarah Spencer | magpi.cc/iSVNEm
One of the must-see exhibits at 2018’s Electromagnetic Field
camp was ‘Stargazing’ by Sarah Spencer. This map of the
universe measures a colossal 4.6 by 2.8 metres and was knitted
on a hacked Brother mechanical knitting machine, controlled
by an Arduino and Raspberry Pi. It’s even networked.
TRUE COMPACT CAMERA

Maker Martin Parker | magpi.cc/dpbFJH
Raspberry Pi Zero can fit into
CUBERT some tiny places, but how about
a vintage 110 format compact
Maker Lorraine Underwood | magpi.cc/dmSCSG camera? Martin replaced the
A beautiful 8×8×8 structure of ping-pong balls, each internals with a Raspberry Pi
containing a NeoPixel to create amazing colour patterns, Zero and Camera Module. Don’t
and you can even play 3D Pac-Man. Of particular interest is worry about film running out
Lorraine’s blog and talks on the project, where she is brutally when your camera can take
honest about the difficulties of making such a unique object. thousands of high-res snaps.
PI CLOCK 2
Maker Tim Richardson | magpi.cc/dbqYPu
Tim’s clock is made up of two
64×32 pixel displays and displays
information being relayed from a
Raspberry Pi-controlled weather
station. It features some clever
energy-saving extras, such as a
motion sensor to only update the
screen when someone is in the
room. It’s been to Parliament as
part of the one-millionth Raspberry
Pi celebrations.
FEATURE
T H E S E A S I N
TAKE TO N O M O U S Y A C H T
YOUR AUTO
This is a wind-powered
craft, so the sail is
moved by motor
MAKER
AI Coventry
(Coventry ‘The Rabbit’, complete
University) with Raspberry Pi Zero
Left to Right: Balazs
Bordas, Mark Tyers,
Sergiu Harjau,
Shahzad Haider.
magpi.cc/uxjfhV
The project’s Raspberry Pi Zero is
connected to a host of sensors to
determine direction and speed
A
I Coventry is making serious progress with Are you happy with the outcome?
autonomous vehicle technology. Sergiu Yes, in our latest trip we did way better than our
Harjau and team entered their aquatic past ones, but even still we weren’t perfect. We’re
vehicle, ‘The Rabbit’, in an autonomous boat very happy to call it a learning experience and go
challenge in China. We asked him all about it. from there. On the flip side, we were very organised,
more prepared than any team out there if I’m
What inspired you to build a self-sailing boat? honest, and that allowed us to quickly fix our issues
I first started having an interest in autonomous when we needed to. In the end, we managed to get
vehicles when I had to choose a project for a third prize, and we’re very happy with the result.
second-year module. I first built an autonomous
RC Car, driven by Raspberry Pi Zero[…]. That got Any improvements planned?
some traction in the university and then a lecturer We’re going to be looking at spending a little bit
offered me a spot on the autonomous boat team in extra on our compass sensor to ensure it doesn’t
Finland. We use the project as a way to broaden our get de-calibrated as often as it did in China. We
skill set, both from a software standpoint but also suspected there were power lines under the lake,
when it comes to electrical engineering, and so far and that didn’t help our autonomous sailing.
it’s been working wonderfully.
What plans do you have for your next vehicle?
What challenges did you face? Since autonomous vehicles and embedded systems
Autonomous vehicles are a bit like chess in some are two of my favourite pastime activities, my next
ways. It’s very easy to understand how it’s all big project will again bring the two together. I’ll
meant to work, but it’s really hard to go ‘deep’ be helping my lecturer Dr David Croft to deliver a
and create beautiful systems which work without hardware-software platform for a new master’s
a single flaw[…]. In China, our biggest challenge course next year: ‘Connected autonomous vehicles
which we didn’t foresee was the weather. The systems’. We’re planning on building an RC car
humidity and extreme heat rendered some of with capabilities to become autonomous on an ROS
our sensors faulty, spitting out random data at software interface. It’s not going to be easy, to say
unpredictable times. Even still, we pursued our the least, but I hope that through my other projects
goals and in the end managed to fix some of the I have managed to gain the necessary skills to
issues and came home with a pretty good result. pursue yet another interesting endeavour.

FEATURE
A touch enclosure was

required to withstand the
rigours of space
All parts are ‘commercial off-

the-shelf’, including the official
Raspberry Pi Camera Module
The project’s Raspberry

Pi Zero required
no modifications
TAKE PHOTOS ACE!

FROM SP
S T here could be some
pace is hard. Space, when you’re not
MAKER
SpaceX or NASA, is extremely hard, but
Surrey Satellites that didn’t stop Surrey Satellites. Having credible applications for
& University secured a slot on Soyuz, they launched the DoT-1
of Surrey satellite, which had a Raspberry Pi and camera low-cost computers and
The Surrey on board supplied by the University of Surrey.
Satellites team
(below) with DoT-1,
It had a simple task: take a photo from orbit cameras of this type
their ‘Demonstration using commercially available off-the-shelf
of Technology’ parts. We spoke to Surrey Satellites’ Director of capture an image from space using a commercial-
satellite designed
Engineering, Rob Goddard. grade Raspberry Pi Zero computer and camera,
to show off new
avionics complete store the data, and downlink it via a new data
with Raspberry Pi What inspired this project? handling system on board the satellite.
on board. Whilst the primary objective of the DoT-1
sstl.co.uk (Demonstration of Technology) mission was to What challenges did you face?
fly the company’s next-generation avionics, It was a surprisingly easy project! We performed
there was space for some additional experimental some screening tests on three Raspberry Pi Zero
payloads, hopefully stimulating the interest of computers to select the best performing over-
our younger engineers. One of those experiments, temperature, and then packaged the computer and
designed and implemented in conjunction with camera into a metal box. The standard camera lens
the University of Surrey Space Centre, was to was changed for a fish-eye lens. The remaining
electronics were completely untouched.
Are you happy with the result?

We were certainly pleasantly surprised by the
quality of both the still imagery and video capture
from Raspberry PI Zero and camera. There
could be some credible applications for low-
cost computers and cameras of this type. We’re
considering flying them as inspection cameras to
confirm deployment of solar panels, or to view
robotic arm movement.
30 magpi.cc Powerful Raspberry Pi Projects

FEATURE
RADICAL ROBOTS INCREDIBLE S

We couldn’t leave our little robotic AI PROJECT
friends out, now could we? Build something super-smart
with Raspberry Pi
ROBOT DINOSAURS
Maker Dr Lucy Rogers | magpi.cc/QPHdBc
GOOGLE CORAL
It’s not often dinosaurs are
Maker Google | magpi.cc/coral
disappointing, but when the animatronic Coral is a range of AI products and projects made
dinosaurs of the Isle of Wight theme by Google. The latest star is the USB Accelerator.
park Blackgang Chine kept failing, This dongle adds a Google TPU to Raspberry Pi,
Lucy came to the rescue. Retrofitting which rapidly boosts real-
the bespoke mechanics with off-the- time classification – all local
shelf parts controlled by a Raspberry Pi, on the Raspberry Pi. Check
she made them easier and cheaper to out Teachable Machine in
maintain, with more movement options. The MagPi 79 (magpi.cc/79).
SOCCERBOTS TENSORFLOW
Maker Neil Lambeth | redrobotics.co.uk
CUCUMBER SORTER
Neil wanted to show kids that robotics
Maker Makoto Koike | magpi.cc/fDeLLK
can be more than just a single ‘bot It’s lovely to see one maker
moving around, so he developed the put AI tech into practice to
SoccerBots, a pair of remote-controlled, solve a problem. Makato’s
ball-firing robots that try to score goals father grows cucumbers
against each other. They’ve inspired and straight ones with lots
hundreds of kids around the UK. of prickles command a high
price. Makato trained an AI robot to spot and sort
them. Perhaps there are a number of production
BIOHEX lines that could benefit from a little AI.
Maker Harry Brenton | magpi.cc/eynBqs

Hydroponics is all the rage. Growing THERE’S WALDO
plants without soil produces amazing
results, but requires careful monitoring
Maker Matt Reed | magpi.cc/LaGxbn
and care. Harry’s BioHex is a 3D-printed Where’s Wally? (Or Waldo as he’s known in
modular plant-growing machine that the US.) Matt Reed’s There’s Waldo robot is an
uses a Raspberry Pi to analyse the irreverent demonstration of machine-learning.
environment, operate the air pump, and There’s Waldo uses OpenCV to extract all the
provide lighting control. faces from the page, and then sends them to
Google Auto ML Vision service. This locates the
striped one and sends it back to a Raspberry Pi,
OPEN-SOURCE MARS ROVER which points him out using a uArm metal arm.
Maker NASA Jet Propulsion Laboratory | magpi.cc/yhXYKp

Want your own Mars Rover? Of
course, you do. After a successful
educational outreach programme
demonstrating a small version of its
real rovers, NASA’s JPL created a new
robot, ROVE-E, that is made of off-
the-shelf parts and runs open-source
software on a Raspberry Pi. It costs
around $2500 to build.
FEATURE
WHOA! WHAT IS THAT?

Some projects are just so ‘out
there’, they defy categorisation
HIGH-ALTITUDE BALLOONING
Maker Dave Akerman | daveakerman.com
The world’s best computer is no stranger to space, often
hitching a lift on the ISS. If you’d like to send a Raspberry Pi
skyward, it’s easier than you think. Dave sends Raspberry Pi
Zero computers up to 100,000 ft (30,480 m) in the air using
helium balloons, taking amazing photos. His comprehensive Warning!
blog shares an immense amount of knowledge. High Voltage
This project uses
potentially dangerous
levels of electricity
MUSICAL TESLA COIL

Maker Derek Woodroffe | magpi.cc/WhJQRq
A Tesla coil as a musical instrument? Why not? Derek is
famous in the community for his high-voltage antics. Here, a
Raspberry Pi Zero can load MIDI files and convert each note to
information that is sent to two coil driver boards. The result is
your favourite tune rendered at 200 volts.
3D SCANNER FLAPPY BRAIN

Maker Richard Garsthagen | pi3dscan.com Maker Albert Hickey | magpi.cc/jhspVm
This project gets a special place on our ‘Whoa!’ list simply for Mattel’s ‘Mind Flex’ toy
98 Raspberry Pi computers in use. Split over 19 poles, they appears to read your mind by
provide a high-resolution 3D model of anything placed within measuring your brain wave
the scanning area. Richard has not only written a great series activity. Egham Jam organiser
of posts as the project has evolved, but has open-sourced Albert Hickey added an
many of the plans and code used. Arduino and Raspberry Pi to
decode the output so you can
play Flappy Bird. Move the
bird down by thinking hard,
then clear your mind to go up!
FLOOD NETWORK SENSOR

Maker Ben Ward | flood.network
Citizen-scientist Ben Ward has invented a cheap, serviceable
alternative to expensive flood-monitoring systems for his
home town of Oxford, using Raspberry Pi computers. The
system bounces sound waves off the water surface to calculate
the level. The reading is then relayed by radio (LoRa) to a
central database. The project is now spreading across the UK.
32 magpi.cc Powerful Raspberry Pi Projects

FEATURE
SPIN UP A N I M A T I O N
DIGIT A L A
An Arduino helps track the

rotation of the zoetrope
Each screen shows a

single frame that is
part of the animation
Brian designed a custom driver

board for each screen so a single
Raspberry Pi can refresh every one
B
rian is a regular at Raspberry Pi events idea that I could make a digital version bringing
MAKER
up and down the UK and is most often Eadweard Muybridge’s images to life.
Brian Corteil seen with his Pi Noon balloon-battling
Brian is an award- robots or FacePlant, the two-wheel balancing What challenges did you face?
winning robot
creation he entered in this year’s Pi Wars. I had to control twelve screens on a single
maker, active
member of the There is another one of his builds that caught our Raspberry Pi and design a circuit to be able to
Raspberry Pi attention, a digital zoetrope (an early animation select each screen. Then I needed to write software
community, and machine) that threw up some real technical to render images for the screens, modifying the
self-titled ‘head
meat-bag’ of challenges, in particular trying to drive twelve driver software to upload an image in four blocks.
Coretec Robotics. screens from one Raspberry Pi. The images on
magpi.cc/LjJFFO the screens can be updated in real-time when the Are you happy with the result?
zoetrope is spun. I’m pleased with the way the Digital Zoetrope turn
out after I changed the shiny black acrylic to matt
What inspired you to build a zoetrope? black and the wiring to black. It ended up being as
While I was researching the images of Eadweard I first imagined it would be.
Muybridge and the history of moving images,
I was reminded of the zoetrope. I had a crazy Any improvements planned?
To make it more interactive and be able to import
cells by taking a photo of a hand-drawn sheet of a
one-second short film.
Are there any more zoetropes in your future?

Well, I have two projects planned. Hopefully,
I will be making a second larger version of the
Digital Zoetrope, using e-paper displays for
Electromagnetic Field 2020 camp as an art
installation, using twelve Pi Zeros and a Raspberry
Pi 4 networked together. And of course, my
annual robot build for Pi Wars.

Fully
Updated for
Raspberry
Pi 4
THE OFFICIAL
Raspberry Pi
Beginner’s Guide
The only guide you need to
get started with Raspberry Pi
Inside:
• Learn how to set up your Raspberry Pi, install an operating
system, and start using it
• Follow step-by-step guides to code your own animations and
games, using both the Scratch and Python languages
• Create amazing projects by connecting electronic components
to Raspberry Pi’s GPIO pins
Plus much, much more!
£10 with FREE worldwide delivery
Buy online: magpi.cc/BGbook

TUTORIAL
Interactive
Rob
tabletop RPG table
MAKER
Zwetsloot
Rob is amazing.
Plunder dungeons and slay dragons in digital style with this
He’s also the
Features Editor
simple TV conversion project for all your TTRPG needs
of The MagPi, a
hobbyist maker,
T
cosplayer, comic
book writer, and abletop RPGs are back in fashion a serious might seem like a no-brainer, we’d suggest doing
extremely modest. way. Thanks to a recent tidal wave of some tests first. We’re using a spare Raspberry
magpi.cc podcasts, live streams, and YouTube series, Pi 3 and it works just fine, and a Raspberry Pi 3A+
games like Dungeons & Dragons, Vampire: The would probably do the job as well, even with the
Masquerade, Warhammer 40,000, and other reduction in RAM.
TTRPG systems have never been more popular. If you’re buying a brand new Raspberry Pi for
Aside from finding a day all your friends are the job, go for the 4GB Raspberry Pi 4 so that
available, the most difficult part of playing can be you have more room to grow with possible future
handling and juggling different maps. Struggle TV upgrades.
no longer with paper printouts and upgrade your
GM’s table with an old TV, a Raspberry Pi, and a
bit of ingenuity. Now grab your carpenter’s tools
Set up Roll20
and roll a skill check…
02 The real magic for this interactive table
comes from Roll20 (roll20.net) – it’s a free
Warning! online service that is normally used to let people
Power Tools
Choose your Raspberry Pi
In this tutorial we use
01 Not every Raspberry Pi will be quite suited
remotely connect to each other for a TTRPG game.
As well as being able to talk to your group and
various hand and power
tools that can be very
for this use. The main function of Raspberry Pi GM, you can roll dice within the app and control
dangerous. Please seek here is to launch into a web app from full-screen tokens of your characters.
adult supervision.
Chromium. It’s not the lightest webpage in the It also allows a GM to display a map that has a ‘fog
world, so while something like a Raspberry Pi Zero of war’ – areas that the players cannot see. From
their computer, they can reveal the map as the
players explore. Sign up for an account – if you’re
the GM, you might want a secondary account to act
as the ‘player’ account for the screen.
You’ll Need
> Flatscreen TV
Initial screen setup

> Roll20 account
roll20.net 03 A fresh install of Raspbian is best for the
> Planed timber table, we find. If this is your first time using a
Raspberry Pi, check magpi.cc/quickstart for
> Wooden skirting
boards instructions on how to install Raspbian, including
the normal first-time setup stuff like connecting
> Some brackets
to wireless LAN and setting a password, etc.
> Carpentry tools Once that’s all done, open Chromium and log
> Nails in to your Roll20 account that will be used for the
Mitre boxes are very handy for cutting perfect
angles on your wood screen. Go to the My Games section and right-
36 magpi.cc Interactive tabletop RPG table

TUTORIAL
The map is displayed

by a full-screen
browser that the GM
controls remotely
Miniature figures can use the A wooden frame is not

screen like any paper map, and required, but it makes the
it really brings the game alive! final product look a lot better
click and ‘Copy link address’ on the Launch Game

link for the campaign you want to show on the
screen.Open Chromium’s settings, scroll down
to ‘Open a specific page or pages’ (under the ‘On
start-up’ section), and paste the link into there.
Raspbian tweaks
04 To get Chromium to launch at startup, you
can add a quick line to the bottom of the profile
config file. Open the Terminal and use:
sudo nano /etc/profile
Use an arrow key to scroll to the bottom of the file

and add:
chromium-browser --start-fullscreen &&
Press CTRL+X, then Y to save and exit. Now on

a reboot, Raspbian will open Chromium in full-
screen straight to your map. Make sure to test your build before trying to make a frame
Interactive tabletop RPG table magpi.cc 37

TUTORIAL
Be careful while

nailing things, and try
to make sure
it’s square
We did a bit of customisation of Raspbian as and bottom of the TV to the exact length of each
Top Tip well. You can swap the Raspberry Pi Desktop side, and then cut the two side bits of wood to fit
splash screen by changing the splash.png file in their size, plus twice the depth of the wood. This
Other software /usr/share/plymouth/themes/pix/ (we used the way, the side parts cover the ends of the wood used
Dungeons & Dragons ampersand logo) and we also for the top and bottom.
Don’t want to changed the wallpaper on the desktop. For the façade, we measured how long each
connect to the piece of wood would be at the top (side length plus
WiFi in every twice the wood depth) and then cut at a 45-degree
new location?
angle inwards so that the chamfered edge was the
You can use
Measure your screen
Dungeon Board,
which allows
05 If you want to build a frame, you need to
shorter edge of the wood.
you to power the make sure you know how big your TV is. Measure
map from the the length and width precisely, as well as the depth
GM’s computer: Assemble the frame
magpi.cc/pJdHtp
and the bezels. For the frame, you want to use
planed lengths of timber to create the sides of a
07 This step looks easy, but is a bit tricky. You
sort of box. need to nail the shorter (side) lengths of wood to
Make sure the width of the timber is larger than the longer (top and bottom) lengths of wood to
the depth of the TV. We used 18 mm-deep cuts of create your basic box-like frame. Use clamps where
wood to try to keep the weight down; however, you you can to keep the angle at as close to 90 degrees
may choose thicker. as possible. We recommend nailing one of the
We used moulded skirting boards for the façade short (side) parts of wood to both of the long pieces
of the frame, meaning we didn’t need to create (top and bottom), before closing it off with the
a chamfer on a piece of wood. The width of the other side part of wood.
skirting should cover the depth of the main frame,
as well as the bezel on the TV.
TV check
08 Before going further, make sure your
Cut your wood
06 We recommend using a mitre box to make
measurements were correct and fit your TV into the
box. At this point you might want to make note of
sure your cuts are straight or perfectly angled. We any extra protrusions, or drill some holes to access
created the frame by cutting the wood for the top buttons on the television if necessary.
38 magpi.cc Interactive tabletop RPG table

TUTORIAL
Top Tip
Elevation
One of the
problems we
came across with
paper maps is
that they take
up valuable
table space. So
does this screen.
A possible
solution? Use
legs to elevate
it and regain
some space for
character sheets.
T
esting the fit is
essential to make
sure everything
is fine before
continuing
Final adjustments
If it doesn’t fit properly, you may need to take
apart the frame and do it again, or make sure you
11 You’ll need to run a couple of power cables
measured correctly in the first place. from beneath the frame to power the TV and
Raspberry Pi – we used a rotary tool to carve out a
little bump that would allow cables (along with a
mouse cable) to run freely from under the frame.
Assemble the façade
09 You should probably glue the edges of the
Now it’s time for the first proper test, so try to get
your friends over (if their schedules allow it) and try
façade together to make sure they’re all even and not to spill any canned drinks onto the new table.
nice before attempting to add it to the frame.
We didn’t do that, and instead clamped each Y ou’ll need to run a couple of power
piece to their specific side and added a few nails to
attach them. In our case, we had quite wide pieces, cables from beneath the frame to power
so we had to make sure they didn’t dip inwards
while we hammered them in. Gluing beforehand the TV and Raspberry Pi
should allow you to avoid that.
Further upgrades
12 The table looks nice, but there are always
ways for it to look nicer. You could carve the façade
Install the TV
10 Once the façade is added, turn over the
parts to make it look more ornate, and give it a coat
of dark varnish to give it a more woody look.
frame and lower your TV in. We screwed in some If the bezels on the TV you used aren’t
wide brackets to the sides of the frame to keep the particularly deep, you could also add a layer of clear
TV in place. This also means you can remove the acrylic as protection to the real screen. Finally,
TV if you need to at some point. Turn it over and maybe add carrying handles if you plan to move it
admire your handiwork. around a lot.
Interactive tabletop RPG table magpi.cc 39

TUTORIAL
Make a Scratch 3
Sense HAT game
Discover what’s new in Scratch 3 as you build this exciting
racing game, using your Raspberry Pi as a steering wheel
S
Draw the road
cratch 3 is now on Raspberry Pi, with new
blocks for the Sense HAT. In this game,
02 Hover over the icon in the bottom right to
you tilt your Raspberry Pi to turn left and open the backdrop menu. Click the option to paint a
Sean right, and use the HAT’s up and down joystick backdrop and draw a green box that fills the Stage.
MAKER
McManus controls as an accelerator. Going off-road or Add Listing 1 to Sprite1 (the cat). You’ll need to use
colliding with the computer’s racer damages the menu in the first block to set up a new message
Author of Scratch your car. Can you complete three laps before your called ‘draw road’. Click the script to test it. You
Programming in
car is too beaten up to drive? If so, how fast is should see the road is drawn with two differently
Easy Steps, Cool
Scratch Projects your qualifying time? This project will give you a coloured checkpoints at the top and bottom.
in Easy Steps, and tour through what’s new in Scratch 3, including
Mission Python. Get
free chapters at
computer speech, new sound effects, and the
extensions. Rev up!
T ilt your Raspberry Pi to
Sean’s website.
sean.co.uk steer, and use the Sense

HAT’s up and down joystick
Add extensions to Scratch
01 One of the best features of Scratch 3 is controls as an accelerator
the extensions, which enable you to add new
Draw the cars
capabilities to Scratch. For example, you can
add blocks for simple electronics, controlling
03 Hover over the icon at the bottom of the
the GPIO, video sensing, and using the Makey Sprite List to add a sprite and choose Paint. The
Makey input device. To simplify Scratch for first- vector editor is now the default. Draw an overhead
timers, the Pen and Music blocks that used to view of a race car, driving right. Centre your car on
be in the Blocks Palette have now been put into the cross-hairs target on the canvas, to make sure
extensions too. For this project, you need to add it turns correctly. Right-click your car in the Sprite
the extensions for Raspberry Pi Sense HAT, Pen, List and duplicate it. With vector images, you can
and Text to Speech. The menu to add extensions is edit the shapes and colours afterwards, so you can
You’ll Need in the bottom left. easily make the second car look different. Click
each car in the Sprite List and use the boxes above
> Raspberry Pi 4 (2GB
them to rename them to ‘player car’ and ‘rival car’.
or 4GB memory)
magpi.cc/rpi4
> Sense HAT
magpi.cc/
Start the rival car moving
sense-hat
04 The rival car is just an obstacle to avoid. Add
> Scratch 3 Desktop
magpi.cc/rNWKPO the scripts in Listing 2 to it. You’ll need to create
a new broadcast message for ‘start race’. Click the
> Pibow or other case
green flag to position the car, then click the longer
compatible with
Sense HAT script. You should see it looping around the road,
magpi.cc/bbSsQo without veering off. If needed, adjust the size of the
car in Listing 2 (and Listing 3 later) to fit both cars
> Speakers to hear
the engines roar comfortably on the road. You might need to tweak
The vertical bar chart in the middle of the LED matrix is the
speedometer. The tiny joystick is your accelerator. Tilt to steer! the positions in the glide blocks in Listing 2 too.
40 magpi.cc Make a Scratch 3 Sense HAT game

TUTORIAL
Tilt your Raspberry Pi with

a Sense HAT fitted to steer
your car around the track
Checkpoints are used to

confirm your car has gone
around the race track
Create the variables Add player movement controls

05 In Scratch 2, variables were created in the
07 You’ll steer by holding your Raspberry Pi Top Tip
Data section of the Blocks Palette. Now, it’s called up, with the Sense HAT facing you, and tilting it
Variables again, as it was in Scratch 1.4. Every left and right. You detect this axis of movement Random gliding
project now starts with a variable created called using the pitch block in the Sense HAT extension.
my variable to help newcomers experiment. You Tilting left (up to 90 degrees) gives values of 0 to We’re not using it
here, but there’s
need to make these variables: half lap count , 90. Tilting right (up to 90 degrees) gives values of
a new block to
next checkpoint , qualifying time , roadworthiness , 360 to 270. Listing 4 goes on your player’s car. It
glide to a random
row to light , row to turn off , and speed . They turns your car if your Raspberry Pi is tilted left or position, which you
can be ‘for all sprites’. Untick your variables in the right by more than 10 degrees, and uses the Sense might find handy
Blocks Palette, except for roadworthiness , which HAT joystick to trigger the blocks to change your in your games.
we want to show on the Stage. Drag its box to the speed. To make the pink blocks, click My Blocks
bottom middle of the Stage. and use the button to make your own blocks,
with the names you see in the listing. For the
touching color blocks, click the colour box in the
block and use the new, improved pipette to copy
Set up the player’s car
06 Click the player’s car in the Sprite List and
the checkpoint colours from the Stage.
add Listing 3 to it. Sense HAT and Text to Speech

are both new in Scratch 3. The display block
Add sounds
enables you to set a pixel pattern to show on the
LED matrix, using the light colours you’ve set up
08 There are fun new sounds to explore. For this
with set background and set colour blocks. At game, we need the Cheer, Coin, Car Horn, Engine,
the start, the game shows a chequered flag on the and Skid effects. Click the Sounds tab on your
Sense HAT and the computer says, “Ready, Get player’s car, and use the button in the bottom left to
Set, Go!” add them. You can now search for them by name.
Make a Scratch 3 Sense HAT game magpi.cc 41

TUTORIAL
Add speed controls

09 Find the pink hat blocks for
define increase speed and define decrease speed .
They were created for you in the Code Area when
you made those blocks in Step 7. Use them to
build Listing 5. You’ll need to create new blocks
(using My Blocks again) for ‘speed lights on’ and
‘speed lights off’. The set pixel Sense HAT block
enables you to light an individual LED using its x
and y position (both numbered from 0 to 7, from
the top left). We’re using it to turn the LED matrix
into a speedometer, with a bar graph that grows
with your speed, which can range from 0 to 8.
Scratch 3 adds new sound effects blocks. We’re
making the engine sounds higher when you speed
up. Don’t confuse the sound pitch (how low or
The vector art editor is now the default. It makes it easy to
high it is) with the Sense HAT pitch (the angle of modify the race cars to make two distinct designs
the device). Your colours in the ‘speed lights off’
script should match the Sense HAT background successfully crossed. Add Listing 6 to your existing
colour in Listing 3. Click the colour box in the define lap counter block in the Code Area. Copy
block to check the numbers. the red and yellow colours in the touching color
blocks from the Stage.
e’re turning the LED matrix into a
W
speedometer, with a bar graph that
Detect car damage
grows with your speed 11 Your roadworthiness variable is like a
health score. It goes down when you hit the grass
Add the lap counter
10 To confirm the car has done a lap of the
or the other car. The two scripts in Listing 7
continuously check whether you’ve hit something.
track, we’re using checkpoints. The car has to If you have, they reduce your score and then pause
When you lift your visit the red one, then the yellow one, and repeat briefly to stop your health sapping too fast. Use the
Raspberry Pi up to until it’s gone around three times. The next pipette to copy the exact grass colour and the main
face you, it’s still the
pitch measurement checkpoint variable remembers which checkpoint body colour of your rival car (pink in our case) into
you need if you move
it like a see-saw
the car needs to visit next. The half lap count your scripts. Listing 7 goes on the player’s car.
above the desk variable stores how many checkpoints have been
Yaw: Z Add game-over sequences

12 There are two ways for the game to end.
Either your roadworthiness gets to zero, or you
successfully complete three laps. The display text
Pitch: Y
block scrolls an appropriate message across the
Sense HAT’s LEDs. Attach Listing 8 to the end of
Listing 4, the script with movement controls on
the player’s car. Now you’re ready to play!
Top Tip
Simplifying strings
Roll: X There’s a new Operators block called apple contains a?
Use it to search a piece of text more easily.
42 magpi.cc Make a Scratch 3 Sense HAT game

TUTORIAL
DOWNLOAD
throttleandtilt.sb3 THE FULL CODE:
> Language: Scratch magpi.cc/github86
Listing 1 Listing 2 Listing 3 Listing 4
Listing 6
Listing 5 Listing 7
Listing 8
Make a Scratch 3 Sense HAT game magpi.cc 43

TUTORIAL
Build a low-cost
Part 03
wheeled robot
A wheeled robot isn’t much fun when it’s stationary. Using the
motor controller and code, it’s time to get the robot moving!
T
he previous part of this series showed for this. When it is ready, eject the microSD card
how to build a robot using a lunchbox as and put it back into the computer. Then follow the
Danny a chassis (call it Lunchbot!). While that instructions at magpi.cc/RhviuV to configure WiFi
MAKER
Staple robot looks smart, and like it might work, it’s not (in the wpa_supplicant.conf file) and enable SSH.
going to do much without code to do something
Danny makes on it. In this part, we’ll get your Raspberry Pi
robots with his kids ready for robotics and write some simple code to
as Orionrobots
Connect to your Raspberry Pi
on YouTube, and
is the author of
move the robot.
You’ll set up the microSD card for running code
02 The microSD card and USB power input on
Learn Robotics over wireless LAN, add tools to connect to the the robot’s Raspberry Pi may not be accessible.
Programming.
robot’s motor board, and write code to instruct If needed, loosen the bolts to get to it. Put the
orionrobots.co.uk the motors to turn. microSD card into the robot’s Raspberry Pi.
You can power this Raspberry Pi from a USB
cable during setup. When the lights stop flashing,
You’ll Need Lunchbot’s Raspberry Pi has booted and should
Prepare the microSD card
> Lunchbot 01 When the robot is moving, Raspberry
be ready to contact.
Raspberry Pi has a guide on finding it on
> Set of 6 × AA Pi can’t be tethered to a screen or keyboard. A the network at magpi.cc/kNOAbE. It’s called
batteries (nice and
‘headless’ configuration is needed. Headless raspberrypi.local for now, but you can change this
fresh, alkaline)
means designed to be operated via the network. A by following magpi.cc/HZGBFR.
> 16GB microSD card NOOBs or Raspbian desktop image is unsuitable Since it is headless, SSH is the right way to
> microSD card for this, so use Raspbian Lite. interact with the robot. See magpi.cc/2sLqBmM
reader Download a Raspbian Lite image from and magpi.cc/ssh for instructions on getting in.
> WiFi network magpi.cc/raspbian and burn it onto the microSD
card. Etcher (balena.io/etcher) is recommended
Installing robotics software

Figure 1 03 This robot is programmed in Python 3, using
GPIO Zero. Use SSH to access Lunchbot’s Raspberry
Pi, then install GPIO Zero with:
sudo apt-get update && sudo apt-get upgrade

sudo apt-get install python3-pip python3-gpiozero
Type python3. You should see something like:

Python 3.7.3 (default, Apr 3 2019, 05:39:12)
[GCC 8.2.0] on linux

Figure 1 A PWM square wave in action, keeping a motor at a constant speed
by turning the power on and off Type "help", "copyright", "credits" or "license"
44 magpi.cc Build a low-cost wheeled robot

TUTORIAL
Table 1
IN 1 IN 2 Motor
Low Low Off
Spin
Low High Forward
Spin
High Low Backward
High High Off
for more information.

DOWNLOAD
>>>
drive_forward.py THE FULL CODE:
Type import gpiozero to test GPIO Zero is ready.
It should not show an error. Press CTRL+D to exit. > Language: Python 3 magpi.cc/QkkmqW
Shut down your Raspberry Pi with sudo poweroff,
remove the USB power, and bolt it in place. 001. import gpiozero
002. import time
003.
004. robot = gpiozero.Robot(left=(27, 17), right=(24, 23))
Motor controller concepts 005.
04 The motor controller has two halves. Each 006. try:
half controls a motor using two outputs, using 007. # Robot actions here
power and three I/O input pins. 008. robot.forward()
The motor outputs can handle higher currents 009. time.sleep(1)
and voltage than the inputs need. Connecting 010. finally:
motors directly to Raspberry Pi would damage it. 011. robot.stop()
The enable input pins turn on half of the
controller. Labelled ENA for motor A or ENB for
motor B, they are connected with a ‘jumper wire’ Figure 2
to a 5 V line (held high) to keep the half enabled.
Each motor has two direction control pins: IN1 and
IN2 for motor A; IN3 and IN4 for motor B.
Controlling speed and direction

05 The IN pins are used in pairs to control a
motor. See Table 1 for how the pins control the
direction of the motor. You can substitute IN 3 and
IN 4 for the behaviour on the other motor.
Figure 2 PWM can control the speed of a motor by changing the on/off ratio
Build a low-cost wheeled robot magpi.cc 45

TUTORIAL
Between these lines, after the comment (starting

with a ‘#’) on line 7 is the code to make the robot
do something. This code can be swapped/changed
for different movement.
How a wheeled
robot moves. The
Driving forwards
08
dark arrows show
the direction of
the wheels; the In drive_forward.py, line 8 instructs the
green arrows show controller to drive both motors forward.
the movement of
the robot The delay on line 9 is needed so that the robot
drives for a little time before stopping the motors.
This controls the direction, but what about time.sleep() uses a time in seconds.
speed? By turning the motor power on and off Put in batteries to switch to battery power. If you
rapidly (in square waves), the ratio of time on vs don’t have a switch, use the last battery as one.
time off changes the speed of the motor. Figures 1 Use SCP to put this code on the robot or use
and 2 show how this works. This is known as Raspberry Pi to edit it. Put it in /home/pi. Give the
pulse-width modulation or PWM. The GPIO Zero robot space to drive and run the code:
library can set the direction and the PWM speed.
python3 drive_forward.py
Top Tip Not driving off the table

It should drive forward for one second and stop.
06 Robots under test have a tendency to

Press CTRL+C if it does not stop.
Have plenty of
shoot off until they hit a wall or off a desk, and
driving space
not in the direction you expect. Emergency stop
Troubleshooting driving forwards
The robot is going
to move and
measures are essential. First, ensure that motors
are always turned off. Python’s try…finally block
09 If running drive_forward.py shows errors,
needs space to do applies in almost all cases. Even if the program check everything in Step 3, and that the code is
so. Don’t test this crashes, it runs the finally code. exactly as listed.
on a tabletop!
If one motor (or both) doesn’t move, inspect the
try: motor controller wiring. Ensure the enable jumpers
pass are fitted. If the motors whine but don’t move, try
# Code that starts motors fresh batteries. If a motor goes backwards, then
finally: swap its pin numbers on line 4.
# Code to stop motors The robot may veer to one side; check the motors
are glued in well, without friction between wheels,
The other measure is an emergency stop button. axles, and robot. Some veer is unavoidable without
Python comes with such a button built-in: pressing sensors. This is when loose screws in the robot will
the keyboard combination CTRL+C will stop the show up and need fixing.
code running and enter the finally code.
Simple turns and driving backwards

Setting up robot code 10
07 The setup for robot experiments is in
The robot object in GPIO Zero makes it very
easy to do this for the simplest movements.
drive_forward.py. Use this as a template for robot Where the code has robot.forward() on line 8
code. Line 1 and 2 make the GPIO Zero and time of drive_forward.py, this can be replaced with
libraries available by importing them. robot.left(). It is only now you will find out if
GPIO Zero has a handy robot object to control you have the motors the correct way around! If the
two motors. At line 4, a robot object is created with robot drives to the right, then swap the left and
pin numbers for the motor controller. right keywords on line 4.
Lines 6 and 10 provide the stop mechanism from The robot is likely to turn too far, so reduce the
Step 6, with line 10 stopping the robot. timer value in line 9, this can be decimals, so try
46 magpi.cc Build a low-cost wheeled robot

TUTORIAL
0.3 seconds here. On line 8, try robot.right and

robot.backward too.
chaining_movements.py
> Language: Python 3
Chaining movements
11 So far, this code has been straightforward 001. import gpiozero
with a single movement. A robot can do a sequence 002. import time
of actions after each other. 003.
The code listing chaining_movements.py 004. robot = gpiozero.Robot(left=(27, 17), right=(24, 23))
shows how. By tuning the timings, this will drive 005.
in a shape such as a hexagon. 006. try:
Line 8 makes a loop, so the action will be 007. # Robot actions here
repeated. Lines 9, 10 drive forward for a little time. 008. for n in range(6):
Lines 11,12 then turn left for a bit of time too. 009. robot.forward()
Lines 13 and 14 then do a victory spin to the 010. time.sleep(0.5)
right. An excellent, fun way to end autonomous 011. robot.left()
events if you can determine a victory condition. 012. time.sleep(0.3)
013. robot.right()
014. time.sleep(1)
015. finally:
Moving at slower speeds 016. robot.stop()
12 A robot’s motors can do more than just
change direction: PWM can be used to vary the
speed. The listing speed_control.py shows how. robot’s motors can do more than just
A
Line 8 sets up a loop, in this case counting
down from 10 to 4. The speed is set in line 9 using change direction: PWM can be used to
robot.value, with the left value setting the left
motor speed, and the right value setting the right. vary the speed
Values go from zero to 1, so divide by 10. Negative
values go backwards.
Lines 12 to 15 do some turns with more precise
control than the robot.left or robot.right
speed_control.py
commands. These will be handy for sensors.
> Language: Python 3
001. import gpiozero

002. import time
003.
004. robot = gpiozero.Robot(left=(27, 17), right=(24, 23))
005.
006. try:
007. # Robot actions here
008. for speed in range(10, 4, -1):
009. robot.value = (speed/10, speed/10)
010. time.sleep(0.4)
011. # Smaller turns with forward motion
012. robot.value = (0.5, 1) # left
013. time.sleep(1)
014. robot.value = (1, 0.5) # right
015. time.sleep(1)
016. finally:
By chaining movements together, a robot can make shapes
017. robot.stop()
on the floor. Add a pen and it could draw them too!
Build a low-cost wheeled robot magpi.cc 47

TUTORIAL
The Photon Lab

Make accurate light level measurements by turning your Raspberry Pi
into a powerful scientific tool to investigate glowing materials
E
ver seen those glow-in-the-dark products?
Figure 2
With the Photon Lab, you can learn how
they work and test how effective they are.
Mike
MAKER
It can also be used for seeing how effective lights

Cook are at charging up as well, by comparing several
photoluminescent materials. Learn about the
Veteran magazine
author from the old concept of half-life, with light as safe radiation.
days, writer of the You could even see how much of an LED’s light
Body Build series, capacity is lost when it is overdriven for a length
plus co-author of
Raspberry Pi for of time.
Dummies, Raspberry
Pi Projects,
and Raspberry

Figure 2 The dual ramp converter in the light sensor chip
jPi Projects
What is photoluminescence?
for Dummies.
01 How does this work?
magpi.cc/TPaUfT
When a material gives off light, it can be
from different types of mechanisms. It seems that
02 Figure 1 shows these two processes, by
a lot of merchants on the web are confused and means of an electron energy diagram. Electrons
often their products are mislabelled. The ‘photo’ normally sit at a low energy state and can be
You’ll Need part of the word means that photons (quantum excited into higher energy states when a photon
particles of light) are responsible for supplying the hits the material. Due to the laws of quantum
> TSL2591 board energy that produces the light. Yes, light produces mechanics, the electron can only have certain
magpi.cc/Mnpiub light, but this often involves a colour change. With discrete energy levels. Once excited to one of
> OVL-5521 LED photofluorescence, light is absorbed by a material these levels, they decay in a very short time; this
magpi.cc/eKNPyQ and almost immediately generates light of another is fluorescence and is shown on the left. However,
colour. With phosphorescence, light is absorbed due to the structure of some materials, there are
> 2N4401 transistor
magpi.cc/Zsssze and then slowly releases the energy as light of metastable states. These can hold excited electrons
another colour. for much longer times – from seconds to hours –
before they decay, as shown on the right.
Figure 1
Testing phosphorescence
03 Our Photon Lab will use a TSL2591 light
sensor, but as these are hard to get hold of in
small quantities, and very tricky to solder, we
are going to use the Adafruit TSL2591 breakout
board. This chip has two light sensors: a visible
one and an IR (infrared) one, plus a dual slope A/D
(analogue to digital converter) for each sensor.
This sort of converter charges a capacitor with the
sensor’s voltage, and then discharges it through
a known resistor. Timing how long it takes to
h = Planck’s constant
discharge is a measure of the sensor’s output

Figure 1 Electron energy diagram showing how photoluminescence works voltage. See Figure 2.
48 magpi.cc The Photon Lab

TUTORIAL
Sample to test for

photoluminescence
Top Tip
The energy in
a photon
A photon carries
energy that
depends on
the frequency:
the higher the
frequency, the
more energy it has.
The frequency of a
photon defines its
The Photon Lab
colour, so a blue
sensor and LED photon has more
energy than a
red one.
Our circuit ake sure there are no light leaks by

M
04 We need the TSL2591 light sensor board,
plus an LED, to illuminate our target – and as we
are dealing with very low light levels, this needs to
using fillets of glue on both inside and
be inside a light-tight enclosure. The schematic of outside seams
our Lab is shown in Figure 3, and the physical layout
diagram is shown in Figure 4 (overleaf). The TSL259
communicates over the I2C bus and we need an LED Figure 3
to act as the excitation light. As this pin powers
up as an input, with the internal pull-up resistors
enabled, we need a 4.7 kΩ pull-down resistor to
stop the LED from lighting from switch-on.
Making the box

05 First, cut the stripboard to size and drill
the three holes in it. See Figure 5 (overleaf) for
the dimensions of the light-tight box. Glue the
wood top to the four sides made from foam-filled
mounting board. Make sure there are no light leaks
by using fillets of glue on both inside and outside
seams – we use a PVA glue for this. Cut the square
hole for the sample holder by marking it out, and
drilling a series of 3 mm holes close together round

Figure 3 The
the inside, then cutting them together with a
schematic of the
scalpel, and finally finishing with a file. Photon Lab
The Photon Lab magpi.cc 49

TUTORIAL
Figure 4
efore assembly,
B
paint everything matt
black to stop any
internal reflections
integration time, along with other things like the
file name to use to store the results. The way we
made the software work is that the keyboard key
that matches the first letter of the line controls the

Figure 4 The physical
layout of the Photon Lab
parameter. If just the key is pressed, the parameter
increases; if SHIFT and the key is held down, the
parameter decreases.
Finishing off
Top Tip 06 Solder header pins onto the TSL2591 board
and build up the sensor board. Make sure you
Using the strip The software
board as a
leave the maximum length of lead on the LED, as
this will need bending towards the target. Cut a
08 The software is shown in Photon_Lab.py.
template small notch on the base plate to allow the ribbon We decided not to use any of the existing libraries
When making
cable to exit the box. Use countersunk screws and for this chip, as it is so simple to use once you find
the box, lay the 2 mm nylon spacers to mount the stripboard, with the right I2C commands in the data sheet. The
stripboard, track 25 mm hex spacers holding the sample holder and a setGain function sets both the gain and integration
side down, on the 20 mm spacer for the board rest. Before assembly, time of each measurement with a write to a single
base, and drill paint everything matt black to stop any internal register. With the readSensor function checking
through the three
reflections in the light-tight box (Figures 6a, 6b). the status register until it indicates a measurement
holes to the wood
is finished, it then reads the four bytes which
underneath. Do
this for the sample contain the IR and visible readings. Then it kicks
holder as well. off the next reading while it processes this one.
Software design
07 For testing photoluminescence, we need
to (optionally) light up an LED to charge the
Using the software
material, and then take light readings until we
decide enough have been taken. What the software
09 First off, press the F key to bring up a dialog

Figure 5 Parts for the
Photon Lab’s box needs to do is to be able to set both the gain and box enabling you to choose the file name and path
for the results file. Press the D key to choose the
data type; the Full Spectrum option is simply the
Figure 5
addition of visible and IR sensor readings. Press the
G and I keys to set the gain and integration time;
use the SHIFT key to make these go down. The L
Figure 6a

Figure 6a Paint all the parts you can matt black

TUTORIAL
Figure 7
key toggles if the excitation LED is turned on, with
the E key determining how long it is on for, and the
S key giving the length of delay after turning off
the LED and starting the readings. This is needed
because white LEDs do not turn off very quickly.
ote that if the light is too bright

N
for the sensor, and it saturates, the
measurement will be shown as -1

Figure 7 Graph of the output using LibreOffice Calc
Making the measurements
Top Tip 10 When all the parameters are set up, the fire up LibreOffice Calc and open the CSV file you
R key will run the measurement sequence. Once have just created – click OK to accept the default
Using a UV LED the sequence gets to the point of making and import settings. The file will open in read-only
recording the light levels, a box appears in the mode, so click the Edit button. Then, select the
You can change
left-hand corner showing the sample number and first column and, holding down the SHIFT key,
the LED to an UV
the reading. When you have reached sufficient select the second column as well. Now click on the
one, for better
excitation. There samples, or the readings show you are not getting chart icon and select the X-Y scatter type of chart;
are two types of any meaningful measurements any more, you can click on your choice of points or joined line. You
UV LEDs: 395 nm press the C key to indicate your measurements are can also add axis labelling if you like, then save the
and 365 nm. While complete. Note that if the light is too bright for the spreadsheet as an ODS file – see Figure 7.
the 365 nm ones sensor, and it saturates, the measurement will be
are more effective,
shown as -1. So, back off the gain or integration
they are also a lot
more expensive. time for the next run.
Understanding the results
12 What you should see is a sudden drop in
light level followed by a much smaller drop with
What to do with your results?
11 The measurements, along with the
time. This is governed by how long photons can
stay in the metastable state. This is not a single

Figure 6b The
parameters you used, are stored in a CSV file and fixed time: it is a statistical probability, expressed
assembly of the
Photon Lab can be opened by any spreadsheet application. You as the amount of time it takes for half of the
electrons to decay. This is known as the half-life
Figure 6b of the metastable state. You might have heard of
half-life in relation to radioactivity; this is exactly
the same sort of measure. However, your curve
is further complicated by the fact there are often
several metastable states in any material, all
having different half-lives.
We have put some teacher’s notes on our GitHub

page to allow you to explore the subject in a
teaching environment. You can test several
different types of glow-in-the-dark materials,
as well as the miniature glow sticks used for
fingernail decoration. These might require samples
taken at a less regular interval than the software
shown here, but the inclusion of a delay after the
sample has been taken will do that. So, let’s not be
in the dark about low light level measurements.

TUTORIAL
Photon_Lab.py DOWNLOAD
THE FULL CODE:
> Language: Python magpi.cc/dhaAam
001. #!/usr/bin/env python3 052. done = True

002. # Photon Lab 053. bus.write_byte_data(luxAdd, 0xA0, 0x01)
003. # By Mike Cook August 2019 054. adc = bus.read_i2c_block_data(luxAdd,0xA0 | 0x14,4)
004. 055. ch[0] = adc[1] << 8 | adc[0] # IR
005. from smbus import SMBus 056. if ch[0] == 0xffff: # overflow check
006. import RPi.GPIO as io 057. ch[0] = -1
007. import os, pygame, sys, time 058. ch[1] = adc[3] << 8 | adc[2] # Visible
008. from tkinter import filedialog 059. if ch[1] == 0xffff:
009. from tkinter import * 060. ch[1] = -1
010. 061. ch[2] = -1
011. pygame.init() 062. if ch[0] != -1 and ch[1] != -1:
012. os.environ['SDL_VIDEO_WINDOW_POS'] = 'center' 063. ch[2] = ch[0] + ch[1] # Full spectrum
013. pygame.display.set_caption("Photon Lab") 064. if enabledS : # start new conversion cycle
014. pygame.event.set_allowed(None) 065. bus.write_byte_data(luxAdd, 0xA0, 0x03) # next
015. pygame.event.set_allowed([pygame.KEYDOWN,pygame.QUIT]) 066. sampleTime = time.time() - startTime
016. sWidth = 500 ; sHight = 200 ; bk = (0,0,0) 067. sampleNumber += 1
017. screen = pygame.display.set_mode([sWidth,sHight],0,32) 068.
018. textHeight = 22;font=pygame.font.Font(None,textHeight) 069. def init():
019. backCol = (200,130,0);displayUpdate=True;running=False 070. global luxAdd, bus, gain, dataType, intgTime,gainT
020. 071. global ledOn, exiTime, fileName, startDelay, logo
021. def main(): 072. global sampleNumber, dataTypeT, intgTimeT, ch
022. global displayUpdate, sampleTime, enabledS 073. bus = SMBus(1) # use bus 1
023. init() 074. luxAdd = 0x29 # address of TSL2591
024. while 1: 075. io.setmode(io.BCM); io.setwarnings(False)
025. while not running: # set up parameters 076. io.setup(4,io.OUT) ; io.output(4,0)
026. time.sleep(0.2) ; checkForEvent() 077. # confirm we have a sensor attached
027. if displayUpdate: 078. print("Checking for TSL2591 sensor")
028. drawScreen(); displayUpdate = False 079. sec = bus.read_byte_data(luxAdd, 0xA0 | 0x12) # ID
029. # prepare to run 080. if sec != 0x50:
030. data_file = open(fileName,'w') 081. print("TSL2591 not found")
031. data_file.write("Time,"+dataTypeT[dataType]+", 082. else :
"+gainT[gain]+",Integration time:- "+intgTimeT[intgTime] 083. print("TSL2591 found")
+",Excitation time "+str(exiTime)+",Start delay:- " 084. gain = 2 ; intgTime = 1 ;setGain() ;ledOn = True
+str(startDelay/10)+" seconds \n") 085. gainT = [
032. if ledOn : # Excitation phase "low gain","medium gain","high gain","maximum gain"]
033. io.output(4,1);time.sleep(exiTime) 086. intgTimeT = [
034. io.output(4,0);time.sleep(startDelay/10) "100 mS","200 mS","300 mS","400 mS","500 mS","600 mS"]
035. sensorEnable() # start up sensor 087. dataTypeT = ["IR","Visible","Full spectrum"]
036. sampleTime=time.time() 088. exiTime = 2 ; dataType = 2 ; startDelay = 1
037. while running: # put samples in a file 089. ch = [0,0,0]; sampleNumber = 0
038. readSensor() 090. fileName = "/home/pi/my_data.csv"
039. data_file.write(str("%.3f" % round( 091. logo = pygame.image.load(
sampleTime,3)+","+str(ch[dataType])+"\n")) "images/Logo.png"). convert_alpha()
040. updateScreen( 092.
str(ch[dataType])); checkForEvent() 093. def sensorEnable():
041. data_file.close() # finished run 094. global enabledS,sampleNumber, startTime
042. enabledS = False # shut down the light sensor 095. bus.write_byte_data(luxAdd, 0xA0, 0x03) # AEN on
043. readSensor() # remove the last reading 096. enabledS = True; sampleNumber = 0
044. sensorDisable() # shut it down 097. startTime = time.time()
045. 098.
046. def readSensor(): 099. def sensorDisable():
047. global ch0,sampleTime, sampleNumber 100. global enabledS
048. done = False 101. bus.write_byte_data(luxAdd, 0xA0, 0x01) # AEN off
049. while not done: 102. enabledS = False
050. status = bus.read_byte_data(luxAdd, 0xA0 | 0x13) 103.
051. if status & 1 == 1: 104. def setGain(): # gain 00 to 11 - inter 000 to 101
The Photon Lab magpi.cc 53

TUTORIAL
Photon_Lab.py (continued)
> Language: Python
105. bus.write_byte_data(luxAdd,0xA1,(gain<<4)|intgTime) 157. screen.blit(textSurface, textRect)

106. 158.
107. def constrain(val, min_val, max_val): 159. def terminate(): # close down the program
108. return min(max_val, max(min_val, val)) 160. print ("Closing down")
109. 161. sensorDisable() ; io.cleanup()
110. def wrap(newVal,min_val, max_val): 162. pygame.quit() # close pygame
111. retVal = newVal 163. os._exit(1)
112. if newVal < min_val : 164.
113. retVal = max_val 165. def checkForEvent(): # see if we need to quit
114. if newVal > max_val : 166. global gain, intgTime, displayUpdate, dataType
115. retVal = min_val 167. global running, startDelay, exiTime, ledOn
116. return retVal 168. event = pygame.event.poll()
117. 169. if event.type == pygame.QUIT :
118. def getFileName(): 170. terminate()
119. global fileName 171. if event.type == pygame.KEYDOWN :
120. root = Tk() 172. if event.key == pygame.K_ESCAPE :
121. root.filename = filedialog.asksaveasfilename( 173. terminate()
initialdir = "/home/pi",title = "file to save data to", 174. if event.key == pygame.K_c : # data run Complete
filetypes = (("csv files","*.csv"),("all files","*.*"))) 175. running = False
122. temp = root.filename 176. displayUpdate = True
123. if len(temp) >3 : 177. if not running: # don't look if running
124. fileName = temp 178. displayUpdate = True
125. root.withdraw() 179. if event.mod == pygame.KMOD_LSHIFT or event.mod
126. == pygame.KMOD_RSHIFT :
127. def updateScreen(data): 180. inc = -1
128. white = (255,255,255) 181. else:
129. pygame.draw.rect(screen,white,(320,16,115,45),0) 182. inc = 1
130. drawW("Sample "+str(sampleNumber),335,20,bk,white) 183. if event.key == pygame.K_g : # gain
131. drawW("Value "+data,335,40,bk,white) 184. gain += inc
132. pygame.display.update() 185. gain = constrain(gain,0,3)
133. 186. setGain()
134. def drawScreen(): 187. if event.key == pygame.K_i: #integration time
135. screen.fill(backCol) 188. intgTime += inc
136. screen.blit(logo, (5,5) ) 189. intgTime = constrain(intgTime,0,5)
137. if running : 190. setGain()
138. drawW("Complete measurements ",15,60,bk,backCol) 191. if event.key == pygame.K_d: # data type to use
139. else: 192. dataType += inc
140. drawW("Run measurements ",15,60,bk,backCol) 193. dataType = wrap(dataType,0,2)
141. drawW("Data type :- "+dataTypeT[dataType], 194. if event.key == pygame.K_l : # excitation LED
15,80,bk,backCol) 195. ledOn = not ledOn
142. drawW("Gain mode :- "+gainT[gain],15,100,(0,0,0),backCol) 196. if event.key == pygame.K_e : # excitation time
143. drawW("Integration time :- "+intgTimeT[intgTime], 197. exiTime += inc
15,120,bk,backCol) 198. exiTime = constrain(exiTime,0,13)
144. if ledOn: 199. if exiTime == 0:
145. drawW("Led on :- Excitation time "+str(exiTime)+ 200. ledOn = False
" seconds",15,140,bk,backCol) 201. else:
146. else: 202. ledOn = True
147. drawW("Led off",15,140,bk,backCol) 203. if event.key == pygame.K_f : # file name
148. drawW("Start delay :- "+str(startDelay/10)+ 204. getFileName()
" seconds",15,160,bk,backCol) 205. if event.key == pygame.K_s : # start delay
149. drawW("File name :- "+fileName,15,180,bk,backCol) 206. startDelay += inc
150. pygame.display.update() 207. startDelay = constrain(startDelay,0,20)
151. 208. if event.key == pygame.K_r : # run
152. def drawW(words,x,y,col,backCol) : # drawWords 209. running = True
153. textSurface = font.render(words,True, col,backCol) 210.
154. textRect = textSurface.get_rect() 211. # Main program logic:
155. textRect.left = x # right for align right 212. if __name__ == '__main__':
156. textRect.top = y 213. main()

TUTORIAL
Tree views
Part 06
with C and GTK

Use the GtkTreeView widget to display information and user input options
A
s mentioned in part five, using a list store g_signal_connect (win, "delete_event",
for a combo box can sometimes be overkill G_CALLBACK (end_program), NULL);
– although in some circumstances, it is
exactly the right thing to do! But the situation for int pos = 0;
Simon which a list store is really designed is as the data
MAKER
Long store for a widget called a GtkTreeView – a table GtkListStore *ls = gtk_list_store_new (2,
of data arranged in columns. The table can show G_TYPE_STRING, GDK_TYPE_PIXBUF);
Simon Long images as well as text, and can even contain other GdkPixbuf *icon = gtk_icon_theme_load_icon (
is a software
widgets, such as check buttons, alongside the data. gtk_icon_theme_get_default (), "dialog-ok-apply",
engineer working
for Raspberry Pi, 32, 0, NULL);
responsible for Creating a tree view gtk_list_store_insert_with_values (ls, NULL,
the Raspberry
To demonstrate this, we’re going to create a new list pos++, 0, "Option 1", 1, icon, -1);
Pi Desktop on
both Raspbian store with two entries per row, a text string, and an gtk_list_store_insert_with_values (ls, NULL,
and Debian. icon. Here’s the code to do that: pos++, 0, "Option 2", 1, icon, -1);
rpf.io gtk_list_store_insert_with_values (ls, NULL,
void main (int argc, char *argv[]) pos++, 0, "Option 3", 1, icon, -1);
{
gtk_init (&argc, &argv); GtkWidget *tv = gtk_tree_view_new_with_model (
GTK_TREE_MODEL (ls));
GtkWidget *win = gtk_window_new (
GTK_WINDOW_TOPLEVEL); GtkCellRenderer *prend =
GtkWidget *btn = gtk_button_new_with_label ( gtk_cell_renderer_pixbuf_new ();
"Close window"); GtkCellRenderer *trend =
g_signal_connect (btn, "clicked", gtk_cell_renderer_text_new ();
G_CALLBACK (end_program), NULL);
gtk_tree_view_insert_column_with_attributes (
GTK_TREE_VIEW (tv), -1, "Icon", prend, "pixbuf",
1, NULL);
An Introduction gtk_tree_view_insert_column_with_attributes (
to C & GUI GTK_TREE_VIEW (tv), -1, "Option", trend, "text",

0, NULL);
Programming
GtkWidget *tbl = gtk_table_new (2, 2, FALSE);
For further tutorials on how to start coding gtk_table_attach_defaults (GTK_TABLE (tbl), tv,
in C and creating GUIs with GTK, take a 0, 2, 0, 1);
look at our new book, An Introduction to gtk_table_attach_defaults (GTK_TABLE (tbl),
C & GUI Programming. Its 156 pages are btn, 0, 1, 1, 2);
packed with all the information you need
gtk_container_add (GTK_CONTAINER (win), tbl);
to get started – no previous experience of
gtk_widget_show_all (win);
C or GTK is required!
magpi.cc/GUIbook gtk_main ();
}
56 magpi.cc Tree views with C and GTK

TUTORIAL
First, we call gtk_list_store_new to create a two- 1, NULL);

column list store; column 0 contains a text string, gtk_tree_view_insert_column_with_attributes (
as in the previous part, while column 1 contains a GTK_TREE_VIEW (tv), -1, "Option", trend, "text",
pixbuf (short for ‘pixel buffer’), which is used to 0, NULL);
store an image.
Each call to gtk_tree_view_insert_column_with_
GtkListStore *ls = gtk_list_store_new (2, attributes takes the tree view itself as the first
G_TYPE_STRING, GDK_TYPE_PIXBUF); argument. The second argument is the position of
the column – this can either be the actual position,
We then create a GdkPixbuf with a small image in it numbered from 0 at the left-hand side of the table,
– in this case, we load an icon from the current icon or as here, -1, which indicates that the column
theme into it, but a GdkPixbuf can store any sort of should be added as the next column; that is to the
image you choose to display. right of the rightmost column already in the table.
GdkPixbuf *icon = gtk_icon_theme_load_icon (

gtk_icon_theme_get_default (),
T he situation for which a list store is
"dialog-ok-apply", 32, 0, NULL); really designed is as the data store
We add three rows to the list store – in each case, we for a widget called a GtkTreeView
put a text string into column 0 of the row, and the
pixbuf we created into column 1. The next parameter is the title for the column
(which can be shown at the top of the table), and
gtk_list_store_insert_with_values (ls, NULL, then the renderer we’ve created to be used for
pos++, 0, "Option 1", 1, icon, -1); the column.
gtk_list_store_insert_with_values (ls, NULL, The final arguments are passed to the cell
pos++, 0, "Option 2", 1, icon, -1); renderer itself, and set an attribute of the renderer
gtk_list_store_insert_with_values (ls, NULL,
pos++, 0, "Option 3", 1, icon, -1); Figure 1
We now need to create a GtkTreeView to display

the list store. The first step of this is similar to
the creation of a GtkComboBox in the previous
part – we associate the new GtkTreeView with the
GtkListStore we just created.
GtkWidget *tv =
gtk_tree_view_new_with_model (
GTK_TREE_MODEL (ls));
As with the combo box, we need to create cell

renderers for all the types of data we want to
display; in this case, we have two – a text renderer
and a pixbuf renderer.
GtkCellRenderer *prend =
gtk_cell_renderer_pixbuf_new ();
GtkCellRenderer *trend =
gtk_cell_renderer_text_new ();
Finally, we insert the columns we want to see into

the tree view.
Figure 1 A
GtkTreeView with
two columns
gtk_tree_view_insert_column_with_attributes (
– a pixbuf and
GTK_TREE_VIEW (tv), -1, "Icon", prend, "pixbuf", some text
Tree views with C and GTK magpi.cc 57

TUTORIAL
Figure 2
GtkTreeModel *model;
GtkTreeIter iter;
char *option;
sel = gtk_tree_view_get_selection (
GTK_TREE_VIEW (wid));
if (gtk_tree_selection_get_selected (
sel, &model, &iter))
{
gtk_tree_model_get (model, &iter, 0,
&option, -1);
printf ("The selected row contains the
text %s\n", option);
}
}
Finding out which row is selected requires an

iterator – a data structure which stores the location
of a row in a list store. First we need to get the
Figure 2 A GtkTreeSelection for the tree view – this stores
GtkTreeView with
which row (or rows) are currently highlighted.
a row selected by
the user
sel = gtk_tree_view_get_selection (
to the data in a certain column of the list store – in GTK_TREE_VIEW (wid));
the first instance we set the pixbuf attribute of the
pixbuf renderer to the data in column 1, and in the From a GtkTreeSelection, we then get the
second we set the text attribute of the text renderer GtkTreeIter and GtkTreeModel associated with it.
to the data in column 0. (Because it is possible to The tree model is the list store which is providing
set multiple attributes on some renderers, the final the data for the tree view, and the iterator is the
argument is a NULL, to indicate that there are no actual row selected.
more attributes to set.)
Build and run the code, and see what happens – if (gtk_tree_selection_get_selected (sel,
you should see something like Figure 1. &model, &iter))
Getting input from a tree view (This function returns FALSE if there is no valid
A tree view is useful as a display of information, selection – it’s important to check for this as
but it can also be used to read user selections. If otherwise the next line will cause a crash if no row is
you click on one of the rows in the table, it will be selected.) Finally, we can get the actual values from
highlighted – you can also move the highlight up the model and iterator.
and down through the table with the arrow keys on
the keyboard (Figure 2). gtk_tree_model_get (model, &iter, 0, &option,
Whenever the selected row is changed, the -1);
cursor-changed signal is generated by the tree view,
so this can be used to call an appropriate callback: As when setting a value in a list store, the
arguments to this function, after the model and
g_signal_connect (tv, "cursor-changed", iterator, are a list of paired values, the first of each
G_CALLBACK (row_selected), NULL); pair being the column to be read, and the second
being a pointer to which the data should be written.
The callback should be as follows: Multiple values can be read from the same row with
a single call, so -1 is used for the column value of
void row_selected (GtkWidget *wid, the final entry in the list, to show there are no more
gpointer ptr) values to read.
{ In this case, a pointer to the text in the first
GtkTreeSelection *sel; column of the selected row is returned as option.
58 magpi.cc Tree views with C and GTK

STRATO PI CM DUO
Dual SD card: for the first time on an industrial Raspberry Pi CM based device!
Strato Pi CM Duo is the perfect solution for high-reliability systems - featuring two distinct SD cards with
high-speed switching matrix for separate OS/data storage, redundancy and in-field full-system upgrades.
Fault tolerance is further enhanced by:

- Regulated wide-range power supply
- Hardware watchdog with boot SD switch control
- Power-controlled USB ports
Additional features:
- Opto-isolated RS-485 serial interface
- Real-Time Clock with a replaceable backup battery
- Secure element
All of this in a compact DIN-rail case!
www.sferalabs.cc
TUTORIAL
Add game music

Part 04
and SFX in PICO-8

Use PICO-8’s built-in synthesizer to create space-age sound effects and
get your pulse pounding by composing some bangin’ retro chiptunes
P
ICO-8 comes with a comprehensive and them with the top-left button. Generally, they
surprisingly versatile set of music and both show the same information, and both have
sound effect editors. Featuring eight synth the same speed, loop, and instrument selectors.
Dan
MAKER
instruments and seven built-in effects – including The number at the top left is the index of the
Lambton-Howard
slides, vibrato, and arpeggiators – it is an current SFX you are editing. Toggle to index 0 and
Dan is an accessible and easy way to make everything from let’s get started.
independent game retro bleeps and bloops, up to entire chiptune
designer based in symphonies. We’ll walk you through each of the
Newcastle upon
Tyne, where he is
editors as we make some simple sound effects
Pew pew pew!
lucky enough to
make games for
for our space shooter game. Then, we’ll put some
loops together to explore the basics of writing a
03 We think our space shooter could do with an
his PhD.
retro techno soundtrack. All together now! old-school laser sound, don’t you? To achieve this
@danhowardgames in pitch mode, draw a descending series of about
eight notes (Figure 1). You can use any instrument
you want, but we’ve alternated between square and
An anatomy of sound
01 Let’s start with understanding how PICO‑8
pulse waves to give a little retro warble. We’ve also
used noise for the last two notes, to create a sense
handles audio. A PICO-8 cartridge can hold up of impact. Hit the SPACE bar at any point to play
to 64 sound effects (SFX). These SFX are used your SFX. We’ve chosen our SFX speed as 2 (1 is the
DOWNLOAD for everything from gameplay sounds, like the quickest), but play around to see what works.
THE FULL ‘boing’ you hear when jumping in a platformer,
CODE: to backing tracks and incidental music. Each
e think our space shooter
W
SFX consists of 32 notes and each note contains
magpi.cc/fB0ksD
information about its pitch (how high or low), its
instrument (the overall timbre and aural quality),
could do with an old-school
its volume (you guessed it), and effect (how that laser sound, don’t you?
note is altered or modified). You can make a lot of
noise with eight little bits!
Impactful audio
04 To see how your laser sound works in game,
You’ll Need add SFX(0) after the call to create_laser() around
The editors
> PICO-8
02 Load up the space shooter game we’ve been
line 35. Reload your game to hear it in action. It
really is that easy. Now, repeat this process to
magpi.cc/pico8 building, and switch to the SFX editor. The first make an explosion sound. For ours, we’ve used
> Raspberry Pi thing to know is that there are two modes. Pitch around ten notes, starting with deep square wave,
mode allows you to plot notes with the mouse and a surge of noise, then finishing on higher-pitched
> Keyboard and
mouse is best for creating sound effects, whilst tracker saw wave. This creates an initial impact noise and
mode is more suited to music. Toggle between ends on a retro, dopamine-inducing chime. Visit
60 magpi.cc Add game music and SFX in PICO-8

TUTORIAL
Figure 1

Figure 1 Here’s the same laser zap sound viewed in pitch mode (left) and tracker mode (right)
the project’s GitHub repository (magpi.cc/fB0ksD)

to hear it in action. Now, add your explosion SFX in
code alongside wherever we create explosions.
Tracker mode
05 Now we’ve got some retro zaps and booms,
let’s move onto the soundtrack. Toggle the editor to
tracker mode. This mode is better for writing music
as it is easier to see the relative spacing and timings
of notes, as well as to adjust individual properties
of each note. You will also be able to see the grey
effect selector buttons in this view. Notes might
look like a baffling array of letters and numbers, but
are actually quite simple. Each line shows the pitch
(A–G#), octave (0–5), instrument (0–7), volume
(0–9), and effect (0–7) of a note.
Kick and snare

06 To write notes in tracker mode, you need to
actually play notes with your keyboard, just like a
piano – see the layout in Figure 2 (overleaf). Have
a little play around; you can hit SPACE to play
your creation and if you set the loop controls to
0 and 32, it will play through all 32 notes before
restarting. Once you’re comfortable, plot a simple
PICO-8’s interface lets Triangle wave, saw wave, pulse
drum beat. Use C1053 for a nice kick-drum sound, you draw out SFX with wave, noise, and more. The
and C3655 for a punchy snare. We’ve gone for a a drag of a mouse complete synthesis starter kit
pretty standard rock beat with a speed of 12.
Add game music and SFX in PICO-8 magpi.cc 61

TUTORIAL
Figure 2
Figure 2 Use this

handy reference
and soon you’ll be
playing your PICO‑8
like Beethoven
The full kit and caboodle

Top Tip 07 Next, you might want to make a few
four SFX, which are shown in the boxes below, and
when it has finished playing, will move onto the
variations on this basic beat and save these as new next pattern. You can also use the controls on the
Use shortcuts SFX. To make things easier, you can copy and paste top-right to set patterns to stop, or loop back to a
individual notes or whole sections. Use CTRL+A to previous pattern.
The keyboard select an entire SFX. To help, a high note with fade
shortcuts for
out (5) makes a great hi-hat, and mid notes with
PICO-8 will really
speed up your
the drop effect (3) work for toms. Layer it up! You
Tub thumping
workflow. Check
the manual for the
can keep the SFX playing as you add notes and play
around. Once you’ve made three or four variations,
09 Start adding your drum beat SFX to the
full list. we’ll use the music editor to put them together leftmost slot of the first few patterns. You can see
into a composition. the index above the slot. Hit SPACE on the first
pattern and you should hear your beat played,
followed by the beat in the next pattern and so on.
We’ve started with minimal drums for patterns
Seeing patterns
08 The music editor is where the magic
0–3, moved into fuller percussion for 4–7, and built
our composition from there. Now, obviously, there
happens. It’s where individual SFX are layered is more to music than drums (though it’s a good
and combined to make music. Switch to it now, place to start), so we’ll need to create some bass,
and take a look. You’ll see a list of patterns at the rhythm, and melodies next. Cue the music!
top of the screen. Each pattern can contain up to
T ry playing around with
volumes and effects
to make notes more
interesting and dynamic
Thank you for the music
10 You probably don’t need us to tell you that
low notes work well for bass, and high and mid
octaves work for melodies and harmonies. For
now, concentrate on creating an SFX for each.
You can start adding these (and looping them) in
your music editor to see how they work together.
It might not look like
much, but hit the Try playing around with volumes and effects to
SPACE bar and you’ll
make notes more interesting and dynamic. We’ve
hear a perfect retro
explosion, boom! created a simple repetitive bassline to run through
62 magpi.cc Add game music and SFX in PICO-8

TUTORIAL
C
omposers like Chris
‘Gruber’ Donnelly
have produced entire
albums on PICO-8,
a testament to the
versatility of the tool
P
ICO-8’s music editor in full swing. Here it is playing our
composition on three of the four available audio channels
most of the composition, and a catchy melody for

the dynamic peaks. Download the cartridge from
the project’s GitHub repository to hear it.
Stops and starts

11 So now your masterpiece is composed,
we need to get it into the game. Simply add
music(0) to _init() and reload your game. Et
voilà, your tune is now blasting out into space.
For extra brownie points, you can add music(-1)
to your code when game-over is triggered. This
will stop the music from playing when the player
is defeated. Or even better, why not compose a
whole new game-over theme tune? Attempt to
capture the sombre feeling of humanity’s last
hope being snuffed out, in 8-bit.
Deep cuts
12 We’ve barely scratched the surface of Top Tip
what you can do with sound effects and music
with PICO-8. But you should have a good enough Only four
grasp of the tools to start exploring the creative
channels
potential of this little virtual console. If you PICO-8 only
want to go deeper, we highly recommend Chris has four audio
‘Gruber’ Donnelly’s series of video tutorials: channels,
magpi.cc/OngdaS. To add to the possibilities, a meaning only
recent PICO-8 update introduced SFX instruments, four SFX can be
playing at any one
allowing makers to define and experiment with
time, including
their own instruments on top of the basic eight. in music.
Plenty to get your teeth stuck into.
Add game music and SFX in PICO-8 magpi.cc 63

TUTORIAL
Access Raspberry Pi over

the internet with VNC
Set up Raspbian so you can remote access Raspberry Pi from
any other machine on your network or over the internet
T
here will be times when you can’t or If you haven’t changed Raspbian’s password
don’t want to switch to your Raspberry Pi. from the default ‘raspberry’, now is a good time
Perhaps you’re using another computer, or to do so. Click the Change Password button and
Lucy
MAKER
your Raspberry Pi is out of reach, behind your TV enter a new one.

Hattersley or a nest of cables. Or you’re on the road and have Now click the Interfaces tab, and set the radio
left your Raspberry Pi at home. button next to VNC to Enabled. Click OK.
Lucy is the editor
of The MagPi. She Fortunately, with VNC (Virtual Network A VNC button appears in the top right of the
has a Raspberry Pi Computing) – free for non-commercial use and screen, at the end of the menu bar. Click it to
hooked up at home built into the Raspbian operating system – you open VNC Server.
that she uses VNC
to access, wherever
can access Raspberry Pi remotely from any other Your IP (internet protocol) address will appear
she is in the world. computer, tablet, or smartphone. Either on your in the VNC Server Window (below Connectivity).
magpi.cc home network, or via the internet. Note down the four numbers; they enable you to
In this walkthrough, we’ll be using VNC locate your Raspberry Pi over the network.
Viewer and VNC Server to connect on the fly
to a Raspberry Pi from a Windows PC and an
Android smartphone.
Open VNC Viewer
02 You’re now ready to connect to your
Raspberry Pi from another computer. We’re going
Enable VNC
You’ll Need 01 First, Make sure both your Raspberry Pi
to use a Windows PC, but you can connect from a
Mac, Linux PC, or even another Raspberry Pi on the
and the other computer you’re going to use are same network.
> Raspberry Pi with
connected to the same network. Because we’re using VNC Server on Raspberry Pi,
Raspbian
In Raspbian, click the applications menu icon it makes sense to use VNC Viewer on the Windows
> Network and (raspberry) at the top-left of the screen and select PC. VNC Viewer is available for macOS, Linux,
internet connection
Preferences > Raspberry Pi Configuration. Android, and iOS platforms, along with a web
> VNC Server and interface. Head to RealMac (magpi.cc/hTpNBm)
VNC Viewer and click Download VNC Viewer. Install and open
the software.
Connect to Raspberry Pi
03 Enter the IP address of your Raspberry Pi
(the four numbers displayed in VNC Server) into
Activate VNC Server the search bar of VNC Viewer (the part saying
on your Raspberry ‘Enter a VNC Server address or search’). Press
Pi with Raspberry
Pi Configuration RETURN to connect to Raspberry Pi.
tool. Choose the
The first time you do this, a window will appear
Interfaces tab and
set VNC to Enabled with a warning: ‘VNC has no record of connecting
64 magpi.cc Access Raspberry Pi over the internet with VNC

TUTORIAL
These buttons appear in VNC

Viewer when you hover the mouse
VNC Viewer is displaying the
near the top of the window. They
Raspbian desktop inside a
enable you to switch to full-screen
Windows PC desktop environment.
mode, adjust the zoom settings,
VNC Server is running on Raspberry
transfer files, and adjust settings
Pi and you can see the small icon
for it to the right of the menu bar
to this VNC Server so its identity cannot be

checked’. Click Continue.
Y ou need to enter the username
You need to enter the username (typically (typically ‘pi’) and password for your
‘pi’) and password for your Raspberry Pi. Click
on Remember Password and then OK to connect Raspberry Pi
to Raspbian.
Looking at properties
05 You can access Properties from the menu Top Tip
Remote control
04 A window appears on your Windows PC
at the top of the VNC Viewer preview window, but
we’re going to close down the preview window to Technical
displaying the Raspbian desktop interface from access it from VNC Connect. Click End Session in information
your Raspberry Pi. Move the mouse around the the drop-down menu and Yes to disconnect.
window and you’ll see the mouse moving around VNC Viewer now displays a small preview of your You can find a
wealth of detailed
on your Raspberry Pi. You can now use this window Raspberry Pi desktop in the Address Book, along
information on the
to control your Raspberry Pi over the network (just with the IP address. You can double-click this
RealVNC website.
as if you were sitting in front of it). at any time to reopen the connection – but first, Take a look at
Hover the mouse at the top of the VNC Viewer right-click and choose Properties. this Technician’s
window and a menu will drop down from the top Enter ‘Raspberry Pi’ in the Name window; Guide PDF:
of the screen. To the left of the Options is Enter this will make your screen friendlier. Now magpi.cc/JiSeZX
Full Screen; click it and the preview window click Options. The Picture Quality setting is
will take over the screen. Your Raspberry Pi set to Automatic by default. If you have a slow
display may not fit your PC display, so click connection, try setting it to Low; alternatively, if
the Scale button in the menu (so it’s set to you have a fast connection, set it to High.
Scale Automatically). Finally, take a look at the Expert tab. Here you
You will now be able to open apps and use your can find a variety of settings for all aspects of the
Raspberry Pi as if you were working directly on the system. Scroll down to find FullScreen and set
small computer. the drop-down menu below from False to True.
Access Raspberry Pi over the internet with VNC magpi.cc 65

TUTORIAL
VNC Viewer
displays the
Raspbian desktop
interface remotely
Now when you open Raspberry Pi in VNC Viewer, ith a RealVNC account,
W
Top Tip the preview window will automatically be in full-
screen mode. Choose the options you prefer and you can access your
Speed it up click OK to set them.
Raspberry Pi across the
If your remote
Raspberry Pi feels wider internet
sluggish, hover at Get online
the top of the VNC 06 So far we’ve been working on our local password generator (rempe.us/diceware). Follow
Viewer window
network. With a RealVNC account, you can access the rest of the setup process and click on the email
and click the cog
on the menu that your Raspberry Pi across the wider internet. authentication when it arrives.
appears, then Open VNC Viewer on your PC and click the Sign
reduce the picture In button on the top left. It’s most likely that you
quality on the don’t have an account already, so click ‘Sign up
Options tab.
Sign in
online’. This will take you to the RealVNC website.
Enter your email address and click the ‘I’m
07 Now you need to sign in with the same
not a robot’ checkbox. Now create a password. account on both VNC Viewer on your PC and VNC
Please choose a long and complex password that Server on Raspberry Pi.
is not easy to guess. We suggest using a Diceware The Sign In window should still be displayed
in the Sign In window in VNC Viewer on your
PC. Open VNC Server on your Raspberry Pi and
click Sign In to enable the cloud connectivity
link (displayed just below your IP address
under Connectivity).
Return to VNC Viewer on your PC. You’ll still
see a Raspberry Pi window in the Address Book
section, but below it you’ll see an option called
Team (it will appear with your name). Click this
to see your Raspberry Pi again. However, this is
Use File Transfer to the connection using your VNC Connect account.
send and retrieve
files from your
Double-click it to launch into your Raspbian
Raspberry Pi desktop and remote control.
66 magpi.cc Access Raspberry Pi over the internet with VNC

TUTORIAL
Top Tip
Got a Mac?
Mac users must
change the
Authentication
protocol to
VNC password
to connect
using macOS’s
native tools.
VNC Server displays

your IP address and
is used to log your
Raspberry Pi to VNC
Connect (so you can
access Raspberry
Pi via the wider
internet)
The difference? This account works remotely, Your Raspberry Pi is now set up for remote
and you can use this from other networks. access. It’s now perfectly possible to remove the
screen and keyboard from your Raspberry Pi
and leave it on the network. It’ll be there waiting
for you to connect from your PC whenever
Send files
08 You can send and receive files from your
you’re ready.
Raspberry Pi and PC. We’ve created a blank test

document in our Documents folder called test.txt.
Android and iOS
To send the file to your Raspberry Pi, access
Raspberry Pi using VNC Viewer. From the VNC
10 It is also possible to connect to Raspberry
Viewer preview window, click the menu at the top Pi remotely from your smartphone. Use the VNC
of the screen and choose Transfer Files. Viewer app for Android or iOS – download it from
Now click Send Files in the VNC Viewer – File the Google Play Store or Apple App Store. Open
Transfer window. Use the file picker to choose a and sign in using your VNC Connect account email
file on your PC and click Open. The file will be sent and password.
to the desktop of your Raspberry Pi. A File Transfer You will see your Raspberry Pi under the Team
window will appear with ‘Download complete’; menu. Click it and enter the username and
close it. password for your Raspberry Pi.
When it first launches, you’ll need to run
through the ‘Control the computer’ process.
Click on Next and it will open the ‘How to
Retrieve files
09 You can retrieve a file from your Raspberry
control’ window. This screen outlines how to
perform gestures such as mouse clicks from the
Pi using VNC Viewer, although the process is touchscreen. Close this window and start using
slightly different. This time, right-click the VNC Raspberry Pi from your phone.
Server icon in Raspbian’s menu bar. Choose File Use the touchscreen to move the pointer around.
Transfer from the drop-down menu to open the A virtual keyboard is accessed by tapping the
VNC Server – File Transfer window. Keyboard icon at the top of the app window.
Click Send Files and choose a file on your You can now access Raspberry Pi from
Raspbian file system. Click OK to send the file to anywhere, including your phone. A great solution
the desktop on your Windows PC. for remote monitoring.
Access Raspberry Pi over the internet with VNC magpi.cc 67

SUBSCRIPTION
SUBSCRIBE TODAY
FROM ONLY £5
Subscriber Benefits
FREE Delivery
Get it fast and for FREE
Exclusive Offers
Great gifts, offers, and discounts
Great Savings
Save up to 35% compared to stores
Rolling Monthly Subscription

Low monthly cost (from £5)
Cancel at any time
Free delivery to your door
Available worldwide
Subscribe for 12 Months

£55 (UK) £90 (USA & Rest of World)
£80 (EU)
Free Raspberry Pi Zero W Kit with 12 Month upfront
subscription only (no Raspbery Pi Zero Kit with Rolling
Monthly Subscription)
Subscribe by phone: 01293 312193

Subscribe online: magpi.cc/subscribe
Email: magpi@subscriptionhelpline.co.uk
68 magpi.cc
SUBSCRIPTION
JOIN FOR 12 MONTHS AND GET A
FREE Raspberry Pi
Zero W Starter Kit
WITH YOUR SUBSCRIPTION
Subscribe in print
for 12 months today
and you’ll receive:
Raspberry Pi Zero W
Raspberry Pi
Zero W case with
three covers
USB and HDMI
converter cables
Camera Module
connector
Offer subject to change or
withdrawal at any time
Buy now: magpi.cc/subscribe
SUBSCRIBE
on app stores
magpi.cc 69
TUTORIAL
O O K T A S T I C
L
10 SP
A
HALL
STOMACH SHOT
MAKER We interviewed Luis about this blood-curdling costume idea
a few years ago. It’s very basically a Raspberry Pi with a Camera
Luis Martin Module that displays what it sees on the screen live. The camera
Nuez
is attached to his back, with the screen on his stomach, and the
magpi.cc/KiVVnM
preview mode is used to create the illusion that he has been shot
through the stomach. Grisly.
Characters: As this is an older project, some of the parts may be unnecessary
Zombie, or easy to upgrade to better versions. We also recommend you use a
skeleton screen solution that is powered by your Raspberry Pi so that you can
use a portable battery charger instead.
Luis created a latex frame of gruesome

flesh to give the screen more realism
70 magpi.cc 10 Spooktastic Halloween Costume Projects

TUTORIAL
O
OWW E E NP R O J E C T S
COSTUM E
Use Raspberry Pi weara
ble tech to make
amazing costumes this
Halloween
G A M E B O Y CO ST UM E
MAKER The point of a Game Boy is that it’s small and you
can fit it into your pocket. Turning yourself into a
MikeHandidate portable console as a costume sort of ruins that aspect
magpi.cc/yLdPXL
of it, but at least you are then still portable.
The costume itself is very simple, with a couple
of cardboard sheets painted to make it look like the
Characters: classic Game Boy Color. It’s got a pretty big screen
BMO, robot, any though, so it may need a bit more power than your
other retro video standard mobile battery. Having the gloves work as
game console custom controllers adds an extra level of complexity to
the build; however, GPIO-based buttons are supported
Instead of poking at Mike, you use
in RetroPie, so they shouldn’t be too hard to do. controls on his gloves
10 Spooktastic Halloween Costume Projects magpi.cc 71

TUTORIAL
RO BO SU IT
MAKER This build combines many
things we enjoy. Robots, simple
Estefannie electronics, googly eyes, flashing
Explains It All lights, and really fun, low-budget
magpi.cc/HPmPZx
DIY construction.
Estefannie used several
Characters: technologies to power this suit,
Darth Vader, including Arduino supplies to
Power Loader, power LEDs around the suit, a
Gort, Teletubby voice changer to giver herself
a more robotic persona, and a
Raspberry Pi to power the screen
on the chest with several functions
which are powered by a series
of buttons. The jaw even moves
depending on how she speaks!
And of course, it’s built using
cardboard boxes and silver tape,
meaning just about anyone can
make the body.
HALLOWEEN
COSPLAY
& COSTUME V O IC E C H A N G E R
SUPPLIES MAKER Voice changers/amplifiers make for excellent parts in a
scary costume, especially when installed in a scary skull
Need some wigs,
Olivier Ros mask like this.
r- magpi.cc/PXEiJX
fabric, or armou While seemingly a simple build – and it generally is – there’s
making su pp lie s? a few neat parts to this project. You need to remove the
Check out our Characters: microphone part of an audio board add-on, and Olivier also
friends at Coscraft Darth Vader, teaches you how to correctly install the built device so that the
(coscraft.co.uk) Dalek, robot, microphone is isolated and to reduce feedback. There’s even a
of
for a huge range alien, Judge Doom button to change between voice types!
mi ng an d co splay
costu
about
supplies for just
.
any wearable build
Modelling clay is
used to fit the device
to the mask, and to
reduce feedback
72 magpi.cc 10 Spooktastic Halloween Costume Projects

TUTORIAL
DOC BROWN
MAKER A good Doc Brown costume can mostly be made with just
a lab coat, cool shades, and a frizzy wig. A great Doc Brown
Carl Monk
costume includes custom-made props from the Back to the
magpi.cc/giHLeF
Future series, such as the flux capacitor that makes time travel
possible, and the time circuit for setting your destination.
The circuit part of the build is fairly simple, making use of
Characters: several seven-segment displays to ape the style of the films,
Darth Vader, and they’re housed in a simple box to complete the
Clock King, Rebel look. Carl has an exhaustive build tutorial on his
pilot, robot website as well, if you wish to pick it apart.
Still images don’t

really do it justice,
but the effect in real
life is excellent
NE OP IXE L SA NS UN DE RT AL E EY ES
MAKER This full-on cosplay has an electronic secret –
simple LED lights for eyes that can change into
Mel Nurdin flashing circles of doom. For those that know of
magpi.cc/ipwbXp
the game Undertale, the light patterns represent
how the character Sans looks when he unleashes
his true power.
Characters: This simple build makes use of a Raspberry
Credit: Beth Dooner
Replicants, Dr Pi Zero connected to a NeoPixel ring that is set

Manhattan, behind some frosted acrylic. With the touch of a
robots, Super hidden pocket button, you can activate the eyes,
Saiyan Goku turning them blue. Another press makes them
flash yellow, and a final press turns them off.

TUTORIAL
STEAMPUNK
TENTACLE HAT
MAKER Have you ever wanted to have tentacles
growing out of your head? Probably not, we’d
Derek
hope, but we can offer you the next best thing:
Woodroffe
a hat that makes it look like transdimensional
magpi.cc/iqDuUm
tentacles are growing out of your head.
It’s actually quite an ingenious build, using
several servos and plastic tentacle skeletons
Characters: to make the stocking-based suckers wiggle
Twi’lek, and move freely on top of the hat. Some latex,
Andorians, other sealant, and paint bits later and you have a
aliens, animal ears very weird and kinda scary hat.
Each tentacle is
controller by servos
that run on a sine
wave pattern to
make them move
more ‘naturally’
POWER
CONCERNS
Powering your costume
D IS CO B A L L
can be tricky. Not
everything can run off a MAKER For a costume that
Raspberry Pi, so you may is essentially a series
Wolfie
find yourself needing a magpi.cc/VsDiFi
of LEDs, there is a lot
battery pack to provide a going on here. It’s fully
bit more oomph. In that autonomous, playing
case, you can also use a a preprogrammed
5 V battery pack to power
Characters: light display, and can
BB-8, a star,
your Raspberry Pi via the connect to wireless LAN to ape the light show that
a planet
GPIO pins – check out our the builder’s house is playing as well.
full powering guide to find The frame is welded together specifically to fit
out how to do this safely: Wolfie’s granddaughter; however, you can make it
magpi.cc/UiAJdk fit whomever you’d like if making it yourself. It uses
some custom 3D-printed parts to keep a Raspberry Pi
and some batteries in place – at the time of making,
it would last several hours.
74 magpi.cc
TUTORIAL
IR O N M A N A R C R E A C TO R
MAKER Voice modification and LEDs are cool, but how
about voice-controlled (and reactive!) LEDs? This
Team
fantastic project from the MATRIX Labs team turns a
MATRIX Labs
cheap Iron Man costume into a party piece that is sure
magpi.cc/PbaWFp
to attract a few nerds.
The voice-controlled magic is handled by Snips.ai
Characters: (snips.ai), a customisable piece of tech that allows you
War Machine, to create voice assistants that work under your control.
robot, Optimus You can set keywords, train it to make sure it understand
Prime, Gundam your voice, and then hook it up to your MATRIX board.
The command-line interface

is perfect as it looks like
you’re an eighties hacker,
and it uses less power
TH E JA CK ET 2.0
MAKER The cyberpunk aesthetic will probably never
go away, especially now that it’s easier than
CoreDump ever to install electronics into clothes, a bit
magpi.cc/kUjSkV
like ‘The Jacket’ that CoreDump likes to wear
at Halloween.
It’s a pretty standard leather jacket, albeit
with some serious modifications. Not just style
Characters: bits like neon lights and punk spikes, but also
Buzz Lightyear, the fully functional Raspberry Pi installed into
Commander one of the sleeves for that ‘hacking-on-the-go’
Shepard, Fallout look. There’s also a hidden action camera in one
character of the spikes, perfect for first-person video fun.

REVIEW
SPECS
SIGNAL TO
NOISE RATIO:
130 dB
(A-weighted)
DYNAMIC
RANGE:
125 dB
TOTAL
HARMONIC
DISTORTION:
0.0003%
SAMPLING RATE:
Up to 192kHz
BIT RATES:
Up to 24-bit
DIMENSIONS:
125×125×70 mm
PecanPi
Orchard Audio magpi.cc/gedJyS £325 / $399
We love DACs here at The MagPi. So what makes

the PecanPi special? PJ Evans turns up the volume
T
he market is crowded with audio streaming
options available well under £100, so
is there a place for another Raspberry
Pi-based DAC (digital to analogue converter)?
Presented in a brutalist black metal box, Orchard
Audio’s PecanPi is built with some of the highest-
quality components available, aiming it squarely The DAC is a HAT sitting on a Raspberry Pi 3B. WiFi is unavailable,
Verdict
at the serious music lover. Inside you’ll find a to preserve sound quality, so you’ll need Ethernet or an adapter
Raspberry Pi 3B and the DAC HAT itself. The
outputs are analogue, with the two expected phono
One for true outputs accompanied by XLR connectors, making the sound processing (an optional WiFi/Ethernet
audiophiles. If
this suitable for professional setups. bridge is available if needed).
music is your
passion or We tested on a high-end amplifier with all its
profession, and Double DACs sound processing disabled, playing FLAC-encoded
you’re OK with Great care has been taken over component choice music. The result was crisp, detailed, and rich.
the selection of and the design uniquely features two of Texas We can see how this device would appeal to the
available software, Instruments’ highest-specification DACs, one enthusiast or professional requiring best-of-class.
this might well be
for each channel, with some of the industry’s A small let-down is the software. Volumio is an
the best streaming
best-performing op-amps. The result is some open-source playback web app that supports many
8
device out there.
impressive technical specifications, including total different DACs. Although it aims to be pretty, we
harmonic distortion of 0.0003% and a dynamic found it unintuitive and buggy, lacking the polish
/10
range of 125 dB. Even on-board WiFi has been of other similar products like Plex. Luckily, other
disabled to prevent the radio interfering with playback packages are compatible with PecanPi.
76 magpi.cc PecanPi
REVIEW
NanoSTEM IOT
Weather Kit
Nanomesher magpi.cc/rpPidc £64 / $80
A much smaller weather kit solution,

complete with Nanomesher’s
signature tiny display. Rob Zwetsloot You can get a 3D case
braves the elements to test it to enclose it all, while

also allowing the
sensors to still work
SPECS
DISPLAY:
1.3” High
Contrast
OLED (128×96
resolution)
PRESSURE
SENSOR:
BMP180 (range
300–1100hPa)
HUMIDITY &
TEMPERATURE
SENSOR:
SHT31
AIR QUALITY
SENSOR:
CCS811 (TVOC
and eCO2
sensing)
What do you get in the kit, then? Well, it’s a
HAT-like add-on board that covers the USB and
Ethernet ports, along with the rest of a Raspberry
H
ome weather kits are excellent for Pi. This is the ProdBoard that Nanomesher makes,
Verdict a number of reasons. With the right

calibration, they can be more accurate than
which includes a tiny 1.3″ OLED display, but adding a
pressure sensor, humidity and temperature sensor,
a lot of basic solutions. In addition, by nature of and an air quality sensor attached to the I2C ports.
A great little IoT
weather station being a computer add-on, they allow you to keep
that’s easy to use track of data over a long period of time – great Plug and play
and configure. for science, and also good for stuff like timing There’s also a microSD card that is all preconfigured
It can be used your heating in the winter, or even just kitchen – very welcome, as we know how tricky these
around the house, conditions when cooking particularly fussy foods. sensors can be to set up. Air quality monitors aren’t
or easily made
The NanoSTEM IoT Weather Kit is one of the something we see regularly in Western weather
portable with a
smallest solutions we’ve seen for this, and it’s kits, but it’s a big thing in built-up areas of China.
9
mobile battery.
relatively cheap as well. Featuring an at-a-glance Everything is ready to go out of the box – even the
display for basic data readouts and an online sensors are plugged into the board – so as long as
/10
dashboard with the full suite of data, it’s basically you have access to power, you can get very quickly
the full package. started with monitoring.
78 magpi.cc NanoSTEM IOT Weather Kit

Tutorial STEP BY STEP
SUBSCRIBE AND
SAVEUP
TO
35%
on the cover price
ISSUE #23
OUT NOW hsmag.cc

REVIEW
10 Best:
Gaming
accessories
Level up your Raspberry Pi gaming
with these accessories and kits
BASIC Arcade Controller Kit
W
e’ve done several features and articles
over the years on how to set up your own Arcade on your lap
Raspberry Pi-based games console. So we This arcade stick-style kit allows you to build an arcade machine right into the
have a good idea what kind of hardware is out there stick. Monster Joysticks also makes a bigger and badder version with high-
that will improve your experience on any Raspberry Pi quality Sanwa arcade parts.
gaming setup. Let’s take a look...
£70 / $87
magpi.cc/ierNVd
Picade X HAT
Ultimate arcade board TinyPi Pro
Created for the amazing Picade,
the X HAT is the absolute perfect Pocket-sized gaming
accessory for turning a
This is a bit more of an accessory and more on the kit side – the TinyPi Pro is
Raspberry Pi into an arcade
absolutely tiny, as the name suggests, yet still allows you to play a huge variety
machine. Just build the
of games.
cabinet, add the buttons,
and you’re good to go. £92 / $115
£16 / $16 magpi.cc/EXKvig
magpi.cc/eaiQpA
USB Gamepad
A retro classic
Including the European/Japanese
gamepad colour scheme, this retro-style controller has enough
buttons to allow you to play just about any game you have prior
to 1995, and some newer homebrew stuff.
£6 / $8
magpi.cc/RRLFPM
80 magpi.cc 10 Best Raspberry Pi media players

REVIEW
Massive RetroFlag MEGAPi Case

Arcade Button
Super stylish protection
For big hits RetroFlag makes a few retro console cases, and all of them are
very cool. This design is a classic though, and even lets you use the
This huge button is 100 mm buttons on the top like the original!
across and comes with an LED
as well. It’s perfect for very £25 / $32
specific arcade and gaming magpi.cc/ArHuJc
builds, especially if you need to
smack a big button very fast.
£9 / $10
magpi.cc/LpMyCp
Joy Bonnet
Tiny controller HAT
This funky add-on for Raspberry Pi
Zero turns it into a controller that is its own console. It’s a bit fiddly,
but it’s also an excellent party piece and can even fit in your pocket.
£14 / $14
magpi.cc/biqbgi
Wireless
Gamepad
New school cool
Playing newer games
thanks to Steam Link or other
streaming tech? Then you may need
a controller that can do it all, which also
doesn’t limit you to the length of a USB cable.
£14 / $18
magpi.cc/fXqWFh
Cupcade
Mini arcade cabinet
Keybow Kit
Arcade machines can be huge and
Extra hot keys
expensive to maintain. The Cupcade
can fit on a DVD shelf and the parts Need more keys for your gaming? Look no further than the Keybow, a
are much cheaper. Plus, you don’t Raspberry Pi-powered mechanical keypad. You can program the keys
need to hire a van to move it – bonus! to do anything you want, so it’s great for MMOs.
£111 / $141 £50 / $52

magpi.cc/KbHeYL magpi.cc/MytktH
10 Best Raspberry Pi media players magpi.cc 81

RESOURCES
Learn Scratch 3
with Raspberry Pi
Discover the delights of the remarkably easy-to-use
programming language. By Lucy Hattersley
Raspberry Pi Resources
Raspberry Pi Scratch is a wonderful educational tool for learners of
AUTHOR
Foundation programming language all levels. Armed with Scratch,

cleverly disguised as a you can learn important coding
Price: multimedia interactive game. concepts such as loops, variables,
Free
With a mixture of characters and conditional branching.
magpi.cc/qxuVKi (also known as ‘sprites’) and Scratch 3 is the recently Help > Projects from the menu
backgrounds, you can build your released update. And running in Raspbian, and click on Learn
own interactive scenes. Throw Scratch 3 on a Raspberry Pi to Code with Scratch; or click
in some music and sound effects throws an extra level of learning on All Projects and change ‘Any
and you have a video game, into the mix, with extensions software’ to Scratch. Many
or an animated movie, or an for GPIO pins and support for of these resources have been
interactive story. Sense HAT. updated to work with Scratch 3
Ostensibly aimed at younger Where better to start than (those that have will proudly
students, Scratch is an excellent Raspberry Pi Projects? Choose display so at the start).
Books and cards

Cards, books, and more
CODING CARDS stickers and magic glasses to read hidden hints.
MIT has produced a collection of Coding Cards It’s a great book for kids.
that can be used to learn Scratch in the classroom. magpi.cc/ccbook1
Scroll down its Ideas page (also useful) and click
the Download Now link. There are 188 cards in total. 25 SCRATCH 3 GAMES FOR KIDS
scratch.mit.edu/ideas No Starch Press is quick off the block with book
of Scratch 3 games. Games include catching
CODE CLUB BOOK OF SCRATCH – VOLUME 1 snowflakes and eating tacos. The author, Max
Code Club’s book on Scratch is a great primer for Wainewright, is a teacher which makes the book
the programming language. Big and colourful, ideal for tutors.
it has easy-to-follow projects and comes with magpi.cc/VMepSh
82 magpi.cc Learn Scratch 3 with Raspberry Pi

RESOURCES
Udemy: Build 11 Games

in Scratch 3.0 Bootcamp
Dr Chris Mall Udemy has a selection of great view a range of games – The
AUTHOR
video courses for Scratch. Most Snake Game, Scary Shark Game,
Price: are being updated for Scratch 3, Helicopter Game, Racing Car
£150 / $150
but and this gaming course is Game, Crossing the Road Game –
magpi.cc/rxAAwp one of the first out. The course all of which builds up to a version
is by Dr Chris Mall and covers all
the basics of programming using
of the arcade game Arkanoid.
There are 46 lectures in all, with Courses &
Scratch 3.
After the introduction to
eight hours of video, along with
two articles and downloadable
projects
blocks and commands, you’ll resources for each game.
As with all Udemy courses, Learn computer
it can be expensive but is
science with these
frequently available at a discount.
The RRP is £150, but at press time
Scratch courses and
it was on sale for a much more online projects
palatable £12.
Dr Mall also has another
course, Scratch 3.0 for Teachers
(magpi.cc/qnSgEA), with
similar content, but aimed at a
classroom environment.
HARVARD CREATIVE
COMPUTING CURRICULUM
Scratch Tutorials The Creative Computing

Curriculum is a collection of
ideas, strategies, and activities
The Scratch Why not cut to the chase and for an introductory creative
AUTHOR
Team learn Scratch straight from the computing experience using the
source? Open up Scratch 3 on Scratch programming language.
Price:
Free
your Raspberry Pi and click the magpi.cc/yhJPtR
Tutorials button.
magpi.cc/jhzDsu
Inside the Scratch 3 program, GOOGLE CS FIRST
you’ll find a Getting Started A free computer science
guide and plenty of other broader focus on animation curriculum that makes coding
tutorials for learning key and storytelling. easy to teach and fun to learn.
concepts in Scratch. As with Some tutorials, such as magpi.cc/mrppRV
the Raspberry Pi Projects, Video Sensing, can work with
these are a varied bunch of Raspberry Pi. But there isn’t CODE CLUB PROJECTS
imaginative projects. the focus on hardware such as Many Code Club projects
You’ll find such projects as the Sense HAT or GPIO pins. appear on the Raspberry Pi
Animate a Name, Make Music, For that, you’ll need to look to website, but it also has a
Create a Story, and Create Raspberry Pi itself. However, collection on the Code Club
Animations that Talk. There the built-in tutorials are a good website. There is a great
are also a few games, such as source of fun and these projects collection of additional
Make a Chase Game and Pong are directly integrated with projects here.
Game. But there’s a much Scratch 3. magpi.cc/kRHmrC
Learn Scratch 3 with Raspberry Pi magpi.cc 83

INTERVIEW
California High School, where Sean teaches,

joined in on the Big Birthday weekend
Sean Raser
Computer science teacher, Raspberry Jam organiser, and
Code Club leader. Sean Raser sure loves to teach Raspberry Pi
> Day job Teacher > Community role Raspberry Jam organiser > Twitter @sraser88
F
or a lot of the people who Valley) and through my school The Castro Valley Jam is his
do a lot with Raspberry Pi, district (San Ramon Valley big community Raspberry Jam,
they’ve been here since Unified School District),” with attendees from all walks
day one – 29 February 2012. Sean tells us. “I also teach of life trying out Raspberry Pi
Sean, on the other hand, didn’t ‘Physical Computing with projects. Sean’s school-based
even learn about Raspberry Pi Raspberry Pi’ classes through Raspberry Jam is aimed more
until early 2015, but that hasn’t our local Education Foundation, towards middle- and high-
stopped him from teaching which take place after school, as school students, though.
about it, putting on events well as during holiday breaks
about it, or running a Code and summer. I am also the Do you use Raspberry Pi in your
Club using the Raspberry Pi leader of the Castro Valley Code high-school classes?
Foundation resources. Club, which I started just around I absolutely do! I have used them
“I have held Jams in both my one year ago (right after I a few different ways. I have used
local community (Castro attended Picademy).” them as their own separate unit,
84 magpi.cc Sean Raser

Sean leads projects for people to try,
or they have a go at one from the
Raspberry Pi Projects page
hen it comes to Jams, there is no

W beneficial part of Picademy. I
Fun with
would encourage anyone on the
right or wrong way that they have to fence about applying to take the Minecraft
next step and apply!
be run or put together “One of my personal
Any Raspberry Jam advice? favourite uses I have
where we spent a chunk of time ever attended. I learned so many When it comes to Jams, there gotten from Raspberry
dedicated to Raspberry Pi mixed practical things that I could take Pi is being able to
is no right or wrong way that
expose my young son
in with other content from the (and have taken) right back to they have to be run or put
to coding at such a
class. I first introduced them, and the class and start using right together. I have found that they young age. He loves
then afterwards I let the students away. Many of the classes I are all different, which is really Minecraft, so being
work on their own projects that teach outside of school are based what makes them such a great able to show him
they either chose or found online. around the Picademy lessons, experience. Every situation is any basic Python
They had a few weeks total to and when I introduce Raspberry going to be different, and I have programs that modify
Minecraft blows him
spend using them. Pi in my high-school classes found that just going for it,
away. The Minecraft
Another way I tried involved I use many similar lessons while not always the best advice camera that can take
working them in throughout from Picademy. for every situation in life, has his picture then build it
the class all year long. For I like how most of the lessons worked for me. I still get nervous in his Minecraft world
example, I dedicated each Friday have the participants just the night before each Jam, but blows him away.”
to Raspberry Pi. At first, they jump right in to the code, and it’s a good, excited nervous.
were taught how to use them, explain it after they have seen Also, I have always felt
but afterwards they were free it running. This was different absolutely great after every
to be creative and either work from what I did before, but I single Jam. They don’t always run
on a year-long project, or many have had a better experience exactly the way I had planned,
projects over the year. with it this way. I met so many and there are always bumps in
wonderful educators at Picademy the road, but at the end of the
How was Picademy? that I still keep in touch with. day I know that the people who
I attended Picademy Denver The network of educators that attended were able to meet, talk,
2018, and it was, and has been, you are introduced to and stay in code, share, and learn. Who could
the greatest workshop I have touch with is the most amazing, ask for a better day than that?
Sean Raser magpi.cc 85

THIS MONTH IN RASPBERRY PI
This Month in
Raspberry Pi
Scratch
Conference Europe
The Raspberry Pi Foundation 01
hosts a Scratch party
Y
ou’ve probably read all about the big Scratch
Conference that the Raspberry Pi Foundation
hosted last month on page 6. It was a great
time for all involved, and we have the pictures to
prove it!
01. There were plenty of stalls to try out

numerous Scratch projects
02. Talks were given on a huge variety of topics
03.
There was a full schedule over three days
with talks, workshops, and keynotes
04. Smaller workshops allowed people to get
some hands-on experience, or present
more niche subjects
05. People from around the world were here to
talk about Scratch
06. Teaching each other was an important part
of the weekend
07. Educators swapped tips with each other on
how best to utilise Scratch
08. Live-streaming your Scratch Conference
experience? Why not?
09. No table or auditorium? Have a chat on the
show floor!
86 magpi.cc Scratch Conference Europe

02
03
04
05
06
07 08
09
Scratch Conference Europe magpi.cc 87

MagPi Monday
Amazing projects direct from our Twitter
E
very Monday we ask the question: have you
made something with a Raspberry Pi over
the weekend? Every Monday, our followers 01
send us amazing photos and videos of the things
they’ve made. Here is a small fraction of them.
Follow along at the hashtag #MagPiMonday.
02
01. A secret mission to

discover the Great
Plumnapper
02. Can it talk as well, so
we can ask annoying 03
co-workers to ‘get in
the bin’?
03.
This Raspberry Pi
project is inside an
Arnie biography and
reads it to you
04. This solar-powered
lawnmower is getting
closer to completion,
it seems!
05. Press the asteroid and
a rocket ship appears 04
from behind the canvas
06. If the MudPi project
piqued your interest
earlier in the mag,
then this might be
for you
05
06
88 magpi.cc MagPi Monday

Crowdfund this! Raspberry Pi projects you

can crowdfund this month
DACBerry AMP2
Pi-oT – IoT Module
With all the DACs available for Raspberry Pi, why should this be the
IoT modules for Raspberry Pi are quite common; one for you? Well, the blurb says: “The DACBerry AMP² provides a
however, this one is quite the beast. Not only is it 4×60 W amplified dual stereo output in Dual Stereo mode and up
designed with normal home automation in mind, but also to 2×100 W in Dual Mono mode. Integrates a 192kHz/32-bit DAC
with industrial automation. It certainly looks the part. chip with hardware volume mixing and mini DSP.”
CROWD
kck.st/2Q3AYTO
kck.st/2MELG0B A PI PRFUNDING
OJECT
If you
’ve la ?
irresis unche
tible P d an
projec i-relate
t, let u d
magp s know
Best of the rest! i@ras !

pberry
pi.org
Here are some other great things we saw this month

RASPBERRY $20 MAGIC
PI-CONTROLLED MIRROR
CRANE Getting a second-hand
This is a 13,000 lb monitor and some
(~6000 tonne), 45 ft mirrored film for about
(13.7 m) crane… being $20 is a great find,
controlled with what especially when you
looks like a third-party can turn it in a very
Xbox controller. We are handy magic mirror.
worried this may not be
the right tool for the job.
magpi.cc/tfJwaa magpi.cc/igkFed
Crowdfund this! magpi.cc 89

EVENTS
04
05
08
Raspberry Jam
Event Calendar 01
Find out what community-organised Raspberry
Pi-themed events are happening near you…
01. Raspberry Jam Estácio 05. Castro Valley Jam

Friday 18 October 2019 Saturday 5 October
Estácio, Maceió, Brazil Castro Valley Library, Castro Valley, CA, USA
jam.maceio.br magpi.cc/eXpRiF
This Brazilian Raspberry Jam is a great place to learn how If you’re interested in computer coding and want
to make your own projects to learn about Raspberry Pi, check out this Jam.
02. Milton Keynes Raspberry Jam 06. Exeter Raspberry Jam

Saturday 19 October Saturday 5 October FULL CALENDAR
The National Museum of Computing, Bletchley, UK Exeter Library, Exeter, UK
Get a full list of upcoming
magpi.cc/dgijby magpi.cc/LpKVCF events for October and
Where better than the National Museum of Computing at A monthly meeting for everyone interested in all beyond here:
Bletchley Park to show off your Raspberry Pi project? things microcomputers, microcontrollers, robotics, rpf.io/jam
and making.
03. Raspberry Pi Jamwich
Friday 25 October 07. Stafford Raspberry Jam
The Forum, Norwich, UK Tuesday 8 October
magpi.cc/pYaUYd Stafford Library, Stafford, UK
Part of the Norwich Science Festival – you’ll be able to try magpi.cc/fNLiwT
out workshops on lights, Minecraft, or whatever you want! A meet-up for folks who have a Raspberry Pi computer
and want to learn more about it.
04. Patriot Pi Raspberry Jam
Saturday 26 October 08. Dallas Young Makers Club
Cherry Valley-Springfield Central School, Cherry Saturday 12 October
Valley, NY, USA Dallas Public Library, Dallas, TX, USA
magpi.cc/bEDMUy magpi.cc/hbGzPD
An educational experience for people new to Raspberry Free mentor-led, hands-on projects for kids with
Pi or veterans, with hands-on activities. Raspberry Pi, Lego Mindstorm robots, and more.
90 magpi.cc Raspberry Jam Event Calendar

EVENTS
FIND OUT
ABOUT JAMS
Want a Raspberry Jam in
your area? Want to start
one? Email Tom Hadfield
about it:
jam@raspberrypi.org
We’ve highlighted some of the areas

in need of a Jam! Can you help out?
Raspberry Jam advice:
Ticketing
“W
e make sure free tickets are always
available for those who need them.
We issue an ‘optional donation’ ticket
with a suggested donation of £3 per person, or £5 if
attending a workshop, but we make it very clear
that it is entirely optional. We then also go
round and shake a tin about half an hour
before the end.”
07 03 Andrew Oakley – Cotswold Raspberry Jam

02
Every Raspberry Jam is entitled to apply for a

Jam starter kit, which includes magazine issues,
06 printed worksheets, stickers, flyers, and more.
Get the book here: rpf.io/guidebook
Raspberry Jam Event Calendar magpi.cc 91

YOUR LETTERS
Your
Letters
Adults in space!
I always love hearing about
new Astro Pi projects; however,
I think I’m a bit too old to
participate in it! Is there
anyway for us grown-ups to get
involved? Would love to say I’d
helped get something in space!
Kelly via Facebook
While you can’t

apply with a team
of grown-ups
yourself, you can
help mentor a group
of young makers! As
T
his year we were judges at the 2019 Coolest Projects USA event – hopefully we
a team mentor, you’ll be the can see your projects next year as well!
contact between your team and
the Astro Pi team, Raspberry Pi More Coolest Projects
Foundation, and even the ESA.
If you want to learn more It’s been a while since the last roughly around the same time as
about how you can help young Coolest Projects event – I was last year:
makers with their Astro Pi wondering if there were any
Challenge, head here for more plans for more Coolest Projects • USA, Discovery Cube Orange
details: magpi.cc/YeisCW. in 2020? I’d love to attend the County, CA: 7 March 2020
International one – it looks like
so much fun! • UK, The Sharp Project,
Contact us! Ken via email
Manchester: 4 April 2020
• International, RDS Main Hall,

> Twitter @TheMagPi You’re in luck – the full schedule Dublin, Ireland: 6 June 2020
> Facebook magpi.cc/facebook for Coolest Projects has just been
> Email magpi@raspberrypi.org announced for 2020! Coolest We’ll try to get along to one or
> Online raspberrypi.org/forums Projects USA, International, and two of them, so hopefully see
UK will all be making a return, you there!
92 magpi.cc Your Letters

YOUR LETTERS
Stretching time More Picademy?

In the article ‘Control servos with CircuitPython and I’m an educator looking to learn more
Raspberry Pi’ in issue 84 (magpi.cc/84), Melissa LeBlanc- about Raspberry Pi and have been very
Williams used a Bosch BNO055 device on the I2C bus, which interested in Picademy. Unfortunately, it
usually requires ‘clock stretching’. always seems to be on at a time and place
In step 7, clock stretching is said to be enabled, which so far I’m unable to go to. Are there any plans to
was not supported by Raspberry Pi devices. The method used expand the amount of Picademy events in
looks rather like slowing down the I2C clock permanently, the country at all?
than enabling clock stretching. Although that may be a
suitable workaround for the problem, I would prefer to call Terri via email
things by their right name, than raise expectations that
cannot be fulfilled. Please correct me if I2C clock stretching is The Raspberry Pi Foundation has just
supported by Raspberry Pi 4 and enabled that way. announced something it’s calling Picademy
Bytes – a shorter, 60- to 90-minute session
Heimo via email run by community volunteers who have
been trained by the Foundation.
We admit we had to ask the Raspberry Pi engineering team They’ll be popping up around the UK,
about this one as we had not come across it before – they told with four Community Trainers raring to go
us that you are indeed correct: I2C clock stretching was not and get people started with RaspberryPi.
supported on older Raspberry Pi models. This was a bug which You can find out more information on the
was finally corrected with the release of Raspberry Pi 4, and the blog here: magpi.cc/dCVWRU. Dates and
method used in the tutorial allowed you to make use of it. venues will soon be announced!
THE BEST-SELLING MAG FOR PC HARDWARE, OVERCLOCKING, GAMING & MODDING
PC HARDWARE
ENTHUSIASTS
ISSUE 194 OUT NOW

VISIT CUSTOMPC.CO.UK TO LEARN MORE
COMPETITION
WIN
ONE OF FIVE
ROCKYBORG
ROBOTS!
We reviewed the RockyBorg last issue
(magpi.cc/85) and loved it. It’s fast,
easy to program, and fun to use.
A nimble robot with two

20 mm 180 rpm metal geared
motors, a powerful metal
gear servo for leaning into
corners, and an all-new
motor controller
– PiBorg
In association with PiBorg
Head here to enter: magpi.cc/win Learn more: magpi.cc/dfcqRi
Terms & Conditions

Competition opens on 25 September and closes on 31 October 2019. Prize is offered to participants worldwide aged 13 or over, except employees of the Raspberry Pi Foundation, the
prize supplier, their families, or friends. Winners will be notified by email no more than 30 days after the competition closes. By entering the competition, the winner consents to any
publicity generated from the competition, in print and online. Participants agree to receive occasional newsletters from The MagPi magazine. We don’t like spam: participants’ details
will remain strictly confidential and won’t be shared with third parties. Prizes are non-negotiable and no cash alternative will be offered. Winners will be contacted by email to arrange
delivery. Any winners who have not responded 60 days after the initial email is sent will have their prize revoked. This promotion is in no way sponsored, endorsed or administered by,
or associated with, Instagram or Facebook.
Competition magpi.cc 95
AVAILABLE NOW AT VILROS
· Faster & more powerful Fully stocked with

· RAM options: 1GB/2GB/4GB Raspberry Pi 4 boards,
· Fast networking kits & accessories.
SCAN NOW TO BUY >>>
/vilrosusa
NEXT MONTH
EDITORIAL
Editor
Lucy Hattersley
lucy@raspberrypi.org
Features Editor
Rob Zwetsloot
rob.zwetsloot@raspberrypi.org
Sub Editors
Phil King and Nicola King
BUILD A
ADVERTISING
Charlotte Milligan
charlotte.milligan@raspberrypi.org
R A S P B E R RY P I
+44 (0)7725 368887
DESIGN
criticalmedia.co.uk
Head of Design
4K M E D I A
Lee Allen
Designers
Sam Ribbits, Harriet Knight,
C E N T RE
Ty Logan
Illustrator
Sam Alder
CONTRIBUTORS
Mike Cook, David Crookes, PJ
Evans, Rosemary Hattersley,
Michael Horne, Nicola King,
Daniel Lambton-Howard, Simon
Long, Sean McManus, Tim
Richardson, Danny Staple
PUBLISHING
Publishing Director
Russell Barnes
russell@raspberrypi.org
Director of Communications
Liz Upton
CEO
Eben Upton
DISTRIBUTION
Seymour Distribution Ltd
2 East Poultry Ave,
London EC1A 9PT
+44 (0)207 429 4000
SUBSCRIPTIONS
Unit 6 The Enterprise Centre
Kelvin Lane, Manor Royal,
Crawley, West Sussex, RH10 9PE
THE MAGPI #87

+44 (0)1293 312193
magpi.cc/subscribe
ON SALE 31 OCTOBER
magpi@subscriptionhelpline.co.uk
Plus! This magazine is printed on paper sourced

from sustainable forests and the printer
Make a Raspberry Pi DON’T MISS OUT!

operates an environmental management
system which has been assessed as
digital camera conforming to ISO 14001.
Retro gaming level magpi.cc/subscribe The MagPi magazine is published by

Raspberry Pi (Trading) Ltd., Maurice Wilkes
Building, St. John’s Innovation Park, Cowley
design in PICO-8 Road, Cambridge, CB4 0DS. The publisher,
editor, and contributors accept no
Assemble a cluster TWITTER @TheMagPi responsibility in respect of any omissions
or errors relating to goods, products, or
computer services referred to or advertised in the
FACEBOOK fb.com/MagPiMagazine magazine. Except where otherwise noted,
Control your low-cost content in this magazine is licensed under
wheeled robot EMAIL magpi@raspberrypi.org a Creative Commons Attribution-

NonCommercial-ShareAlike
3.0 Unported
(CC BY-NC-SA 3.0).
ISSN: 2051-9982.
THE FINAL WORD
The secret to success

Volunteering – why we do it and why you should too.
By Michael Horne and Tim Richardson
O
ur volunteer experience with and clear-down, who gave talks, and without you. You are the backbone
Raspberry Pi started way who did show and tell. All of these of every event that is run, the
back in May 2013. First, Mike volunteers gave up their own time so (sometimes hidden) element of any
resurrected the Cambridge Raspberry that we could support the aim of the successful event.
Jam. Two Jams later and Tim joined in Jam – which was primarily to help kids
to run the event. learn to both code and get involved in Getting involved
Together, we turned it into one of physical computing, as well as support If there is a message behind this
the biggest Raspberry Jam meet-ups the vast array of hobbyists that were article, it is to encourage anyone
in the world. That is only part of the using Raspberry Pi. reading to support your local events;
story, though, because it sounds like to get involved. If you are a hobbyist,
we did it all ourselves, which just is Rise of the robots consider spreading your knowledge
not true. When we then started Pi Wars, the and experience around. If you are
In order to make the Jam bigger, challenge-based robotics competition, bringing your child to an event, and
we needed a larger venue, and to be we knew that it would only work with you are on your own, of course you
honest, we did not have a clue as to the help of others. We could sort out will want to keep an eye on them. If
both parents are attending, though,
one or both of you might consider
e had so many volunteers who contributed
W giving up some of your time to
so much to the Jam support the event. Even if you do not

have the technical skills to support
in a workshop, you could volunteer
how to get one. Fortunately, Andy the courses and the logistics in the to be on the front desk at a Jam, or
Batey came forward and offered his run-up to the event, but on the day be a judge at Pi Wars. Our point is:
workplace as a venue. we would need virtually an army of everyone has something to contribute,
That venue, the Institute of volunteers, to marshal and judge, and and it is one of the most rewarding
Astronomy, in West Cambridge help us to tidy up at the end of the things you can do.
(ast.cam.ac.uk), was our home for the event. We knew that getting those
next four-and-a-half years, and it was volunteers would be a central aim of
Michael Horne & Tim Richardson
AUTHOR
only with the help of other people that the organisation of the event and the
we managed to keep it going. We had ‘other side of the coin’ when it came
Between them, Mike & Tim have run
so many volunteers who contributed to the event itself. the Cambridge and Potton Jams, Pi
so much to the Jam. We had people We are incredibly grateful to anyone Wars, and the first two Raspberry Pi Big
who ran workshops, who manned the who has volunteered at one of our Birthday Weekends.
front desk, who helped us with setup events. We simply could not do it Mike @recantha / Tim @geeky_tim
98 magpi.cc The secret to success

MagPi86 Magazine

Uploaded by

Copyright:

Available Formats

MagPi86 Magazine

Uploaded by

Document Information

Copyright

Available Formats

Share this document

Share or Embed Document

Sharing Options

Did you find this document useful?

Is this content inappropriate?

Copyright:

Available Formats

MagPi86 Magazine

Uploaded by

Copyright:

Available Formats

BUY IN PRINT WORLDWIDE MAGPI.

Issue 86 October 2019 magpi.cc The official Raspberry Pi magazine

BUILD AN INTERACTIVE MAKE 8-BIT GAMES WITH

Subscribe by phone: 01293 312193

Lucy Hattersley Editor

MudPi Stonehenge Skyscape

The Big Feature

PecanPi Halloween costume projects!

06 magpi.cc Raspberry Pi hosts Scratch Conference Europe

 ore children from more backgrounds

Raspberry Pi hosts Scratch Conference Europe magpi.cc 07

Shaun the Sheep

08 magpi.cc Shaun the Sheep enters space race

Shaun takes his

for the prestige of having your animation hosted

Code Club exclusive

Shaun the Sheep enters space race magpi.cc 09

explains. “The system controls the irrigation to

It became apparent that

Automate gardening Sensors are placed

> It works for indoor

> People are already

Irrigation hoses are

Indoor hydroponics can also be controlled by MudPi

“I’ve had a Raspberry Pi sitting around that my

 ost of the resources I

Proof is in the parsnips

Plan your garden – specifically, how you plan

The MudPi software can be found on GitHub

Press a single button to

‘driving event’ on the owner’s designated storage

14 magpi.cc Dride Zero for Raspberry Pi

The Dride Zero can be > Yossi hand-soldered

connected to Android and 150 Dride Zero units

iOS apps > The original

Dride Zero for Raspberry Pi magpi.cc 15

Share your ride

Install the DrideOS to a microSD card using

The Dride Universal app

T hese days the units are built at a

16 magpi.cc Dride Zero for Raspberry Pi

With the Dride Zero

Pimp your Dride

Dride may sell the case separately. magpi.cc/MzBaGy

Dride Zero for Raspberry Pi magpi.cc 17

 hat it does is give a live view of the stones as

18 magpi.cc Stonehenge Skyscape

communicate with it via Raspberry Pi so that full-

To protect the equipment, > The hardware cost

> Suncalc2 and

> The site had 80,000

Stonehenge Skyscape magpi.cc 19

Magic Wand with

cast incredible charms,” he reveals. “That was the

Jasmeet used this

20 magpi.cc Magic Wand with Computer Vision

The OpenCV computer

locks. So, appropriately, if someone draws a letter

Magic Wand with Computer Vision magpi.cc 21

The camera is housed

ore children from more backgrounds

Shaun takes his

It became apparent that

> It works for indoor

> People are already

Irrigation hoses are

Indoor hydroponics can also be controlled by MudPi

ost of the resources I

The Dride Zero can be > Yossi hand-soldered

iOS apps > The original

The Dride Universal app

T hese days the units are built at a

With the Dride Zero

hat it does is give a live view of the stones as

To protect the equipment, > The hardware cost

> Suncalc2 and

> The site had 80,000

Jasmeet used this

Dan accidentally cracked the

T he flash unit has the

Be careful while