Skip to content

Commit ef39b79

Browse files
committed
BOM update
1 parent 926da5a commit ef39b79

File tree

4 files changed

+32
-95
lines changed

4 files changed

+32
-95
lines changed

README.MD

Lines changed: 9 additions & 81 deletions
Original file line numberDiff line numberDiff line change
@@ -1,84 +1,12 @@
1-
TeleBall - Retro Handheld Game Console
2-
======================================
1+
TeleBall
2+
========
33

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

6-
What is TeleBall?
7-
-----------------
8-
9-
TeleBall is a handheld game console. You cannot buy it. You need to build it
10-
by yourself. It lets you play **BreakOut** in single-player mode using one
11-
device and **Tennis for Two** in multi-player mode using two devices
12-
communicating via radio.
13-
14-
TeleBall is pretty retro and very minimalistic: It features an
15-
8x8 pixel LED matrix display, a paddle as game controller and one button.
16-
Therefore, the range of possible games is limited but you will be surprised
17-
how much fun and even zenlike meditation this kind of gameplay can bring you,
18-
particularly when you play Tennis for Two with a friend.
19-
20-
![TennisOnTwoDevices](doc/images/intro_tennis.jpg)
21-
22-
About this GIT Repository
23-
-------------------------
24-
25-
This repository contains everything you need to build your own TeleBall
26-
device:
27-
28-
* CAD .stl and .cmb.gz data for your 3D printer or for any online 3D print
29-
shop to 3D print the TeleBall case
30-
31-
* Eagle PCB layout for any online PCB manufacturer to make the TeleBall PCB
32-
33-
* Part lists and hints how to build the hardware
34-
35-
* Arduino source code to flash the firmware
36-
37-
TeleBall is made using the
38-
[Arduino Nano platform](http://arduino.cc/en/Main/ArduinoBoardNano) on a
39-
custom PCB.
40-
41-
Browse TeleBall's [project page](http://sy2002.github.io/TeleBall)
42-
for a much better documentation, including a how-to play and
43-
how-to build guide and a bill of materials (BOM). The project page
44-
is also available offline using `index.html` in the root folder of
45-
this repository.
46-
47-
### Folder Structure
48-
49-
cad: CAD data for 3D printing the TeleBall case
50-
Use ".stl" to modify the design or to create a custom output file.
51-
Most online 3D print shops can use the ".cmb.gz" for production.
52-
Made with FreeCad: http://www.freecadweb.org
53-
54-
doc: HTML documentation; use `index.html` in root folder to browse
55-
56-
eagle: Electronic schematic diagram including PCB layout.
57-
The libraries.zip files are only needed, if you want to modify
58-
anything; otherwise you can just send the ".brd" file to any
59-
online PCB manufacturing company to receive a TeleBall PCB.
60-
Made with the freeware version of Eagle: http://www.cadsoftusa.com
61-
62-
src: Arduino source code aka Sketch in the subfolder "TeleBall".
63-
Compile and upload it to your device using Arduino's IDE. You need
64-
to install the libraries from libraries.zip first, before being
65-
able to compile. The "archive" folder contains historic versions.
66-
Made with Arduino: http://arduino.cc/de/Main/Software
67-
68-
The Makers
69-
----------
70-
71-
TeleBall is brought to you by
72-
73-
* [sy2002](http://www.sy2002.de): idea, code and original circurit design
74-
* doubleflash: additional circurit design and board layout
75-
* lamags: body housing/case
76-
77-
TeleBall was designed, built and released as an Open Source / Open Hardware
78-
project during August 2014 and January 2015.
79-
80-
TeleBall is a project of
81-
[MEGA - Museum of Electronic Games & Art](http://www.m-e-g-a.org).
82-
83-
We are looking forward to hearing from you. Email to sy2002 at teleball.org
6+
This repository contains the [Jekyll](http://jekyllrb.com) source code
7+
for TeleBall's project website and documentation:
8+
[http://sy2002.github.io/TeleBall](http://sy2002.github.io/TeleBall)
849

10+
Switch to the [TeleBall Master Repository](https://github.com/sy2002/TeleBall)
11+
to work with the official release package that is including the rendered
12+
HTML version of this documentation.

WHATSNEW.MD

Lines changed: 8 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1,3 +1,11 @@
1+
TeleBall - Version 1.3 - 06/03/16
2+
---------------------------------
3+
4+
Improved documentation: Updated the Bill of Material (BOM) in the
5+
"Electronics" section (some links and some part numbers where outdated).
6+
7+
From a technical perspective, Version 1.3 is identical to Version 1.2.
8+
19
TeleBall - Version 1.2 - 01/01/15
210
---------------------------------
311

doc/electronics.html

Lines changed: 9 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -316,14 +316,14 @@ <h2 id="bill-of-materials">Bill of Materials</h2>
316316
<tr>
317317
<td><img src="eagle/bom_max7221.jpg" alt="IC1" /></td>
318318
<td>IC1</td>
319-
<td>The MAX7221CNG is the display driver of the TeleBall.</td>
320-
<td>Standard / Farnell <code>1593381</code></td>
319+
<td>The MAX7221CNG+ is the display driver of the TeleBall.</td>
320+
<td>Standard / Farnell <code>2516083</code></td>
321321
</tr>
322322
<tr>
323323
<td><img src="eagle/bom_radio.jpg" alt="SV1" /></td>
324324
<td>SV1</td>
325325
<td>NRF24L01+ 2.4GHz Antenna Wireless Transceiver Module for Arduino on a breakout board</td>
326-
<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>
326+
<td>There are plenty of vendors on ebay selling this. Search for <code>NRF24L01+ Arduino</code>.</td>
327327
</tr>
328328
<tr>
329329
<td><img src="eagle/bom_rohm.jpg" alt="IC2 VREG3" /></td>
@@ -346,8 +346,8 @@ <h2 id="bill-of-materials">Bill of Materials</h2>
346346
<tr>
347347
<td><img src="eagle/bom_button.jpg" alt="BUTTON" /></td>
348348
<td>BUTTON</td>
349-
<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>
350-
<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>
349+
<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>
350+
<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>
351351
</tr>
352352
<tr>
353353
<td><img src="eagle/bom_speaker.jpg" alt="LS" /></td>
@@ -358,8 +358,8 @@ <h2 id="bill-of-materials">Bill of Materials</h2>
358358
<tr>
359359
<td><img src="eagle/bom_poti.jpg" alt="POTI" /></td>
360360
<td>POTI</td>
361-
<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>
362-
<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>
361+
<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>
362+
<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>
363363
</tr>
364364
<tr>
365365
<td><img src="eagle/bom_c10uf.jpg" alt="C2" /></td>
@@ -389,13 +389,13 @@ <h2 id="bill-of-materials">Bill of Materials</h2>
389389
<td><img src="eagle/bom_knob.jpg" alt="Knob" /></td>
390390
<td>Knob</td>
391391
<td>Black aluminum rotary knob, 40mm diameter for 6mm shaft</td>
392-
<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>
392+
<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>
393393
</tr>
394394
<tr>
395395
<td><img src="eagle/bom_clip.jpg" alt="Battery Clip" /></td>
396396
<td>Battery Clip</td>
397397
<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>
398-
<td>Not easy to find. Google for <code>KEYSTONE BK5201</code> or <code>KEYSTONE BK5201 Battery Holder</code> or similar combinations.</td>
398+
<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>
399399
</tr>
400400
</tbody>
401401
</table>

doc/software.html

Lines changed: 6 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -42,8 +42,8 @@ <h1 id="teleball---software">TeleBall - Software</h1>
4242
<h2 id="basics">Basics</h2>
4343

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

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

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

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

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

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

0 commit comments

Comments
 (0)