How To Setup Touch OSC and Hog 4

This guide will explain the step by step process to set up Touch OSC software on an external device to use as an RFU with a console. Touch OSC software is a 3^rd party tool. High-End Systems does not create the OSC software, but does provide templates for Hog4 users to download and communicate with Hog4 devices. These templates are editable and can be configured by users to best fit their system.

Hardware requirements

Step 1: Download items

1. Touch OSC for your Apple or Android device
2. Hog4 Touch OSC Templates (Website) 
   1. Note IPhone and iPad template will work with android devices
3. (Optional) Touch OSC Editor (Found under the “Downloads” tab)

Step 2: Add Templates to your device

1. Browse to the template files downloaded in the previous step
   1. Unzip the Template file
   2. Connect your device to your computer
   3. Move the files to your device, Recommended to move it to your “Downloads” folder
2. Open the Touch OSC application
   1. Select “layout”
   2. Select “Add from File”
   3. Browse to where you moved the template files from the step above  
   4. Select Touch OSC
   5. Select a folder for your device
      1. If on Android phone or newer iPhone, select from “iPhone 5” folder
      2. If on Android tablet select from “iPad” folder
   6. To use your device as an RFU, you will need the “Hardware” Template or the “All” template if on a tablet

Step 3: Configure Hardware

1. Wi-Fi Router
   1. Connect a wireless router to your HogNet port on the console
      1. If running Hog4 PC plug the router into your PC network
      2. It is not recommended to have anything else on this network other than other Hog4 consoles, or hardware from High End Systems like DP8000s. A network switch may be required depending on your setup.
2. Console (choose DHCP or Static IP)
   1. DHCP IP (Basic, recommended if no other devices are on the network)
      1. Navigate to control panel [Setup](Control Panel) (HogNet)
      2. Select “Obtain IP address using DHCP”
      3. The console will now receive an IP address from the router
   2. Static IP (Advanced, recommended if you already have DHCP server on your network, or if other devices are already on the network)
      1. Navigate to control panel [Setup] (Control Panel) (HogNet)
      2. Select “Static IP”
      3. Configure your console, and other preexisting devices on you network to be in range of each other
         1. By default, HogNet IP range is 172.31.0.XXX
      4. Configure your router for a static IP within the range of your console network. Refer to your router’s manual for steps to configure
      5. Connect your device to the Wi-Fi router, and set a custom Ip that is within the range of your network. The steps to do this will be different from device to device

Step 4: Configuring Software

1. Console
   1. Open the network window [Setup](Network)
   2. Right click on the console, select (Settings)
   3. Select the “Open Sound Control” tab.
   4. Enable OSC in and OSC out
   5.  Ensure the port numbers are different,
      1. Recommended to use input port: 7001
      2. Recommended to use output port: 7002
   6. Input your phone or tablet IP address into the IP address box under the output panel
      1. To see your local IP, open the Touch OSC app on your device, then press “OSC” under the connections pane.
2. Device
   1.  Make sure that the device is connected to the Wi-Fi router.
   2.  Open the Touch OSC app on your device, then press “OSC” under the connections pane.
      1. Host: this is the IP for your consoles HogNet
         1. To see your consoles IP, press [Setup](Control panel) (HogNet) 
      2. Port (Outgoing): this should be the same as the Input port on the console. Recommended to use 7001.
      3. Port (incoming): this should be the same as the output port on the console. Recommended to use 7002.
   3. Using OSC
      1. Go back to the Touch OSC home screen
      2. Press (Layout)
      3. Select the desired Hog4 layout
      4. Go back to the Touch OSC home screen
      5. Press (Done)

Your device should now be working with your console!

Troubleshooting tips

1. Restart your console and your device, to allow for network changes to fully apply
2. Ensure that all settings carried through after the restart
   1. Control Panel: HogNet
   2. Network, Console: Open Sound Control
   3. Device Settings: Touch OSC
3. Remove any other devices from the network non-essential to lighting.
4. Hog4 PC
   1. Disable Wi-Fi if the Pc is directly plugged into the router.
5. Highly recommended to be on the most recent version of Hog4 software.
6. The console must be on
7. Some Wi-Fi routers have a limited IP range, refer to the routers manual for any limitations.

Notes:

1. Touch OSC Encoders will not work if connected to a Hog4 PC system without any hardware attached. (NanoHog, Hoglet, Wing, or unlocked ETCnomad key)
2. Wi-Fi can be unreliable, and your device may be disconnected from the network if the connection is lost or unreliable.
3. The templates provided, do not have DMX testing capability. OSC cannot control specific addresses in a particular universe. See, “DMX Test” in the console
4. OSC does have limitations, it is not meant intended to be used as an alternative to hardware, just as a tool.

YouTube Video by Colin Wood

Touch OSC Editor