background image

WWW.APART-AUDIO.COM

10

stopir

A stopir command is used to halt IR transmission. Any remaining <repeat> 
counts will be discarded. A stopir command sent to a connector configured as 
an input will return an error message. An IR transmission halted with the stopir 
command will return a stopir response. Furthermore, if an IR command is halted 
before its completion by another connection, the originating IR connection and 
the connection sending stopir will both receive a stopir response. If stopped, the 
originating connection will not receive a completeir response.
Sent to Netkit:
stopir,1:1(enter) to stop the 1st IR connector transmission
stopir,1:2(enter) to stop the 2nd IR connector transmission
stopir,1:3(enter) to stop the 3rd IR connector transmission
Sent from Netkit in response to stopir command:
stopir,<connectoraddress>(enter)
where; <connectoraddress> is as defined in stopir command
A stopir command always returns a stopir response regardless if the 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 multiple iPhone users) there is a possibility of an IR transmission not being 
transmitted. This occurs when an IR command is sent to the same IR connector 
from another IP connection, and will cause a busyIR response.
A busyIR response does not occur if the two IR commands are executed on different 
IR connectors.
Sent from Netkit in response to an attempt to interrupt IR transmission by another IP 
connection or socket: busyIR,<connectoraddress>,<ID>(enter)
where: <connectoraddress> is the busy connector <ID> is |0|1|2|…|65535| 
(ID is specified in sendir command)

Note

: The busyIR response is returned to the originator of the unexecuted IR 

command. A command to stopir will only return the stopir response. At no time will 
a command of stopir return a response of busyIR.

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: