Skip to content
Innomesh Docs
Room Manager

Loading Crestron Middleware onto a DMPS

Crestron DMPS controllers used in Space CE rooms run a middleware program — a compiled Crestron program (a .cpz file) that bridges the DMPS hardware to Space CE. When Innomesh ships a new middleware build, it must be loaded into a program slot on the DMPS and started.

This guide covers the two officially supported ways to load a program onto a Crestron 3-Series or 4-Series control system:

  1. Crestron Toolbox — the graphical tool, recommended for most cases.
  2. SFTP + console — transferring the file over SSH, then loading it with the progload console command.

Both do the same thing: place the .cpz in a program slot and register it with the control system. Choose whichever fits your access and tooling.

📝 Note
A .cpz is a compiled Crestron program. A DMPS has up to eleven program slots (0–10); the Space CE middleware normally lives in slot 1 (Program01). Always confirm the correct slot for your deployment before loading — loading into the wrong slot leaves the old program running.

Prerequisites

  • The middleware .cpz file, supplied by Innomesh.
  • Network reachability to the DMPS (IP address), or a direct USB connection to the controller’s COMPUTER port.
  • The DMPS administrator credentials.
  • Which program slot the middleware belongs in (typically slot 1).
  • Crestron Toolbox installed (for Method 1). Download it from the Crestron Toolbox product page (a free Crestron account is required).
🚨 Caution
Loading a program overwrites whatever is in the target slot and briefly stops control. Schedule the load for a time when the room is not in use, and confirm a current backup of the existing program exists before you start.

Crestron Toolbox is the standard graphical tool for managing control systems. This is the most reliable method for IT support.

1. Connect to the DMPS

Toolbox connects to a device through an Address Book entry — a saved connection you create once and reuse.

  1. Open Crestron Toolbox.
  2. Open the Address Book from the toolbar’s Address Book icon (or Tools > Manage Address Book).
  3. Click Add Entry (or press F3) to create a new connection, and give it a Name you’ll recognise, such as the room or DMPS name.
  4. Choose the connection type:
    • Ethernet (network): select the TCP radio button and type the DMPS IP address into the IP Address/Hostname field. Leave Port blank unless you use a non-default port. To connect securely (encrypted), tick the SSH box — SSH is the recommended default on current DMPS firmware.
    • Direct USB: select the USB tab/option instead, used only when your computer is plugged into the controller’s COMPUTER port.
  5. Click OK to save the entry, then select it and connect. When prompted, enter the DMPS administrator username and password.

You are connected when the status at the bottom of the tool window reads Connected.

2. Open the SIMPL Program function

  1. With the DMPS connected, open System Info (Tools > System Info, or the System Info icon).
  2. In the System Info window, click the Functions menu and choose SIMPL Program (also labelled Program on some Toolbox versions). This opens the program-loading dialog.
Crestron Toolbox System Info window with the Functions menu open, listing the available device functions
Opening a device function from System Info: the Functions menu lists everything the connected device supports, including SIMPL Program. Image: Crestron Toolbox help.

3. Select the file and slot, then send

  1. Set the memory location to Internal Flash (the DMPS default).
  2. Click Browse and select the middleware .cpz file.
  3. In the program slot dropdown, confirm the correct slot (Program 01 for the Space CE middleware). Toolbox suggests a slot based on the program’s ID tag — change it if it does not match your target slot.
  4. Click Send.
SIMPL Program dialog with a program file browsed in, an Internal Flash memory option, a program slot dropdown, and a Send button
The SIMPL Program dialog, where the .cpz file and target program slot are selected before sending. Image: Crestron Toolbox help.

Toolbox stops the running program, transfers the file, and restarts the program automatically. A progress window shows the time remaining. If the program’s default IP table differs from the one on the DMPS, Toolbox prompts before overwriting it — leave the existing table in place unless Innomesh instructs otherwise.

Please Wait progress window with a progress bar and the maximum time remaining for the program transfer
The progress window Toolbox shows while it stops, transfers, and restarts the program. Image: Crestron Toolbox help.

When the transfer completes, Toolbox confirms the program is loaded and running. Skip to Verifying the load.

Method 2: SFTP transfer, then load from the console

For headless deployments or scripted workflows, transfer the .cpz to the controller over SFTP, then load it with the progload console command. This is the manual equivalent of what Toolbox does for you: the file transfer puts the .cpz on the controller, and progload registers and starts it.

1. Transfer the .cpz over SFTP

  1. Connect to the DMPS with any SFTP client (for example WinSCP, FileZilla, or the sftp command line). Use the DMPS IP address, port 22, and the administrator credentials.

    ❗ Important
    Crestron file transfer runs over SSH/SFTP on port 22. Plain FTP is disabled on secured firmware. In Toolbox connections, this is what the SSH checkbox selects.
  2. Upload the .cpz into the program slot directory. The Space CE middleware slot 1 maps to:

    /Program01/
    📝 Note
    On some firmware the program slots are exposed as /simpl/app01, /simpl/app02, and so on (where the number is the slot). /Program01 and /simpl/app01 refer to the same slot-1 location — use whichever your DMPS presents.

2. Load it with progload

  1. Open a console session to the DMPS — SSH on port 22 with any terminal client, or Tools > Text Console in Crestron Toolbox.

  2. Load the transferred program into its slot:

    progload -p:1

    The -p: flag is the target program slot. Use -p:1 for slot 1. progload on its own loads the most recently transferred program; the -p: flag makes the slot explicit.

  3. The console reports the load progress and confirms when the program starts.

💡 Tip
Append ? to any console command to see its syntax, for example progload ?.

Useful related commands:

CommandPurpose
progload -p:1Load the program in slot 1 after the .cpz has been transferred
progreset -p:1Restart (reset) the program in slot 1 without reloading the file
progregList the registered programs and their slots
progcomments:1Show details of the program in slot 1 (name, compile date, source path)

Verifying the load

After loading by either method, confirm the correct middleware is running:

  • Run progcomments:1 (or progreg) in the console and check the program name and compile date match the build you just loaded.
  • Confirm the room comes back under control from Space CE and the touch panel — the middleware re-registers with Space CE within a minute or two of starting.

If the program does not start, restart it explicitly with progreset -p:1. If it still fails, re-check that you loaded into the correct slot and that the .cpz matches the DMPS model.

⚠️ Warning
progreset restarts the program in place. It does not reload the file — if you need to replace the program, transfer the new .cpz and run progload again.