sparkfun Roshamglo Badge Kit Technical document

Roshamglo Hookup Guide


Roshamglo Hookup Guide SparkFun Wish List
Introduction
The Roshamglo Badge Kit is an easy to assemble badge that allows you to
play Rock-Paper-Scissors with an opponent using infrared (IR)
communication. The Roshamglo will also keep track of your score, which
you can upload to the scoreboard station and see how you’re doing against
other people at the event.
Required Materials
To follow along with this hookup guide, you will need the following:
Solder Lead Free - 15-gram Tube
TOL-09163
This is your basic tube of unleaded (Pb-free) solder with a 60/40 no cl…
Hakko FX888D Soldering Station
TOL-11704
For over 50 years, Hakko has been producing superior quality solderi…
Suggested Reading
SparkFun Roshamglo Badge Ki
t

KIT-14130
Page 1 of 7

If you aren’t familiar with the following concepts, we recommend checking
out these tutorials before continuing.
Hardware Overview
The Roshamglo uses the following:
•ATtiny84
•IRLED
• IR receiver with built in 38kHz demodulator
• USB programming
• Programmable red and green LED
• A switch for power
• 5-way switch for input
• Reset switch
• 6x AAA PTH battery clips
IR Communicatio
n
This tutorial explains how common
IR communication works, as well as
shows you how to set up a simple IR
transmitter and receiver.
What is an Arduino?
What is this 'Arduino' thing anyway?
How to Solder: Through
-
Hole Solderin
g
This tutorial covers everything you
need to know about through-hole
soldering.
How to Install an ATtiny
Bootloader With Virtual USB
With this, you will be able to upload
Arduino sketches directly to the
ATtiny84 over USB without needing
to use a programming device (such
as another Arduino or FTDI chip).
Page 2 of 7

• 3x AAA batteries for power
The brains behind the Roshamglo is an ATtiny84, a light weight Arduino
compatible microcontroller. The ATtiny84 comes with the following:
• 8kB of flash memory for our program (~6kB after the bootloader is
installed)
• 512B of SRAM, which stores our variables used in our program
• 512B of EEPROM
• 12 IO pins MAX (the Roshamglo breaks out 9 of these pins)
• 10-bit analog to digital converter which can be used on 8 pins
For details about what each pin is able to do, refer to the table below.
Pin Analog or Digital Additional Uses Roshamglo Uses
0 Both Analog Reference 5-way switch down
1 Both -- 5-way switch right
2 Both -- 5-way switch up
3 Both -- IR Receiver
4 Both SCK, SCL 5-way switch left
5 Both MISO, PWM IR LED
6 Both MOSI, SDA, PWM 5-way switch center
7 Both PWM Green LED
8 Digital PWM Red LED
Missing from the list, are digital pins 9 and 10. The bootloader,
uses these two pins for USB programming.
Each of these pins have been broken out to edge of the board to make
customization easy! If you would like to use any of these pins for something
other than what it’s currently connected two, we provided jumpers that can
easily be cut with a hobby knife. The only pins that do not have a jumper on
them are the pins used for the 5-way switch. The pins for the switch use the
ATtiny’s internal pull up resistors, so as long as the switch is not closed, the
pin can be configured in any way you’d like without having to cut traces.
Page 3 of 7

One important feature missin
g
If you hadn’t noticed in the pin description, there was no mention of RX or
TX pins. This is because unfortunately the ATtiny84 doesn’t have a
hardware UART. The UART is used for serial communication, whether it’s
for programming, or printing messages to the serial window. You might be
thinking “But doesn’t the USB connector provide communication between
the ATtiny and computer?”, and you’re right; it does. To keep the
bootloader size as small as possible, the bootloader only allows for USB
programming. For serial debugging, you’ll need a USB cable and a USB-to-
Serial adapter, and Software Serial library to send messages to a
computer. You can learn more about serial communication here.
Hardware Assembly
To use your Roshamglo, all that’s needed is to solder in the battery clips.
To insert the battery clips, you’ll need to turn the board to the side with the
pictures of the batteries and push the battery clips into the holes. Make sure
that the metal tab on the ends are facing away from the center of the board.
Make sure the battery clips aren’t touching each other! To make sure they
won’t short against each other, make sure the clips sit flat against the circuit
board.
After the clips are installed, you can turn the board over and solder all of the
joints on the top side of the board. When they’re all soldered together, they
should look like this:
Installing the batteries are easy, but as you install the batteries, make sure
you insert the batteries in the same orientation as the silkscreen image
between each pair of battery clips. After the batteries are installed, you’re
all set! You can move the switch on the left side of the board to “ON”, and
you should see the red power LED come on.
Page 4 of 7

How to Use the Roshamglo
To use the Roshamglo, first make sure that the board is on. When you
move the power switch to “ON”, the red LED should illuminate.
How to Play
Playing the game is very straight forward, next to the 5-way switch are
three images that correspond to your three possible moves: rock, paper,
and scissors. To set your move as rock, you will push the switch to the left
towards the rock image. Paper and scissors are played the same way, but
this time towards their corresponding images. When you move the switch,
the green LED will flash quickly every time the IR LED sends a signal. Once
the LED starts to blink, you’ll want to point the USB connector towards your
opponent’s controller.
If you’ve pressed the button by mistake, you can press the switch in any
direction to cancel the move. Once you select your move though, the green
LED will blink for a few seconds. After both sides have received their
opponent’s move, the center LEDs will display one of the following:
• Solid red - lose
• Solid green - win
• Alternating red and green - tie
• Blinking red - see explanation below
• Fading - timeout. Try standing closer to your opponent and aiming
your USB connector at their USB connector
A blinking red LED could mean one of two things. One possibility is that you
have played against an opponent too many times. Each controller has a
unique ID and your Roshamglo will not function with the same opponent
after 15 rounds. We want the Roshamglo to start a conversation with
people around you, and the Roshamglo can be used to help break the ice.
So walk around and continue on your quest of total domination! Another
possibility is that the score saved to your controller is full. You can dump
your points by heading over to the scoreboard station.
Viewing and Uploading Your Score
You can view your score by closing the 5-way switch’s center switch (push
the switch straight down towards the top of the board). Each time the green
LED turns on, represents one point. The score is saved to a 8-bit register,
which means that the maximum score you can have saved is 255 points.
You can clear your score by uploading it to the scoreboard station. If the
LED is red, it means that your current saved score is 0.
Page 5 of 7

To upload your score, head over to the scoreboard station. With the board
powered on, insert the board to the station and move the 5-way switch to
the down position (towards the SparkFun Logo and lanyard clip). Just like
when you’re playing a game, the green LED will flash a few times. The
score will be successfully read when the LED changes to solid green. If the
LED is solid red, that means that it was not able to read the score.
Summary of the LED Indicator
If the center LED is fading on and off, it means you’re in standby mode. In
standby, the board will go into a deep sleep for two seconds, and then
wake up to fade LED on and off. Pressing the 5-way switch in any direction
will wake up the Roshamglo and perform the function attached to that
switch. There are three other modes that control the LED, those LED
patterns are described below.
Playing a game:
LED Color Meaning
Blinking Green Transmitting IR.
Solid Green You won!
Solid Red You lost.
Alternating Red and
Green
It's a tie!
Blinking Red Case 1: Played this person too many times.
Case 2: Saved score is too high. Upload score
to reset.
Checking your score:
LED Color Meaning
Blinking
Green
Each blink represents 1 point.
Red Your saved score is 0. Go find someone to play
against!
Uploading your score:
LED Color Meaning
Blinking
Green
Transmitting IR.
Solid Green Score uploaded successfully. You can now remove your
controller.
Red Unable to upload score.
Resources and Going Further
Now that you’ve successfully got your Roshamglo up and running, it’s time
to incorporate it into your own project! If you’d like to hack your Roshamglo,
you should check out the Hack Your Roshamglo Badge tutorial.
For more information, check out the resources below:
Page 6 of 7

• Eagle Schematic
• Eagle Design Files
• Roshamglo Source Code
• Roshamglo GitHub Repository
Need some inspiration for your next project? Check out some of these
related tutorials:
Hack Your Roshamglo Badge
Learn how to customize and
program your Roshamglo badge.
IR Control Kit Hookup Guide
How to get the most out of the IR
receivers and transmitters included
in the IR Control Kit.
Boss Alar
m
Build a Boss Alarm that alerts you of
anyone walking into your office and
automatically changes your
computer screen.
ZX Distance and Gesture
Sensor Hookup Guide
How to connect and use the
SparkFun ZX Distance and Gesture
Sensor with an Arduino.
Roshamglo Project: TV-B
-
Gone
Turn your Roshamglo board into a
(nearly) universal TV power button.
Page 7 of 7
3
/
22
/
201
7
https://learn.sparkfun.com/tutorials/roshamgl
o
-hooku
p
-guide?_ga=1.153078457.1064614
6
...