X-10 Remote TCP Server 1.0 Released
Copyright (c) 2003, by Marcus Jeffers, L.Ac., Dipl. Ac., MSTOM, MCSE, CNA, MCP, N+, A+

Jeffers Software

 

Installation

X-10 Remote Server

rX-10 Desktop PC Remote Client

rX-10 Pocket PC Remote Client

Operation

X-10 Remote Server

rX-10 Desktop PC Remote Client

rX-10 Pocket PC Remote Client

License Agreement



Installation:

  1. Install the server first:
    1. The server file is named "Server.exe". 
    2. Install this application onto the PC that your CM11A computer interface is connected to by double-clicking the Server.exe file.
    3. Make sure the Server connects to your CM11A:
      1. Once the application is installed, locate the "X10 Remote Server" folder off of the "Start->Programs" menu and click the "X10 RS" shortcut
      2. The server will minimize itself to the system tray, next to the Cloc,k at the bottom right side of the screen.
      3. Locate the computer icon and Right-click it and choose "Expand X-10 Remote Server" or Left-Click it.
      4. If you see a RED bar beneath the module numbers, this tells you that the server has not connected to your CM11A interface, to remedy this:
        1. Right-click an empty light-gray area between the numbers or to the far left of the server application.  This will bring up another menu.  From here, choose to change the com port that your PC communicates to your CM11A.  Once you have chosen the correct Communications / Serial port, the server will find the CM11A and it will connect and display the GREEN bar instead of the RED bar.  You are now connected.
        2. If changing the communications port doesn't work, please check that the CM11A is connected to your computer and that it's working properly.  Verify the communications port number the CM11A is connected to and try again.
      5. If you see a GREEN bar beneath the numbers, you are connected and the server is ready to send, receive, and issue commands to the interface
        1. To test this out, Left-Click a module number and the module should go ON.  Right-Click will turn the module OFF.

  2. Install the rX-10 Desktop PC Remote Client (optional):
    1. The Desktop Client file is named "Desktop_Client.exe".
    2. Install this application on a computer connected to your network for easy remote access to the X-10 Server by double-clicking the "Desktop_Client.exe" file.
    3. Once the application is installed, locate the "X10 Remote Desktop Client" folder off of the "Start->Programs" menu and click the "X10 Remote Desktop Client" shortcut to start the Client.

  3. Install the rX-10 Pocket PC Remote Client:
    1. The Pocket PC Client is located in the "PPC_Client.exe" file.
    2. Double-clicking this file will start the setup program.
    3. Make sure your device is attached and an ActiveSync connection is established.
    4. If you are prompted to replace or keep existing files on your Pocket PC, always choose the most recent file versions.  In most cases you will not have to replace any files and can choose the "No to All" button.
    5. NOTE To Windows Mobile 2003 / Pocket PC 2003 Users:  You will need to download and install the runtime files, provided by Microsoft, in order to use this program and many other new programs that will require these files.  You can obtain these files from Microsoft here:  http://www.microsoft.com/windowsmobile/resources/downloads/developer/evb.mspx

Operation:

X-10 Remote Server:

Changing the HouseCode:

  1. If the server is minimized to the system tray, Right-Click the computer icon and choose "Change the Housecode" - type a letter from A to P
  2. If the server is maximized, Right-Click an empty gray area (ex. between the "16" and the "L") and a menu will appear, choose "Change the Housecode" - type a letter from A to P

Changing the Communications / Serial Port that your CM11A is attached to:

  1. If the server is minimized to the system tray, Right-Click the computer icon and choose "Change the Com Port" - type a number 1, 2 or 3
  2. If the server is maximized, Right-Click an empty gray area (ex. between the "16" and the "L") and a menu will appear, choose "Change the Com Port" - type a number 1, 2 or 3

Turning a module On or Off:

  1. Maximize the server by Right-Clicking the icon and choosing "Expand X-10 Remote Server"
  2. Use your mouse to hover over the module you want to turn On or Off
  3. Left-Click to turn it ON, Right-Click to turn it OFF.  If you turn on a module, the number will turn Green

Turning All lights On or All Units Off:

  1. Maximize the server by Right-Clicking the icon and choosing "Expand X-10 Remote Server"
  2. Left-Click on the Green bar below the module number to turn All Lights ON, Right-Click to turn All Units OFF

Dimming a Light module:

  1. Maximize the server by Right-Clicking the icon and choosing "Expand X-10 Remote Server"
  2. Use your mouse to hover over the module you want to turn Dim
  3. Left-Click to turn it ON, the number will turn Green and a Slider control will appear
  4. Move the slider to the Left to Dim the light, to the Right to Brighten the light
  5. Note: hovering your mouse over the slider will tell you what percentage the light is brightened

The Logging Window:

  1. Maximize the server by Right-Clicking the icon and choosing "Expand X-10 Remote Server"
  2. Left-Click the green "L" and the logging window will be displayed
  3. This is useful for debugging purposes and to let you know the IP addresses of the clients that are connected
  4. It also displays your current server computer name, IP address, listening port, and communications port
  5. Left-Click the green "L" again and the window will roll back up

The Connection State Label (i.e. the Red "X" or Green "C"):

  1. Maximize the server by Right-Clicking the icon and choosing "Expand X-10 Remote Server"
  2. In the upper right corner of the server there will be either a Red "X" or a Green "C"
  3. The "X" tells you that no clients are connected
  4. the "C" tells you clients are currently connected.

Deciphering the server application Title Bar:

  1. The server Title Bar that reads "X-10 Remote Server (HouseCode: x) - x" will tell you a few things
  2. "HouseCode: x" will tell you what housecode the server is currently set to
  3. The -" x" tells you how many remote clients are currently connected to the server

Minimizing the Server back to the System Tray:

  1. If the server is maximized, Right-Click an empty gray area (ex. between the "16" and the "L") and a menu will appear, choose "Minimize X-10 Remote Server to System Tray"

Maximizing the Server:

  1. Locate the Server "computer" Icon in the system tray. 
  2. Left-Click the Icon once to expand the application OR Right-Click the Icon and choose "Expand X-10 Remote Server"

 

rX-10 Desktop PC Remote Client:

Editing the Device Panel Text File (rx10.ini):

  1. You can customize the names for each of your modules by editing the included "rx10.ini" file.  This file is located in the folder where you installed the PC Remote Client - default location is: "C:\Program Files\rX10_DClient\rx10.ini"
  2. You can either edit this file directly or you can Double-Click the "Device Panel" label and this file will be opened in NotePad.
  3. After you have made changes, save the file and then you will have to Exit the Client and re-start it for the changes to take place
  4. A Few Things About the rx10.ini File:
    1. The first 4 lines are for you to type in some server IP addresses that you connect to.  Do not erase these lines or unpredictable things may happen.  Don't worry, if you don't need these IP address, they will just sit there waiting and the most recent IP you last connected to will be chosen by default anyway.
    2. Each Housecode will have it's own set of 16 modules:
      1. See the example under the "A" housecode
      2. Each line will be truncated at 12 characters AND depending upon which font your computer uses, you may not see all 12 characters and you will have to play around until you get the desired results.
      3. Please make sure the housecode you are modifying still contains 16 lines, even if they are blank they need to be there or unpredictable results can occur

Connecting to the Server:

  1. Make sure the server is running and communicating with the CM11A interface (i.e. a Green bar beneath the modules is an easy way to tell if the server "sees" the interface).
  2. Located next to the "Connect" button on the PC Client is the IP address pull-down box - type in Either the IP address of your X-10 server OR it's computer host name
  3. Click the "Connect" button
  4. If the Server is found, the "Connect" button will turn into a "Disconnect" button AND the top status bar will read "Connected"
  5. Note: the last IP address of the server you last connected to will be saved and displayed upon the next startup of the PC Client

Minimizing the PC Remote Client:

  1. To minimize the Client to the System Tray, just click the "m" button next to the "Exit" button.  This way the client will be ready when you need it, but out of the way in the meantime.

Maximizing the PC Remote Client:

  1. Locate the Client "computer" Icon in the system tray. 
  2. Left-Click the Icon once to expand the application OR Right-Click the Icon and choose "Expand rX10- Desktop PC Remote Client"

Changing the HouseCode:

  1. Use the pull-down box and choose the appropriate housecode for the module you want to control

Modules: On / Off / All Lights On / All Units Off:

  1. First choose a Housecode, then click a module, then click the appropriate button

Dimming a Light module

  1. First choose a Housecode, then click a module, then adjust the brightness slider to the appropriate brightness and then click the "Dim" button
  2. Note: After moving the brightness slider, the brightness level is displayed at the top status bar. 

rX-10 Pocket PC Remote Client:

Editing the Device Panel Text File (rx10.ini):

  1. Please read the following section on editing the rx10.ini file
  2. Note: If you haven't installed the PC Client or don't want to, you can edit the "rx10.ini" file included in the "X10_Remote.zip" file where this Readme.htm file is located and copy this file over to your Pocket PC
  3. After editing this file, you can copy it to your pocket pc for use, here's how:

    Follow the steps below to get started for Manual File Transfer:

    1. Locate the rx10.ini file on your desktop PC. The default location is: "C:\Program Files\rX10_DClient\rx10.ini"
    2. Right click this file, “rx10.ini”, and choose “Copy”
    3. Connect your Device (Pocket PC) and establish an ActiveSync connection
    4. When ActiveSync comes up, click the “Explore” button
    5. Double-click “My Pocket PC” in the Mobile Device window
    6. Then browse to: “\Program Files\Pocket PC X-10”.  This is the Default Installation Directory on your Pocket PC
    7. Make sure Pocket PC X-10 is NOT running on your Device or the paste function will not work. 
    8. Once you are sure the program is closed, in the ActiveSync explorer window in the "Pocket PC X-10" folder, Click “Edit” and select “Paste” and the file will be copied over.
    9. Now the newly copied file is ready for use on your device.

Connecting to the Server:

  1. Make sure the server is running and communicating with the CM11A interface (i.e. a Green bar beneath the modules is an easy way to tell if the server "sees" the interface).
  2. Located next to the "Connect" button on the Client is the IP address pull-down box - type in Either the IP address of your X-10 server OR it's computer host name
  3. Click the "Connect" button
  4. If the Server is found, the "Connect" button will turn into a "Disconnect" button AND the top status bar will read "Connected"
  5. Note: the last IP address of the server you last connected to will be saved and displayed upon the next startup of the PC Client

Changing the HouseCode:

  1. Use the pull-down box and choose the appropriate housecode for the module you want to control

Modules: On / Off / All Lights On / All Units Off:

  1. First choose a Housecode, then click a module, then click the appropriate button

Dimming a Light module

  1. First choose a Housecode, then click a module, then adjust the brightness slider to the appropriate brightness and then click the "Dim" button
  2. Note: After moving the brightness slider, the brightness level is displayed at the top status bar. 

End User License Agreement

Use of the Jeffers software ("JS") provided with this agreement (the "SOFTWARE") constitutes your acceptance of these terms. If you do not agree to the terms of this agreement, do not install and/or use this SOFTWARE. User's use of this SOFTWARE is conditioned upon compliance by user with the terms of this agreement.

1. License Grant

"You" means the company, entity, or individual installing or using the SOFTWARE.

"Use" means storing, loading, installing, executing, or displaying the SOFTWARE.

This Agreement grants you, the Licensee, a license to:

(a) use the Software on a single computer system; and
(b) make one copy of the Software in machine readable form solely for back-up purposes, provided you reproduce JS copyright proprietary legends.

Notwithstanding the foregoing, the SOFTWARE may be used on the home, laptop or other secondary computer or handheld of the principal user of the SOFTWARE, and an additional copy of the SOFTWARE may be made to support such use. More than 2 copies of the SOFTWARE per principal user will require the purchase of additional licenses for use on additional computers or handheld devices.  As used in this license, the SOFTWARE is "in use" when it is either loaded into RAM or installed on a hard disk or other permanent memory device. The SOFTWARE may be "in use" on only one computer at any given time. (Different license terms and fees are applicable for networked or multiple user applications.) As a specific condition of this license, you agree to use the SOFTWARE in compliance with all applicable laws including copyright laws.

You may not modify the SOFTWARE or disable any licensing or control features of the SOFTWARE except as an intended part of the SOFTWARE's programming features. This license is not transferable to any other hardware product or other company, entity, or individual.

2. Ownership

The SOFTWARE is owned and copyrighted by JS.
Your license confers no title or ownership in the SOFTWARE and should not be construed as a sale of any right in the SOFTWARE.

3. Unauthorized Use

(i)You shall not (nor shall You permit anyone else to) use, copy, rent, lease, sell, distribute, modify, decompile, disassemble, otherwise reverse engineer, or transfer the SOFTWARE except as provided in this agreement.
(ii)You shall not (nor shall You permit anyone else to) remove or obscure any proprietary notices on the SOFTWARE; post or otherwise make available the SOFTWARE, or any portion thereof, in any form, on the Internet or the World Wide Web; distribute copies of the SOFTWARE to others (electronically or otherwise); use a previous version of the SOFTWARE after you receive a new version and are asked to discontinue using the previous version.

Any such unauthorized use shall result in immediate and automatic termination of this license.

4. Bundling

In no case may the SOFTWARE be bundled with hardware or other non-shareware software without written permission from JS.

5. Distribution

Distribution of this version is forbidden.

All distribution of SOFTWARE is further restricted with regard to sources which also distribute virus source code and related virus construction/creation materials.
The SOFTWARE may not be made available on any site, CD-ROM, or with any package which makes available or contains viruses, virus source code, virus construction programs, or virus creation material.

Permission to distribute the SOFTWARE is not transferable, assignable, saleable, or franchisable.
Each entity wishing to distribute the package must independently satisfy the terms of the distribution license.

6. Limited Warranty

THIS SOFTWARE IS PROVIDED ON AN "AS IS" BASIS.
JS DISCLAIMS ALL WARRANTIES RELATING TO THIS SOFTWARE, WHETHER EXPRESSED OR IMPLIED, INCLUDING BUT NOT LIMITED TO ANY IMPLIED WARRANTIES OF MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE.

NEITHER JS NOR ANYONE ELSE WHO HAS BEEN INVOLVED IN THE CREATION, PRODUCTION, OR DELIVERY OF THIS SOFTWARE SHALL BE LIABLE FOR ANY INDIRECT, CONSEQUENTIAL, OR INCIDENTAL DAMAGES ARISING OUT OF THE USE OR INABILITY TO USE SUCH SOFTWARE, EVEN IF JS HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES OR CLAIMS.

THE PERSON USING THE SOFTWARE BEARS ALL RISK AS TO THE QUALITY AND PERFORMANCE OF THE SOFTWARE.

SOME JURISDICTIONS DO NOT ALLOW LIMITATION OR EXCLUSION OF INCIDENTAL OR CONSEQUENTIAL DAMAGES, SO THE ABOVE LIMITATIONS OR EXCLUSION MAY NOT APPLY TO YOU TO THE EXTENT THAT LIABILITY IS BY LAW INCAPABLE OF EXCLUSION OR RESTRICTION.

IN NO EVENT SHALL ANY THEORY OF LIABILITY EXCEED THE LICENSE FEE PAID TO JS.

7. Severability

In the event of invalidity of any provision of this license, the parties agree that such invalidity shall not affect the validity of the remaining portions of this license.

8. No Liability For Consequential Damages

IN NO EVENT SHALL JS OR ITS SUPPLIERS BE LIABLE TO YOU FOR ANY CONSEQUENTIAL, SPECIAL, INCIDENTAL, OR INDIRECT DAMAGES OF ANY KIND ARISING OUT OF THE DELIVERY, PERFORMANCE, OR USE OF THE SOFTWARE, EVEN IF JS HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES.
IN NO EVENT WILL JS'S LIABILITY FOR ANY CLAIM, WHETHER IN CONTRACT, TORT, OR ANY OTHER THEORY OF LIABILITY, EXCEED THE LICENSE FEE PAID BY YOU, IF ANY.

9. Governing Law

This License shall be governed and construed in accordance with the International laws and shall benefit JS, its successors and assigns.

10. Entire Agreement

You acknowledge that you have read this Agreement, understand it, and that by using the SOFTWARE you agree to be bound by its terms and conditions. You further agree that it is the complete and exclusive statement of the agreement between JS and you, and supersedes any proposal or prior agreement or understanding, oral or written, and any other communication between JS and you relating to the subject matter of this Agreement. No additional or any different terms will be enforceable against JS unless JS gives its express consent, including an express waiver of the terms of this Agreement, in writing signed by an officer of JS. You assume full responsibility for the use of the SOFTWARE and agree to use the SOFTWARE legally and responsibly. This Agreement shall be governed by California law, except as to copyright matters, which are covered by Federal law. This Agreement is deemed entered into at San Diego, California by both parties. Should any provision of this Agreement be declared unenforceable in any jurisdiction, then such provision shall be deemed severable from this Agreement and shall not affect the remainder hereof.

11. Reserved Rights

All rights not expressly or specifically granted here are reserved to JS.

 

 

Copyright 2003 by Marcus Jeffers (102603-1)