Crestron AM-100 AirMedia Quick reference guide

AirMedia®Presentation Gateway
Deployment Guide
Crestron Electronics, Inc

Crestron product development software is licensed to Crestron dealers and Crestron Service Providers (CSPs) under a limited non-exclusive, non transferable Software Development Tools
License Agreement. Crestron product operating system software is licensed to Crestron dealers, CSPs, and end-users under a separate End-User License Agreement. Both of these Agreements
can be found on the Crestron website at www.crestron.com/legal/software_license_agreement.
The product warranty can be found at www.crestron.com/warranty.
The specic patents that cover Crestron products are listed at patents.crestron.com.
Certain Crestron products contain open source software. For specic information, please visit www.crestron.com/opensource.
Crestron, the Crestron logo, AirMedia, Crestron Connected, and PinPoint are either trademarks or registered trademarks of Crestron Electronics, Inc. in the United States and/or other
countries. App Store, iTunes store, Mac, and OS X are either trademarks or registered trademarks of Apple, Inc. in the U.S. and/or other countries. IOS is either a trademark or registered
trademark of Cisco Systems, Inc. in the United States and/or other countries. Android and Google Play are either trademarks or registered trademarks of Google, Inc. in the United States and/
or other countries. HDMI is either a trademark or registered trademark of HDMI Licensing, LLC in the United States and/or other countries. Excel, Microsoft, PowerPoint, Windows, Windows
Vista, and Windows XP are either trademarks or registered trademarks of Microsoft Corporation in the United States and/or other countries. Other trademarks, registered trademarks, and
trade names may be used in this document to refer to either the entities claiming the marks and names or their products. Crestron disclaims any proprietary interest in the marks and
names of others. Crestron is not responsible for errors in typography or photography.
This document was written by the Technical Publications department at Crestron.
©2016 Crestron Electronics, Inc.

Doc. 7693G |crestron.com
AirMedia Presentation Gateway Deployment Guide
i
Contents
Introduction 1
User Experience 3
On-Screen Display ....................................................................................................... 3
Login Code .................................................................................................................. 3
Connecting toAirMedia 3
Guest Application......................................................................................................... 4
Deployable (Installed) Application ................................................................................ 5
Device Considerations 9
Device Naming............................................................................................................. 9
Device Administration .................................................................................................. 9
Mobile Applications 12
Connecting .................................................................................................................12
Future Development. ..................................................................................................12
AirMedia Security 13
Deployment Options for Guest Network Access........................................................13
Network Infrastructure 16
PowerPoint Presentation Use Case ............................................................................16
Word Document Use Case .........................................................................................17
Windowed Video Use Case ........................................................................................18
Full Screen Video Use Case........................................................................................19
Device Upgrades 20
Single Device (Web Interface)...............................................................................................20
Multiple Devices......................................................................................................................20
Control 20
Crestron Connected...............................................................................................................20
Control System........................................................................................................................20
Guest Application Executable ...................................................................................... 5
Room Lists ............................................................................................................. 6
File Association .......................................................................................................7
Discovery ............................................................................................................... 8
Manual Entry ......................................................................................................... 8
VLAN Based...........................................................................................................13
Physical Air Gap......................................................................................................14

Doc. 7693G |crestron.com
AirMedia Presentation Gateway Deployment Guide
1
Introduction
The AirMedia®Presentation Gateway (AM-100 and AM-101) allows users to present their content via projectors
and displays using the existing IT infrastructure without connecting wires. It is a small network device with a single
10/100 mbps Ethernet port. Because of its reliance on Ethernet, AirMedia has been designed with the IT
professional in mind and includes many features to ease deployment.
Windows®and OS X®software users can share their desktop by running a small application (no installation
required). iOS®and AndroidTM software users can share Excel® spreadsheets, Word documents, PowerPoint®
presentations, PDF les, photos, and other content by using the free application available from the App Store® and
in the Google PlayTM retail stores.
NOTE: Android users can share their full screen from the PinPointTM App.
This deployment guide provides information on AirMedia operation, user access, security, and control systems.
For more detailed information on the AM-100 and AM-101 devices, refer to the AM-100 Operations Guide
(Doc 7463), AM-100 Quickstart Guide (Doc 7464), AM-101 DO Guide (Doc 7930), and AM-101 Supplemental Guide
(Doc 7918) at www.crestron.com/manuals.

AirMedia Presentation Gateway Deployment Guide
2Doc. 7693G |crestron.com
Optional
Control
System
SERVICE
5V 2.5A
LAN
OR
Color Key
LAN
L
A
N
L
A
N
HDMI
LAN
Wireless
Access
Point
HDMI
HDMI®Interface
Simple AirMedia Deployment Application

Doc. 7693G |crestron.com
AirMedia Presentation Gateway Deployment Guide
3
User Experience
On-Screen Display
AirMedia uses an on-screen display to convey the basic connection instructions for guest access. The display can
be personalized to allow custom login instructions and branding. It provides the hostname, IP address (optional),
and login code for the specic AirMedia device.
Login Code
A login code is provided to help prevent users from accidentally connecting to an unintended device. The user
begins the connection process and is prompted to enter a code in the Login window. The code is only four digits,
so it is easy for the user to enter while still preventing unwanted presentations.
Login Window
There are three modes of operation:
1. Disabled: A login code is not required.
2. Random: A login code is generated after the last user disconnects.
3. Fixed: A login code is set using the web administration pages (static) or using a control system to update
programmatically.
Connecting to AirMedia
There are two ways to connect to the AirMedia device using a PC:
1. Guest Application: Connect to AirMedia using either the Windows or the OS X guest application. The guest
application is downloadable from the AirMedia device.
2. Deployable Application: Access the deployable stand-alone application at www.crestron.com/airmedia.
The guest and installed applications are compatible with the operating systems shown below.
Operating System Versions Supported
Windows Windows XP®, Windows Vista®, Windows 7, and Windows 8 operating systems
OS X 10.5 and newer

AirMedia Presentation Gateway Deployment Guide
4Doc. 7693G |crestron.com
Guest Application
The guest application is a small downloadable application that runs with standard user permissions. The IP
address of the AirMedia device is encoded in the lename of the application. The user may save the application
locally, which allows for direct connection to the device the next time the application is accessed.
To access the guest application from the AirMedia Welcome window, complete the steps below:
Connected Device Displaying AirMedia Welcome Window
1. Open a web browser and enter the user's IP address or hostname into the browser. The AirMedia
Download window opens.
2. Download the applicable AirMedia software (either client for Windows or client for Mac® computer).
• A small application is downloaded; the user runs the application.
• If prompted, enter the login code.
The session begins. The user’s desktop is shown on the on-screen display.
AirMedia Download Window

Doc. 7693G |crestron.com
AirMedia Presentation Gateway Deployment Guide
5
Guest Application Executable
The guest application can be downloaded and saved for custom deployments, such as to websites or other media.
The connection parameters for the guest application are embedded in the le name. The format is as follows:
<any_text>_.<ip_address>.exe.
NOTE: The underscore anddot must precede the IP address. Refer to the following example:
executive_conference_room_.10.1.1.13.exe.
Deployable (Installed) Application
A deployable stand-alone application can be deployed to users’ computers across the enterprise. This application
allows other types of connections to the AirMedia device and has no registry requirements. The application can
be silently deployed as a group of les to a folder on the users' computers. The enterprise application can be
downloaded at www.crestron.com/airmedia.
Managing the rooms in which AirMedia is installed can be a signicant task. There may be multiple campuses or
rooms that only certain employees can access. To address the various deployment scenarios, AirMedia has four
methods to access the connection parameters of a room.
1. Room Lists: The AirMedia client application reads the XML le containing a list of rooms and presents
them in a searchable list as shown in the Available Remote Box List window.
Available Remote Box List Window
2. File Association: The AirMedia client application is associated with .present les. These les can be
embedded in meeting invites or hosted on a corporate website.
3. Discovery: If the AirMedia devices and the user’s computer are on the same subnet, the AirMedia client
application locates these devices and presents them to the user. This method is recommended if a room
list or .present le is not used.
4. Manual Entry: AirMedia allows the user to enter the hostname or IP address of the device.

AirMedia Presentation Gateway Deployment Guide
6Doc. 7693G |crestron.com
Room Lists
The application reads a list of devices and populates the connection dialog. A search box is provided to locate
devices in long room lists. To connect using a room list, complete the steps below:
1. Launch AirMedia.
2. From the Available Remote Box List window, select the room from the list of devices.
Available Remote Box List Window
3. Click Connect.
• If prompted, enter the login code.
• If a Crestron Connected®display is used, the display turns on automatically.
• The session begins.
4. Create two les: cong.ini and XML.
• The cong.ini le provides the location of the list of rooms (XML le) to the AirMedia application. This le
must be in a xed location. For more information, refer to Conguration File section below.
• The XML le should contain the list of AirMedia devices. For more information, refer to the "Device List
File (XML le)" on page 7.
Configuration File (config.ini)
Crestron® software uses the common repository for user specic data on Windows and OS X to store its cong.
ini le. Windows refers to this as the application data folder, and it can be accessed by the environmental variable
%APPDATA%. For OS X, the preferences are stored in the user’s home directory under Application Support. For
both operating systems, the conguration le must be located within Crestron\AirMedia in the common repository.
Examples of typical user directory locations (which vary) for Windows 8 and OS X are shown below:
User Name: TestUser
Windows 8: C:\Users\TestUser\AppData\Roaming\Crestron\AirMedia
OS X 10.8.6: /Users/TestUser/Library/Application Support/Crestron/AirMedia/Congure
After the folder is created, the conguration le must be created. The cong.ini le contains the location of the
room list le. The le contains two items: the section Crestron and the key XMLPath. An example of a cong.ini le
is shown below.
[Crestron]
XMLPath=M:\cong\airmedia\room_list.xml
When the AirMedia application starts, it attempts to read the le at the location specied by the XMLPath. Local
and network paths are allowed. Do not enclose the path in quotes. Environmental variables are not supported.

Doc. 7693G |crestron.com
AirMedia Presentation Gateway Deployment Guide
7
Tag Description Example
devices This is the main container for the device list le.
Each le must contain only one set of tags.
<?xml version="1.0"?>
<devices>
<device>
<name>Room 239</name>
<address>192.168.0.184</address>
<code>5885</code>
</device>
<device>
<name>Room 240</name>
<address>192.168.0.185</address>
</device>
<device>
<name>Room 241</name>
<address>192.168.0.186</address>
</device>
</devices>
device This is the container for each device to be
displayed. The le may contain one more set of tags.
name This is the display name for the AirMedia device that
is shown in the Device Name column of the
application.
address This is the IP address of the AirMedia device. This
eld is currently limited to IPv4 addresses only.
code This tag is used to limit access to AirMedia and can
be disabled, randomly generated, or xed to a
specic value. In xed mode, the code tag may be
used to specify the access code.
Device List File (XML file)
The room list le is an XML le that denes the devices and their connection parameters. The specics of the le
are dened below.
File Association
The .present les contain the connection parameters and start a connection. These les can be hosted by a web
server or deployed to folders within the user’s computer. The association is made by the installer.
To connect using le association, complete the steps below:
1. Double-click a .present le. The application launches.
2. If prompted, enter the login code in the Login window and click Connect. The session starts.
Login Window
NOTE: If a Crestron Connected display is used, the display turns on automatically.
A .present le is a set of connection parameters to a single AirMedia device. It uses the same format as the device
section of the room list le. An example of the .present le is shown below.
<?xml version="1.0"?>
<device>
<name>Room 239</name>
<address>192.168.0.184</address>
<code>5885</code>
</device>

AirMedia Presentation Gateway Deployment Guide
8Doc. 7693G |crestron.com
Discovery
If a room list le is not found when AirMedia is started, the application scans the local subnet for connection
devices.
• If only one device is found, the application tries to connect to that device.
• If multiple devices are found, the application displays a list of connection devices. From the Available
Remote Box List window, select the Device Name and IP address and click Connect.
Available Remote Box List Window
Manual Entry
If the application is unable to nd any devices, the Login window (for manual connection) opens. Enter the
IP address or hostname of the device, User Name, and Code, and click Connect.
Login Window

Doc. 7693G |crestron.com
AirMedia Presentation Gateway Deployment Guide
9
Device Considerations
Device Naming
The use of IP addresses can cause confusion; therefore, Crestron recommends that each AirMedia device be given
a hostname that is easy for the user to remember. The IP address can be hidden from the on-screen display, which
limits the amount of information presented to the user. Crestron has implemented the following automated ways of
resolving the device by hostname:
• NetBIOS resolution
• DHCP options 12 and 81
• NSUPDATE for dynamic DNS servers
Crestron recommends conguring a static IP and DNS entry for the AirMedia device. Once the hostname is
congured, the IP address display can be turned off in the Device Setup section of the AirMedia web pages.
NetBIOS is used only if the hostname is 15 characters or fewer. NetBIOS is disabled if the hostname is longer than
15 characters.
NSUPDATE is sent under the following conditions:
• If the device is using a static address and the DNS eld is populated
• If the device is using DHCP to obtain an IP address, and the Domain Name eld in the Network Setup
screen is not blank
NOTE:If the domain name eld is blank, NSUPDATE is not sent.
Device Administration
AirMedia is congured through the built-in web pages of the device. Parameters such as the device IP address,
remote view settings, connections to control systems, and Crestron Connected devices are set in the Device
Administration window. The default password is admin, which can be changed.
Device Administration Window with Network Setup Selected

AirMedia Presentation Gateway Deployment Guide
10 Doc. 7693G |crestron.com
The AirMedia application requires firewall rules to allow it to communicate with the AM-100 and AM-101 devices.
Crestron recommends creating a rule for the application that allows all traffic to pass to the device. If the rule does
not exist, the operating system prompts the user to add a rule. This may require administrator privileges.
Refer to the Port Map 1: Ports Used by the Client table for the set of ports that allow the client to communicate
with the device.
Port Map 1: Ports Used by the Client
Port Type Direction Function Open Notes
80 TCP Both Projector
Control
Optional This port is used to turn on a Crestron Connected
projector. If this port is blocked, the device functions
normally, but the "automatic projector power on"
feature does not work.
389
443
445
TCP Both Control
Channel
Required For best performance, Crestron recommends that ports
389, 443, and 445 are open. At a minimum, one port
needs to be open for the device to function properly. If
only one port is open and that port is used by another
application, AirMedia will not function properly.
515 TCP Both Video Required This port is for the video data channel.
1041 TCP Outbound Control
Channel
Required If this port is not open, AirMedia does not
function properly.
1047
1048
1049
UDP Inbound Discovery Optional These ports are used for device discovery. If the port
is closed, AirMedia may not be able to nd devices
automatically.
1688 TCP Both Audio Recommended This port is for the audio data channel.
3268 TCP Both Control
Channel
Required This port is used as part of the screen sharing process.
8080 TCP Both Video Required This port is for the video data channel. If the port is not
open, AirMedia does not function properly.
19996 TCP Both Future Optional This port is reserved for future use.
31865 TCP Both Discovery Optional This port is used for device discovery. If this port
is closed, AirMedia may not be able to nd devices
automatically.

Doc. 7693G |crestron.com
AirMedia Presentation Gateway Deployment Guide
11
Port Type Direction Function Open Notes
21 TCP Both Update Utility Optional This port is used to transfer the rmware to the device
and is used only with the batch update application.
This port is not used when updating the device with the
web interface.
80 TCP Both Web Services Required This port is used to access the AirMedia device
conguration website.
137 TCP Both NetBIOS
Discovery
Optional This port allows the device to be resolved without a
DNS server present. This port is enabled if the
hostname is fewer than 15 characters.
138 UDP Both NetBIOS
Discovery
Optional This port allows the device to be resolved without a
DNS server present. This port is enabled if the
hostname is fewer than 15 characters.
41794 TCP Both Control System Required This port is used to control Crestron Connected
devices.
42891
42892
TCP Both Update Utility Required These ports are used to control rmware updates and
are used only with the batch update application. These
ports are not used when updating the device with the
web interface.
Port Map 2: Ports Used by the Device (AM-100 and AM-101)
Refer to the Port Map 2: Ports Used by the Device (AM-100 and AM-101) table below for the ports that the
AM-100 and AM-101 use only for management functions.

AirMedia Presentation Gateway Deployment Guide
12 Doc. 7693G |crestron.com
Mobile Applications
Connecting
Crestron offers applications for both iOS and Android to allow users to give presentations using their mobile
devices. Applications are available at no cost from the iTunes store® online store and on Google Play (search for
AirMedia). The application connects to AirMedia devices by discovering them or when the IP address or hostname
of the device is entered.
Connected devices are saved to allow for easier future connection. A search function is provided to quickly
navigate long lists. AirMedia devices can be marked as favorites for quick connections to frequently used rooms.
The Crestron AirMedia for iOS window is shown.
Crestron AirMedia for iOS Window
Future Development
The user support of room lists for mobile applications and .present les is planned and will be released through a
free update.

Doc. 7693G |crestron.com
AirMedia Presentation Gateway Deployment Guide
13
AirMedia Security
AirMedia has been designed to leverage existing IT policies. AirMedia contains a single-wired network interface
with no wireless interfaces or bridges in the device. It becomes a wireless solution by utilizing the existing wireless
network. All policies, encryptions, and other security measures implemented carry over to AirMedia because it
creates standard Ethernet trafc. Once AirMedia is on the corporate network, the trafc generated by AirMedia is
treated like any other network trafc. All existing policies that apply to physical network devices (switches, routers,
etc.) also apply to AirMedia. AirMedia can be treated as a standard network appliance (like a printer) and is as
secure as the supporting network. AirMedia employs a proprietary protocol to transport the screen data to the
device.
Deployment Options for Guest Network Access
In meeting rooms, guests may want to present to corporate users. Keeping the guest networks and corporate
networks separate while allowing the users to share a display presents a challenge. As a standard network device,
AirMedia solves this problem by using standard networking practices. There are two suggested methods: VLAN
based method and physical air gap method.
VLAN Based
AirMedia devices are placed in their own VLAN. This VLAN is congured to allow only incoming connections.
Outbound trafc is not allowed. The guest and corporate networks exist in separate VLANs. Since outbound
connections are not allowed, the guest VLAN cannot access the corporate VLAN through the AirMedia VLAN.
AirMedia VLAN Based Method Example
AirMedia
30.0.0.31
Wired Corporate User
10.0.0.202
Corporate Server
10.0.0.20
AirMedia
VLAN
Room TV
Wireless Guest User
20.0.0.200
Wireless Guest User
20.0.0.201
Wireless
Access Point
20.0.0.10
Guest
VLAN
AirMedia® Presentation Gateway VLAN
Accepts Only Incoming Connections
Wireless
Access Point
Wireless Corporate User
10.0.0.201
Wireless Corporate User
10.0.0.200
10.0.0.10
Wireless Connection Secured
Using Enterprise Policies
Corporate
VLAN
Color Key
Ethernet
HDMI

AirMedia Presentation Gateway Deployment Guide
14 Doc. 7693G |crestron.com
Physical Air Gap
The corporate and guest networks are separated by a physical air gap, and two AirMedia devices are used: one for
corporate users and one for guest users. Switching presentations is done in the HDMI®interface domain using a
2 x 1 matrix switch. While extremely secure, this approach requires more hardware.
AirMedia Physical Air Gap Method Example
Wireless
Access Point
10.0.0.10
AirMedia 1
20.0.0.30 AirMedia 2
10.0.0.30
Router or Firewall Router/Firewall
Wired Corporate User
20.0.0.202
Corporate Server
20.0.0.20
Room TV
Internet
Corporate Server
20.0.0.20
INPUT OUTPUT
LAN COMPUTER
SETUP
NET
12345678
24YZ G 24YZ G
G
CRESTRON
ELECTRONICS INC. RO CKLEIGH, N J 07647
12
HD-MD8X2
10.0.0.1
05.24.21.5
20.0.0.1
85.24.21.4
Wireless
Access Point Wireless Corporate User
20.0.0.201
Wireless Corporate User
20.0.0.200
20.0.0.10
Corporate
Network
Color Key
Ethernet
HDMI
Wireless Guest User
10.0.0.200
Wireless Guest User
10.0.0.201
Internet
Guest
Network

Doc. 7693G |crestron.com
AirMedia Presentation Gateway Deployment Guide
15
Data Transport
AirMedia employs a proprietary protocol to transport the screen data to the AirMedia device. The data is encrypted
based on the four-digit code displayed on the on-screen device (OSD).
AirMedia Data Transport Example
AirMedia 1
10.0.0.30
Wired Corporate User
10.0.0.202
Corporate Server
10.0.0.20
Room TV
Wireless Connection Secured Using
Enterprise Policies
Wireless Corporate User
10.0.0.201
Wireless Corporate User
10.0.0.200
Color Key
Ethernet
HDMI
Wired Connection to IT Infrastructure
Wireless
Access
Point
10.0.0.10
Corporate
Network

AirMedia Presentation Gateway Deployment Guide
16 Doc. 7693G |crestron.com
PowerPoint Bandwidth Example
Network Infrastructure
The AirMedia bandwidth requirements are low, falling well below 1 mbps. However, if a user is showing a video or
other application with motion, the bandwidth required could be as much as 35 mbps. For the best performance,
the latency between the user’s computer and AirMedia should be minimized. The best performance is seen
with less than 50 ms round-trip time. PowerPoint, Word, Windowed Video, and Full Screen Video use cases are
presented in this section.
PowerPoint Presentation Use Case
The most common use case for AirMedia is using a productivity application such as Microsoft®Ofce software.
In this case, small bursts of data are sent during connection and for large screen changes, such as changing from
the desktop to the full screen Start menu in Windows 8.
The illustration below shows the bandwidth consumption associated with launching the PowerPoint application and
delivering a presentation. The PowerPoint presentation consists of mostly white slides with text. The exceptions are
slide 1 (full screen graphic) and slide 6 (one-third of the screen graphic). Data are in bits per second.