Keene Electronics KIRA-CC User manual

Kira CC Guide
KEENE IR ANYWHERE KIRA-CC IP CONTROLLABLE
CONTACT CLOSURE MODULE WITH IR AND RS232

Contents
Overview
Setup
Connections
First Steps
Browser pages
- Control Options
- RS232 setup
- Factory Default Reset
- Conguration
- Password
- DDNS
- PC Mobile & Relay
- Browser Control
Java Utility Program
Java Software Program
Learning IR Code Basic
Learning IR Code Adv
Learning IR Code Tips
Advanced
Shadowle
Macro Commands
UDP Port
Firmware Update
Port Forwarding
RS232 Strings
RS232 X10 Control
Troubleshooting
Quick Checklist
Other
Optional Accessories
Third Party Software
Software Developers

The Keene KIRACC Contact Closure module provides a number of ways to control devices via local network and the internet.
Commands can be issued simply by accessing the built in web pages via any device with a browser. The open API structure means
it can integrate seamlessly with a number of other IP control systems and apps for tables and smart phones.
Key features:
Infra Red
Infra Red over IP either real time IR receive/transmit over IP
used in conjunction with another KIRA module, or use IP
control to blast any of the 150 IR codes stored within the
on-board memory
Two IR emitter outputs, individually routable
20 macro commands, each up to 30 steps
Built-in dedicated high accuracy IR code learning receiver.
Contact Closure
Two isolated relay contacts, each rated at 48V 6A.
The relays can be set to open, close or pulse with
congurable timings.
Both relays feature pluggable Phoenix connectors for easy
installation.
RS232
Contains a TCP/IP to RS232 server that can be used as an
RS232 / TCPIP bridge.
RS232 strings can be stored into on-board memory and
triggered by IP from an app or as part of a macro.
Power
Built in Power over Ethernet (PoE) capability
TCP/IP
Can act as a TCP/IP target for IR Anywhere modules
Built-in support for a dynamic DNS client to cater for non-
static IP addresses
Strong ABS case with anges for quick and reliable
installation.
Relays
Two isolated relay contacts 48V 6A max each
Pluggable Phoenix connectors for easy installation
Can be set to open closed or can be pulsed
Pulse time can be set in 1/4 second intervals up to 1 minute.
Pulse will invert current state for the time required.
Can be set to start up open or closed with a delay.
Infra Red
2 individually routable IR outputs.
Each output can drive twin emitters.
Can be used as an source for the Keene IR distribution
ampliers with correct lead.
RS232
Support for baud rates up to 115200.
Can be used as an RS232 / TCPIP bridge.
RS232 strings can be stored into eeprom memory and used
from an app and as part of a macro
EEPROM MEMORY
150+ memory locations
Can store IR codes up to 128 bit to include Air Conditioning
control
Can store RS232 strings up to 256 chrs
Can store relay set commands or relay pulse commands
Can store macros
Enhanced macro support
Macros can reference anything that can be stored into a
memory location whether RS232 string, relay state change or
IR codes.
Step pause can be set for each step.
Up to 20 macros
Up to 30 steps per macro
Flash based web pages
Access to module set-up
Web button access to the stored memory locations and
macros
UDP based API available
Can be accessed from most networkable devices.
Allows easy use for mobile Apps and xed applications
Built in support for ‘pronto’ style IR codes
IR codes macros, relay set, clear, pulse can all be sent via the
API as well as stored in memory
Product Code: [KIRACC]
Brand: Keene Electronics

Reset Button
Pressing and holding the reset switch until the acknowledge
light comes on will reboot the module whilst retaining all of
the current settings. This switch can also be used to perform
a full factory reset as detailed on the reset link opposite.
LAN link LED
Will illuminate to conrm that a network connection has
been successful established.
LAN data LED
Will ash whenever network data is sent or received.
Activity LED
Will ash whenever the module is executing a command.
Twice per second = looking for another module or computer
on the network
Once every ve seconds = found another module or
computer on the network.
(see “advanced settings” for compatible computer
information)
ACK - acknowledge LED
Will ash to conrm that data has been successfully
transmitted to the target - in other words your message got
there! (see“port forwarding” for more details)
IR Learn Window
Aim your remote control at this when learning codes for storage.
IR1 & IR2 Activity LED’s
Will ash whenever IR data is sent to that IR emitter port.
Relay1 & Relay2 Activity LED’s
Will illuminate whenever the contacts are closed.
Power LED
Should always be illuminated whenever power is connected.
Don’t expect much to happen if it’s not.
LAN PoE compatible
Use a CAT5/E/6 cable to connect this port to your hub,
switch or router. This should not be connected directly to
your computer network port. If you can’t run a network
cable to the desired location you can optionally connect to
your home network using either a pair of plug-in powerline
adapters or a wireless Ethernet Bridge. If connected to a
PoE (power over Ethernet) compatible hub then no external
power supply will be required.
RS232
Jack socket to connect to the RS232 port (via KLD80 cable).
The RS232 port can be used as an RS232 / TCPIP bridge, or
RS232 strings can be stored into on-board memory and
triggered by IP from an app or as part of a macro.
IR Output 1 & IR Output 2
To be connected to IR emitter wands or to the input of an
IR distribution system. Optionally send commands to both
outputs simultaneous or route to output 1 or output 2 as
required. Supplied as standard with universal output wands,
other options are available as listed under “Accessories”.
Relay 1 & Relay 2
The green connectors can be unplugged by simply pulling
away from the unit for ease of installation. The contacts are
rated at 48V 6A and can be commanded to open, close or
pulse as required. The Pulse time can be set in 1/4 second
intervals up to 1 minute. Pulse will invert current state for the
time required. They can be congured to start up as open
(N.O.), closed (N.C.) and optionally with a start-up time delay
if required.
Power
If a PoE (Power over Ethernet) connection is used then no
other power supply is required. If a power supply is to be
used it should be rated at a minimum of 7v and maximum
of 9v DC (regulated) at 200mA or greater, 2.1mm DC socket,
centre positive.
CONNECTIONS & INDICATORS
Setup

Assuming that you have your module has power and is
connected to your network correctly the next step is to
access the built-in web pages and congure it as required.
The default factory setting is for DHCP to be enabled so
the module will request an IP address from your router. In
order to nd the IP address assigned by your router it is
recommended to use the Java Utility program. The program
can be freely downloaded
Note - If the module is unable to obtain an IP address via
DCHP the factory default IP address is 192.168.1.34.
Unzip the downloaded le into a folder of your choice and
browse to the“Java utility” program folder. Within this folder
click on“kira.exe”(if using Windows) or“kira.jar”(if using a Mac).
Note - no installation is required, the program will just run.
The Java Utility program will scan your network and report
back any compatible Keene KIRA modules that it nds.
The module IP should be listed at the top alongside“select
current module”. You can now enter this IP into your
browsers address bar, or from the java program select “web
pages”and then “open module home page”.
The java program can be used for many other functions.
These are covered in depth in the“Java program” section but
for now we will continue with the web pages conguration.
It is also possible to connect to the module by typing the
host name into your browser address bar. If still at factory
default this will be
http://KIRACC
(note the lack of “www”)
FIRST STEPS  FINDING THE MODULE
Setup

Note that this is a password protected page - Factory default
user = “Keene” and default password = “Electronics”
This section allows you to disable the API control of the
relays. If disabled then only direct web browser control will
function. Factory default is ENABLED and it is recommended
to leave it set in this state.
Allow Activity LED to pulse. This check box determines
whether the acknowledge LED should pulse during normal
operation. Maybe it bothers you? if it does then turn it o!
Factory default is ENABLED
Enable IR code learning. If you wish to learn and store IR
codes this must be enabled by checking the box and clicking
“save” at the bottom of the page. Factory default is DISABLED
and it is recommended to change back to this state once you
have nished learning your codes.
Here you can set the default state for each relay when power
is lost and re-applied. Factory default is “Restart in OFF state”.
Remember to click “save”after you have made any changes.
MODULE CONTROL OPTIONS
Browser pages

The RS232 port can be congured as follows:
RS232 for TCP/IP <-> RS232 bridge
In this mode the module will send any data received on
the RS232 port out via TCP on port 9761. The port can be
changed via the options in the section below.
RS232 for device control
In this mode the module will output any RS232 strings that
have been stored within the eeprom memory. These stored
commands can be used from an app and as part of a macro
combined with Infra Red.
Send KRS followed by a 3 digit decimal number representing
the location you want to address. The string should be
terminated by a Carriage return and line feed Cr Lf (chars 13
and 10)
For example: KRS002CrLf
This will cause the contents of memory location 002 to be
blasted via the IR emitters.
Note - the CrLf is just 2 characters char(10) and char(13)
RS232 is disabled
In this mode the module will neither output nor respond to
any activity on the RS232 port.
Factory default is RS232 For device control.
RS232 <-> TCP Bridge Options
These options are only available if you chose RS232 for TCP/
IP <-> RS232 bridge above.
It can operate in 2 modes client and server.
When the unit is a server it does not need to know the IP
address of the client. The client initiates the transaction and
from then on data is sent to the IP address of the client.
When the unit is a Client it must have an IP address to send
to as it is the one that initiates the service.
The IP of the Server can be entered into the IP address box,
or if there is another IR Anywhere module on the network
and that is a server, check the nd server box and the two
will nd each other. The IP address box and MAC address will
be automatically lled in once they have found each other.
(About 1 minute) You will need to refresh the page to see
them.
The Bridge will operate at all of the baud rates. Please make
sure that on board IR code learning receiver is switched o
(via the main options page). If unwanted IR noise is detected
it can generate interrupts that might cause dropped
characters.
Set Baud Rate
Select RS232 to TCP bridge baud rate. As it says, if you wish
to use the RS232 interface you can choose the required baud
rate - default is 19200.
Remember! you must click “save and re-boot” for any
changes to take eect.
RS232 CONTROL OPTIONS
Browser pages

As it says. Any changes you have made and any IR & RS232
codes stored will be erased and the module will be reset to
factory default with DHCP enabled.
It is also possible to perform a complete factory default reset
by using the reset switch as follows; press the reset switch
for two seconds then release and wait for both the“ACK” and
“Activity” LED’s to illuminate, then press the reset switch again
and keep it depressed until the“ACK” LED goes out. Release
the switch and when the module has rebooted it will be reset
to factory default.
RESET TO FACTORY DEFAULT
Browser pages

Browser pages
Note that this is a password protected page - Factory default user = “Keene”and default password =“Electronics”
• View the modules MAC address. It is not possible to alter
this.
• Set the modules Host Name – for example you might
want one called “lounge”or “Study” or “Bernard”,
whatever you like really.
• Use DCHP for IP address. Uncheck this if you want to
assign your own IP address.
• IP Address. This is where you can change it from the
factory default or DHCP assigned to one that better suits
your network if required. Be aware that once changed,
you may not be able to connect to it again straight away
without rst reconguring your computers network
settings.
• Subnet Mask. The default is 255.255.255.0 and we
recommend you leave it set at this. The only time this
should really altered is if you have more than 255
devices on you local network.
• Gateway address. If the initial DHCP was successful this
is usually set to the IP address of your router, and can be
manually entered if required.
• DNS Server 1 & DSN Server 2. The Domain Name Servers
will usually have auto congured with the initial DHCP
and can be edited if required.
• UDP port used for IR. The default is 65432. See“Advanced”
help section“UDP Port”for more detail.
• Computer MAC & IP address. Should be set to match
the IP address of the computer you will use for learning
IR codes. The MAC address is displayed above in red for
reference only. If the MAC address is shown as all FF’s
the the MAC address has not been resolved. This is not
necessarily a problem as not all modes of operation
require the module to attempt to resolve it.
• Enable DNS client.
• Save and reboot. If anything has been altered you
will need to reboot the module to make the changes
permanent.
BOARD CONFIGURATION

Browser pages
Note that this is a password protected page - Factory default user = “Keene”and default password =“Electronics”
As it says, change from the factory default of “Keene” and “Electronics”to anything else you might prefer.
CHANGE PASSWORD