Contents 1 Introduction 2 Protocols 3 Quickstart 4 Setting up 5 Network 6 Show Control 7 Monitors 8 Settings Appendices A Trigger Types B Task Types C Templates D API...
Page 3
2014-2017 Visual Productions BV. All rights reserved. No parts of this work may be reproduced in any form or by any means - graphic, electronic, or mechanical, including photocopying, recording, taping, or infor- mation storage and retrieval systems - without the written permission of the publisher.
Programming the triggering and converting functionality is done in the 6 chapter as discussed on page 27. At the time of writing this manual the IoCore’s firmware was at version 1.39. Features The feature set of the IoCore includes:...
Page 6
RAM memory is, however, volatile and its content will be lost through a power cycle. For this reason the IoCore will copy any changes in the RAM memory to its onboard flash memory. Flash memory retains its data even when...
Page 7
This memory copy process is conducted automatically by the IoCore and should not be of any concern of the user. One point of consideration is, however, that after making a change the unit should be given time to perform the copy to flash.
This chapter describes these protocols and to which extent they are implemented in the IoCore The IoCore features eight General Purpose Inputs (GPI) ports that can be con- nected to external equipment, switches and sensors. State changes on these GPI ports can be used to trigger programmed events inside the IoCore.
Page 9
Each GPO port features a normally-open (NO) relay for switching external equipment. The relay can switch 250VAC/30VDC up to 2A. Please refer to figure 2.2 for the pinout of the GPO connector. Figure 2.2: GPO Pinout RS-232 The bi-directional RS-232 port can be used to communicate with external equip- ment such as video projectors and matrix switchers.
Page 10
32 more devices. The Splitter can also function as a signal booster as each port supports another 300 meter long connection. The IoCore has one DMX port and is therefor able control 512 channels. The port can be configured either as input or output. Figure 2.5 shows the pinout of the connector.
Page 11
Show Controllers. It does not incorporate error checking, therefor it is faster than TCP but less reliable. There are two ways how to have the IoCore respond to incoming UDP mes- sages. The API (see page 56) makes typical IoCore functions available through UDP.
Use DMX to trigger a RS-232 lamp strike command to a video projector Convert 0-10V levels to DMX This tutorial shows how to use the IoCore to convert 0-10V levels to DMX. The 0-10V levels could be generated by sensors (e.g. ambient lighting sensor) or a potentiometer (1-10V wall mount rotary dimmer).
Page 13
3. Add template Open a browser on the computer and browse to the web-interface of the IoCore by typing ’192.168.1.10’ in the browser’s address field. Go to the Show Control page and select the ’GPI - DMX’ template. Press the ’Add...
Page 14
4. Configure GPI port Go to the IoCore Settings page and set GPI port 1 to ’analog’. 5. Configure the DMX port In the settings page, set the DMX port direction to ’output’ Changing the rotary encoder should now control DMX channel 1 for the fixture.
Page 15
1. Setup network and connect equipment Connect the IoCore and the computer to a network switch. Connect the the external DMX board to the DMX port. Connect the projector to the RS-232 port.
Page 16
2. Add source Open a browser on the computer and browse to the web-interface of the IoCore by typing ’192.168.1.10’ in the browser’s address field. Go to the Show Control page and select the ’DMX In’ source. Press the ’Add ’...
Page 17
3. Add action Make sure the ’DMX In’ actionlist is selected and press the ’ Add’ button below the ’Action Types’ table. 4. Edit action Make sure the new action is selected and press the ’Edit’ button. Set the flank to ’Down’. This will make sure that the action is only triggered when DMX channel 1 goes from 0% to non-zero.
Page 18
5. Add task Press the ’Add’ button at the top left of the screen and choose ’RS-232’ from the task categories.
Page 19
’Close’ button. Please consult the projector’s documentation and replace the ’lampon’ string accordingly. 7. Configure RS-232 port Go to the IoCore Settings page. Set the RS-232 details to match specifications that would be found in the projector’s documentation.
Page 20
In the settings page, set the DMX port direction to ’input’ Bringing channel 1 up from 0% will now make the IoCore send the RS-232 string to the projector. The DMX console should bring channel back to 0% so it is...
Chapter 4 Setting up This chapter discusses how to set up the IoCore. Mounting The device can be placed desktop or it can be DIN Rail mounted. The device is prepared for DIN Rail mounting by using the ’DIN rail holder TSH 35’ from Bopla (Product no.
Page 22
Figure 4.2: Kensington lock Power The IoCore requires a DC power supply of 12 Volt with a minimum of 500mA. The 2,1 mm DC connector is center-positive. The IoCore is also Power-over- Ethernet (PoE) enabled. It requires PoE Class I.
The IoCore is a network capable device. A network connection between between a computer and the unit is required to configure and program the IoCore, how- ever, once the device is programmed then it is not necessary anymore for the IoCore to be connected to an Ethernet network.
Page 24
VPN feature. Once set up, this is a very secure way to communicate with the IoCore. A VPN is a network technology that creates a secure network connection over a public network such as the Internet or a private network owned by a service provider.
Page 25
Revert to factory defaults Figure 5.3: vManager The firmwares for the IoCore and similar devices are bundled with vManager. So new firmware are distributed via new vManager releases. The following section explain the buttons in the vManger, as seen in figure...
Page 26
USB stick. The data of the backup can be restored via the Restore button. The backup files created by vManager can be found at the following locations: Microsoft Windows Users [username] Documents Visual Productions Common Backups /Users/[username]/Visual Productions/Common/Backups Ubuntu Linux /home/[username]/Visual Productions/Common/Backups 5.3.2...
UDP network message. The Show Control page (See figure 6.1) enables this kind of programming to be made. When using the IoCore as an expansion to the CueCore controller then it is advised to use OSC messages to establish communication between IoCore and CueCore.
Page 28
Figure 6.2: Show Control structure The IoCore is capable of listening to various protocols. These available pro- tocols are listed in Sources, however, the IoCore can only actively listen to 8 protocols at once. The active protocols are listed in ’Action Lists’. Each ac- tion list can contain actions.
Page 29
Source Description Touch Screen Triggers from VisualTouch. For each Action various controls can be chosen such as buttons and sliders, colour picker etc. The order of the actions will control the arrangement in VisualTouch. Art-Net Art-Net DMX data DMX In Receiving DMX data when the DMX port is set as input System Events such as ’Power on’...
Page 30
Templates The Show Control page presents a list of templates. A template is a set of action-list, actions and task. These templates configure the IoCore to perform typical functions; for example convert Art-Net to DMX or control the 8 relays through OSC.
Page 31
Variables are internal memories that can hold a value; a number in the range of [0,255]. There are 8 variables and they are typically used for advanced show control programming. In the IoCore, the content of the variable is not stored between power cycles.
Chapter 7 Monitors This page allows the user to inspect the incoming and outgoing data, both DMX-type data (See figure 7.1) as well as control messages (See figure 7.2). Monitoring incoming and outgoing data can help the user troubleshoot during programming.
Figure 8.1: Settings page General You can change the IoCore’s label. This label can be used to distinguish the unit in a set-up with multiple devices. By enabling the ’Blink’ checkbox the device’s LED will blink to help to identify it amongst multiple devices.
Page 35
Figure 8.3: DMX Settings Art-Net The IoCore supports sending out 1 universe or and receiving 1 universe of Art- Net. These universes can be mapped to any of the 256 available universes in the Art-Net protocol. The universe is entered in the ’subnet.universe’ format, i.e.
Page 36
Calibrate button again. Figure 8.5: GPI Settings Caution: Applying a voltage 10V could damage the IoCore. This section shows the status of the GPO relays and provides buttons to switch them directly.
Page 37
Defines the listening ports for TCP and UDP messages. External system in- tending to send TCP or UDP message to the IoCore should need to know the unit’s IP address and this port number. By default both ports are set to 7000.
Page 38
filled with IP 0.0.0.0:0. It is possible to enter a broadcast IP address like 192.168.1.255 in order to reach more than four recipients. The IP fields are for setting up the IP address and subnet mask of the IoCore. The ’Router’ field is only required when Port Forwarding is used.
Appendix A Trigger Types The following tables list the different types of triggers that can be used in the IoCore. The different types are accompanied with values and flanks. Touch Screen Trigger Type Trigger Value Flank Description Change Button/Fader goes up or down...
Page 42
Lost Art-Net signal Receiving Start receiving Art-Net signal System Trigger Type Trigger Value Flank Description Startup The IoCore has been power up Network Connection Change Network connection established or lost Network Connection Stop Network connection lost Network Connection Start Network connection established...
Page 43
Trigger Type Trigger Value Flank Description Channel Port number Change Port state changes Channel Port number Down Port is closed Channel Port number Port is opened Channel 0-19% Port number Change Analog level enters or leaves the range Channel 0-19% Port number Down Analog level enters the range...
Page 44
For example, to trigger on both port 1 and 2 being closed fill in trigger value 3 (1+2). To trigger on port 5 and 6, fill in value 48 (16+32). Trigger Type Trigger Value Flank Description Channel Port number Change Port state changes Channel Port number...
Page 45
RS-232 Trigger Type Trigger Value Flank Description Message String Receive a message that matches the trigger-value Receiving Receive any message The user can define his own string as the trigger value of a message. Please note that this string has a maximum length of 25 characters. It is possible to pass a parameter along with a message.
Page 46
A.10 Variable Trigger Type Trigger Value Flank Description Channel Variable Index The specified variable changes Variable 1 Number [0,255] Change Variable 1 becomes = or # to the value Variable 1 Number [0,255] Down Variable 1 becomes = to the value Variable 1 Number [0,255] Variable 1 becomes # to the value...
Page 47
A.11 Randomizer Trigger Type Trigger Value Flank Description Result The Randomizer made a new value Specific Value Number in the range of [0,255] The Randomizer made a value that matches A.12 User List (1-4) User lists have no triggers. Actions inside user lists can only be activated by other actions through ’Action’...
Appendix B Task Types Tasks allow you to automate the functionality in the IoCore. All this func- tionality is categorized in task-types. This appendix provides a listing of the various task-types. The tables present an overview of all available features and functions per task-type.
Page 49
Manipulate the DMX levels. These are the levels that can also be send out via Art-Net. Feature Function Parameter 1 Parameter 2 Set Value Channel [1,512] Value [0,255] Set Value Toggle Channel [1,512] Set Value Control Channel [1,512] Set Value Inverted Control Channel [1,512] Set Value...
Page 50
Feature Function Parameter 1 Parameter 2 Send text string Send Control Send Float floating point number Send Float Control Send Unsigned positive number Send Unsigned Control Send Bool On or Off Send Bool Control Send String text string Send String Control Send String Hex hex string...
Page 51
Feature Function Parameter 1 Parameter 2 Send floating point number Send Control Send Float floating point number Send Float Control Send Unsigned positive number Send Unsigned Control Send Bool true or false Send Bool Control Send String String of characters Send String Control Colour...
Page 52
Please note that string in parameter 1 has a maximum length of 25 charac- ters. The Send Bytes features allows for sending ASCII codes. For example, in or- der to send the string ’Visual’ followed by a line feed parameter 1 should be ’56697375616C0A’.
Page 53
Feature Function Parameter 1 Parameter 2 Set Value Variable [1,8] Value [0,255] Set Value Toggle Variable [1,8] Value [0,255] Set Value Control Variable [1,8] Set Value Inverted Control Variable [1,8] Set Value Decrement Variable [1,8] Vari- Set Value Increment Variable [1,8] Set Value Continuous Decrement Variable [1,8]...
Appendix C Templates This appendix discusses the templates provided in the Show Control page. Template Description Art-Net - DMX Converts the incoming Art-Net universe to DMX. The Art-Net universe number is determined on the settings page. The direction of the DMX port should be set to output. Art-Net - GPO Control the GPO relays by Art-Net (channel 1-8).
Appendix D The IoCore is pre-programmed to make its internal functionality available via OSC and UDP. There is a simple API implemented for each protocol. Notwith- standing these API’s, it is possible to create your own OSC and UDP imple- mentation in the Show Control page.
Page 56
Parameter Description /core/blink Momentarily flashes the IoCore’s LED The following table uses GPO #1 as an example. The number ’1’ can be re- placed by any number in the range of [1,6]. String Description core-gpo-1= 0/1 Switch the relay on GPO port #1 The following table uses actionlist #1 as an example.
Need help?
Do you have a question about the IOCORE and is the answer not in the manual?
Questions and answers