Crestron SW-MAIL Manuale utente

CRESTRON

e-control™ Mail

(SW-MAIL)

version 1.4

Crestron e-control Mail SW-MAIL

ii •• Table of Contents Installation & Reference Guide — Doc. 5798

Contents

How to Use This Manual 4

A Note on Printing This Document................................................................................................... 4

Quick Start ........................................................................................................................................ 4

Section Summary .............................................................................................................................. 4

Quick Start Guide 1: Sending e-Mail (demo3) 6

Quick Start Guide 2: Receiving e-Mail (demo4) 7

Introduction 8

What is Crestron e-control Mail? ...................................................................................................... 8

System Terminology and Topology .................................................................................................. 8

Leading Specifications .................................................................................................................... 11

Requirements................................................................................................................................... 11

Installation....................................................................................................................................... 12

Licensing......................................................................................................................................... 12

Basic Server Setup 14

Communications Setup.................................................................................................................... 15

Test Communications...................................................................................................................... 19

Additional Server Side Setup .......................................................................................................... 19

Server Configuration In Depth 20

Specifying a Configuration File ...................................................................................................... 20

Password Access ............................................................................................................................. 21

e-Mail Options................................................................................................................................. 22

COM Settings Definition................................................................................................................. 24

Signal Block Definition................................................................................................................... 26

Server Windows and Menus............................................................................................................ 37

The e-Mail Database Tables 42

Table design .................................................................................................................................... 42

Editing the Existing Database.......................................................................................................... 46

Composing e-Mail 46

Recipient Lookup............................................................................................................................ 47

Message Lookup ............................................................................................................................. 47

Implicit Recipient Name & Address................................................................................................ 47

Manual Selection of Recipient and/or Message............................................................................... 48

Text Substitution and File Inclusion 48

Text Substitution Directives............................................................................................................ 48

Text File Inclusion .......................................................................................................................... 49

Rescanning...................................................................................................................................... 49

Control Messages 49

Identification ................................................................................................................................... 50

Message types ................................................................................................................................. 50

Syntax.............................................................................................................................................. 50

Example........................................................................................................................................... 51

Demos 52

Demo 1: The Shortcut Signals......................................................................................................... 52

Demo 2: The LookupMsg and LookupRcpt Signals ....................................................................... 53

Demo 3: Interactive Scrollers.......................................................................................................... 55

Demo 4: Receiving e-Mail .............................................................................................................. 56

Crestron e-control Mail SW-MAIL

iii •• Table of Contents Installation & Reference Guide — Doc. 5798

Appendix A: Theory of Operation 59

Server Protocol................................................................................................................................ 59

Signal Block Definition / Activation............................................................................................... 59

Signal Block Enable / Disable......................................................................................................... 59

Signal Block Error Reporting.......................................................................................................... 59

Appendix B: Intersystem Communications and Signal Space Considerations 61

System Connections........................................................................................................................ 61

Appendix C: Signal Reference 65

Definition of Terms......................................................................................................................... 65

String Proxies.................................................................................................................................. 65

Bit Patterns...................................................................................................................................... 65

Standard e-mail Address Format..................................................................................................... 66

Error Reporting ............................................................................................................................... 67

Signal Summary.............................................................................................................................. 67

Signal Reference.............................................................................................................................. 68

Appendix D: System limitations 107

Serial Transmissions...................................................................................................................... 107

Signal Definitions.......................................................................................................................... 107

Appendix E: Standard Scroller / Custom Scroller Feature Comparison 108

Appendix F: Dial-up TCP/IP configuration 109

Crestron e-control Mail SW-MAIL

4•• How to Use This Manual Installation & Reference Guide — Doc. 5798

Crestron e-control Mail

How to Use This Manual

A Note on Printing This Document

Adobe and Acrobat are

trademarks of Adobe Systems

Incorporated.

This Portable Document File (PDF) can be printed with AdobeAcrobatReader.

Printing from a Windows 95 platform, version 4.0 or later, is strongly recommended

because the figures print poorly with earlier versions. The latest version is freely

available from Adobe at http://www.adobe.com/acrobat/.

Quick Start

To see an “out-of-the-box” demonstration of Crestron e-control Mail as quickly as

possible, turn to the Quick Start Guide(s) beginning on the next page.

You will need:

•A Crestron CNMSX-PRO control system

•A touchscreen (LC-3000, CT-3000, CT-3500, or VT-3500); and

•A null-modem cable

Follow the instructions in the guides precisely in the order given and you should be

up and running in a matter of minutes.

NOTE: The demos included with this package are all compiled to two versions, a COM version for

use with an RS-232 serial connection, and a TCP version for use with an Ethernet connection (the

latter case requiring the CNX Gateway). The Quick Start Guides refer only to the COM versions of

these programs because setting up a serial connection is far simpler. We strongly recommend getting

at least one demo to work first using a serial connection. Once that works, try the TCP versions.

Instructions for setting up TCP/IP communications are provided under “Communications Setup,

Control System Side, TCP/IP,” on page 17).

You do not need to license the software to try the demos provided you are still within

the 15-day free trial period.

Section Summary

For more information, start with “Introduction” on page 8.

Detailed setup and configuration instructions follow “Introduction”.

Crestron e-control Mail SW-MAIL

5•• How to Use This Manual Installation & Reference Guide — Doc. 5798

Then comes information about the e-Mail database file, including information

about text substitution and file inclusion directives.

After that, the examples (demos) are described and illustrated in detail.

Appendices include Theory of Operation, along with a complete Signal Reference.

Crestron e-control Mail SW-MAIL

6•• Quick Start Guide 1: Sending e-Mail (demo3) Installation & Reference Guide — Doc. 5798

Quick Start Guide 1: Sending e-Mail (demo3)

1Install this package on your PC

Presumably, since you are reading this PDF file, you have already done this.

2Connect a CNMSX-PRO (with touchscreen)

Connect a programming cable (a standard modem cable) from any COM port on

your PC to the COMPUTER port on the front or back of the CNMSX-PRO control

system. Connect a touchscreen to the control system set up for CRESNET ID 03.

3Upload all control system software

The demo files can be found in the

demos folder (also accessible

through the Start Menu shortcut

e-control Mail Demos)

Open the Crestron Viewport and establish communications with your control system.

Use the FileTransfer | Send Touchpanel… command to upload demomail.hex

to the touchscreen at ID 03. Use the FileTransfer | Send Program… command to

upload the compiled SIMPL windows file demo3COM.bin to the CNMSX-PRO.

4Connect the null modem cable

Make sure pins 4, 5, and 6 are not

connected. Connect a null-modem cable from COM1 on the PC to COM A on the

CNMSX-PRO.

5Run the “server”

The installer sets the server to

use the Configuration Settings

file demomail.ini.

Select shortcut e-control Mail Server from the Crestron folder in the Windows Start

Menu. If the title bar of the window does not read “e-control Mail Demos,” use the

File |Configuration file… command to select the file demomail.ini.

6Specify an SMTP (outgoing mail) server address

The initial configuration

password is: crestron2 Give command Server | Configure…, select the e-Mail tab, and enter an SMTP

server’s IP address or domain name. Close the window.

7Enter your e-mail address

Depress the down-arrow key to

leave the row, and click Yes to the

“Commit Changes?” dialog.

For testing purposes, you must provide an e-mail address which you can check for

incoming mail. Give command e-Mail | Tables… to bring up the e-Mail Tables

window. Enter your address in the addr field (column) of the first record (row)

(GEORGE WASHINGTON) of the eMail_Addr table. Save the change by either

repositioning the cursor to a different record or by closing the window.

8Start server protocol

Give the command Server | Start Server w/Signal Analyzer. (The Signal Analyzer

is good for demos because it shows you the various signals going back and forth.)

9Start the demo

On the touchscreen, navigate through the setup instructions to the demo screen. This

final page-flip to the demo screen starts the demo.

10 Send an e-Mail message!

From the SILLY MESSAGES list, select the message called, INVITE. Notice that the

default recipient for this message is “George Washington” (you). Or, select another

message, then select GEORGE WASHINGTON from the U.S. PRESIDENTS list to

override the default. Press the Send Now button. When the button feedback goes

low, the message has been sent. (You should now check your incoming mail for a

message from the control system.)

Crestron e-control Mail SW-MAIL

7•• Quick Start Guide 2: Receiving e-Mail (demo4) Installation & Reference Guide — Doc. 5798

Quick Start Guide 2: Receiving e-Mail (demo4)

1Install this package on your PC

Presumably, since you are reading this PDF file, you have already done this.

2Connect a CNMSX-PRO (with touchscreen)

Connect a programming cable (a standard modem cable) from any COM port on

your PC to the COMPUTER port on the front or back of the CNMSX-PRO control

system. Connect a touchscreen to the control system set up for CRESNET ID 03.

3Upload all control system software

The demo files can be found in the

demos folder (also accessible

through the Start Menu shortcut

e-control Mail Demos)

Open the Crestron Viewport and establish communications with your control system.

If you have not already done so, use the FileTransfer | Send Touchpanel…

command to upload demomail.hex to the touchscreen at ID 03. Use the

FileTransfer | Send Program… command to upload the compiled SIMPL windows

file demo4COM.bin to the CNMSX-PRO. You may now close the Viewport.

4Connect the null modem cable

Make sure pins 4, 5, and 6

are not connected. Connect a null-modem cable from COM1 on the PC to COM A on the

CNMSX-PRO.

5Run the “server”

The installer sets the server to

use the Configuration Settings

file demomail.ini.

Select shortcut e-control Mail Server from the Crestron folder in the Windows Start

Menu. If the title bar of the window does not read “e-control Mail Demos,” use the

File | Configuration file… command to select the file demomail.ini.

6Specify a POP3 (incoming mail) server address

The initial configuration

password is: crestron2 Give command Server | Configure…. In the resulting Configuration Options

window,select the e-Mail tab and enter a POP3 server’s IP address or domain name.

7Enter your e-mail address

Select the Signal Blocks tab. Select the signal block called “DEMO4” and click the

Modify… button. In the resulting e-Mailbox Signal Block Definition Window,

provide an e-mail account name and password. In each window, click OK to close.

8Start the “server protocol”

Give the command Server | Start Server w/Signal Analyzer. (The Signal Analyzer

is good for demos because it shows you the various signals going back and forth.)

9Start the demo

On the touchscreen, navigate through the setup instructions to the demo screen. This

final page-flip to the demo screen starts the demo.

10 Download new mail

Touch the button Touch here to check manually for NEW MAIL. The button

feedback stays active while the server contacts the e-mail host. All new messages are

displayed. Scroll the listing to see all the messages.

11 Read a message!

Touch the listing to select a message to read.

Crestron e-control Mail SW-MAIL

8•• Introduction Installation & Reference Guide — Doc. 5798

Introduction

What is Crestron e-control Mail?

Crestron e-control Mail (SW-MAIL) empowers any Crestron control system with the

ability to construct and transmit, and receive and view e-mail messages.

Simply by asserting specific signals, your control systems can send arbitrary text,

whole text files, canned messages, alerts, status updates, etc., to any e-mail address.

Messages can be sent to a control system for display and to assert specific signals.

The term “server” does not imply

a need for specialized hardware.

Any PC meeting the minimum

requirements on page 11 will

suffice to run swserver.exe.

The actual e-mailing is not carried out by the control systems themselves, but by a

remote e-e-mail host. The control system relies on intermediaries to translate

communications protocols and supply other services. One of these intermediaries is

the freely distributed Crestron e-control Software Server. SW-MAIL is a licensable

component of this “server” application (swserver.exe) which is hosted on a

standard PC running Windows®95/98/NT and provides the following core

technologies:

•Signal-level communications with the control system

•Access to database tables

•Access to external services (such as e-e-mail hosts) through the PC’s network

connection.

The server is connected to the control system via either a serial cable through an

RS-232 port or an Ethernet network through a LAN port. To effect the latter type of

connection, the control system relies on an intermediary, the Crestron CNX Gateway,

to translate communications protocols.

To aid in making all this clear, the following illustrated discussion of system

terminology and topology should prove useful at this point.

System Terminology and Topology

This manual simultaneously discusses several different inter-connected computer

systems. To reduce confusion, throughout the manual, these systems are referred to

using the terms in the following table. (Also refer to the diagrams on the next page.)

Term Explanation

The system

or the control system One of a number of Crestron control

system(s), which may include any combination

of the following models: CNMS, CNRACK,

CNMSX-PRO, CNMSX-AV, and CNRACKX.

The server

or the software server The Crestron Software Server,

swserver.exe,which runs on a PC under

Microsoft®Windows®95 or Windows NT®.

The gateway

or the CNX Gateway A communications conduit that sits between

the server and the control system(s).

The host

or the e-mail host An e-mail host used for exchanging mail with

the system and other e-mail clients.

The control system(s) are connected to the server via direct RS-232 serial connection

or via TCP/IP to the gateway and thence via TCP/IP to the server.

Crestron e-control Mail SW-MAIL

9•• Introduction Installation & Reference Guide — Doc. 5798

NOTE: “Connected via TCP/IP” means any node (computer) visible on the Local Area Network

(LAN). If the LAN is connected to the Internet, this could include any node visible anywhere on the

Internet. Since a node can also see itself, this implies that multiple services can run on the same

machine. For example, the gateway and the server can be “self-hosted” in this way.

The server is also connected to the e-mail host via TCP/IP (which can also be self-

hosted on the same machine, although this is not normally the case).

The e-mail host is actually comprised of two separate pieces of software, one for

incoming mail (a POP3 server ) and one for outgoing mail (an SMTP server). While

these software generally reside on the same physical computer (host), this is not

always the case. Whatever the case, we generally use the term host herein to refer to

both of them as a single entity. (Nevertheless, it should be pointed out that if your

application requires only sending mail or only receiving mail, you only need to be

connected to one server or the other.)

In the illustrations that follow, the communication pathways are represented by the

arrows. The physical network is not represented, however.

System block diagram, showing communication pathways (all connections using TCP/IP)

VT-3500 VT-3500 VT-3500

e-Mail

Host

Crestron

Software

Server

Crestron

CNX

Gateway

Crestron

control

system

Crestron

control

system

Internet

VT-3500 VT-3500 VT-3500

Crestron e-control Mail SW-MAIL

10 •• Introduction Installation & Reference Guide — Doc. 5798

System block diagram, showing communication pathways

(curved arrows are RS-232 serial connections; straight arrows are TCP/IP)

VT-3500 VT-3500 VT-3500

e-Mail

Host

Crestron

Software

Server

Crestron

control

system

Crestron

control

system

Internet

VT-3500 VT-3500 VT-3500

NOTE: The CNX Gateway is not necessary when using RS-232 serial communications.

TCP/IP connections between the server and the control systems require that each

side of the connection be provided with the IP address of the other. This kind of

connection also requires the use of the CNX Gateway which is separately licensed

software that facilitates communication between the server and the control system.

The CNX Gateway is typically installed on the server (when sufficient TCP/IP

sockets are available) or it can be installed on any computer visible (i.e., pingable) on

the TCP/IP network. There only needs to be one Gateway running on one computer

to service the needs of all the computers and CNX control systems on the network.

However, multiple Gateways are perfectly permissible as long as they are run on

different computers.

Questo manuale è adatto per i seguenti modelli

Indice

Altri manuali Crestron Software

Crestron

Crestron SW-SIMPL Guida alla risoluzione dei problemi

Crestron

Crestron D3 PRO Manuale utente

Crestron

Crestron VisionTools Pro-e Guida rapida

Crestron

Crestron Active CNX Istruzioni operative

Crestron

Crestron SIMPL Windows Guida di riferimento

Crestron

Crestron e-Schedule Manuale

Crestron

Crestron SW-DBM Manuale utente

Crestron

Crestron CRESTRON-APP-SSTV Come usare

Crestron

Crestron RoomView Manuale utente

Crestron

Crestron Touch the PC v1 Manuale

Crestron

Crestron SW-WMC Manuale utente

Crestron

Crestron e-Control Manuale utente

Crestron

Crestron SIMPL Windows Manuale utente

Crestron

Crestron C2N-DAP8 Manuale utente

Crestron

Crestron Touch the PC v2 Manuale

Crestron

Crestron SW-WMC Manuale utente

Crestron

Crestron SW-VOTE Manuale utente

Crestron

Crestron SIMPL+ Manuale utente

Crestron

Crestron SIMPL+ Istruzioni operative

Crestron

Crestron e-Control Manuale utente

Manuali Software popolari di altre marche

COMPRO

COMPRO COMPROFM Manuale utente

Muratec

Muratec OFFICEBRIDGE ONLINE Manuale utente

Oracle

Oracle Contact Center Anywhere 8.1 Manuale utente

Adobe

Adobe 65007312 - Photoshop Lightroom Manuale

Avaya

Avaya NULL One-X for RIM Blackberry Manuale utente

HP ProLiant BL420c Manuale utente

PS Audio

PS Audio PowerPlay Manuale del proprietario

Brady

Brady LOCKOUT PRO 3.0 Manuale di servizio

Avaya

Avaya Interaction Center Manuale utente

Texas Instruments

Texas Instruments TI-83 Plus Silver Edition Manuale

Novell

Novell GROUPWISE 8 - INTERNET AGENT Manuale utente

Oracle

Oracle Application 9i Manuale utente

Acer

Acer RDM Manuale utente

Canon

Canon Vixia HF21 Manuale utente

Canon

Canon ZR950 Manuale utente

Samsung

Samsung Auto Backup Manuale utente

Polycom

Polycom Vortex EF2201 Istruzioni per l'installazione e il funzionamento

Brocade Communications Systems

Brocade Communications Systems Brocade 8/12c Manuale utente