Surface Mount with Buttons Set Up, Configuration and Drivers

Be sure to watch the videos below to learn more about discovery, configuration and programming.

After connecting your Surface Mount with Buttons System to the local network by plugging in a CAT5e or CAT6 into the iPort PoE Splitter (70718), download the Fing App on any iOS device.  Make sure the device is connected to the Wireless Access Point of the network your surface Mount with Buttons System is plugged into.  Use the Fing App to find the Surface Mount device (manufacturer will show as "iPort").  Note the IP address assigned to the device.

Next, use any web browser on any device connected to the same network as your Surface Mount with Buttons System and type the IP address of the Surface Mount device into the URL bar and click "browse".  The iPort Configuration Utility will appear.  You can use this utility to give your Surface Mount device a unique name, set Static IP address, set the LED backlight color and brightness, and save settings to the device.  After this, note the IP address you've assigned to the device and you an begin programming. 

In your control system, download and/or install the Surface Mount Buttons driver / module.  The control system will need to know certain information about your device:  IP address, comm port (10001), and button configuration.  

When a button is pressed, the button number in the JSON string will correlate with the number on the button out of the box.  You can use Press and Press & Hold button states to trigger commands in your control system.  You can always use a debugger or a command prompt with Telnet and view IP strings as they come in from the Surface Mount with Buttons device if you like. 

Firmware

Current Firmware Version:

version 6 (05.06.16)

Sign up to receive firmware update information when released

Videos

Video 1:  Discovery and Configuration

Factory Reset 

To reset a Surface Mount with Buttons bezel to factory state, press and hold buttons 1, 2, 5 & 6 for at least 9 seconds. You will then notice a flash of all LEDs.  The bezel may be reconfigured at this point using the discovery and configuration instructions described above.

More Information on Buttons

Surface Mount Buttons Bezels ship with numbered buttons on the bezel out of the box.  These numbers correlate with the button identification number in the IP string that is sent to the control system when a button is pressed.  Use this labeling when programming button functions initially to ensure the correct button is associated with the macro or function in your control system.  

The Buttons may be switched out for different buttons with icons to best represent the programmed function.  Simply unscrew the PCBA from the bezel using a precision Phillips screw driver.  Watch the video below, or click on the installation guide.

Video:  Button Removal

To remove and change the buttons of a Surface Mount with Buttons bezel, turn the device face down on a cushioned, flat surface.  Using a Philips P0 screwdriver, remove the screws securing the circuit board to the bezel.  You can then access the buttons.   

Control System Drivers & Support

More drivers and support coming soon.  If you are interested in developing a driver, please read below about our API.

iPort Button API

iPort's button API is an open platform allowing developers with knowledge of JSON and control system driver coding to create custom drivers to support nearly any system.  In most cases, it only takes a few hours to code and test a custom driver.   To become a developer, fill out the form below and we will contact you with more API information!