I can't connect to Crestron devices on  the Control Subnet?

Version 16.1 by Alexander Mott on 2024/05/29 18:56

Crestron processors should automatically route traffic from the LAN side of the network to devices on their Control Subnet as long as the following is true:

  • Control Subnet devices are Crestron devices
  • Control Subnet devices are set DHCP and receiving IP addresses from the Crestron processor
  • The Crestron processor is set securegatewaymode default
  • The processor Control Subnet and LAN are not isolated by the isolatenetworks command

If the above conditions are met, then the easiest way to connect to devices on the Control Subnet from the LAN is do the following:

  • Use Crestron Device Discovery Tool with the LAN IP address of the processor as the Remote Search
    • Optionally, select "Control Subnet Only" when conducting the Remote Search to only include devices on the Control Subnet side of the search
  • Once the Remote Search is complete, export the results to a new Address Book 
  • Open the desired Tool and use the dropdown menu to import the new Address Book and select the device on the Control Subnet that you would like to connect to

Non-Crestron devices (such as Pharos LPC) and Crestron devices with static IP addresses require a port map on the processor in order to access the Pharos from the LAN-side of the processor. 

Ports can be added to the port map with the addpo [ext_port] [int_port] [target_ip/target_hostname] [protocol] command, and ports can be removed with the rempo [ext_port] [int_port] [target_ip/target_hostname] [protocol] command. The current port mapping can be viewed with the showportmap command. 

The table below shows the required parameters for common Crestron devices. The external port can vary, but it must be unique and cannot be in the range reserved by the processor for dynamic ports (default 64000 thru 64301). We recommend using ports above this range (e.g. 64302). 

Device[ext_port][int_port][target_ip/target_hostname][protocol]
TSW-xx60/TSW-xx70 Crestron touch screens6430222IP address or hostname on Control SubnetTCP
ZUMNET-JBOX-16A-LV or ZUMNET-JBOX-DALI room controllers6430341795IP address or hostname on Control SubnetTCP
DIN-CENCN-2(-POE) Cresnet/Ethernet bridges6430441795IP address or hostname on Control SubnetTCP
DIN-DALI-2 DALI controllers6430541795IP address or hostname on Control SubnetTCP

Once ports have been mapped, an Address Book can be created to allow easy connection to new devices. This address book can either be created manually or it can be done by editing the Address Book created when doing a Remote Search from the processor:

  • Address Books can be edited by opening the .xadr file in a text editor
  • Address Books created using the Remote Search will typically have devices in the [ComSpecs] section in the following format:
    • [DeviceName]=auto [Processor LAN IP Address];pat ctp,[DeviceHostname]
    • e.g., ZN-2-16=auto 10.44.5.45;pat ctp,ZN-2-16
  • When using a port map, the correct format is:
    • [DeviceName]=auto [Processor LAN IP Address],[ext_port]
    • e.g., ZN-2-16=auto 10.44.5.45,64325
  • All entries for Control Subnet devices using a port map instead of Crestron's dynamic ports must be edited

Bonus: Excel Tips

Probably the easiest way to bulk add/remove port maps or to view a current port map is to save a DeviceSummary.txt, run the showportmap command, and use Excel to either match IP addresses/Hostnames with existing ports or construct commands to assign new ports:

  • Open a new Excel file
  • In Sheet1:
    • Paste the results of the showprotmap command into column A so that each row in Excel corresponds to one row in the showportmap table
    • Use formula "=TRIM(TEXTSPLIT(A1,"|")"  into cell B1 and drag it down so that all rows are covered  and then delete row 2
    • 1717007667054-686.png
  • In Sheet2:
    • Paste DeviceSumamry.txt into column A so that each row in Excel corresponds to one row in DeviceSummary.txt
    • Use formula "=TRIM(TEXTSPLIT(A1,",")" into cell B1 and drag it down so that all rows are covered and then delete row 2
    • 1717007718176-788.png
  • Get existing ext_port information into column K on Sheet2:
    • If you want to see which existing port maps correspond to device hostnames, use the XLOOKUP function:
      • Use formula "=XLOOKUP(C2,Sheet1!Demoticon_grin,Sheet1!B:B)" in cell J2 and drag it down so all rows are covered
      • If ports were mapped using the device hostname, use the formula "=XLOOKUP(B2,Sheet1!Demoticon_grin,Sheet1!B:B)" instead
  • Additional information can be input into the spreadsheet and the "=CONCAT(...)" command used to construct commands
    • An excel file (portmap.xlsx) with these formulas is attached; red columns are where information should be pasted, yellow columns should have information input manually, and green cells will automatically update
    • In the attached excel, column C2 should be the LAN address of the processor in order for the [ComSpec] concatenation to work as intended
  • Multiple commands that have been constructed in Excel can be pasted into Text Console at a time in order allow for bulk changes, but it is always recommended to paste commands into a blank text document first to verify that Excel did not add any extra punctuation to the commands