Gordius TINYBOX4KEMPER User manual

THE TINYBOX4KEMPER
User Manual v.1

1
Contents
The TinyBox4Kemper hardware .............................................................................................................. 2
Connecting the TinyBox4Kemper to your rig .......................................................................................... 3
Adding the JackBox to your rig ................................................................................................................ 4
Using a computer with the TinyBox4Kemper.......................................................................................... 5
The TinyBoxServer software .................................................................................................................... 6
Launching TinyBoxServer .................................................................................................................... 6
Connecting to TinyBoxServer .............................................................................................................. 7
Using the TinyBox4Kemper editor ...................................................................................................... 8
Displaying Profiler status info, and remotely controlling your Profiler .............................................. 9
Upgrading the TinyBox4Kemper firmware ........................................................................................ 12
Programming the TinyBox4Kemper using the G# language ................................................................. 13
The TinyBox4Kemper setup structure ............................................................................................... 13
Example 1 : the general setup syntax ................................................................................................ 14
Example 2 : sending MIDI messages ................................................................................................. 15
Example 3 : programming expression pedals .................................................................................... 16
Example 4 : using variables ............................................................................................................... 17
Example 5 : using conditional commands ......................................................................................... 18
G# language reference .......................................................................................................................... 19
Comments ......................................................................................................................................... 19
DEFINE ............................................................................................................................................... 19
LINK .................................................................................................................................................... 20
MIDI commands ................................................................................................................................ 20
DELAY command ............................................................................................................................... 21
Expression pedal commands ............................................................................................................. 21
Variable commands ........................................................................................................................... 22
Conditional commands ...................................................................................................................... 23
Conditions.......................................................................................................................................... 24

2
The TinyBox4Kemper hardware
1. Power input : connect any power adapter delivering 9V AC or DC, 500mA or more
2. 7-pins MIDI connector for two-way connection with FCB1010(*)
3. USB connector for connection with a Windows or Mac computer
4. MIDI IN connector, to be connected to the MIDI OUT connector of the Kemper Profiler
5. MIDI OUT connector, to be connected to the MIDI IN connector of the Kemper Profiler
6. Red power LED
7. Blue status LED
- Slow blinking (each 2 seconds) = the TinyBox4Kemper is started and ready for connection
- Fast blinking (each second) = the TinyBox4Kemper has detected a connected Profiler
- LED off, except when blinking = no USB connection
- LED on, except when blinking = USB connection with a computer detected
(*) The 7-pins cable transfers MIDI to and from FCB1010, along with FCB1010 phantom power. For
plug-and-play compatibility the FCB1010 needs to be equipped with a “Single Cable Kit” (available at
http://shop.tinybox.rocks) which makes the FCB1010 phantom powered and gives it the same 7-pins
MIDI connector for connection with the TinyBox4Kemper.
The illustration below compares the 7-pins connector with regular MIDI IN and MIDI OUT connectors:

3
Connecting the TinyBox4Kemper to your rig
The TinyBox4Kemper allows you to synchronize a complex MIDI based rig with your Kemper Profiler.
To do so, it listens to rig and effect changes in the Profiler. This is possible by connecting a MIDI cable
from Profiler MIDI OUT to TinyBox MIDI IN.
Each change can trigger a TinyBox4Kemper preset, which sends any number of additional MIDI
commands. These commands travel from TinyBox4Kemper MIDI OUT to Profiler MIDI IN and from
there through its MIDI THRU connector to all other devices down the MIDI chain.
The TinyBox4Kemper reacts on Profiler rig changes to send extra MIDI messages to other devices. It
doesn’t matter how the rig change is done: it can be through the local buttons on the Profiler, by using
the Kemper Remote, or by using a third party MIDI controller like the FCB1010.
When using the FCB1010 with UnO4Kemper firmware, the TinyBox4Kemper allows you to connect it
to your rig through 1 single cable, just like the Remote. For that a “Single Cable Kit” is available, which
adds a phantom power option to the FCB1010, and replaces the two 5-pins MIDI connectors with a
single 7-pins MIDI connector and a power switch. As the TinyBox also has a 7-pins connector, 2-way
MIDI plus power can be sent through a single MIDI cable. No more power cable required at your feet,
the FCB1010 is powered from the TinyBox4Kemper.

4
Adding the JackBox to your rig
The JackBox(*) allows you to turn up to 4 regular expression pedals into continuous MIDI controllers.
The MIDI stream of the JackBox can be seamlessly merged with the UnO4Kemper MIDI stream coming
from the FCB1010, by connecting the FCB1010 to the JackBox as depicted below, using a short 7-pin
MIDI cable (this type of cable can be optionally ordered along with the JackBox).
Also when using the Remote as MIDI controller, you can add the JackBox to your rig by connecting it
to the TinyBox4Kemper as shown above. This wiring gives the advantage that you don’t need to run
multiple long analog cables from your expression pedals to the Profiler. Instead you run one single
MIDI cable which carries power and the digital MIDI signal. The TinyBox adds lots of possibilities to the
expression pedals connected to it through the JackBox. You can easily program the expression pedals
to have a different function for each rig, to have a linear sweep or volume (logarithmic) sweep, to use
full range or part of the adjustment range, etc. All this is explained in great detail in later chapters.
(*) a separate user manual is available for the JackBox

5
Using a computer with the TinyBox4Kemper
In order to program the TinyBox4Kemper, you need to connect it to a computer (Windows PC or Mac)
using a USB cable. The computer runs the “TinyBoxServer” software. You will find out all details about
this software in the next chapter.
The TinyBoxServer software not only allows you to program the TinyBox4Kemper, but it can also
communicate with the TinyBox4Kemper during live use to request realtime status info of the Profiler:
the currently selected performance, activated effects, tuner info when in tuner mode, etc. Since the
TinyBoxServer software acts as a real lightweight web server, any web browser can connect to that
server and display live status info. In the simplest scenario you can use the browser of the computer
itself, however you can as well use an iPad or smartphone as “wireless status display”. Of course for
this your iPad or smartphone must have a WIFI connection with your computer. Most nowadays
computers have WIFI built in and can easily be turned into a WIFI access point1. An alternative is to
connect through an external WIFI router, which can be purchased new for around 20 USD.
using laptop as WIFI access point
using an external WIFI router
1 https://www.imore.com/how-turn-your-macs-internet-connection-wifi-hotspot-internet-sharing
1 https://www.windowscentral.com/how-turn-your-windows-10-pc-wireless-hotspot

6
The TinyBoxServer software
This software can be freely downloaded from our webshop. Once you have purchased a TinyBox a
download link will appear on your account page. Both a Mac installer and a Windows installer are
available. The TinyBoxServer is actually a lightweight web server which communicates with the TinyBox
through USB, and with a remote web browser through WIFI or wired network (next to communicating
with a local browser on the same computer of course)
Launching TinyBoxServer
After launching the software, a status window appears. As with most “server” software, you will never
interact with the TinyBoxServer software directly, everything is done in the browser instead. The status
window just gives you a way to check if everything is correctly connected and up and running.
When no TinyBox4Kemper is connected, the TinyBoxServer status window will say something like this:
As soon as you connect the TinyBox4Kemper USB cable, this will change into :
The TinyBoxServer opens 2 MIDI IN ports and 2 MIDI OUT ports on the TinyBox. One set of ports is
used for transferring TinyBox4Kemper setups, the other set of ports is used for getting Profiler status
info and for remotely controlling the Profiler from your iPad or laptop.

7
Connecting to TinyBoxServer
The webserver which is built into TinyBoxServer can be reached from a browser, using the address
mentioned in the TinyBoxServer status window. This address will always be http://the-name-of-your-
computer:2000 When you use the browser on the laptop which runs the server software you can as
well use the address http://localhost:2000 . Alternatively, when you happen to know the IP address of
your laptop you can also use that for connecting remotely: for instance http://192.68.0.120:2000
Don’t forget to always include the “:2000” at the end. The webserver is listening on this specific port
2000 in order to keep the default port (80) available for regular internet browsing.
This is what you see when browsing to the given address :
The start page shows you the 3 options which the software offers :
- Creating and editing TinyBox4Kemper setups
- Showing a realtime status display of the Profiler
- Upgrading the TinyBox4Kemper firmware
Tip:
If you wish you could create a shortcut on your laptop referring to the address of the editor, which is
http://the-name-of-your-computer:2000/editor_kpa.html
On your iPad you could create a shortcut referring to the address of the status display, which is
http://the-name-of-your-computer:2000/kpa.html

8
Using the TinyBox4Kemper editor
From the TinyBoxServer homepage shown above click the large “setup editor” icon.
On this web page you can create, edit and manage your TinyBox4Kemper setups. The menu options
are fairly self explanatory. They allow you to create, rename and delete setups, save changes, and
download a setup to your TinyBox4Kemper. The Home button brings you back to the overview page
shown in previous chapter, and the Help button shows the necessary info to assist you in writing a
TinyBox4Kemper setup. The same info is also available in later chapters of this user manual.
Remember that TinyBoxServer is a web server, which means that you can edit your setup on any device
which has a browser connected to the web server. However in practice the laptop running the server
software will most probably also be the best tool for editing setups. A decent keyboard and mouse are
still the best tools for text editing… No matter on which device you are editing your setup, all changes
are always stored on the server side, that is on the computer running the TinyBoxServer software. One
of the advantages of the TinyBox4Kemper approach is that its setups are purely text based. So you can
very easily copy-and-paste your setup into an external text file for backup on a stick, for sharing with
others on a forum, etc…
Full details on the actual setup structure and programming syntax are given in a later chapter.

9
Displaying Profiler status info, and remotely controlling your Profiler
From the TinyBoxServer homepage shown earlier click the large “status display” icon.
This gives you a representation of your Profiler, showing detailed info about its current status. In the
screenshot above, taken with the Profiler in performance mode, you can see :
- which performance is currently selected (“song 01” in this test setup)
- which slot of the performance is selected (first slot, called “Verse 1”)
- which rig is active (“Rocket Dirty mod”)
- which effects are available (the X and MOD effects, showing ‘-‘, are not available for this rig)
- which effect is linked to each of the A/B/C/D/X/MOD effect slots (‘BOOST’,’CHO’,’DIST’,…)
- what type of effects they are (colored LEDs, similar to the Profiler front panel)
- which effects are active (they have a dark blue color)
Next to showing you the current status, this screen can also be used as an actual remote control for
the Profiler. This way you can browse through performances, activate effects, or activate the tuner by
using your iPad !
- click an effect box to activate or deactivate it
- click a slot box to select a slot within a performance
- click the up or down arrow to go to next or previous performance
- click the Performance toggle button to toggle between performance mode and browse mode
- click the Tuner toggle button to activate or deactivate the tuner