LED Cube/Benutzeranleitung

Aus Wiki CCC Göttingen
Zur Navigation springen Zur Suche springen
LED Cube-Serie

Kapitel 1: Bauen

Teil 0: Voraussetzungen & Vorbereitung

Teil 1: PCB Lötanleitung

Teil 2: Cube Lötanleitung

Teil 3: Zusammensetzen und testen

Kapitel 2: Spielen

Benutzeranleitung

Eine Animation erstellen

Kapitel 3: Lernen

Die Elektronik verstehen

Eigene Programme

Nun werden wir lernen den Cube zu benutzen. Aber zunächst etwas Theorie.

LED Cube Operation

Der LED-Cube kann vor dem Eingeschalten in zwei Modi gestellt werden:

  • Bootloadermodus: Im Bootloadermodus überprüft der LED-Cube alle USB-Host, zu denen er verbunden ist und wartet darauf, dass eine neue Application auf ihn transferiert wird.
  • Applicationsmodus: Die Application die das letzte Mal auf den LED-Cube gespielt wurd, als dieser im Bootloadermodus war, wird ausgeführt.

Der Modus in dem der LED-Cube gestartet wird, wird durch den Bootloaderjumper gesetzt. Ist dieser auf der linken Seite, wird der LED-Cube im Bootloadermodus starten.

Wenn er auf den rechten der beiden Pins ist, oder komplett entfernt wurde, wird der LED-Cube im Applicationsmodus starten.

Creating Your Own Animation

There are many ways for creating an animation. For now, we will stick to separate frames which will be played in an endless loop. You can use our LED Cube web interface to create your animation: cube6.0x53a.de.

If you do not have IPv6 uplink visiting this site will fail always. You may then also use a proxied version of this web interface at sandroknauss.de/ledcube. This proxy is kindly provided by hefee for those of you who are still stuck in an IPv4 age. This version is limited to generating hex files and saving a animations. However, you can not re-load them. If you do want to use the full version of the web interface, get IPv6 uplink. The direct way for this would be to ask your Internet Service Provider. Alternatively you can ask SiXXS to provide you with an IPv6 tunnel.

Simply use this web interface to click your own animation. Once you have finished one, click on the 'Generate HEX' button. This will generate an application for your LED Cube, playing the animation you just created. Save this hex file on your disk and remember where it was.

Loading Your Application

Now we are going to load the application which is contained in the HEX file you just downloaded. To do this, we first need to get the host application to talk to the LED Cube bootloader. This process is different for Windows and Linux:

Windows

@todo

Linux

You first need some software. In particular:

  • make
  • gcc
  • libusb (including headers)
  • git

For example, if you are using Ubuntu, the only thing you need to do is:

sudo apt-get install git git-core libusb-dev

Now we check out the LED Cube git:

git clone http://www.0x53a.de/git/cube-3

Then enter the directory where the bootloader tool is located.

cd cube-3/bootloader/commandline

And let's build this thing

make

Now, if everything went as expected, you will have a new file in this Folder. Type ls to check if it appeared:

ls

You should see a file named 'bootloadHID'. (You will also see a bootloadHID.exe. This is not it. This is for the windows people who are unable to build the tool for themselves ;) .)

Now set the bootloader jumper on your cube to bootloader mode (see above if you skipped the previous part) and reconnect it. Then flash the new software onto the cube using the following command:

sudo ./bootloadHID -r <path to the hex file you just downloaded>