background image

Using the FTCon Console Program (Advanced Programmers Only)

34

FileTransfer2

AXW File Transfer Arguments

The following arguments specify how to launch the FTCon program with an AXW file:

"FileName" ["Project Id"] [“System Id”]

 

"Project Id" – If not supplied, all files in the workspace are transferred. Otherwise, this 

must be the identifier of a project. The first matching project is transferred.

 

"System Id" - If not supplied, all systems in the project are transferred. Otherwise, this 

must be the identifier of a system. The first matching system is transferred.

FTL File Transfer Arguments

The following arguments specify how to launch the FTCon program with an FTL file:

"FileName" –Send | -Receive

 

"FileName" - Fully qualified file name of the FTL within quotes.

 

-Send |-Receive Indicates whether to load the specified FTL into the send or receive 

queue.

Send is assumed by default.

Single File Transfer Arguments

The following arguments specify how to launch the FTCon program with a single file.

All arguments must be present on the command line, except where noted, for the specified file or 

the file will not transfer. 

The order of the arguments is important and will need to follow the order listed below.

"FileName" CommSettings [DeviceMapping] –Send|Receive -Boot 
               -Axcess -Optimize -Direct –Tpd=BIF –User="username:password"

 

"FileName"

 - Fully qualified file name of the file to transfer within quotes.

 

CommSettings

 - Specifies the communication protocol and settings used for transferring 

the file. 

For a TCP/IP transfer, the command would be:

ip/url:[port]:[ping-before-connect]

The IP/URL address can be either the IP address or an URL and the port specifies the port on the 

master. 

An example for a TCP/IP transfer would be:

192.168.221.3:1319:1   

-or-

amx.boardroom.net:1319:0 

The port is optional and defaults to 1319. Ping-before-connect is optional and the default is 

1(enabled).

For serial transfer, the command would be:

commport,baud,[databits],[parity],[stopbits],[flow] 

 

commport = specifies the comm. port for transfer (i.e. COM2).

 

baud = specifies baud rate (i.e. 9600 or 57600).

 

databits = specifies the number of data bits. This should be set to 8.

Summary of Contents for FileTransfer2

Page 1: ...instruction manual Software FileTransfer2 ...

Page 2: ...X SOFTWARE including without limitation any if any service packs or hot fixes provided to Licensee after the expiration of the ninety 90 day Limited Warranty period are not covered by any warranty or condition express implied or statutory LICENSEE REMEDIES AMX s entire liability and Licensee s exclusive remedy shall be repair or replacement of the AMX Software that does not meet AMX s Limited Warr...

Page 3: ... 13 File Transfer List FTL Files 14 NetLinx Master Security 14 Adding Files To The Files To Send Queue 15 Adding All Files Contained In an APW or AXW File 15 Adding Files From a Specific Project System 16 Adding Individual System Files From the Open Workspace file 16 Adding Orphan Files 16 Adding Files To The Files To Receive Queue 17 Step 2 Communication Settings 18 Listening for NetLinx Masters ...

Page 4: ...ouch Panel for Virtual NetLinx Master TCP IP Transfers 27 Configuring FileTransfer2 for Virtual NetLinx Master TCP IP Transfers 28 Transferring Files Using a Virtual NetLinx Master TCP IP Connection 28 Virtual NetLinx Master USB Transfers 29 Configuring the Touch Panel for Virtual NetLinx Master USB Transfers 29 Configuring FileTransfer2 for Virtual NetLinx Master USB Transfers 29 Transferring Fil...

Page 5: ... and password for NetLinx masters that have security enabled Ability to send receive via USB for USB enabled devices via a Virtual NetLinx Master VNM connection Ability to send receive files via TCP IP and RS232 protocols FileTransfer2 recognizes the following file types for transfer APW NetLinx Studio Workspace AXW NetLinx Studio Export to Go FTL File Transfer List The FileTransfer2 User Interfac...

Page 6: ... target device when the transfer is complete By default the Reboot option is enabled for Workspace files only so that the System Master will automatically reboot after the transfer is complete It is usually necessary to reboot a NetLinx master after a TKN file transfer However it is not always desirable to have the reboot occur immediately after the file is transferred The Reboot checkbox allows y...

Page 7: ... file type Currently there are only options available when transferring TPD and TP4 type files This button is disabled for all other file types File Transfer Context Menu Right click on any file listed in the Send or Receive tabs to access the File Transfer context menu Add Adds a new file to the Send or Receive table depending on which tab is open when this option is selected This option opens th...

Page 8: ...iles To Send Files to Receive tables Edit With a file selected in the Files To Send table click the Edit command button to open the Edit menu Send Send tab only Click to send the file s in the Files To Send table to the specified device s Receive Receive tab only Click to receive the file s in the Files To Receive table to the specified device s Exit Click to exit the FileTransfer2 application Edi...

Page 9: ...sferred files to be automatically reloaded the next time the File Transfer dialog is opened This is useful if you transfer the same files repeatedly That way you don t have to re add the items over and over again De selecting the checkbox clears the remembered list of files and prevents file transfer from reloading the files the next time the dialog is displayed Workspace display This read only fi...

Page 10: ...fer The time and date of the last transfer Transfer Status Context Menu Right click on any file listed in the Transfer Status List to access the Transfer Status context menu Copy All Items Copies all items in the list to the clipboard Copy Selected Items Copies only the selected items in the list to the clipboard Save All Items Saves all items to a user defined file You will be prompted for a file...

Page 11: ...to the panels themselves KPD files are sent to the master and not directly to the keypad Before sending a KPD KPDesign file to the target keypad s be sure that you have successfully compiled the Source Code file that contains the keypad module and sent it to the Master see Configuring NetLinx Source Code for KPD Files Supported Operating Systems and Minimum PC Requirements Supported operating syst...

Page 12: ...XP Diamond Supra 336i SP ASVD C Diamond Supra 56i SP C Lucent 56K LU PCI C C US Robotics 56k Fax PCI 3CP5610A C C US Robotics Sportster WinModem 0467 X Zoom Fax 28 8 v 341 275 C Note Internal modes were tested only for calling capabilities capabilities External Modems Windows Operating System Manufacturer Model External Boca 14 4 V 32b MV 34xx X X X X X X Hayes Accura 56k 03328 A C C C C Hayes Acc...

Page 13: ...Welcome To FileTransfer2 9 FileTransfer2 ...

Page 14: ...Welcome To FileTransfer2 10 FileTransfer2 ...

Page 15: ...ncluded in a selected Workspace file to add to the Files To Send queue There are several possible ways to access the Quick Load dialog Click the Quick Load command button If there is not already a Workspace file open then the Quick Load dialog will indicate that no zero projects are open no Project file file path indicated in the top text field and New Workspace 0 Project s indicated in the main w...

Page 16: ...iles using NetLinx Studio v2 Refer to the NetLinx Studio on line help for details on creating editing and saving Workspace Files and Workspace To Go files A Workspace File represents at least one Project containing at least one System however a Workspace can contain multiple Projects Each Project in turn can contain multiple Systems At any time you can create a Workspace file via the File Save Wor...

Page 17: ...nx Studio v2 s Project menu allows you to export the currently open Workspace for distribution as a Workspace To Go AXW file AXW files preserve all relative file path information for the Projects Systems and System files contained in the Workspace making them ideal for distribution to remote sites As is indicated in the Export Workspace Files To Go dialog in NetLinx Studio v2 there are three major...

Page 18: ...aster Security NetLinx Studio v2 3 or higher supports secure communication with NetLinx Masters via the Authentication Required option in the Communication Settings dialog Before you can enable disable NetLinx security on a Master through NetLinx Studio you must verify the following The target Master has been loaded with firmware that supports security This means that the Master must have Master F...

Page 19: ...nding a KPD KPDesign file to the target keypad s be sure that you have successfully compiled the Source Code file that contains the keypad module and sent it to the Master Adding All Files Contained In an APW or AXW File In the Send tab 1 Select File Open Workspace AXW FTL File or click the Load Workspace command button to open the Open File dialog 2 Select either NetLinx Studio Files apw or Expor...

Page 20: ...and button in the Send tab to select individual System files to add to the Files To Send queue 1 Click the Add command button to open the Select Files For File Transfer dialog 2 Open the Current Workspace tab This tab consists of a display of the compiled Source Code AXS Token TKN User Interface TPD TP4 and IR IRL files contained in the currently open Workspace Use the options in the Current Works...

Page 21: ...em numbers for the source device and click OK to close the dialog and add the to the File list at the bottom of the Select Files To Transfer dialog 7 Click Settings in the Communication Settings section at the bottom of the dialog to open the Communication Settings dialog and specify the communication settings for the source device Note that in the Select Files For File Transfer dialog communicati...

Page 22: ...alog 6 Click Start Listening to begin listening for UDP messages from active NetLinx Masters on the subnet 7 Click Stop Listening to stop listening for UDP packets All Masters that were detected on the subnet are listed by TCP IP URL address in this dialog To Add NetLinx Masters to the List of Addresses in the TCP IP Settings dialog 1 Select one or more Ctrl click to multi select of the Masters in...

Page 23: ...dem or Virtual NetLinx Master c Click Edit Settings to specify the communication settings for the selected connection option see list of topics below 3 Click OK to close the Communication Settings dialog Configuring TCP IP Communication Settings NetLinx only With a Transfer selected in the Transfer List 1 Click the Edit command button and select Communication Settings to open the Communication Set...

Page 24: ...ity None Stop Bits 1 Flow Control None 6 Click OK to return to the Communication Settings dialog 7 Click OK to save the new Serial communication settings with the selected file Configuring Modem Communication Settings With a Transfer selected in the Transfer List 1 Click the Edit command button and select Communication Settings to open the Communication Settings dialog 2 Specify the Platform Selec...

Page 25: ...the Touch Panel for Virtual NetLinx Master USB Transfers If it is not already powered up and connected apply power to the G4 panel and verify that it is connected to the PC running NetLinx Studio via the USB connector on the rear or side of the panel Connecting the Panel to your PC via USB 1 Apply power to the panel by plugging in the power supply 2 Wait for the splash screen to disappear then use...

Page 26: ...ment for a target device Editing Device Mapping Information Device file mapping information for each file which associates a device address with each file is established and saved with the files when they are created in NetLinx Studio but can be overwritten in FileTransfer2 via the Device Mapping options accessible via the Edit menu 1 Select a file in the Transfer List Send or Receive tab 2 Click ...

Page 27: ... must be successfully compiled before they can be sent Touch Panel UI files created in TPDesign3 TPD are sent directly to wired Touch Panels on the bus via an AXlink serial connection where the Device ID 0 Touch Panel UI files created in TPDesign4 TP4 are sent to the Master either serially or over TCP IP G4 panels are connected to the Masters via TCP IP and cannot be sent over AXlink You can choos...

Page 28: ...r is invalid Invalid file type the file supplied on the cmdline is an unknown file type Unknown Error generic unknown error Not enough arguments not enough console parameters supplied to do anything Unable to install handler Ctrl C Break console handler couldn t be installed Invalid Option Expected U user password console security option is incorrect option is an invalid option invalid unknown opt...

Page 29: ...isted in the Files To Send List in the order in which they are listed top to bottom 2 The progress and status of each file transfer is indicated in the Transfer Status Window To receive files directly from a system device Serial connections only 1 In the Receive tab click to select a file in the Files to Receive queue 2 Click Edit to open the Edit menu and select Device Mapping This opens the Ente...

Page 30: ...Update Driver button 6 When the Install Driver dialog does appear click on the Next buttons accepting all the default prompts 7 The OS will complain about the fact that the driver you are installing updating does not have a digital signature This is acceptable so select to continue the installation 8 After installation is complete you are ready to connect to the USB port of the G4 panel a Open the...

Page 31: ...TCP IP Transfers 3 Transferring Files Using a Virtual NetLinx Master TCP IP Connection Configuring the Touch Panel for Virtual NetLinx Master TCP IP Transfers If it is not already powered up and connected apply power to the G4 panel and verify that it is connected to the LAN via the TCP IP connector on the rear or side of the panel 1 Press and hold the grey Front Setup Access button below the touc...

Page 32: ...XD T CV7 panel via TCP IP 1 Click the Add button to open the Select Files for File Transfer dialog 2 Click the Other tab and select the type of file you want to transfer only IRL IRV TP4 or IRN files can be transferred via a Virtual NetLinx Master connection 3 Click the Add button This invokes the Open dialog where you can locate and select the file you want to transfer 4 Select the desired file a...

Page 33: ...ual NetLinx Master transfers via USB 1 Press and hold the grey Front Setup Access button below the touch screen for 3 seconds to access the Setup page 2 Press the Protected Setup button to access the Protected Setup page 3 Use the on screen keyboard to enter the password the default password is 1988 4 Press the System Connection button to access the System Connection Setup page 5 Select USB as the...

Page 34: ...transfer only IRL IRV TP4 or IRN files can be transferred via a Virtual NetLinx Master connection 3 Click the Add button This invokes the Open dialog where you can locate and select the file you want to transfer 4 Select the desired file and click OK to close this dialog and invoke the Enter Device Mapping Information dialog 5 Review the mapping information and click OK to return to the Select Fil...

Page 35: ...ile default enabled By default select Send Icons when sending a TPD file default enabled By default select Send Fonts when sending a TPD file default enabled By default connect directly to a touch panel no master whenever transferring TPD files only available for Serial Connections default disabled When started from a console auto close when all console file transfers are finished Any interaction ...

Page 36: ...eived from a master and allow you to open the received code file for viewing editing in NetLinx Studio If the source code files were compiled with password protection in NetLinx Studio and then retrieved from the master via FileTransfer2 without supplying the correct password one for each platform NetLinx and Axcess the file will be received but it will appear to be empty if an attempt is made to ...

Page 37: ...tes Project Id If not supplied all files in the workspace are transferred Otherwise this must be the identifier of a project The first matching project is transferred System Id If not supplied all systems in the project are transferred Otherwise this must be the identifier of a system The first matching system is transferred Examples ftcon exe test apw Send the entire workspace contained in test a...

Page 38: ...rogram with a single file All arguments must be present on the command line except where noted for the specified file or the file will not transfer The order of the arguments is important and will need to follow the order listed below FileName CommSettings DeviceMapping Send Receive Boot Axcess Optimize Direct Tpd BIF User username password FileName Fully qualified file name of the file to transfe...

Page 39: ...ss This flag indicates that the specified transfer is an Axcess transfer Boot This flag indicates that the master should be rebooted after all transfers on the connection are finished User For NetLinx masters that have security enabled the argument will need to contain the username and password separated by a colon User fieldtech mypassword Optimize For TP4 transfers this enables Smart Transfer Sm...

Page 40: ...itmaps within the TPD file I Send icons within the TPD file F Send fonts within the TPD file You many use any combination For example t do not send bitmaps fonts or icons t B send bitmaps only t BI send bitmaps and icons only t BF send bitmaps and fonts only t BIF send bitmaps icons and fonts ...

Page 41: ...Using the FTCon Console Program Advanced Programmers Only 37 FileTransfer2 ...

Page 42: ...NA AUSTRALIA BELGIUM BRAZIL CANADA CHINA ENGLAND FRANCE GERMANY GREECE HONG KONG INDIA INDONESIA ITALY JAPAN LEBANON MALAYSIA MEXICO NETHERLANDS NEW ZEALAND PHILIPPINES PORTUGAL RUSSIA SINGAPORE SPAIN SWITZERLAND THAILAND TURKEY USA ATLANTA BOSTON CHICAGO CLEVELAND DALLAS DENVER INDIANAPOLIS LOS ANGELES MINNEAPOLIS PHILADELPHIA PHOENIX PORTLAND SPOKANE TAMPA 3000 RESEARCH DRIVE RICHARDSON TX 75082...

Reviews: