JMRI Hardware Support - Lionel TMCC

# Hardware Support: Lionel TMCC

## Supported Hardware

### Command Station

Lionel TMCC 1 or TMCC 2 Legacy thru the serial port on the Command Base 1, Command Base 1L, or Command Base 992. Via WiFi to Command Base 992 and Command Base 3. Note: Connecting to the Command Base 1L will require an LCS SER2 serial converter. Connecting to the Command Base 992 may require the Y-cable included with the Lionel Legacy Command Set.

## Limitations

As of JMRI v 5.13.5, Lionel TMCC Train(TR) commands and some Legacy Engine(ENG) extended commands are still under development.

## Connecting

### DB9 Serial Cable

First, connect your computer's serial port to the TMCC command station using a DB9 serial cable. This should be a "straight-through" or "modem" cable, not a "crossover" or "null-modem" cable. if your computer doesn't have a built-in serial port, you can use a USB-serial adapter, but make sure you install the correct drivers if needed. Recent Mac OS distributions and Windows versions have the drivers already there for some adaptors.

### Setting Up JMRI

Next, configure the JMRI program for TMCC:

- Start your JMRI-based program (DecoderPro, PanelPro, etc).
- Go to the Connections tab of the Preferences pane. This opens automatically the first time a program is run, or you can select it from the "Edit" menu.
- Click the + tab and Select "TMCC (Lionel)" as the System Manufacturer.
- Under Connections, choose from Serial and Simulator.
  Enter a Prefix and Connection Name to identify this connection.
- When using Serial, pick the name of the serial port that you have connected to the TMCC system.
  If the baud rate doesn't show a fixed value, set it to 9,600 baud.
- Click "Save". You'll be asked if it's OK for the program to quit, click "Yes".
- Restart the program. You should be up and running.

### WiFi

Follow the instructions in the Lionel Legacy Control System or Command Base 3 Manual.

## Programming Mode

To Program ID#s/Addresses for Engines(ENG), Switches(SW) or Accessories(ACC):

- Follow the target device instructions to set it into "Program" mode.
- Start DecoderPro.
- Go to Actions/Single CV Programmer (*Actions is a tab at the top).
- Under Programming Track, select the device to be programmed.
- Set CV = 1.
- Enter the desired ID#/Address into Value.
- Select Write CV.
- Follow the device instructions to set it into "Run" mode.

To Program Engine(ENG) Feature Type:

- Follow the target device instructions to set it into "Program" mode.
- Go to Actions/Single CV Programmer in DecoderPro (*Actions is a tab at the top).
- Under Program on Main, select the device to be programmed.
- Under Program on Main, enter the target Engine ID#/Address.
- At the top, Set CV = 2.
- At the top, Enter the desired Feature Type# into Value.
- Select Write CV.
- Follow the device instructions to set it into "Run" mode.

## Engine(ENG) Operation

The functions below will take care of most Engine Controls on TMCC 1 and TMCC 2 Legacy equiped locomotives, and up to Railsounds 4 including aftermarket units such as ERR, K-Line and TAS.

### TMCC 1 and TMCC 2 Legacy (ENG) Sliding Speed Control

When using a JMRI Throttle to run a Locomotive, there is a drop-down menu at the top of the Sliding Speed Control (Control Panel) for selecting the proper speed step mode for operation. The choices are:

- 32 Speed Steps (TMCC 1).
- 32 Speed Steps (TMCC 2 Legacy).
- 100 Speed Steps (TMCC 1 ERR).
- 200 Speed Steps (TMCC 2 Legacy).

The arrow keys on the keyboard may also be used to adjust locomotive speed (left arrow - speed increase; right arrow - speed decrease). WARNING Note: Use the arrow keys for slight adjustments only. Holding down the arrow keys queues individual speed commands faster than they can be sent to the locomotive, and it can take some time for these "sent" commands to finish processing before the locomotive will respond to other commands (including IMMEDIATE STOP).

### TMCC 1 and TMCC 2 Legacy (ENG) Standard Function Buttons

When using a JMRI Throttle to run a Locomotive, the function buttons are allocated as follows:

F0
  Headlights On / Off (Equivalent to Aux2 Option 2 Operation)
F1
  Bell
F2
  Whistle 1 (Steam) / Horn 1 (Diesel)
F3
  Open Front Coupler
F4
  Open Rear Coupler

--------------------------------------------------------------------------
Numeric Keypad (Active in ENG mode after pressing Aux1 when using Lionel remote.)

F5
  Num 0; Preface needed for sending specified commands (TBD)
F6
  Num 1; Volume Up
F7
  Num 2; Crew Talk
F8
  Num 3; Activate Sound Card and Play Start up Sounds
F9
  Num 4; Volume Down
F10
  Num 5; Deactivate Sound Card after Playing Shut Down Sounds
F11
  Num 6; Steam Release (Steam) / Air Horn and RPM Decrease (Diesel)
F12
  Num 7; Tower Comm
F13
  Num 8; Smoke and Firebox OFF on Steam / Auxilliary Lighting OFF on Diesel
F14
  Num 9; Smoke and Firebox ON on Steam) / Auxilliary Lighting ON on Diesel

--------------------------------------------------------------------------

F15
  Aux 1 (Does not toggle buttons on remote in JMRI. This is a stand-alone code sent to the Engine.)
F16
  Let Off Sound
F17
  Forward
F18
  Reverse
F19
  Toggle Direction
F20
  Boost
F21
  Brake
F22
  Increse Speed (Relative) 2 Steps
F23
  Decrease Speed (Relative) -3 Steps
F24
  Momentum Low
F25
  Momentum Medium
F26
  Momentum High
F27
  Set

Any Accessory/Other component that uses the TMCC Engine(ENG) ID#/Address should also work with the above function buttons; however, the function buttons above may not allign with the expected functions of the target device. Consult the manual that came with the Accessory ( Crane Car, etc. ) to determine what the Aux1 buttons do for that item and label the JMRI function buttons accordingly.

### TMCC 2 Legacy Extended Functions

Extended TMCC 2 Legacy Functions are under development. If you have suggestions for usage of additional function keys, please make a suggestion via the JMRIusers list.

.

## Switch(SW) and Accessory(ACC) Operation

TMCC Switch(SW) and Accessory(ACC) functions are handeld through the JMRI Turnout tool. Follow the instructions below for setting up TMCC Switch(SW) and Accessory(ACC) elements in JMRI. Note: Before using the JRMI Turnout tool, be sure to program TMCC Switch(SW) and Accessory(ACC) ID#s/Addresses found in the Programming Mode section above.

### TMCC Switch(SW)

- Start DecoderPro.
- Go to Actions/Turnout Control (*Actions is a tab at the top).
- Enter the target Switch(SW) ID#/Address (TMCC Switch(SW) ID#s should be between 0-99).
- Select Thrown to set the switch to Out.
- Select Closed to set the switch to Through.
- If actual switch position does not match the selected Thrown/Closed position above, consider that your switch may be wired in reverse polarity.

### TMCC Accessory(ACC)

- Start DecoderPro.
- Go to Actions/Turnout Control (*Actions is a tab at the top).
- Enter the target Accessory(ACC) ID#/Address (TMCC Accessory(ACC) ID#s should be between 0-9). Note: For operating TMCC Accessories(ACC) with JMRI Turnout Control, translate Accessory(ACC) ID#s into 100-109 for Aux1 connected accessories and into 110-119 for Aux2 connected accessories.
- Select Thrown to turn ON the Accessory(ACC).
- Select Closed to turn OFF the Accessory(ACC).
- If actual accessory On/Off behavior does not match the selected Thrown/Closed position above, consider that your accessory may be wired in reverse polarity.

Learn more about using JMRI Turnouts here: JMRI: Turnouts Documentation.

.

## Route(RTE) and Group(GR) Operation

In TMCC terminology, Route(RTE) is for triggering multiple switches with one command and Group(GR) is for triggering multiple accessories with one command. In JMRI, both TMCC Route(RTE) and Group(GR) functions are handeld through the JMRI Route tool. Follow the instructions below to set up TMCC Route(RTE) and Group(GR) elements.

### TMCC Switch(SW)

- Start PanelPro.
- Go to Tools/Tables/Turnouts (*Tools is a tab at the top).
- Add each TMCC Switch and Accessory to this table (*The Add button is at the bottom toward the left).
- While in the Table tool, select Route (from the list on the left).
- Build the Route by selecting a combination of switches (TMCC Route(RTE)) or accessories (TMCC Group(GR)), or both (see JMRI LRoutes).
- Note: When you are adding switches/accessories you must use Set State to set them as Set Thrown, Set Closed or Set Toggle. BE SURE to use Set TOGGLE if you want the Set button (see below) to trigger both states of your selected devices.

- Select the Set button of the target Route to trigger all devices set up in that Route.

Learn more about using JMRI Routes here: JMRI: Routes Documentation..

For more fun, explore JMRI LRoutes here: JMRI: LRoute Documentation.

.