System shell

Any QNX-based JACE has a “system shell,” providing low-level access to a few basic platform settings. Using a special JACE power-up mode, you can access this system shell using a serial connection to the JACE’s onboard RS-232 port. Note that system shell is also available via Telnet (providing that Telnet is enabled in the JACE).

Typical usage is for troubleshooting. However, in the case of IP address mis-configuration, you can use the serial system shell in order to regain access to the unit.

Also, depending on your preference, as an alternative to reconfiguring your PC’s IP address in Windows (to initially connect to a new JACE), you may wish to use the serial system shell to set the JACE’s IP address. If done as the first step, afterwards you could connect normally (Ethernet/IP) and perform all other Niagara software installation/platform configuration using Workbench and the Commissioning Wizard. This method would save you from having to re-configure your PC’s IP address settings in Windows: first to connect to the JACE as shipped from the factory, and then back again to its original settings.

The following sections provide more details:

About JACE serial shell mode

Any JACE circuit board has a small 4-pin jumper connector, commonly called the mode jumper. To put the JACE in serial shell mode, you put a 2-pin jumper on certain connector pins, and cycle power to the unit. Upon system boot, this makes the system shell available at the JACE’s primary RS-232 (COM1) port, at a pre-defined serial rate: typically 115200, 8, N, 1 (or else if a JACE-403 or JACE-545: 57600, 8, N, 1).

Using a serial terminal program such as PuTTY or HyperTerminal, you can then login using platform credentials and access the system shell menu. After changing platform IP address parameters, a reboot command from the menu is necessary, and you remove (or reposition) the mode jumper. The JACE reboots using the changed IP address parameters, and its COM1 port operates as normally configured.

If using COM1 for any other application, be sure to move the 2-pin jumper from the “Serial Shell” position to the “Normal” position before rebooting from the serial system shell.

Items needed for serial system shell

Apart from physical access to the JACE, you need the following items:

A working RS-232 port on your PC.

Usually this is a DB-9 connector with a specific Windows ComN assignment (say Com1 or Com2). However, newer notebook PCs may require a USB-to-RS-232 adapter, installed with a Windows driver.
Terminal emulation software, such as PuTTY (free open source application) or Microsoft HyperTerminal (standard in Windows XP).
A serial cable to connect between your PC’s serial ComN port to the JACE’s RS-232 port, plus any adapter, if necessary.
- A JACE-3E, JACE-6E, or JACE-2,-6,-7’s RS-232 port uses a DB-9 connector. Use a standard DB-9 to DB-9 “null modem” cable.
- For JACE controllers with RS-232 ports that use RJ-45 connectors, such as a JACE-x02 Express (M2M JACE), JACE-603, JACE-645, or any JACE-4/5 series, the following parts, listed by Tridium part number, apply:
  - 10148 — Adapter, RJ-45 to DB-9, null modem type
  - 10181 — Silver satin RJ-45 patch cable, 10 ft. (connects adapter to RJ-45 type RS-232 port)
    
    Patch cables are also available in lengths 4 ft. (10180) and 25 ft. (10182)
  If sourcing your own RJ-45 to DB-9 adapter, refer to the Mounting and Wiring Guide for the appropriate JACE controller for the pinouts used on the RS-232 port.
A 2-pin jumper block for the JACE’s “Serial Shell” jumper pins—in most cases this should already be installed on the “Normal” position pins.

Using serial system shell

The following procedure provides steps to use serial system shell.

In serial shell mode, normal COM1 port usage is overridden! Note that some models, such as a JACE-403, have configurable serial ports, where the RS-485 port may be configured as COM1. In this case, note that the RS-485 port will not function during serial shell mode.

To connect to the JACE serial system shell

To connect to the JACE’s system shell using a serial connection, do the following:

Connect the necessary serial cable and adapter between the JACE’s RS-232 port and the RS-232 COM port you are using on your PC. See Items needed for serial system shell.
On your PC, start your terminal emulation software. For Hyperterminal, from the Windows Start menu, this is typically Programs->Accessories->Communications->HyperTerminal.
In the “Connection Description” dialog, type a name for this session.

For example: Jace serial shell

Click OK.
In the “Connect to” dialog, use the “Connect using” drop-down list to select the COM port you are using on your PC, for example COM1. Click OK.
In the Comn Properties dialog, choose the following settings:
- Bits per second: 115200 for a JACE-3E, JACE-6E, JACE-2,-6,-7, or JACE-x02 Express, JACE-603, JACE-645. (For a JACE-4/5 series, select 57600).
- Data bits: 8
- Parity: None
- Stop bits: 1
- Flow control: Hardware
Click OK. The HyperTerminal session is now set up.
On the JACE controller, locate the 4-pin “Serial Shell” connector and put a 2-pin jumper on the appropriate pins. See the label on the JACE to locate the mode or “serial shell” connector pins.
With your HyperTerminal session active, remove power from the JACE, let it cycle down, then reapply power.

After a few seconds, text should appear in your terminal emulation software window similar to:

Press any key to stop auto-boot...
Do not press any key, wait for the login prompt.

If you did press a key to stop auto-boot, select option 1 (Boot from on-board nand flash).
At the login prompt, enter the platform user name, and at the password prompt, the platform password. See Platform daemon credentials for factory-default values.

The system shell menu appears. See About the JACE system shell menu.
When finished making platform changes from the serial system shell, do the following:
- Move the 2-pin jumper block from the “Serial Shell” position back to the “Normal” position, or remove it from the “Mode” connector of a JACE-4/5 controller.
- From the system shell menu, select the Reboot option.
  
  Type “y” at the “Are you sure you want to reboot [y/n]” prompt, and press Enter.
  
  Shutdown-related text appears in the HyperTerminal window, and then the connection is dropped.
Press the Disconnect button on the HyperTerminal tool bar.
Exit from the HyperTerminal application, selecting to Save if you wish to reuse this setup again.