background image

WWW.APART-AUDIO.COM

4

The Netkit product family’s modular design provides a variety of capabilities. 
Each module provides a particular function: power and network connections, with 
either infrared (IR) or digital connections (RS232). A module may also support 
one or more connectors of the same type. For example, an IR module has three 
independent IR connectors; whereas, a serial module has only one serial RS232 
connector. This is due to the fact that the number of connectors a module can 
support is dictated by its 1.5 inch physical width.

It is important to understand that a module’s address is determined solely by its 
physical position within the Netkit enclosure. Each module occupies 1.5 inches 
of front panel space. At power on, module addresses are assigned starting with 
“0” for the left-most module (containing the network and power connectors) and 
increasing 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, separated 
by a colon. One IR module is contained in the Netkit-IR (figure 1). The first IR 
connector on the IR module has an address of 1:1, whereas the third IR connector 
has an address of 1:3.

IR Connectors: Support for an IR blaster is enabled on the third (*:3) IR connector 
on an IR module. This can be configured via command, or must be selected via the 
internal webserver. Attempts to configure connectors other than *:3 as an IR blaster 
will result in a returned error message. The IR blaster is available on request only. 
Contact your local dealer for more information.

Netkit application programming interface. Version 1.0

1. The Netkit modular design concept

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: