background image

WWW.APART-AUDIO.COM

16

A general discussion is necessary to better understand how smooth continuous IR 
commands are executed by the Netkit. This desirable feature is utilized for smooth 
volume control or repeating an operation without the appearance of choppy 
actions. The approach of sending an IR command with very large repeat counts 
and stopping it upon request will work, but can lead to undesirable incidents.
Consider the scenario of large repeat count IR command for raising the volume in 
a smooth fashion. The command works properly until the connection is broken. A 
repeating IR command is sent, volume continuously increases, then the controlling 
iPhone is unexpectedly dropped. The volume continues to rise (possibly damaging 
equipment) until a stopir command is ultimately received.
The Netkit solution is to limit the repeat count. Hence, to create a smooth IR 
operation, the Netkit resets the IR repeat count each time the identical IR command 
(from the same IP connection) is resent. This method will not interrupt and restart 
the IR command, but reset the IR repeat count back to the original value.

Example: If the IR repeat count is set to 5, and the IR command has transmitted 
3 times, receipt of the same command causes the repeat count to be reset back 
to 5. This process can continue indefinitely while a volume button is held down to 
create a smooth operation. However, at no time can the command repeat more 
than 5 times after the button is released or an IP connection is inadvertently lost, 
preventing a potentially serious issue.
By selecting an appropriate <repeat> value, the need for a stopir command 
is eliminated. In this example the volume continues to increase smoothly by 
retransmitting repeated IR commands due to the volume button being pressed. As 
long as the next repeated IR command is received before the previous command 
finishes, smooth operation is realized. By choosing a low repeat value, the volume 
increase will stop when the volume button is released. Also, proper IR operations 
happen even with unintended network delays due to traffic or WiFi connectivity. In 
this unlikely event, only small hesitations will be experienced during IR operation.
In the event that the identical command is not received before the original 
command is finished, the command will be registered as a brand new command, 
and is sent as such. The command in question will operate functionally the same, 
but delays between commands may be evident when used in this way.
Increasing the <repeat> value will likely eliminate these discrepancies.

5.3.7 Smooth Continuous IR Commands

Summary of Contents for NETKIT-IR

Page 1: ...INFO APART AUDIO COM 1 MANUAL NETKIT IR RS ...

Page 2: ...the power supply to your Netkit unit Connect the other end of the network cable to your wireless router or IP network In its default configuration the Netkit models use DHCP to automatically obtain an IP address from your network router To determine the IP address download the Netkit Help application from our website Run the program from a Windows PC that is connected to the network The Netkit Hel...

Page 3: ... Netkit specific hexadecimal or uncompressed formats Netkit test test your commands before using them in your specific application 3 mm The LED s on the front of the Netkit unit will rapidly blink in unison indicating a reset Use a light touch when resetting your Netkit unit as force may damage your Netkit hardware irreparably For easy programming and Netkit setup four dedicated applications are a...

Page 4: ...creasing sequentially to the right until all module addresses are assigned see figure This presents a consistent programming interface as additional modules are added A connector s address is its position within a module starting at 1 on the left and increasing sequentially as you move to the right A complete connector address includes the module address and the connector location in the module se...

Page 5: ...g Netkit units on the network The beacon is a UDP packet sent to the multicast IP address 239 255 250 250 on UDP port number 9131 Any system listening to this address and port will receive the periodic beacon message The message is sent shortly after power on and then at random intervals of 10 to 60 seconds thereafter The UUID value contains the unique MAC address of the Netkit unit which is also ...

Page 6: ...t getdevices This Netkit command is used to determine installed modules and capabilities Each module responds with its address and type This process is completed after receiving an endlistdevices response Sent to Netkit Getdevices enter query for modules and capabilities device Sent from each Netkit module in response to getdevices device moduleaddress moduletype one sent for each module where for...

Page 7: ...t mask gateway is the default network gateway unknowncommand An unknowncommand response will be sent by the Netkit when a command is not understood This can happen if for example a connector is set up as a digital input and the command requested is sendir Sent from Netkit in response to unknown commands unknowncommand error code enter Note Definitions are contained in the Error Codes table in sect...

Page 8: ... where 1 1 is the Netkit serial connector s address baudrate is 115200 57600 38400 19200 14400 9600 4800 2400 1200 flowcontrol is FLOW_HARDWARE FLOW_NONE parity is PARITY_NO PARITY_ODD PARITY_EVEN Example set_SERIAL 1 1 38400 FLOW_HARDWARE PARITY_NO enter This command string will set the Netkit serial connector to operate at 38400 baud with hardware flow control and no parity get_SERIAL This comma...

Page 9: ...ial device status This mode can only be enabled or disabled from the Serial settings web page set_IR This command allows configuration of each IR connector to the desired mode of operation The possible modes are IR output sensor input sensor notify see 5 3 2 IR blaster and LED lighting see 5 3 3 The IR blaster is only supported on the third IR connector Sent to Netkit set_IR 1 1 mode enter where m...

Page 10: ...he connector is idle or an IR transmission is actually halted A stopir response means only that the stopir command was successfully sent to the Netkit and any transmission has been halted from the designated connectoraddress busyIR A busyIR response occurs when an IR command is received by a connector that is already sending an IR transmission If multiple IP connections are present i e from multip...

Page 11: ...ess inputstate enter where connectoraddress is as defined in section 1 inputstate is as defined in 5 3 2 5 3 2 Sensor Notify This connector state allows for pulse width modulated control at 120Hz of LED lighting Wiring for the 3 5mm connector must be connected so that the Dim line comes in on the tip and the Dim Return line is on the base The necessary command syntax and parameters for changing th...

Page 12: ... lighting control sensor which monitors the circuit between the tip and the base of the 3 5mm connector When a momentary contact is made the lighting control sensor toggles the lighting level between on and off When held for a long press the lighting control sensor will dim or elevate the lighting level for as long as the contact is closed The long press function toggles between elevating light le...

Page 13: ...nd a value of 24 periods is 600μS IR timing patterns typically have a long final off value or rest state to ensure the next IR command is interpreted as a separate IR transmission 5 3 5 IR Structure Control of IR devices is accomplished through use of the sendir command Since IR commands may take up to 100mS to complete the Netkit provides a completeir acknowledgment to indicate when it is ready t...

Page 14: ... on and off states Also every on and off state must meet an 80μS minimum time requirement for the Netkit to work properly Example With a carrier frequency of 48 KHz the minimum value for on and off states is calculated below off min on min 80μS ƒ 80μS 48KHz 3 84 For proper Netkit operation all on and off values in the timing pattern must be 4 or higher All of the conditions above must be met for v...

Page 15: ...2 65535 ID is specified by originating sendir command Example A few simple IR commands are shown below The following will send the IR timing sequence illustrated in figure 4 2a to the 2nd IR connector on the Netkit shown in Figure 1 Sent to Netkit sendir 1 2 2445 40000 1 1 4 5 6 5 enter Sent by Netkit in response to sendir completeir 1 2 2445 enter In the next example the following two IR commands...

Page 16: ...times receipt of the same command causes the repeat count to be reset back to 5 This process can continue indefinitely while a volume button is held down to create a smooth operation However at no time can the command repeat more than 5 times after the button is released or an IP connection is inadvertently lost preventing a potentially serious issue By selecting an appropriate repeat value the ne...

Page 17: ...mand terminated by a carriage return through TCP packets via port 4998 Although the Netkit product family supports up to eight simultaneous connections the captured command will only be sent to the connection that initiated learner mode Learner mode is disabled when Netkit units receive any command or when stop_IRL is sent If get_IRL is sent to a unit which is configured to control LED lighting yo...

Page 18: ...id pulse count ERR_09 Invalid pulse data ERR_10 Uneven amount of on off statements ERR_11 No carriage return found ERR_12 Repeat count exceeded ERR_13 IR command sent to input connector ERR_14 Blaster command sent to non blaster connector ERR_15 No carriage return before buffer full ERR_16 No carriage return ERR_17 Bad command syntax ERR_18 Sensor command sent to non input connector ERR_19 Repeate...

Page 19: ...INFO APART AUDIO COM 19 Notes ...

Page 20: ...ggestions to suggestions apart audio com developed by Audioprof nv Industriepark Brechtsebaan 8 bus 1 2900 Schoten Belgium Company names product names and names of formats etc are the trademarks or registered trademarks of their respective owners 2012 APart Audio specifications subject to change without notice ...

Reviews: