Skip to content

Commit

Permalink
BOM update
Browse files Browse the repository at this point in the history
  • Loading branch information
@sy2002
sy2002 committed Jun 3, 2016
1 parent 926da5a commit ef39b79
Show file tree
Hide file tree
Showing 4 changed files with 32 additions and 95 deletions.
90 changes: 9 additions & 81 deletions README.MD
View file
Original file line number Diff line number Diff line change
@@ -1,84 +1,12 @@
TeleBall - Retro Handheld Game Console
======================================
TeleBall
========

![DeviceInHand](doc/images/intro_breakout.jpg)
Build your own Arduino based retro handheld game console.

What is TeleBall?
-----------------

TeleBall is a handheld game console. You cannot buy it. You need to build it
by yourself. It lets you play **BreakOut** in single-player mode using one
device and **Tennis for Two** in multi-player mode using two devices
communicating via radio.

TeleBall is pretty retro and very minimalistic: It features an
8x8 pixel LED matrix display, a paddle as game controller and one button.
Therefore, the range of possible games is limited but you will be surprised
how much fun and even zenlike meditation this kind of gameplay can bring you,
particularly when you play Tennis for Two with a friend.

![TennisOnTwoDevices](doc/images/intro_tennis.jpg)

About this GIT Repository
-------------------------

This repository contains everything you need to build your own TeleBall
device:

* CAD .stl and .cmb.gz data for your 3D printer or for any online 3D print
shop to 3D print the TeleBall case

* Eagle PCB layout for any online PCB manufacturer to make the TeleBall PCB

* Part lists and hints how to build the hardware

* Arduino source code to flash the firmware

TeleBall is made using the
[Arduino Nano platform](http://arduino.cc/en/Main/ArduinoBoardNano) on a
custom PCB.

Browse TeleBall's [project page](http://sy2002.github.io/TeleBall)
for a much better documentation, including a how-to play and
how-to build guide and a bill of materials (BOM). The project page
is also available offline using `index.html` in the root folder of
this repository.

### Folder Structure

cad: CAD data for 3D printing the TeleBall case
Use ".stl" to modify the design or to create a custom output file.
Most online 3D print shops can use the ".cmb.gz" for production.
Made with FreeCad: http://www.freecadweb.org

doc: HTML documentation; use `index.html` in root folder to browse

eagle: Electronic schematic diagram including PCB layout.
The libraries.zip files are only needed, if you want to modify
anything; otherwise you can just send the ".brd" file to any
online PCB manufacturing company to receive a TeleBall PCB.
Made with the freeware version of Eagle: http://www.cadsoftusa.com

src: Arduino source code aka Sketch in the subfolder "TeleBall".
Compile and upload it to your device using Arduino's IDE. You need
to install the libraries from libraries.zip first, before being
able to compile. The "archive" folder contains historic versions.
Made with Arduino: http://arduino.cc/de/Main/Software

The Makers
----------

TeleBall is brought to you by

* [sy2002](http://www.sy2002.de): idea, code and original circurit design
* doubleflash: additional circurit design and board layout
* lamags: body housing/case

TeleBall was designed, built and released as an Open Source / Open Hardware
project during August 2014 and January 2015.

TeleBall is a project of
[MEGA - Museum of Electronic Games & Art](http://www.m-e-g-a.org).

We are looking forward to hearing from you. Email to sy2002 at teleball.org
This repository contains the [Jekyll](http://jekyllrb.com) source code
for TeleBall's project website and documentation:
[http://sy2002.github.io/TeleBall](http://sy2002.github.io/TeleBall)

Switch to the [TeleBall Master Repository](https://github.com/sy2002/TeleBall)
to work with the official release package that is including the rendered
HTML version of this documentation.
8 changes: 8 additions & 0 deletions WHATSNEW.MD
View file
Original file line number Diff line number Diff line change
@@ -1,3 +1,11 @@
TeleBall - Version 1.3 - 06/03/16
---------------------------------

Improved documentation: Updated the Bill of Material (BOM) in the
"Electronics" section (some links and some part numbers where outdated).

From a technical perspective, Version 1.3 is identical to Version 1.2.

TeleBall - Version 1.2 - 01/01/15
---------------------------------

Expand Down
18 changes: 9 additions & 9 deletions doc/electronics.html
View file
Original file line number Diff line number Diff line change
Expand Up @@ -316,14 +316,14 @@ <h2 id="bill-of-materials">Bill of Materials</h2>
<tr>
<td><img src="eagle/bom_max7221.jpg" alt="IC1" /></td>
<td>IC1</td>
<td>The MAX7221CNG is the display driver of the TeleBall.</td>
<td>Standard / Farnell <code>1593381</code></td>
<td>The MAX7221CNG+ is the display driver of the TeleBall.</td>
<td>Standard / Farnell <code>2516083</code></td>
</tr>
<tr>
<td><img src="eagle/bom_radio.jpg" alt="SV1" /></td>
<td>SV1</td>
<td>NRF24L01+ 2.4GHz Antenna Wireless Transceiver Module for Arduino on a breakout board</td>
<td>There are plenty of vendors on ebay selling this. Search for <code>NRF24L01+ Arduino</code> on eBay; we used <a href="http://r.ebay.com/2JUtNU">this one</a>.</td>
<td>There are plenty of vendors on ebay selling this. Search for <code>NRF24L01+ Arduino</code>.</td>
</tr>
<tr>
<td><img src="eagle/bom_rohm.jpg" alt="IC2 VREG3" /></td>
Expand All @@ -346,8 +346,8 @@ <h2 id="bill-of-materials">Bill of Materials</h2>
<tr>
<td><img src="eagle/bom_button.jpg" alt="BUTTON" /></td>
<td>BUTTON</td>
<td><a href="http://focan.en.alibaba.com/">Focan Electronic</a> PBS-10C-2 Reverse-logic button by. If you need to find an alternative, use the <a href="http://www.pollin.de/shop/downloads/D420320D.PDF">datasheet</a> to get the exact specs.</td>
<td>Not that easy to find. We got it from eBay.de (.de not .com); it is also available on alibaba.com; googling <code>PBS-10C</code> might also help. Amazon.com has similar buttons on stock if you search for “<code>pbs push button</code>”.</td>
<td><a href="http://focan.en.alibaba.com/">Focan Electronic</a> PBS-10C-2 reverse-logic button. If you need to find an alternative, use the <a href="http://www.pollin.de/shop/downloads/D420320D.PDF">datasheet</a> to get the exact specs.</td>
<td>Not that easy to find. Try Amazon, eBay, Alibaba; googling <code>PBS-10C</code> might also help. There might be similar buttons available, if you search for “<code>pbs push button</code>”. IMPORTANT: The PBS-10C-2 is a reverse-logic button, that closes the circuit when not being pressed and opens it when being pressed. If you use another button type, you might need to adjust <a href="https://github.com/sy2002/TeleBall/blob/master/src/TeleBall/TeleBall.ino#L1128">this line of code</a>.</td>
</tr>
<tr>
<td><img src="eagle/bom_speaker.jpg" alt="LS" /></td>
Expand All @@ -358,8 +358,8 @@ <h2 id="bill-of-materials">Bill of Materials</h2>
<tr>
<td><img src="eagle/bom_poti.jpg" alt="POTI" /></td>
<td>POTI</td>
<td>Monacor VRB-141M10 10 kΩ linear mono potentiometer, 6mm shaft diameter, 25mm shaft length + 9,5mm body. If you need to find an alternative, use the <a href="http://www.monacor.co.uk/products//vnr/012620/?type=257&amp;no_cache=1">datasheet</a> to get the exact specs.</td>
<td>Monacor UK shop <a href="http://www.monacor.co.uk/products/0/vnr/012620/">article VRB-141M10</a>, click on “Find Your Retailer” on the right sidebar. Alternately google for “<code>Monacor VRB-141M10 10k linear mono potentiometer</code>”.</td>
<td>Monacor VRB-141M10 10 kΩ linear mono potentiometer, 6mm shaft diameter, 25mm shaft length + 9,5mm body. If you need to find an alternative, use the <a href="http://www.monacor.co.uk/categories/potentiometers/vnr/012620/">datasheet</a> to get the exact specs.</td>
<td>Monacor UK shop <a href="http://www.monacor.co.uk/categories/potentiometers/vnr/012620/">article VRB-141M10</a>, click on “Find Your Retailer” on the right sidebar. Alternately google for “<code>Monacor VRB-141M10 10k linear mono potentiometer</code>”.</td>
</tr>
<tr>
<td><img src="eagle/bom_c10uf.jpg" alt="C2" /></td>
Expand Down Expand Up @@ -389,13 +389,13 @@ <h2 id="bill-of-materials">Bill of Materials</h2>
<td><img src="eagle/bom_knob.jpg" alt="Knob" /></td>
<td>Knob</td>
<td>Black aluminum rotary knob, 40mm diameter for 6mm shaft</td>
<td>Not easy to find. We found <a href="http://r.ebay.com/idjUgo">ours</a> on ebay.de (.de not .com). Google for <code>Black aluminum rotary knob, 40mm diameter for 6mm shaft</code>, sometimes vendors call it a “Volume Control Potentiometer Knob”.</td>
<td>Not easy to find. Try eBay’s <a href="http://www.ebay.com/bhp/audio-knobs">Audio Knobs Section</a> or google for <code>Black aluminum rotary knob, 40mm diameter for 6mm shaft</code>, sometimes vendors call it a “Volume Control Potentiometer Knob”.’</td>
</tr>
<tr>
<td><img src="eagle/bom_clip.jpg" alt="Battery Clip" /></td>
<td>Battery Clip</td>
<td>KEYSTONE BK5201 Battery Clip, 11.2x12.0 mm, 0.8 mm height of the foot, 10.5mm height including spring. You need 4 of them per TeleBall. Get the <a href="http://www.luedeke-elektronic.de/images/product_images/popup_images/4836_1.jpg">specs here</a> if you need to find an alternative.</td>
<td>Not easy to find. Google for <code>KEYSTONE BK5201</code> or <code>KEYSTONE BK5201 Battery Holder</code> or similar combinations.</td>
<td>Not easy to find. Amazon or eBay sometimes have it. Google for <code>KEYSTONE BK5201</code> or <code>KEYSTONE BK5201 Battery Holder</code> or similar combinations.</td>
</tr>
</tbody>
</table>
Expand Down
11 changes: 6 additions & 5 deletions doc/software.html
View file
Original file line number Diff line number Diff line change
Expand Up @@ -42,8 +42,8 @@ <h1 id="teleball---software">TeleBall - Software</h1>
<h2 id="basics">Basics</h2>

<p>The newsest stable release version is
<a href="https://github.com/sy2002/TeleBall/releases/tag/V1.2">TeleBall Version 1.2</a>,
you will also find the releasenotes here.</p>
<a href="https://github.com/sy2002/TeleBall/releases/tag/V1.3">TeleBall Version 1.3</a>,
you will also find the release notes here.</p>

<p>TeleBall is implemented in a C / C++ mixture (more C than C++) as this is
rather typical for Arduino projects. You need the
Expand All @@ -68,8 +68,9 @@ <h3 id="folder-structure">Folder Structure</h3>
<h3 id="libraries">Libraries</h3>

<p>TeleBall is using two 3rd party libraries. As mentioned above, the GIT repository
contains the versions of these libraries that are known to work with TeleBall. If
you prefer to use newer versions, you can find them here:</p>
contains a ZIP with versions of these libraries that are known to work with TeleBall.
We strongly recommend that you use these versions. If you prefer to
use newer versions, you can find them here:</p>

<ul>
<li>MAX7221 driver: <a href="https://github.com/wayoda/LedControl">wayoda / LedControl</a></li>
Expand Down Expand Up @@ -730,7 +731,7 @@ <h5 id="pseudocode-for-slave-game-loop-tennisplayslave">Pseudocode for Slave Gam

<h4 id="identifying-the-master-and-the-slave-device">Identifying the Master and the Slave Device</h4>

<p>The current version 1.2 of the TeleBall firmware shows during the first two seconds of the
<p>The current version 1.3 of the TeleBall firmware shows during the first two seconds of the
“question mode” (in Device Pairing), while the “?” displayed statically, if a device is
a master or a slave device:</p>

Expand Down

0 comments on commit ef39b79

Please sign in to comment.