86R00-2 HTX2 Mobile Designer User's Guide
Contents
1. 4 DAVE a lec E carrera ri 4 Adding and Configuring 5 eeeh 5 Auto DISCOVEIY 5 5 Lota e lire ei arpa 5 Web Configi sissit oriyin aaa 5 Add to Project 5 Manual aria 5 6 HTX2 Hardware Properties L nen iii 6 5 lt 6 iaia 7 ened vane 7 A E A EE iene E E E 7 RELAYS 2 2 E E 8 56 DOVICES ul 9 Serial Devices ana 102. 17 R EA SA E NEE NANa ERREA KS OE AEA 18 GI MGI a a T T 18 18 SPACING CTPA E A AA N N A AA A 18 iii E E E A A tera 18 Turn Snap ONO ff ali iii ipa 18 a to 18 eh ia 19 GUT cea US sce sees che hae cheeses hed ses hed ea dii dir dir dior ii i dt di A di ur 20 CULES clitici 20 GUI Paje S aaa aa aaa 20 20 GUI Page ee 21 IA eee 21 22 External JavaScript References iii ante 22 GUI Generation as 22 GUI Uploading to Snap Link 0002110 22 Firmware Updates Lolli le een 23 Chapter 1 2 Mobile Desi
3. Socket Device Setup Socket command data can be defined in one of three methods New SOCKET Command Name New Socket Command ASCII String Command data is entered as plain ri ia an ASCII text Hag ASCII String w Hex Terminator Hex String Command data is entered as a series of hex bytes For example ODOAFF01 without quotation marks would send the hex bytes Ox0D OxFF 0x01 ASCII String with Hex Terminator Command data is entered as a plain ASCII string to be terminated with one or more hex characters Page 10 Script Devices Script Devices provide the ability to add two way feedback for HTX2 GUI pages A Script Device can use either RS 232 or TCP UDP Script Devices are made up of JavaScript Functions for controlling the device and Expressions using RegEx or Regular Expressions for capturing status feedback from the device Script Devices are edited with the Script Device Properties Window Script Device Device Name New_Script_Device Functions Incoming Data Feedback Shared Functions Notes To new Script Device to your project right click the SCRIPTDEVICES node in the CONNECTED DEVICES node of the desired HTX2 in your Project tree then select New Script Device Script Devices are a powerful way to add two way feedback and advanced functionality to your installation As such creating new s
4. ii 10 Script Devices unire 11 DEVICE IMIPORUEX PORE Ea ELI iaia 11 Device CopyiPaste utili 12 Device Prop Ti OS 12 Online D vi e Library e a ella 12 Creating 1 13 Nail laine 13 205 13 13 2 14 15 511 0 amp ri 16 16 Creation 2 eee ee eee es 17 GUIGIOups ille 17 GUl Pages GG 17 Editino ale ie 17 GUI lille 17 Target Screen Resolutioniin aereoa naan ea NaN N EnaA coctnevy secesec escecuvssecvnedveccnrsdusecessdvetevevsstecvvssteteedvcccersvssedeis 17 Render oR ea ees ea SR Pa ee ee ee O A 17 iPhone iPad Rotation
5. internally connected to GPIO1 edit the GPIO properties right click the desired GPIO node in the Project tree then click Properties GPIOO GPIO1 and GPIO2 can be configured to behave in a number of modes of operation Disabled Activity will not be monitored or reported Digital Input The supplied voltage signal will be reported as a 0 or 1 depending on whether the voltage level is above the Threshold setting Analog Input The supplied voltage will be monitored by a 10 bit 0 3 3VDC DAC The signal can be evaluated by its VAL current value MIN minimum value since last report and MAX maximum value since last report Digital Output The GPIO can be set to switch a 10ma 3 3VDC signal on or off GPIOO is tied internally to GPIO1 and can be configured to report GPIO1 activity in two additional modes Counter Keeps a running count of off on transitions on GPIO1 Frequency Reports the frequency in Hz of off on transitions GPIO1 The GPIOs have two adjustable parameters to help tailor the monitoring to the supplied signal Delay The amount of time in tenths of a second between asynchronous status reports when a GPIO state is changed Set to 0 to disable async reporting Threshold For a digital input this is the level that will determine the difference between reporting the signal as off 0 or on 1 Click the Apply button to apply settings to the unit Click the Refresh button to
6. MOBILE DESIGNER HTX2 Mobile Designer User s Guide Document Number 86R00 2 Rev A February 2012 Table of Contents HTX2 Mobile Designer 3 3 Step 2 Add Connected DOV S r p rrap r Tra Ea a aa raa a Aaa TE aa aa Aaa A raa Ta aaa a aAa AeA Aa Ar cnasencteoraeassnassnndtaccvedseadentececeears 3 3 EPE TTET TATA TTT 3 Step 4 Create GUT Pages firs ciccecccacdehesctcceeeasadetessecudeeeacetbeevactdeecsacadecessecuueteaceitessinedueesacadeeessacivedeacetervacetuessueedueesaccteeesss 3 HTX2 Mobile Designer Main 3 nnna 3 Men andenn rr ta 3 e a Tree E E E T E E A E E E E reseed T T 3 lt 4 aa a a Ea a aa a 4 Macro Editor iaia lai ari 4 Project Files gt lesse 4 n 4 Opening an Existing cuscued eustuadeeseangen 4 Openinga Recent File
7. GUI Group simply right click the Group in the Project tree and select Export Group You will be prompted to choose the name and location to export the GUI file To import a GUI file right click GUIs node in the Project tree then click Import GUI Group Browse to the device file you wish to import Note that exported GUI files will not retain button actions but Page Navigations assigned to GUI Buttons will be maintained Exported GUI files include all associated image files When a GUI file is imported the image files will be copied into Project Editor s default image folder Page 21 Chapter 4 Scripts You can use custom JavaScript files to extend the functionality of GUI pages GUI Groups can then utilize embedded scripts which eliminates the need to maintain separate JavaScript files These embedded scripts can utilize the built in script editor which includes syntax highlighting for JavaScript JavaScript functions can be called from GUI button actions using the External JavaScript button action type Specify your function and parameters in the following format funcName parameter1 parameter2 parameter3 etc External JavaScript References In addition to embedded scripts you can reference external JavaScript files for your custom functions To add a JavaScript file reference to a GUI Group right click the GUI Group then click Add External File Reference You can specify an external JavaScript editing prog
8. get settings from the unit Click the Monitor Activity button to monitor real time activity on the selected GPIO It can be useful to watch the behavior of the GPIO when connected to a signal to make evaluating the input during macro setup easier Relays Relay The HTX2 has two SPDT relays rated for 2A 30VDC built in Name These relays can be controlled via control macros or GUI button actions To edit Relay properties and test Relay functions right click the desired Relay node in the Project tree then click Properties Test Control Set On Set Off You can give the Relay a friendly name such as Projector Screen for 100 Motor to make macro creation and editing easier You can also use the supplied control buttons to control test the Relay in real time canca Page 8 IR Devices To create a new IR Device right click the IRDEVICES node in the Project tree then select Add New IR Device The IR Device Properties window opens Enter a name for the new device and select which IR port this device s emitter is connected to Device Setup Device Info commands Name Default Keys User Keys Living Room Television 1 Power On Off New User IR Key IR Port 10 0 0 237 2 x E Uses Channel Macros 23 Extemal Antenna 24 Play 25 Stop 26 Pause 27 Rewind 28 Fast F
9. protected Protected project files will not allow GUI or Device exporting without supplying the password Page 4 Chapter 2 Adding and Configuring Hardware Adding the HTX2 Start by adding one or more HTX2 units to the project There are two ways to add the HTX2 Auto Discovery Right click on the node entitled HTX2s You will be presented with the option to either add hardware from the network auto discovery or to add hardware manually Click Add Controller from Network to use auto discovery to find any HTX2 on the network The Controller Discovery window will appear To add an HTX2 to the project select it from the list of discovered hardware and click Add to Project Note that if the project already contains an HTX2 with the same MAC address you will not be able to add it The Controller Discovery window has the following buttons Discover Click this to refresh the list of hardware available on the network Locate Click this to put the selected unit into Locate mode which will start blinking the red Status LED on the selected unit This is useful for identifying hardware in a multi unit installation Click again to stop the Locate mode Web Config Click this to use the HTX2 s internal web configuration pages These pages can be used to set up the unit s network settings Add to Project This button will add the selected HTX2 hardware to the Project tree Done After you have finished adding HTX2 hardware
10. The Firmware Updater can be accessed from the Tools Menu of the Main Window To update the firmware use the Discover button to discover any HTX2 hardware on the network Select the desired unit from the list Use the Browse button to browse to the desired firmware file Click Update Firmware to apply the update The Firmware Updater window can also be used to update the unit s internal web pages Page 23
11. base and images for the handle s pressed and released states Changing slider images is handled the same way as a GUI button Sliders can be assigned functions and feedback via the same methods as GUI buttons GUI Panels GUI Panels are a simple static image which can be used to create a layered appearance for backgrounds Panels do not have actions or display feedback To add a new panel right click anywhere on the background then click Add Panel To edit an existing panel right click the panel then click Properties Web Images Web Images can be used to add any network accessible image file including most MJPEG IP Camera streams to GUI Pages To add a new Web Image right click anywhere on the background then click Add Web Image To edit an existing Web Image right click the Web Image then click Properties In the Web Image Properties window you can define the path to the image file as well as the desired display size of the Web Image Page 20 GUI Page Copy Paste You can copy and paste GUI Pages from one GUI Group to another or within the same GUI Group To copy a GUI Page right click the GUI Page in the Project tree then click To paste the GUI Page right click the GUI Group you want to paste the GUI Page into then click Paste GUI Import Export Once you have created your GUI Pages and Groups you may wish to export them to share with others or to use in a future project To export a
12. cript devices can be more complicated that simple one way Serial or Socket Devices Make sure to select the proper Two Way mode in the Serial Port properties if your Script Device uses RS232 or TCP Device Import Export Once you have created your devices you may wish to export the device to share with others or to use in a future project To export an IR Serial or Socket device simply right click the device in the Project tree and select Export Device You will be prompted to choose the name and location to export the device file To import a device right click the desired device group i e IRDEVICES SERIALDEVICES or SOCKETDEVICES in the Project tree and choose Import Device Browse to the device file you wish to import Page 11 Device Copy Paste You can copy and paste devices from one HTX2 to another or within the same HTX2 To copy a device right click the device in the Project tree then click Copy To paste the device right click the device group you want to paste the device into then click Paste Device Properties To edit a device you have already created or imported right click the device in the Project tree then click Properties Online Device Library Other users have submitted exported device files to share in the Online Device Library In the main menu bar click Tools gt Online Device Library You can browse the library for IR Serial or Socket device files To download a file from the library use the
13. d commands one at a time If you hold Shift while dropping the command it will be added to the button s Release action instead of the Press action Macros can also be added to button actions using the drag drop feature Entire pages of commands can be populated by dropping a Device node from the Project tree onto the GUI page background You will be prompted to choose which command types to populate Commands are populated on buttons based on the button s Command Tag which can be defined in the button s properties window If a button has no Command it will be matched based on button text You can also drag drop Devices onto GUI Groups and Pages inside the Project tree This allows you to populate pages quickly without even needing to open the page in the GUI Editor Dropping a device onto a single page will populate only that page Dropping onto a GUI Group will populate the entire Group This is especially useful for volume commands GUI Buttons can also be assigned a Feedback ID FBID from a script device This will allow two way feedback to be displayed as the button s text using the Feedback Text ID or the button s Pressed state using the Feedback State ID at runtime To assign a FBID to a label either drag drop the feedback item from the Script Device in the Project tree onto the Label in the GUI Editor or manually select the FBID in the GUI Label s properties window Dropping the feedback item ont
14. d upload control macros for All HTX2 hardware in the project In projects containing multiple HTX2 units you may wish to only upload one unit at a time To upload a single HTX2 unit right click the HTX2 node in the Project tree then click Upload This HTX2 Page 16 Chapter 4 GUI Creation HTX2 Mobile Designer includes a visual GUI Graphical User Interface editor which is used to create GUI pages which control the HTX2 and its connected devices These GUI files can be used in conjunction with the Snap Link Mobile for iPhone iPod Touch and iPad and can also be generated as complete HTML files which can be used for browser based control via PCs and mobile devices The basic components are listed below but be sure to watch all available tutorial videos GUI Groups GUI Groups contain one or more GUI Pages All GUI Pages that you wish to include for a given display device such as an iPad must be contained in a GUI Group A Project file can contain as many GUI Groups as you like A single GUI Group can be uploaded to multiple Snap Link Mobile devices To add a new GUI Group right click the GUIs node of the Project tree then click Add GUI Group GUI Pages Each GUI Page can contain labels images and buttons and is completely customizable To adda new GUI Page right click the GUI Group you want to add a page to then click Add GUI Page Editing a GUI Page To customize a GUI page double click the GUI page or r
15. e Snap Link Mobile GUI is launched or when a specific page is loaded App Macros and Page Macros can be selected via the GUI menu in the GUI Editor or by drag dropping the desired macro onto the GUI page or GUI Group in the Project tree Grid Menu You can use a customizable grid to assist you in lining up GUI page elements such as Buttons Labels and Images The Grid Menu contains the following items Show Hide Click to show or hide the grid Spacing Used to adjust the spacing size of the grid Color Choose what color you want the grid to be displayed in Turn Snap On Off Used to turn Grid Snapping on or off When snapping is enabled the GUI element being moved will snap to the nearest grid corner that lines up with the top left corner of the GUI element Background You can choose to use a solid color background for your GUI Page or to use an image file for the background To change the Background color right click anywhere on the background then click Change Background Color If you have selected a Background Image you will need to remove it before you will be able to see the Background color To change the Background Image right click anywhere on the background then click Change Background Image Browse to the image file you wish to use Note that the image size should match the GUI Page s Target Screen Resolution To remove the Background Image right click anywhere on the background then click Remove Background I
16. e sensor GPIO Count The current state of the counter Only available if GPIOO is set to Counter Mode GPIO Frequency The Frequency of input activity on GPIO1 Only available if GPIOO is set to Frequency Mode GPIO Input The current value of the GPIO Only available if a GPIO has been set to Digital or Analog Input mode GPIO MIN The Minimum value of the GPIO since the last report Only available if a GPIO has been set to Analog Input mode GPIO MAX The Maximum value of the GPIO since the last report Only available if a GPIO has been set to Analog Input mode Relay State The current state of the Relay Will be 0 if the Relay is deactivated 1 if the Relay is activated User Variable The current value of the User Variable Host TCP Socket Status The status of the main TCP socket which is used for HTX2 Command Protocol communications Serial TCP Socket Status The status of the HTX2 serial dedicated TCP socket Client TCP Socket Status The status of the Client TCP Socket which is used to communicate with TCP Socket Devices The value will be 0 if the Client Socket is disconnected 1 if the Client Socket is connected Page 14 Actions Each macro line must have a Command Action Actions can be dragged into a macro from the Project tree The following Action types are available Output Action Only available if a GPIO has been configured as a Digital Output Relay Action The selected Relay can be set On or O
17. ff or can be pulsed with a user defined period IR Command Action Send an Infrared command to a connected IR device IR Command Actions can be defined as a single pulse or a continuous send which must be canceled Continuous Cancel mode IR commands can be useful for things like volume controls where you want an IR command to start sending continuously when a GUI button is pressed and canceled when the GUI button is released Serial Command Action Send a RS232 command to a Serial Device Socket Command Action Send a command to a Socket Device Report Variable Force the HTX2 to send a User Variable state report packet to a connected system Set Variable Set the value of a User Variable Increment Variable Increase the value of a User Variable by one Decrement Variable Decrease the value of a User Variable by one Report Counter Value Force the HTX2 to send a Counter report packet to a connected system Report Frequency Value Force the HTX2 to send a Frequency report packet to a connected system Set Counter Manually set the Counter value Manual Command Manually define a command to execute based on the HTX2 Command Protocol Run Macro Run another Macro Note that when running one macro from another macro the last macro called will only return to the macro that called it For example if Macro 3 calls Macro 4 which then calls Macro 5 after Macro 5 completes it will return to Macro 4 but Macro 4 will not return to Mac
18. gner The HTX2 Mobile Designer software is used to create and manage project files for the HTX2 HAI Home Theater Extender 2 HTX2 Mobile Designer project file consists of the hardware profile for the HTX2 connected devices IR codes RS 232 IP macros and custom GUI graphical user interface pages Setting up a new project consists of four steps Step 1 Add HTX2 Add 2 to the project via automatic discovery or by manually entering the unit s address info Step 2 Add Connected Devices Create and test connected equipment such as IR RS232 and IP TCP UDP devices Step 3 Create Macros Create test and upload control macros series of commands to be executed such as Watch DVD Step 4 Create GUI Pages Create and upload GUI graphical user interface pages These files are created for use with HAI Snap Link for iPhone iPad iPhone iPod Touch and can also be generated as HTML files for use with other web enabled devices like Desktop PCs Notebooks and mobile devices HTX2 Mobile Designer Main Window The Main Window has four main sections Main Menu The Main Menu bar runs across the top of the main window The main menu contains items for project file management project uploading firmware updating and more Project Tree On the left hand side of the window is the Project tree This tree contains all hardware connected equipment and GUI pages in the project Items can be added deleted and ed
19. ight click the GUI Page in the Project tree then click Edit The GUI Page Editor will be displayed GUI Menu The GUI Menu contains the following page specific options Target Screen Resolution This is where you define the size of the GUI Page Changing this setting will resize the canvas to the boundaries of the specified resolution Note that you can choose from preset screen resolutions or enter a custom value Presets are provided for iPhone iPod Touch and iPad in both Landscape and Portrait orientations Render Mode In most cases this will be left in Normal mode If you are storing GUI files as HTML to be stored a web server for use with the Mobile Safari browser choose Mobile Safari iPhone iPad Rotation If you would like to create both landscape and portrait versions of each GUI Page when used with Snap Link Mobile you can have them automatically jump when the device is rotated Page 17 For example let s say you ve created a landscape page called DVD Landscape and a portrait version of the same page called DVD Portrait When editing DVD Landscape you would set the On Portrait Rotation setting to the DVD Portrait page and leave the On Landscape setting to None When editing DVD Portrait you would set the On Landscape setting to the DVD Landscape page and leave the On Portrait setting set to None Page Macros Page Macro and App Macro triggers allow macros to be triggered when th
20. ited by right clicking the item and selecting the desired action from a pop up menu Page 3 Properties Pane The upper right hand pane is the Properties pane When you select an item in the Project tree the Properties pane will display any relevant properties for that item Macro Editor The lower right hand pane is the Macro Editor When creating or editing a macro this is where you will drag drop device action lines to create your control macros Project Files Creating a New Project In the main menu click File and then New Project You may be prompted to save the previous file before creating a new one Once the new file has been created click File and then Save As and enter a new file name for this project Now you are ready to add your HTX2 to the project In the Project tree expand the PROJECT node You should see two child nodes HTX2s and GUIs Opening an Existing File In the Main Menu click File and then Open Browse to the desired project file Opening a Recent File In the Main Menu click File and then Open Recent Select from the list of recently opened project files Save a File In the Main Menu click File and then Save to save the current project Select Save As to save the current project file under a new file name Note The file extension includes all required GUI image files inside the project file which makes projects portable The bws extension is the same as a bwe but is password
21. k Import to import the converted IR data into the selected User Key Page 9 Serial Devices To create a Serial Device right click the SERIALDEVICES node in the Project tree then select Add New Serial Device The Serial Device Properties window opens Enter a name for the device To add a command enter a name for the command define the command data and click Add To edit an existing command right click the command and select Edit Serial Device Setup Serial command data can be defined in one of three methods ASCII String Command data is entered as plain ASCII text New Serial Command Name New Serial Command Hex String Command data is entered as a series of D ASCII String hex bytes For example ODOAFF01 without D Hex String quotation marks would send the hex bytes Ox0D OxFF 0x01 String ASCII String with Hex Terminator Command data is entered as a plain ASCII string to be terminated with one or more hex characters Socket Devices To create a new Socket Device right click the SOCKETDEVICES node in the Project tree then select Add New Socket Device The Socket Device Properties window opens Enter a name for the device To add a command enter a name for the new command define the command data and click Add ZF To edit an existing command right click the Name command and select Edit New Socket Device Protocol
22. lick the TEMPERATURE node then select Properties to open the Temperature Properties window There are two settings which can be adjusted Delay Can be set from 0 200 tenths of a second This affects how often the HTX2 will send asynchronous temperature reports to a connected third part hardware or software system Offset Can be set from 0 255 The offset value affects the raw AD value of the temperature sensor and can be used to make the reported value more closely reflect ambient temperature as opposed to the internal temperature of the unit Click the Apply button to apply the currently displayed settings to the unit Click the Refresh button to get the actual settings from the unit Click the Monitor Activity button to view real time incoming temperature reporting from the unit Page 6 Connected Devices The HTX2 contains all of the interface connections for IR and RS232 devices as well as the built in relays and GPIOs All of these hardware connections are available in the Project tree within the CONNECTED DEVICES node of the HTX2 To create and set up connected devices expand the HTX2 node in the Project tree and then expand the CONNECTED DEVICES node Serial Port The HTX2 has 1 serial port To change serial port settings right click the SERIALPORT1 node in the Project tree then click Properties The serial port can be configured to work in different modes Normal Two Way TCP This mode means that external system
23. list boxes to choose a device file and then click Download The file will be saved to the Devices folder in the application directory These files can then be imported to your projects Page 12 Chapter 3 Creating Macros A macro is a series of command actions For example you might create a Watch DVD macro which would set the theater Projector and AV Receiver to the correct inputs set the correct surround mode and start playing the movie in the DVD player In the HTX2 Mobile Designer you can define these macros and upload them to the 2 To start working with macros expand the HTX2MACROS node in the Project tree Inside this node you will find three child nodes VARIABLES MACROS and MATCHSTRINGS Variables Each HTX2 contains 30 numeric user variables which can be used to track equipment states and help create complex logic for control macros User variables can hold numeric values from 0 255 You can rename a variable to something more user friendly like Theater Power State To do this expand the VARIABLES node right click the desired variable then click Rename User variable values can be set and evaluated in control macros Macros There are two System Macros present in every HTX2 Macro 1 is the Startup Macro which runs every time the hardware is reset Macro 2 is the Looping Macro which runs in a continuous loop anytime the unit is not doing anything else The Looping Macro is a go
24. mage Page 18 GUI Buttons GUI Buttons are used to control devices and or navigate between GUI pages To add a new button right click anywhere on the background then click Add Button To edit an existing button right click the button then click Properties or double click the button In the Button Properties window you can select image files to use for the Normal and Pressed states of the button You can define multi line button text including left center right alignment font and size Use the Navigation drop list to choose a GUI page you would like the button to jump to Other specialized Navigation options include URL Schemes for launching other Apps Exit GUI fore returning to the previous list Snap Link Mobile and Wait Page functionality which allows you to jump to a Please Wait page during system setup then jump to the another page after the desired delay GUI Button navigation can also be set by dragging a GUI page from the Project tree onto a button in the GUI Editor Use the Actions lists to define button actions The action list will be populated with any HTX2 hardware and connected devices you have defined in the project Note that you can define separate actions for button press and release GUI Button actions can also be added to buttons using the drag drop feature from the Project tree You can drag individual commands from a device in the Project tree onto a GUI button to ad
25. o a button in the GUI Editor will set the button s Text ID Dropping while holding Shift will set the button s State ID Note that a button that has a defined State ID will not change its press release appearance based on physically touching the button it will only change state when the associated feedback value changes Page 19 GUI Labels GUI Labels are used to add text to GUI Pages To add a new label right click anywhere on the background then click Add Label To edit an existing label right click the label then click Properties In the Label Properties window you can define multi line label text including left center right alignment font and size GUI Labels can also be assigned a Feedback ID FBID from a script device This will allow two way feedback to be displayed as the label s text at runtime To assign a FBID to a label either drag drop the feedback item from the Script Device in the Project tree onto the Label in the GUI Editor or manually select the FBID in the GUI Label s properties window GUI Sliders Sliders are used in conjunction with Script Devices or custom JavaScript functions They provide a convenient method for controlling and displaying the current level of things like device volume To add a new slider right click anywhere on the background then click Add Slider To edit an existing slider right click the slider then click Properties Sliders consist of a background image the slider s
26. od place to evaluate the state of GPIO inputs in order to trigger actions based on an input state change To add a new macro right click the MACROS node in the Project tree then click Add New Macro Edit a Macro To edit a macro select the desired macro from the Project tree and click Edit in the Macro Editor pane of the Main Window You can add macro lines in one of two ways You can right click the macro line list and choose Insert Command You can also drag any command such as an IR command or a Relay Action from the Project tree into the Macro Editor Once the command has been added to the macro you can right click any macro line then click Edit This will bring up the Macro Line Editor window Macro Lines Each macro line is made up of three components The Macro Line Editor window provides a tab to edit each component Delay The amount of time to delay before executing the command action The delay value is in tenths of a second for example 0 5 or 1 2 Page 13 Evaluations Each macro line can execute its command action based on the evaluation of user variables or hardware states Action This is the actual command to be executed Evaluations The following items can be part of a macro line evaluation Temperature AD Val The current AD reading of the built in temperature sensor Temperature C Val The Celsius value of the built in temperature sensor Temperature F Val The Fahrenheit value of the built in temperatur
27. orward Record 33 Menu Picture 34 Menu Audio 35 Guide To browse the built in IR database begin by choosing the applicable Device Type from the list Next choose the desired Manufacturer Each Manufacturer in the list will have one or more codesets available for the selected Device Type To test a codeset double click any IR command in the Default Keys list That code will be sent from the selected IR port If there are any IR keys that are not found in the built in database you can add learned IR keys to the IR device file Enter a name in the New User IR Key text box and click Add This will add a new key to the User Keys list To learn a User Key select it from the list and click the Learn button When the HTX2 is ready to learn the red Status LED will flash rapidly Hold the original remote directly in front of the Learn LED on the HTX2 and press the desired button After the IR key has been learned you can double click it to test You may need experiment a bit when learning certain remotes Try moving the original remote closer or farther away from the Learn LED Try a longer press hold of the original button or a very quick press release You can also import Pronto Hex formatted IR codes into a User Key Right click the desired User Key and select Import Convert Pronto Hex Paste the Pronto Hex formatted code into the provided text box Click Convert If the conversion is successful clic
28. ram by clicking Tools gt External Editors To edit an external file right click the file reference in the Project tree then click Edit The file will be opened for editing in the specified external editor GUI Generation as HTML GUI Groups can be generated as HTML files which can be used with most modern desktop browsers such as Internet Explorer Firefox Safari and Chrome To generate a GUI group as HTML right click the GUI Group in the Project tree then click Generate Group as HTML You will be prompted to select the directory you would like to generate the files into After the files have been generated you will be prompted to view the generated folder Note that Two Way communication with Script Devices requires native socket support At this time this is not possible with GUIs running in desktop browsers as HTML GUI Uploading to Snap Link Mobile After you have created a GUI Group you can upload the files to Snap Link Mobile for iPhone iPad and iPod Touch Right click the GUI Group you want to upload then click Upload Group to HAI App The Upload Server window should appear On the mobile device start the Snap Link Mobile application When prompted click Yes to begin the file transfer Page 22 Firmware Updates Occasionally updated firmware for the HTX2 hardware may be released to introduce new or enhanced functionality HTX2 Mobile Designer has a built in Firmware Updater you can use to update the hardware
29. ro 3 Page 15 Matchstrings If the serial port has been configured for Serial Matching you can define serial Match Strings which will execute a macro when received Incoming serial data is matched according to two configurable parameters Match Length and Match Terminator If Match Length is set to 0 it will attempt to match the entire incoming string until the Match Terminator is received Otherwise it will attempt to match the number of characters defined as Match Length Match Terminator is the decimal representation of the character you expect to be received as a terminator for incoming serial data packets To Edit these parameters expand the HTX2MACROS node in the Project tree right click the MATCHSTRINGS node then click Serial Match Settings To add a new Matchstring expand the HTX2MACROS node in the Project tree right click the MATCHSTRINGS node then click Add New Serial Match When the Serial Match Editor window appears you can enter the string of incoming serial data you expect to receive Then select the macro you want to trigger when that Matchstring is received You can click Get Match String From Input to monitor the incoming serial data and choose the desired Matchstring from that data Macro Uploading After you have created your control macros they must be uploaded to the HTX2 Macros can be uploaded by clicking Upload Project all units in the Program menu of the Main Window This will compile an
30. s can connect to the defined TCP port number and operate in a Properties pass through two way mode e Processes Host Commands In this mode the unit will respond to Processes Host Commands the Command Protocol normally reserved for TCP and UDP 7 Serial Matching Or IR Receiver communications with external systems over the serial port SerialPort GUI Two Way RS232 Serial Matching In this mode the unit will attempt to match GUI Two Way TCP incoming serial data against user defined match strings Upon a successful match the unit will trigger the control macro associated with that match string GUI Two Way RS232 In this mode the unit will pass any TCP Pot 5001 incoming serial data to Snap Link Mobile for iPhone for use with two way Script Devices Refresh Apply Ai Baud 115200 4 GUI Two Way TCP In this mode the unit will pass any incoming Cancel TCP Client data to Snap Link Mobile for iPhone for use with two way Script Devices Choose the desired baud rate from the Baud drop down list If applicable enter the desired port number for TCP communications Click the Apply button to apply settings to the unit Click the Refresh button to get settings from the unit GPIOs GPIO Properties The HTX2 has three GPIO General Purpose 5 Input Output ports GPIO1 GPIO2 are accessible through the terminal blocks on the unit GPIOO is
31. to the project click Done to close the Controller Discovery window Manual Right click on the node entitled HTX2s You will be presented with the option to either add hardware from the network auto discovery or to add hardware manually Click Add Controller Manually Enter the MAC address and IP address of the HTX2 hardware that you want to add to the project Click Add to add the unit to the project and close the Manual window Page 5 Hardware Properties HTX2 Hardware Properties To change the network settings of the HTX2 right click the desired HTX2 node in the Project tree and then select Properties The HTX2 Properties window opens Here you can make changes to all of the unit s network settings sin it i Click Get Settings From HTX2 to poll the unit Network Settings for the actual settings stored in the device which MAC 0050 209 be different from the values stored in the Name HAIHDO project file FW OE Click Apply Settings To HTX2 to apply the a project values to the Subnet 255 0 0 0 Gateway 10001 DNS 1 10 0 0 50 DNS 2 10 00 8 TCP Telnet Port 5000 UDP In Port 5200 UDP Out Port TCP Timeout 15 Heartbeat Interval 0 Temperature Sensor The HTX2 hardware has a built in temperature sensor The state of this temperature sensor can be evaluated in macro lines To modify the temperature sensor settings expand the HTX2 node in the Project tree and right c
Download Pdf Manuals
Related Search