AirconsoleTSUserManual2 70
AirconsoleTSUserManual2 70
User Manual
Version 2.70
Welcome to Airconsole TS
Airconsole TS Features
Package Contents
Serial Settings
AP Client Mode
Basic Wireless
HT Physical Mode
Wireless Security
Advanced Wireless
Troubleshooting
Technical Information
Airconsole Connectors
Airconsole TS comprises a head unit and additional 4port cable kits which form a 4 to 12 port single
terminal server unit. The entire unit is powered via either via mains from an external 5V DC USB
power adaptor (included) or from a 802.3af PoE switch via an optional PoE splitter.
The first part of this guide highlights the most common setup requirements. Later sections go
through the full configuration options in more detail.
Airconsole TS Features
Airconsole TS has the following supported features
Package Contents
Your Airconsole TS package contents
depends on whether you ordered a
Standard or PoE model
Airconsole TS ships with 4 serial cables with RJ45 presentation. These are
pinned out for cisco serial console ports. Each cable can be individually adapted
to DB9 (Null or Straight through) via an additional RJ45toDB9 adaptor. Other
adaptors including RJ45toDB25 and RJ45toDEX are also available from
www.getconsole.com.
Airconsole TS can be expanded by adding both additional 4 Port Serial cable
kits, and also via using a slide on PoE Splitter rather than the external power
cable and Power adaptor. Add these optional components as per the illustration
above.
Airconsole TS has a built in webpage that can be used to change the default settings, as
well as flash the device with new firmware if required. To access this webpage complete
steps 1 and 3 of the initial setup instructions above, and then browse to
http://192.168.10.1/from any modern web browser.
The default username and password are both "
admin
".
As Airconsole’s web pages do not automatically refresh, it is useful to refresh this page
in browser after changing a LAN, WIFI or Remote Access configuration to see the
change reflected.
For applications such as Get Console, these settings on this webpage do not need to be
changed as the Get Console application will dynamically reconfigure Airconsole’s serial
settings (Baud rate, Flow Control, Data/Stop/Parity Bits etc) on each new connection.
The supported options for each of the serial settings are as the below table:
Airconsole TS allows for individual Serial ports to have different Default settings
by changing the Line settings to “Custom”. Modify each individual port as well as
provide the port a more friendly name on the Port Settings page.
Airconsole TS can act as an RFC2217 compatible serial terminal server and/or a Raw
IPSerial bridge. The default ports for each of these services can be modified on the
Advanced Serial Settings page.
Note that altering the default Com Port Control tcp port from 3696 will require a restart of
Get Console app to redetect the changed port, and will require modification of windows
and OSX driver default configuration.
If SSH support is enabled, then the default starting port is 4001. This can also be
changed.
Note that the telnet (3696) and SSH (4001) tcp ports refer to the first Airconsole TS
serial port. Each subsequent serial port the tcp port number increases by one as per the
below table:
Serial 1 2 3 4 5 6 7 8 9 10 11 12
Port
Telne 3696 3697 3698 3699 3700 3701 3702 3703 3704 3705 3706 3707
t
TCP
Port
SSH 4001 4002 4003 4004 4005 4006 4007 4008 4009 4010 4011 4012
TCP
Port
The “Force Binary Mode” can be used when operating on the 3rd party HW Group
Windows driver that does not dynamically negotiate binary transfer mode.
Unchecking the “Enable Com Port Control” tick box will disable the NVT
extensions to the RFC2217 that allow for dynamic changing of baudrate, flow
control and other serial parameters inband without resetting the serial port.
Airconsole TS also supports direct interaction with its serial port via Websockets protocol
on tcp port 8080. This port can be changed on this Advanced Serial Settings page.
Websockets provides a simple and developer friendly method for communicating
through a serial port directly from a web page or web application. To learn more about
Websockets support in Airconsole download the Websockets SDK at
support.getconsole.com
Airconsole TS supports the Bluetooth Low Energy and Bluetooth Classic connectivity to
asingle serial port if a Bluetooth dongle is attached to the female USB port on the 4 port
cable kit. The first port (labelled “1”) is accessible via Bluetooth. Other ports and multiple
ports concurrently over Bluetooth will be supported in later firmware releases.
Behaviour when using Bluetooth connectivity to the 1st Serial port by default allows for
subsequent Bluetooth connections to “kick out” the initial connection. This behaviour can
be modified on the Multiple Connection Preference section of Advanced Serial Settings.
Tick the box to prevent subsequent connections, and then set an idle time before a
subsequent Bluetooth connections can terminate the original connection.
2.3 Airconsole TS Network Options - READ BEFORE CONFIGURING WIFI and LAN
Airconsole TS has 4 different operating modes to participate in WIFI and Wired Ethernet
networks. Before configuring LAN and WIFI settings, consider the best mode for
Airconsole TS in your environment.
1. Bridge Mode : The Default Mode. Airconsole Bridges between its own
AirconsoleXX WIFI and Wired LAN port. It has an IP address on the logical
Bridge interface only. The IP address can be configured statically, or learnt from
an external DHCP server via the LAN port. If the IP address is configured
statically, then Airconsole itself can be a DHCP server for the bridged WIFI/Wired
Interfaces.
2. Bridge Mode with AP Client ( AP Client Mode ): This is an extension to Bridge
Mode with an additional
routed WIFI connection can be made to an external
WIFI network. Airconsole will route between the Bridged group of interfaces (LAN
port, AirconsoleXX WIFI) and this external WIFI network.
3. Station Mode (
Bridged
): The Airconsole internal Access Point is disabled, and
instead Airconsole joins only to an external WIFI network. The external WIFI
interface is bridged with the LAN port. Airconsole’s IP is configured either
statically or learned from the external WIFI DHCP server.
4. Station Mode (
Gateway / Routed): The Airconsole internal Access Point is
disabled, and instead Airconsole joins o nlyto an external WIFI network. The
Wired LAN port is also configured on a different IP subnet. The external WIFI
interface subnet is routed with the LAN port. Airconsole’s IP on the external WIFI
segment is configured either statically or learned from the external WIFI DHCP
server. Airconsole’s IP on the LAN port subnet is also either statically configured
or learnt via DHCP.
The following drawings and interface descriptions further expand on each mode and the
configuration steps to achieve the correct operation.
Bridge Mode (Default Operation)
eth0 Physical Ethernet Port (by default) connected to Br0 bridge (does
not have its own IP address)
ra0 802.11n WIFI interface (by default) connected to Br0 bridge (does
not have
its own IP address)
AN
Configure br0’s IP address on the L page
The DHCP Server function is enabled by Default. Airconsole will allocate IP’s to both
WIFI clients connecting to the ra0 interface or LAN users reachable via the eth0
interface. Sometimes this is not desirable, if connecting the LAN port into an existing
Corporate LAN that already has a DHCP server. In this case disable the Airconsole
DHCP server and enable “DHCP Client” rather than Static IP address for Airconsole’s
interface itself.
When DHCP Client is enabled for Airconsole LAN (br0) interface IP, it will automatically
disable the DHCP server.
AP Client Mode
Airconsole will route between these two networks. Optionally NAT can be configured so
that traffic from the AirconsoleXX WIFI and LAN going to the external WIFI network will
be NAT’ted to the apcli0 IP address. This is useful where the external WIFI network
provides an Internet hotspot service.
eth0 Physical Ethernet Port (by default) connected to Br0 bridge (does
not have its own IP address)
ra0 802.11n WIFI interface (by default) connected to Br0 bridge (does
not have
its own IP address)
AN
Configure br0’s IP address on the L
page
apcli0 Additional WIFI interface This interface is routed to/from the above
connected to external bridge group of interfaces. Optionally NAT
WIFI network. can be performed for traffic from the
Bridged interfaces to this routed interface.
Use this method (for example) to provide
AirconsoleXX and LAN users access to an
external WIFI network that can connect to
the Internet.
To enable AP Client mode go to Wireless>AP Client (1) and then tick the “Enable
Wireless Client Mode” (2)
Then initiate Scan for a WIFI network to join with the SCAN button (3)
The SSID, Authentication type and encryption method are prepopulated. Tick the Enable
Wireless Client Mode and add in passphrase. Then press Apply.
Note that with AP Client mode, Airconsole’s AP client will NOT follow the external
WIFI network if the channel changes. If the channel changes then the user must
rescan and reconnect to the external WIFI network. This is because in AP client, the
Airconsole is operating its own Access point at the same time on a single radio so
cannot change channels automatically.
Also on the Airconsole Home (Status) page the IP Address allocated to the AP Client
(WAN) interface will be visible
Note the WAN IP will change from 0.0.0.0 to the allocated IP from the external
WIFI network.
Station Mode (Bridged) is the simplest configuration option where Airconsole should join
just an external WIFI network and bridge it to its LAN port. It does not operate its own
Access point rather behaves just like a WIFI client only.
Station Mode is often better than AP Client Mode because if the external WIFI
network changes WIFI channels then with Station Mode, the Airconsole will follow
the channel. This is not possible with AP Client Mode.
OT
To enable Station Mode (Bridged) is a little counterintuitive. It is N configured via the
Wireless>”AP client” page. Rather, it is only accessible after disabling the Airconsole
Internal AP from the Wireless>Basic (1) page, then click “Turn Off” next to Internal
Access Point (2)
Note that this configuration should be done via the LAN port else access to the
Airconsole’s web interface will be lost.
After switching off the AP, the options on the Wireless Tab change to Setup and Profiles.
Setup allows for Scanning and connecting to external WIFI networks, along with how the
br0 interface will be addressed (ie via External WIFI’s DHCP server (default) or
statically). By Default the br0 interface will use an address learnt from DHCP over the
ra2 interface. Alternatively change the “IP Configuration” dropdown to Static and
populate the fields.
Profiles allow for the storage of 8 WIFI networks and credential settings so that
Airconsole can automatically join these if seen again after power cycle.
Station Mode (Routed) is an alternative Station mode where Airconsole routes between
the ra2 (external WIFI) and eth0 interface (rather than bridging). This configuration is
useful where the internal private LAN network needs NAT to reach the external network
(generally because the internal LAN network is not routable from the external network)
To configure Station Mode (Routed) perform the same steps as Station Mode (Bridged)
above, however on the WIFI Setup tab, change the “Network Mode” to “Gateway”
Once “Gateway” is selected, the option for configuring the Wired LAN’s segment IP
address and details is presented. the LAN (eth0) port can be addressed via either DHCP
or Statically.
If NAT is required when routing from the LAN to the external WIFI then tick the NAT box.
This will translate all source addresses from the LAN to the WIFI interface IP address.
2.4 Airconsole DHCP Server Setup
[Applies only to Default Bridge Mode]
While the Airconsole Setup page has a static IP address set for the Bridge interface, the
DHCP Server Mode is enabled by default on the main Setup page.
In this mode the Airconsole acts as a DHCP Server on its Bridge interface .ie for both the
“AirconsoleXX” wireless and wired LAN port. It will allocate IP addresses from the range
configured on the web page. Within this mode there are 2 sub options:
● “No default Route” – with this option selected: Airconsole will provide an IP
address only to DHCP Clients. This is to allow devices such as iPhones and
iPads with 3G wireless to continue to access the Internet directly over that
interface while concurrently connected to the AirconsoleXX WIFI network. Note
as at writing this option does not work with Android devices (an AP client tether
workaround exists for Android as discussed below).
● “Enable DNS Proxy” – with this option enabled, when Airconsole has an AP
Client interface enabled along with NAT, the Airconsole will act as a DNS proxy
to resolve external names to IP addresses on behalf of AirconsoleXX WIFI
clients. This allows these clients to access the Internet via the AP Client interface
without knowing external DNS server addresses.
Assuming the DHCP Server feature is disabled, Airconsole will still bridge DHCP client
requests (if any) from wireless clients on the AirconsoleXX WIFI through to the wired
LAN, meaning any client connected wirelessly to the Airconsole will still be able to obtain
an IP address from a wired LAN DHCP server if one exists.
802.11 Mode:
11b/g/n mixed mode
SSID:
AirconsoleXX where XX is the last 2 digits of the device mac address
Broadcast SSID: On – disable this if you do not want Airconsole to announce its SSID
to Wireless LAN. Only wireless clients that are manually configured to join the
AirconsoleXX WIFI network with the correct password will be able to join
AP Isolation:Off – enable this if you do not wish wireless clients joined to Airconsole to
be able to communicate with each other (ie only with the Airconsole itself)
Channel Bandwidth: 802.11n allows for doublewidth channels (ie channel 1 and 6
bound together) to improve throughput. The default is 20/40 which means Airconsole will
accept 40Mhz channel connections from wireless clients that support this but also
support legacy wireless clients that support only 20mhz channels (the default for
802.11b and 802.11g). We recommend however when using with AP Client to set
this to 20Mhz only.
Guard Interval: Long or Auto. The Default is Auto. Setting Guard interval to “Long” will
improve reliability in noisy WIFI environments at the expense of throughput. Airconsole’s
Auto setting will attempt to tune the Guard Interval to maximize reliability and throughput.
2.5.2 Wireless Security
Airconsole offers 11 Security modes
● Security Disabled
● Open System – for WEP based encryption using preshared secrets. This is very
weak encryption for use with very old Wireless clients that do not support newer
WPA based security.
● Shared System for WEP this allows sharing only between clients that use the
same WEP key.
● WPA/WPA2 using TKIP for preshared key exchange
● WPA/WPA2 using AES for preshared key exchange
● 802.1X with pre shared key against remote RADIUS server
The default security mode is WPA2 with TKIP key exchange. This setting is the second
most secure setting. TKIP is less secure than AES for key exchange; however has
broader wireless client support. WPA2 still uses AES for encrypting data regardless of
key exchange.
Airconsole does not support the use of WPA2 or 802.1X with certificates. 802.1X is
supported with just Radius preshared key.
Generally, reducing the TX power is possible to 50% or lower in low WIFI noise
environments. This will extend the Airconsole battery life by up to 1 hour.
iPad/iPhone (iOS 8+) Get Console 2.21+ SSH, Telnet, Bluetooth 4.0
By default, Airconsole presents each serial port on a separate TCP port, via the telnet
protocol. SSH Access is disabled by default, but is enabled via the Serial>Advanced
page. Telnet and SSH use different TCP port numbers to reach the same serial ports as
shown in the below table.
Serial 1 2 3 4 5 6 7 8 9 10 11 12
Port
Telne 3696 3697 3698 3699 3700 3701 3702 3703 3704 3705 3706 3707
t
TCP
Port
SSH 4001 4002 4003 4004 4005 4006 4007 4008 4009 4010 4011 4012
TCP
Port
For example, assuming that SSH has been enabled, to connect to Serial port 12 on
Airconsole TS from Apple OSX’s built in Terminal.app
When connecting via SSH, Airconsole will require an SSH username and
password before permitting the connection through to the serial port. These are
user credentials stored on Airconsole or resolved via external RADIUS /
TACACS server (see Admin settings below).
Just as in Get Console App, the Enterprise Server connection does not preclude
concurrent access to the same physical serial port via a terminal client (such as PuTTY,
Get Console, SerialBot etc as described above) at the same time.
When Airconsole remote access is set to ENABLED it will attempt to connect to the
Enterprise Server cloud service and once successful, tunnel its serial port to an
Enterprise Server via the best interface in its routing table, The Airconsole must have a
valid default gateway in order to route out to the configured Airconsole Enterprise Server
IP address. If the Remote Server is specified as a domain name then Airconsole TS
must have a valid DNS server configured (or learnt via DHCP) in order to resolve the
server IP.
Airconsole will try every 60 seconds to make a connection to the configured Enterprise
Server IP or hostname.
If the connection to the Enterprise Server is successful, then a session key will be shown
in the Status (Home) page of the Airconsole and also the Airconsole will be visible on the
Airconsole Enterprise Server portal page. It can take upto 15 seconds for the Airconsole
TS to be visible in the AES portal.
If the SSL option is selected then the Enterprise Server m ust have a valid SSL
certificate, issued by a recognized Certificate Authority, installed. Using the selfsigned
certificate that come preinstalled with AES will not work.
Once connected the serial ports on the Airconsole TS can be directly accessed via the
Web Console as per any other Enterprise Server shared terminal session. Apart from
direct interaction with the terminal, the Enterprise Server also allows the pushing and
remote execution of terminal scripts via the Airconsole, along with pulling of Airconsole
terminal log files.
Unlike dynamically shared Get Console terminal sessions, individual Airconsole sessions
via AES will always use the same session code. The session code will incorporate the
last 6 digits of the Airconsole MAC address.
5 Airconsole TS - Built in Web Terminal
Airconsole has a built in websockets Terminal that can be used for quick
configuration tasks via a web browser. The Web terminal is a very simple
terminal implemented in javascript. It is not full VT100 compliant rather it is
designed for simple quick CLI interaction via a browser without the need to
launch a dedicated terminal app.
After connection Airconsole will work with terminal applications such as the
comprehensive OSX terminal applications (for example) Macwise, SecureCRT or Zterm
that require a kernel mode installed serial port.
Airconsole can also be accessed directly from the OSX terminal using the “screen” app
that is bundled with OSX.
If WIFI serial is required (for higher speed serial connections), ensure that your Mac has
an IP network connection to the Airconsole adaptor’s Wireless or Wired LAN prior to
launching the AirConsoleOSX.app
For simple Bluetooth low energy connections, ensure that Bluetooth is enabled in your
OSX System Preferences.
In the above example, the OSX computer has detected Airconsole on both WIFI and
Bluetooth. In this situation, select the method required, or Auto – Auto will default to WIFI
as WIFI has better performance than Bluetooth.
The AirconsoleOSX program will create a NullModem1 and an Airconsole1 COM port.
In your Terminal Application (ie MacWise) only connect to the
Airconsole1
port
7 Airconsole TS - Win7/8 - Direct COM Port Connection
For connecting to just a single Serial port we recommend using Airconsole 2.0 on
Windows via Bluetooth 2.1. This configuration is significantly simpler than mapping a
Serial Port via WIFI. Once Airconsole has been paired with the Windows PC, Windows
will create a new COM port that can then be connected to via the Windows terminal app
of your choice (ie Putty or SecureCRT).
7.1 Windows Bluetooth Pairing
If when attempting to pair Windows comes up with a number string that has to be typed
in to pair, then just wait as no pairing number key is required and Windows will connect
anyway after a few seconds.
After adding the Airconsole device, Windows will install a new Serial port and map it to
the Bluetooth pairing. When that is complete the “Device is ready to use” message will
appear.
http://support.getconsole.com/support/solutions/folders/5000112382
Launch terminal application of your choice and connect to the discovered COM port. In
this example we use the free Putty terminal to connect to our discovered COM port 25.
8 Other Airconsole TS Features and Settings
8.1.1 Configure NTP Server
Airconsole TS can receive time from an external NTP server. Configure the server,
timezone and how often to syncronize via the Admin>NTP settings.
8.1.2 Configure SNMP Support
Airconsole TS has basic SNMPv1 support. Configure a read community and optionally
specify a contact and location. Remote SNMP management stations can now poll
Airconsole for stats on various interfaces including Ethernet and WIFI connections, along
with system health, CPU and other parameters.
Configuration of M2M mode is onlyrequired on ONE Airconsole (called the Master), the
other Airconsole can have its default configuration, but its IP addresses (ie APClient, or
Bridge) must be reachable / routable from the Master Airconsole. This feature is
currently BETA.
The master Airconsole can optionally set the line properties (Baud rate etc) which will be
applied to the remote Airconsole to ensure that both serial port configurations match.
Successful connection to the remote Airconsole will be visible on the Status (home)
page.
Note
for firmware 2.x and later after a factory reset the SSID should remain the same
Download the latest Firmware and Firmware upgrade instructions from the
http://support.getconsole.com
webpage. The firmware instructions and firmware
downloads are on the right hand side of the page under Airconsole Resources.
10 Troubleshooting
Symptom Possible Resolution
No light on side of unit Airconsole TS can be powered via either PoE splitter
when connecting power or the included Power adaptor. Do not use any other
cable. USB power adaptors as they may not produce
enough current to power Airconsole and all
connected 4 port USB Cable kits. Try to reseat the
power connector with just Airconsole TS and no 4
port cables connected. Check cable length the
supplied 2.5m cable has thicker gauge internal cable
to prevent excessive voltage drop. Other cables may
not offer same voltage at the Airconsole end.
Connected to Airconsole USB4 port Serial cable not connected: Get Console
WIFI but cannot connect to will popup error if it connected to Airconsole WIFI,
serial port in Get Console but there is no 4 port Serial cable kit connected from
app Airconsole to your serial device. Connect cable and
retry the connection.
Get Console needs to be restarted: If Get Console
was running in the background of iPhone/iPad prior
to joining to Airconsole WIFI network it may not
pickup the Airconsole Bonjour broadcast. Restart
Get Console by exiting the app (single tap home
button) and then close it down fully by
doubletapping home button and finding Get
Console icon on list of background apps. Press and
hold Get Console icon on the background app list
and then close it via the “x” that appears. You can
then relaunch the Get Console app from the normal
app button on your iPad/iPhone. On restart the
green “Airconsole discovered” message should
appear.
AP Client “connects” but On 802.11N networks, this problem can happen when
cannot pass traffic on operating in mixed 20/40mhz mode. In the basic WLAN
802.11N dual channel Settings page, set the “Channel Bandwidth” under HT
networks. Physical Mode to be “20” rather than 20/40
11 Technical Information
11.1.1 Airconsole Connectors
USB Port For connecting the supplied 4 port USBSerial Cable kits,
or for connection directly to Cisco USB Console ports,
via a USBmini USB cable.