Just Add Power Cardware 2G HD over IP Installation instructions

Dealer Support
Manual V1.2

2G HD over IP Dealer Support Manual –Page 2
©2011 Just Add Power Cardware Co, Inc. All rights reserved. Unauthorized use or disclosure prohibited. V1.2
Contents
Just Add Power 2G OSD Messages............................................................................................................................. 3
Simple Type 1 Serial Communications using RS232 over IP ports............................................................................. 4
Type 2 Binary Serial Communications using RS232 over IP ports.............................................................................. 5
Advanced Controls Overview:.................................................................................................................................... 6
How to Access the Console:................................................................................................................................... 6
How to determine the 2G board's IP address:....................................................................................................... 6
FAQs: ...................................................................................................................................................................... 7
Console APIs Description: ...................................................................................................................................... 8
Debug Console APIs: .......................................................................................................................................... 8
Configurations APIs:........................................................................................................................................... 9
UART Port 1 APIs:............................................................................................................................................... 9
Configuration Options List: .............................................................................................................................. 10
Example console session for visual learners:....................................................................................................... 12
Practical application examples: ........................................................................................................................... 12
Diagnostic Console access without InstallerPro UART2 console cables .................................................................. 13
Using IR Manager VBS-HDMI-IR104 with 2G RS232 ports....................................................................................... 14
VBS-HDMI-IR104 RS232 Command List: .............................................................................................................. 16
Adjust IR Command Length (Short vs. Long).................................................................................................... 16
IR Control Commands ...................................................................................................................................... 17
RS-232Port IR Memory Write Command......................................................................................................... 19
HDMI Video Resolutions supported: ....................................................................................................................... 20
NOTES: ..................................................................................................................................................................... 25

2G HD over IP Dealer Support Manual –Page 3
©2011 Just Add Power Cardware Co, Inc. All rights reserved. Unauthorized use or disclosure prohibited. V1.2
Just Add Power 2G OSD Messages
- Splash screen at boot up
Trying to find the gateway... –This means no Transmitter detected on the
same VLAN. Check the network settings. Using a direct connect CATX cable
(one TX to one RX) can be used to prove it is a network problem.
Found {Transmitter IP}, starting link.. –This means a Transmitter was
found.
Gateway may have rebooted - standby –Self explanatory (the Gateway is typically a Transmitter)
HD_OVER_IP initialized. –Self explanatory, the Transmitter and Receiver have established a link
All services initialized - please standby... –Self explanatory, usually happens when the HDMI source boots up
slowly
Waiting for video source –please standby... –Self explanatory, often caused by a slow player
HD_OVER_IP stopped! –Self explanatory, may be caused by an IP command to the Transmitter to shut down
video.
ERROR! HD_OVER_IP failed? Stop the link –Self explanatory, probably a hardware problem.
System stopped! –Self explanatory, may be caused by IP command to Receiver
All services are stopped –Self explanatory, probably a hardware problem
Gateway is not ready yet - –Self explanatory, wait for Transmitter to finish booting up
- The HDMI source is set at something not supported –change to 480, 720, or 1080
if possible. We have used a computer to test the 2G solution to confirm
compatibility with the following common graphics resolutions: 1920*1080,
1680*1050, 1600*1200, 1440*900, 1366*768, 1360*1024, 1360*768 and
1280*1024. Of course the target display must be compatible with the same.
- The HDMI source was power cycled or the HDMI cable was unplugged
NOTICE: HD over IP and HD/IP are global trademarks or registered trademarks of Just Add Power Cardware Co., Inc. HDMI, the HDMI Logo, and High-
Definition Multimedia Interface are trademarks or registered trademarks of HDMI Licensing LLC in the United States and other countries.

2G HD over IP Dealer Support Manual –Page 4
©2011 Just Add Power Cardware Co, Inc. All rights reserved. Unauthorized use or disclosure prohibited. V1.2
Simple Type 1 Serial Communications using RS232 over IP ports
The 2G's have been shipped with the RS232 ports set for Type 1 ASCII mode. There is also a Type 2 BINARY
mode option, but that is a bit more complicated (more on BINARY mode later). In order to "connect" a
Transmitter RS232 port to a Receiver RS232 port in ASCII mode you do the following:
1. Enter client access mode by sending the byte "0x0E" (Ctrl-N, aka hex 0E ) to the Transmitter RS232 port.
This will break an existing link to another Receiver.
2. Link to the Receiver Mac Address with the ASCII Terminal Connect command (ast_c). The Receiver Mac
Address is shown on the TV status screen in the lower right hand corner as CLIENT ID. Baud rates up to
115200 are supported.
a. ast_c <macaddr><baudrate><break code override><enter>
b. For example, if your Receiver Mac Address is ABCD12345678 and you are wanting a typical
9600, 8, N, 1 connections you would issue the command
ast_c ABCD12345678 9600-8N1 [ENTER]
c. In the example below we see a HyperTerminal session where I used 2G RS232 Over IP to
connect to my Netgear switch RS232 port and issued the SHOW VLAN command.
AT THIS POINT I PRESSED CTRL-N to break the session

2G HD over IP Dealer Support Manual –Page 5
©2011 Just Add Power Cardware Co, Inc. All rights reserved. Unauthorized use or disclosure prohibited. V1.2
3. You should now be connected to the terminal prompt from the attached RS232 device connected to the
Receiver. The session will stay connected until you issue the hex 0E command (Ctrl-N) again. This does
mean you cannot use hex 0E for any ASCII control commands during a communications session, which
may be a minor inconvenience for some RS232 devices. You can overcome this limitation by using the
optional “break code override”function when you establish the link to the target. For example: "ast_c
0200000000e1 9600-8n1 f0" to set "f0" as the break code of this link session. The new break code is
only applied to the current link session. After the current link session is disconnected, the break code
will reset to the default "0E". The valid break code range is any character from 01 to ff hex.
NOTE: The Break Code Override function was introduced with firmware A1.32. Older firmware does
not support this function. Always check your firmware version before attempting to use new features.
Now it gets interesting. With one RS232 connection to your host processor device, you can have a 2G
Transmitter dedicated to serial communications. You can think of this as sort of a serial master device. As long
as there is no HDMI source connected to the serial master, it can be on the same VLAN as another Transmitter
and there will be no disruption to the HDMI content being watched on the Receiver. With typical switches, this
means you will need to issue a SWITCHPORT command to get the serial master on the same VLAN as the target
Receiver before you issue the "ast_c" connect command.
Type 2 Binary Serial Communications using RS232 over IP ports
The 2G's have been shipped with the RS232 ports set for Type 1 ASCII mode. There is also a Type 2 BINARY
mode option. Details on how to change the serial port from Type 1 to Type 2 are provided later on in this
document.
With Type 2 serial communication there is no manual initiation of the link between the Transmitter and
Receiver. Instead, the Transmitter is always trying to talk to all the Receivers simultaneously, until one Receiver
echoes a response to the Transmitter. Then a point-to-point bidirectional link is established that will break after
a user specified period of no data activity designated by the ASTPARAM variable 'soip_type2_token_timeout'.
This form of communications is intended for advanced RS232 devices that need to talk to each other in Binary
mode. Using an isolated VLAN would be one method of having more specific control over which Receiver(s) can
respond to the RS232 transmission.

2G HD over IP Dealer Support Manual –Page 6
©2011 Just Add Power Cardware Co, Inc. All rights reserved. Unauthorized use or disclosure prohibited. V1.2
Advanced Controls Overview:
This section of the Dealers Manual document describes the advanced commands which can be used with the
Just Add Power 2G processor console. The 2G processor uses Linux OS and the console is driven by a BusyBox
shell. The debug console is set to UART port 2 using baud rate at 115200-8n1 (requires a special cable to
connect to the PCB). Through console APIs, developers can control certain 2G firmware features and functions
Notation:
• Console commands starting with "$": Means they are global console commands. This kind of command is
executed under Linux shell console from any location.
• Console commands starting as "$./": Means they are exclusive console commands and must be executed
within the path "/usr/local/bin". These commands must be prefaced with “./” (dot-slash).
How to Access the Console:
There are two ways to access the console:
1. UART2 debug port on the 2G printed circuit board: It is a RS232 interface using 115200-8n1 baud rate
settings. Developers can attach to this debug port to access console. This RS232 Console port requires a special
cable.
2. Use telnet: Every 2G Transmitter/Receiver has Telnetd and a telnet client built in (port 24 is the open port,
„root‟ is the userid, and there is no password). Developers can use one 2G telnet client to connect to any other 2G
board on the same VLAN or write their own program using telnet protocol to connect to any 2G board through an
Ethernet network.
How to determine the 2G board's IP address:
The 2G firmware default setting is for "autoip" mode and uses the 169.254.xxx.xxx private IP domain range. The
IP of target 2G boards is resolved by its hostname using mDNS protocol. If you have access to the InstallerPro
software utilities (licensed separately) It is possible to use “static IP” or “DHCP” instead of “autoip”, but it is not
recommended for most users. If a developer chooses “static IP” or “DHCP”, they must be responsible to maintain
their own IP mapping to know which 2G board is using which IP address. When using the recommended “autoip”
mode there are several supported methods available to resolve the IP addresses:
1. 2G Receiver‟s HDMI GUI: The 2G Receiver‟s HDMI GUI will display the Receiver‟s IP address and the
connected Transmitter‟s IP address.
2. Console APIs: Two console APIs are provided:
a. astresname: use this command to resolve a target's IP address by providing target‟s hostname.
b. node_list: use this command to list all found 2G boards' hostname and IP address.
3. Use mDNS protocol tools. For example:
a. Bonjour: http://developer.apple.com/networking/bonjour/ or
http://www.science.uva.nl/research/air/wiki/mDNSResponderInstallation
b. pyZeroConfig: http://sourceforge.net/projects/pyzeroconf/files/

2G HD over IP Dealer Support Manual –Page 7
©2011 Just Add Power Cardware Co, Inc. All rights reserved. Unauthorized use or disclosure prohibited. V1.2
FAQs:
General Configuration:
1) How can I discover all the other 2G boards on the same LAN?
Use the telnet or debug console to attach to the target board
Login as “root” and then change directory “cd usr/local/bin”
Start discover all: $./node_list
Start discover hosts: $./node_list -t host
Start discover clients: $./node_list -t client
The result will be shown on the console, where hosts are 2G Transmitters and clients are 2G Receivers
2) How do I read/write target board's UART port 1 (/dev/ttyS0)?
Use telnet or debug console to attach to target board
Use stty to configure the UART port 1. Ex: $stty 115200 -F /dev/ttyS0 => set UART port 1's baud rate to
115200.
To start read: $cat /dev/ttyS0 & => UART data will be redirected to console
To stop read: $pkill cat
To start write: $cat > /dev/ttyS0 => console input will be redirected to UART
To stop write: press "ctrl+c" (0x03)
3) What if I need to include “ctrl+c (0c03) in my RS232 command string?
You can use the console function $printf instead to send commands out port 1 (/dev/ttyS0)
Example: $ printf "\x02 PLAY \x03" > /dev/ttyS0
4) How do I configure UART port 1 (/dev/ttyS0) for non-"Serial over IP" usage?
UART port 1 is typically used for "Serial over IP" feature. Developers who want to manually control UART
port 1 need to disable the "Serial over IP" feature.
To configure UART port 1, please use "stty" command. See "Console APIs Description" below for details.
5) How do I change the IP Address and Netmask of the Transmitters or Receivers
Use InstallerPro software utilities –InstallerPro is purchased separately and has a one time license fee
for authorized dealers.

2G HD over IP Dealer Support Manual –Page 8
©2011 Just Add Power Cardware Co, Inc. All rights reserved. Unauthorized use or disclosure prohibited. V1.2
Console APIs Description:
Debug Console APIs:
Turn on/off RS232 Console application debug message
NAME: setconsole
EXAMPLE:
Turn off: $setconsole /dev/ttyS1
Turn on: $setconsole –r
Turn on/off RS232 Console kernel debug message
NAME: dmesg
EXAMPLE:
Turn off: $dmesg -n 1
Turn on: $dmesg -n
Reboot system
NAME: reboot
EXAMPLE: $reboot
Telnet client
NAME: telnet
EXAMPLE:
telnet to IP 169.254.0.101 port 24
$telnet 169.254.0.101 24
telnet to ast-client0000.local port 24
$telnet ast-client0000.local 24
List all 2G devices
NAME: node_list
OPTIONS
-t : specify the device type to list
EXAMPLE
List all clients:
$./node_list -t client
List all hosts:
$./node_list -t host
Get IP from hostname:
NAME: astresname
EXAMPLE:
Get "ast-gateway0001.local"'s IP address:
$./astresname ast-gateway0001.local
To kill a running process by process name:
NAME: pkill
EXAMPLE:
kill a process named "abc"
pkill -9 abc

2G HD over IP Dealer Support Manual –Page 9
©2011 Just Add Power Cardware Co, Inc. All rights reserved. Unauthorized use or disclosure prohibited. V1.2
Configurations APIs:
Access configurations from flash:
NAME: astparam
OPTIONS
r : read from RO section
g : read from RW section
s : write to RW section
flush : clear all settings in RW section including random generated MAC address
save : saves changes to flash memory
EXAMPLE:
read " no_soip" setting from RO section:
$./astparam r no_soip
read " s0_baudrate" setting from RW section:
$./astparam g s0_baudrate
write " soip_type2" setting as "y" to RW section:
$./astparam s soip_type2 y
clear all settings in RW section:
$./astparam flush
clear “no_soip” setting in RW section:
$./astparam s no_soip
Reset setting to factory default:
NAME: reset_to_default.sh
DESCRIPTION: resets the RW section but keeps the random generated MAC address. A system reboot
is required to take effect.
EXAMPLE:
$./reset_to_default.sh
UART Port 1 APIs:
Setup /dev/ttyS0:
NAME: stty
DESCRIPTION: used to configure terminal parameters, such as baud rate and whether characters will be
echoed
Example: set baudrate to 115200
$stty 115200 -F /dev/ttyS0
Reference http://linux.about.com/od/lna_guide/a/gdelna38t01.htm for more details on stty

2G HD over IP Dealer Support Manual –Page 10
©2011 Just Add Power Cardware Co, Inc. All rights reserved. Unauthorized use or disclosure prohibited. V1.2
Configuration Options List:
Configuration options are settings saved in flash memory. These settings are used by the 2G firmware. The 2G
firmware reserves two flash partitions for this purpose. One is read only (RO), the other one is a read-writable
(RW) partition. The Just Add Power factory default settings are saved in the RO partition. Changes are saved in
the RW partition. When the same configuration name is defined in both partitions, the setting in RW partition will
be used (unless especially noted otherwise).
s0_baudrate
DESCRIPTION: The static baud rate used under RS232 over IP Binary mode. For example: "115200-
8n1" means using "115200" baud rate with data bits "8", parity "None" and stop bits "1".
DEFAULT: 115200-8n1
PARTITION: RO, RW
no_soip {y/n}
DESCRIPTION: Used to turn ON/OFF the external RS232 UART1 serial over IP port.
DEFAULT: n (the port is enabled as Type 1 ASCII RS232 in the factory)
soip_type2 {y/n}
DESCRIPTION: Used to change the external RS232 UART1 serial port mode where type 1 is ASCII and
type 2 is BINARY
DEFAULT: n (the port is enabled as Type 1 ASCII RS232 in the factory)
soip_type2_token_timeout
DESCRIPTION: Used to set the idle activity timeout disconnect function for Type 2 RS232
DEFAULT: 3 seconds
This variable can be set to whole numbers 1 or higher representing whole second increments
$./astparam r soip_type2_token_timeout 1