JMRI® is...
By the community of
JMRI tools for working with your layout:
Layout Automation
Use JMRI to automate parts of your layout and operations:
Supported Hardware
Devices, command stations, networks, and protocols:
JMRI Setup and Installation
JMRI environments...

JMRI Help:

Contents Index
Glossary FAQ

Donate to

JMRI Applications: Error Messages and Codes

Various things can go wrong when JMRI tries to work with your DCC command station to program a DCC decoder. This page lists the error message that can result, and describes what they mean.

JMRI Error Codes

301 - no locomotive detected
The command station has reported that it doesn't see a locomotive on the programming track.

This can happen if the locomotive isn't making good electrical contact or if there's a wiring fault in the locomotive.

302 - programmer busy

The command station has reported that it's busy doing something else, and can't do any programming right now. This usually means that some other part of the DCC system is doing a programming operation, e.g. a hand-held throttle.

Some DCC systems can't do ops-mode programming (programming on the main) while also using the service mode programming track, in which case they'll return this error message.

303 - requested not implemented in command station

This means that JMRI has requested the command station do something that it doesn't support.

This is not supposed to happen, as JMRI should disable programming modes that the command station can't provide. If you do see this message, please report the circumstances on the JMRI users Group.

304 - aborted by user

The user has requested that the read or write operation stop early.

This is considered an error, because the program doesn't know whether the decoder actually saw the operation complete or not.

305 - confirm failed

Some command stations allow you to "confirm" the content of a CV, rather that read the value from it. In general, this is faster than doing a complete read. If the value in the CV doesn't match the expected value, this message is issued. It's considered an error because if the values don't match, we know that we don't know the correct value for the CV contents.

306 - timeout talking to command station

The program did not hear back from the command station when it expected to.

This is by far the most common error message when people first start using JMRI. In that case, it usually means that the connection to the command station isn't correct. This could be a problem with the cable(s) making the connection, or a problem with how the preferences are set. Picking the wrong serial port is particularly common.

Once JMRI is working properly, this error may occasionally happen due to a transient error. DecoderPro generally will retry it successfully in that case.

307 - Unknown error

An error has happened, but JMRI doesn't know enough about it to be able to report more detail.

In general, JMRI is pretty good at deciphering what went wrong, and this message isn't very common. If you do see this message, please report the circumstances on the JMRI users Group.

308 - No acknowledge from locomotive

At the end of a CV read or write operation, the locomotive replies ("acknowledges") to the command station using a pulse of current.

If that pulse isn't seen, some command stations provide this error message. It could be due to poor electrical connections to the programming track or within the locomotive. It could also be that the decoder doesn't support readback.

Some decoders, particularly certain sound decoders, draw so much current that the reply pulse isn't detected by the command station. In that case, one of the various "programming boosters" may solve the problem.

309 - Short Circuit on Programming Track

The command station has reported seeing a short circuit on the programming track. That prevents programming operations.

Check the electrical connections to the programming track, and also within the locomotive.

310 - Sequence Error

For some reason, the programming operation ended early and the command station returned to normal mode (left service mode) before it should have.

This error can occur when some operations are performed in JMRI during programming. Turning track power on during a programming operation on an XpressNet is one example of how to create this error.

If you haven't performed any operations during your programming sequence, this error, might indicate that you've selected the wrong command station type in JMRI Preferences. Check that. If that's set correctly and error 310 still shows up, ask for help on the JMRI users list.

311 - Communication Error Between PC and Command Station

The data between the PC and the Command Station was corrupted and the corruption was detected before the Command Station processed the request.

If this error occurs frequently, this error might indicate a problem with the connection between your computer and the command station or an issue with your system interface. Wireless connections are more prone to this issue than connections with physically connected cables.