search JMRI:

Development tools

• Getting the code via Git
• Developing with JMRI Code
• Git FAQs
• Building with:
  • Ant
  • NetBeans
  • Eclipse
  • IntelliJ IDEA

Code Structure

• Introduction
• Names and Naming
• Application Structure
• Code Structure Patterns
• Swing Structure
• External Connection Structure
• Application Preferences
• Threading
• Use of XML
  • XML Schema
  • XSLT Formatting
• Web Site
• Javadocs
  • Name Index
  • Packages
  • Classes

Techniques and Standards

• Recommended Practices
• Continuous Integration
• Internationalization
• Logging & Error Handling
• Unit testing with JUnit
• Documentation with Javadoc and UML
• Run the SpotBugs static analysis tool
• Providing help with JavaHelp
• Portable Filename Method
• XML Persistance

How To

• Extend JMRI
• Add a New System
• Add a New Type

Functional Info

• Turnout Feedback
• Network Connections
• How the startup scripts work
• LogixNG

Background Info

• Technology Roadmap
• Survey of JVM Capabilities
• Usage Poll, Spring 2007

JMRI Code: Network Access

This page describes various forms of network access available in JMRI. More capabilities are added all the time, so please check with the user group for up-to-date information.

Methods of Network Access

JMRI interacts with networks in two basic forms: downstream connections and upstream connections.

A downstream connection allows JMRI to connect to a layout via a network for operations and control. This uses a network connection to do the same kinds of things that are often done via serial RS232 and USB links.

An upstream connection allows other devices to command JMRI over a network connection. In this case, the network connection allows other devices and/or programs to do things that are normally done via scripts and the graphical user interface.

In the rest of this page, we provide links to the various examples of those two general areas.

Downstream (networked layout hardware) connections

• LocoNet systems
  • LocoNet RMI client server connection

    This uses Java RMI to provide client-server access to the LocoNet message stream.

  • LocoNetOverTcp to LbServer

    This uses Java RMI to provides access to the LocoNet message stream via the LbServer protocol.

• C/MRI
  • This exchanges the C/MRI poll/response protocol via a terminal server
• CAN via MERG Network Interface
  • The network interface can be used for the CANEther, CANGC1e, CANPi and CBUS Server.
  • CBUS Server is a Node.js program to allow multiple network connections to a MERG CANUSB4. MERG CBUS Server
• EasyDCC
  • This exchanges the EasyDCC ASCII command station protocol via a terminal server
• JMRIClient
  • Via network connection to a JMRI Simple Server
• NCE
  • This exchanges the NCE command station protocol via a terminal server
• SRCP
  • Via network connection to SRCP server
• ECOS
  • Via network connection to ECOS command station
• XPressNet
  • Via network connection to an XnTcp adapter
  • Via network connection to the Lenz LIUSB Server (Windows only)

Upstream (networked JMRI operations) connections

• Built-in web server (code)

  This is advertised on Bonjour/Zeroconf as a "_http._tcp.local." service. In particular, this contains the JMRI XMLIO support, which allows web browsers (with or without AJAX) to monitor and control a layout by accessing a JMRI XMLIO Servlet via the web. It also includes facilities for displaying and clicking on any open JMRI window.

• Via Python/jython scripting
• For remote throttles such as the iPhone or Android. (code) (WiThrottle product web site) (Android Engine Driver page)

  This is advertised on Bonjour/Zeroconf as a "_withrottle._tcp.local." service.

• Via running JMRI as an Enterprise Java Bean
• Via providing a LocoNet RMI server.

  This is advertised on Bonjour/Zeroconf as a "_jmri-locormi._tcp.local." service.

• Via providing a LbServer implementation.

  This is advertised on Bonjour/Zeroconf as a "_loconetovertcpserver._tcp.local." service. (Name pending approval from the original protocol developers)

• Via providing an SRCP server implementation.

  This is advertised on Bonjour/Zeroconf as a "_srcp._tcp.local." service.

• Via providing a JMRI Server implementation.

See also the jmri.util.zeroconf package of Zeroconf/Bonjour utilities for use in JMRI.

See also the DNS-SD page for more information on Zeroconf/Bonjour/"DNS Service Discovery" networking.

Search "man dns-sd" for more information on the dns-sd debugging command-line tool.

---