Class XNetAddress


  • public class XNetAddress
    extends java.lang.Object
    Utility Class supporting parsing and testing of addresses for Lenz XpressNet

    Two address format are supported:

    • Xtxxxx where: t is the type code, 'T' for turnouts, 'S' for sensors, and 'L' for lights xxxx is a int for the hardware address (1-1024) examples: XT2 (address 2), XS1003 (address 1003), XL134 (address 134)
    • XSmm:pp where mm is the module address (1-128) and pp is the contact pin number (1-8).
    • Constructor Summary

      Constructors 
      Constructor Description
      XNetAddress()  
    • Method Summary

      All Methods Static Methods Concrete Methods 
      Modifier and Type Method Description
      static int getBitFromSystemName​(java.lang.String systemName, java.lang.String prefix)
      Public static method to parse a Lenz XpressNet system name.
      static java.lang.String getUserNameFromSystemName​(java.lang.String systemName, java.lang.String prefix)
      Public static method to check the user name for a valid system name.
      static Manager.NameValidity validSystemNameFormat​(java.lang.String systemName, char type, java.lang.String prefix)
      Public static method to validate system name format.
      • Methods inherited from class java.lang.Object

        clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
    • Method Detail

      • getBitFromSystemName

        public static int getBitFromSystemName​(java.lang.String systemName,
                                               java.lang.String prefix)
        Public static method to parse a Lenz XpressNet system name. Note: Bits are numbered from 1.
        Parameters:
        systemName - system name to parse.
        prefix - system prefix.
        Returns:
        the hardware address number, return -1 if an error is found
      • validSystemNameFormat

        public static Manager.NameValidity validSystemNameFormat​(@Nonnull
                                                                 java.lang.String systemName,
                                                                 char type,
                                                                 java.lang.String prefix)
        Public static method to validate system name format. Logging of handled cases no higher than WARN.
        Parameters:
        systemName - system name.
        type - bean type, S for Sensor, T for Turnout, L for Light.
        prefix - system prefix.
        Returns:
        VALID if system name has a valid format, else return INVALID
      • getUserNameFromSystemName

        public static java.lang.String getUserNameFromSystemName​(java.lang.String systemName,
                                                                 java.lang.String prefix)
        Public static method to check the user name for a valid system name.
        Parameters:
        systemName - system name to check.
        prefix - system prefix.
        Returns:
        "" (null string) if the system name is not valid or does not exist