BomeBox™ Instructions The Bome Team appreciates your purchase of the BomeBox, a versatile MIDI and network connection and translation box.
Table of Contents Important Safety Instructions............................................3 Assistance.......................................................................4 Before you get started......................................................5 Power Up!.......................................................................6 Initial Configuration..........................................................7 Register your BomeBox...................................................10 Power Options.......
Important Safety Instructions Before using the BomeBox, thoroughly read the following instructions for important information needed for setting up and using your BomeBox safely. Keep this document in a safe place for further reference. WARNING RISK OF ELECTRIC SHOCK DO NOT OPEN This symbol is intended to alert you to the presence of important operating and maintenance instructions in the literature accompanying the product.
Safety Instructions ᴑ ᴑ ᴑ ᴑ ᴑ ᴑ ᴑ ᴑ ᴑ Make sure you understand and follow these instructions. Do not expose the BomeBox to water or moisture. Only clean the BomeBox using a soft, dry cloth. Never keep the BomeBox near any heat sources (e.g., radiators, stoves, amplifiers). Avoid direct exposure to sunlight. After exposure to cold temperatures, let the BomeBox warm up slowly to room temperature before use. Before moving the BomeBox, remove power and all connected cables.
Before you get started... Video Tutorials We provide a growing collection of video tutorials for using the BomeBox. Please visit our YouTube channel and select the BomeBox Tutorials playlist: https://www.youtube.com/bomesoftware In particular, the tutorial BomeBox Unpacking and Initial Setup should get you started quickly. Bome Network Tool The Bome Network Tool is an application for Windows and macOS, which allows you to connect to a BomeBox (Network MIDI) and to invoke the Web Config directly.
Power Up! There are multiple ways to power your BomeBox. Micro USB The port marked USB Power allows you to use the included micro USB cable to power the BomeBox. The Micro-USB connector is used for power only and does not allow for data transfer between the BomeBox and a computer or another USB host.
Initial Configuration Web Config via WiFi For configuring your BomeBox for the first time, the easiest approach is to use WiFi to access the Web Config: 1. Press the WiFi button to enable the BomeBox wireless LAN. 2. Once the WiFi LED is on, use a laptop, tablet, or smart phone to connect: go to WiFi settings and select the HotSpot “BomeBox” (SSID). 3. Then, if you are on a computer with Bome Network installed (see above), click on the green B icon and in the menu, select Web Config → BomeBox - Net. 4.
5. On the computer, click on the green B icon of the Bome Network tool and in the menu, select Web Config → Bome Box – Net. 6. Now you should see the login page of the Web Config in the web browser. Proceed with the next chapter. Web Config Password Now that you see the Web Config login page, look at the bottom of your BomeBox: on the sticker, the serial number is the default password. Enter it with all leading zeroes.
2. Select your country from the WiFi regulation drop-down menu. This makes sure that the built-in WiFi follows your country's regulation and, maximizing performance. 3. Change the Web Config password. We recommend to change the Web Config password to prevent unauthorized or even malicious access to your BomeBox. Make sure to use a password which is not easy to guess, but which you don't forget.
Update Firmware We regularly improve the firmware of the BomeBox to add new features or to improve existing functionality. Therefore, we recommend to update to the latest firmware. The update process will not change any settings and it will not remove any uploaded project or other files. To update, follow these steps: 1. Using an Internet browser, download the latest firmware here (a .bxfw file): 2. 3. 4. 5. 6. 7. 8. 9. https://www.bome.
Power Options Daisy Chaining If your BomeBox is powered via PoE, you can use the PoE Out connector to power another BomeBox. You can daisy chain up to 3 BomeBoxes via PoE. The PoE Out will not provide power if you're powering the BomeBox via Micro-USB. You can also use the USB host connector marked to power one other BomeBox. Do not daisy chain more than one BomeBox via USB host. Powering USB-MIDI Gear The USB host port (type A) provides a maximum of 1A to connected devices (depending on power supply).
USB Host Port The USB host connector marked allows you to plug in and power your USB-MIDI gear. Use a USB hub to connect multiple USB-MIDI devices. If you encounter power issues, a powered USB hub will help. Or use a PoE power supply for the most reliable power. MIDI Routes By default, every MIDI port is routed to all other ports, except to itself. All available MIDI ports (MIDI DIN, plugged USB-MIDI devices, Network MIDI) can be routed using the MIDI Router in the Web Config.
1. Connect the two BomeBoxes (A and B) or BomeBox A and computer B via Ethernet or WiFi. 2. Make sure that A and B have different names. 3. In the Web Config of BomeBox A, go to the Network MIDI page. 4. In the list of Network MIDI devices, find device B and click on the Connect button next to its name. 5. If you're connecting to BomeBox B, approve the pairing by pressing the blinking Pair button on BomeBox B. Alternatively, you can also approve the pairing in the Web Config of BomeBox B. 6.
Bluetooth / BLE-MIDI The BomeBox does not have a built-in Bluetooth radio, so you cannot directly use BLE-MIDI (Bluetooth Low Energy) devices with the BomeBox. WIDI BUD However, there is a trick: you can use CME's WIDI BUD to connect one standard BLE-MIDI device to the BomeBox by plugging the WIDI BUD into the USB host port of the BomeBox. Note: not only CME devices work, we have tested with many different BLE-MIDI devices from different manufacturers.
The BomeBox will also pass through any other Ethernet data, such as Artnet, OSC, and more. By default, the BomeBox Ethernet is set up as Ethernet Client, for connecting to an existing network with DHCP router. To configure the Ethernet ports, go to the Web Config, page Settings, tab Ethernet. You have these options: ᴑ Ethernet Client: the default Ethernet setting. Use it for connecting to an existing router.
WiFi Press the WiFi button to enable the BomeBox wireless LAN. Activating the wireless network takes a few seconds, during which the WiFi LED blinks. Once the WiFi LED stays on, the wireless network is ready. The BomeBox is a full WiFi router, so you can also use it for connecting computers and other gear to each other. We recommend to set a WiFi password (see page 9), so that all wireless traffic is encrypted.
ᴑ WiFi Access Point: this setting is like HotSpot, but it relays the wired Ethernet network instead of creating its own DHCP server. It uses the same configuration and IP address as the Ethernet network. If Ethernet is configured as Master, any WiFi clients connecting to this Access Point will be assigned an IP address by the Ethernet DHCP server. If Ethernet is configured as Client, connected WiFi clients will get an IP address by the same remote DHCP server connected via Ethernet (e.g.
In case of Network Problems... You can reset the network settings to their defaults and remove the WiFi password. Please see Network Reset on page 28 in the Troubleshooting chapter. MIDI Translator For advanced MIDI mappings and translations, you can upload MIDI Translator Pro project files into the BomeBox on the MIDI Translator page in the Web Config. Only project files saved in a licensed version of Bome MIDI Translator Pro can be uploaded to the BomeBox.
2. In the Project File Upload section at bottom, click the Browse... button and select the project file you want to add. 3. Click the Upload Project File... button. 4. Now that project file should appear in the list of projects. 5. Click the Select button in the list next to the name to activate and load this project. Project MIDI Routes Selecting a project file will reset all MIDI routes to the routes stored in the project. If the project does not define MIDI routes, all previous routes are removed.
Assigning MIDI Port Aliases Every MIDI Port Alias referenced in an uploaded and selected MIDI Translator project will appear in the list of MIDI ports on the MIDI Ports page of the Web Config. If an alias is not assigned, the respective row will be read and a warning will appear at top of the Web Config. Each alias in the list has a drop-down list in the Assignment column. The drop-down list has the following entries: ᴑ (none): select this to not select a MIDI port for this alias.
The list at bottom shows all auto-detected A&H mixers, and already connected mixers, and manually added devices. For each device, you have the following options: ᴑ With the Enable button, you connect to this mixer device and you start using it. This will make available a new pair of associated MIDI Input and Output ports, with the name of this mixer. You can use these ports in MIDI routes and in a MIDI Translator translation project. ᴑ For a connected mixer, you can press the Disable button to disconnect.
ᴑ For devices in manual mode, you'll also find a Remove button. This will remove this manual entry in the list of devices. If the corresponding device was an edited auto-detected device, the device will reappear under its own name. You also have the following global settings: ᴑ Auto-Enable devices: if this option is checked, all auto-detected A&H mixers are automatically enabled whenever they are detected.
their own name, which you can change using the Allen & Heath Director software. Once you have enabled such an auto-detect device, it is stored under its name. So when you power cycle the BomeBox, it will look for an auto-detect A&H mixer of the stored name. If you rename your A&H device using the Director software, the BomeBox will recognize this mixer as a new device and will keep on looking for an A&H mixer of the old name (state “pending”).
Serial Ports The BomeBox allows you to plug one or more USB serial port adapters (RS-232) into the USB host port (or an attached USB hub). Note that while the most common brands of serial port adapters work with the BomeBox, there might be particular serial port adapters which do not work with the BomeBox. Mapping Serial Ports to MIDI At this point, serial ports can only be used from MIDI Translator projects.
ᴑ Serial Port Device: selecting an actual serial port device (with awkward internal names like “/dev/ttyUSB0”) will assign this alias to that serial port device. To finalize the alias assignments, click the Save button at bottom of the list. Serial Port Alias assignments are stored indefinitely, even if you select other MIDI Translator projects or power cycle the BomeBox. So you only need to assign a Serial Port Alias the very first time it appears in a project.
Keystroke_to_MIDI_simple.bmtp This project maps every key on a standard QWERTY computer keyboard to MIDI notes. Keystroke_to_MIDI_by_channel.bmtp This project maps every key on a standard QWERTY computer keyboard to MIDI notes. You can use modifiers like SHIFT and CONTROL for selecting one of 16 MIDI Channels. See the following web page for more information and complete list of which keys are mapped to which MIDI message: https://www.bome.
LEDs Power This LED indicates that the BomeBox is on. It is blinking during boot and during a firmware update. Pair Pair LED on: at least one Network MIDI connection is established (paired). Blinking slowly: waiting for a remote BomeBox or computer to approve a connection (press to cancel). Blinking fast: another BomeBox or computer wants to connect to this box (press to approve). WiFi On if WiFi is enabled. Press to enable or disable. It is blinking when transitioning between states.
Troubleshooting Online User Support In case of questions or problems, please consult our support team in the Q&A discussion forum: https://www.bome.com/support Network Reset It's possible to misconfigure the BomeBox network setup and entirely lose connectivity. If that happens to you, please follow the following instructions. All your other settings, project files, and Web Config password remain the same. 1.
Password Reset If you have forgotten your password for the Web Config, you can reset it in a similar manner to resetting the network (see previous chapter). All other settings, network configuration, WiFi password, and project files remain the same. 1. Prepare a USB thumb drive to reset the password: it must be FAT formatted, and not exceed 16GB in size. 2. Copy an arbitrary text file to the root folder of the thumb drive, and rename it to: {serial}_reset_password.
Environmental Information Disposal of the Product This product is subject to the provisions of the European directive 2002/96/EC. Should the product become damaged beyond repair, or if you wish to dispose of it, it must be disposed of separately from the municipal waste system via designated collection facilities appointed by the government or the local authorities.
Legal Notices GNU Public License The firmware of the BomeBox is based on the open source project OpenWRT, which is based on the Linux kernel. Most of that software is licensed under the GNU Public License (GPL) version 2. Consequently, we publish all source code modifications to OpenWRT and to the Linux kernel in an online repository hosted on github.com. You can use that repository to create your own firmware for the BomeBox. Note that this repository does not include BomeBox specific tools and scripts.
Manufacturer Information Bome Software GmbH & Co. KG Petra-Kelly-Str. 15 80797 Munich Germany Contact: https://www.bome.com/contact Registration Court: Munich HRA95502 VAT ID: DE271182542 WEEE-Reg.-Nr.: DE43133930 LUCID Reg.-Nr.
