Java eISCP - Integra Serial Control Protocol

  /**

    * Wraps a command in a eiscp data message (data characters).

    *

    * @param command must be one of the Strings from the eiscp.Eiscp.Command class.

    **/

  public StringBuilder getEiscpMessage(String command)

  {

    StringBuilder sb = new StringBuilder();

    int eiscpDataSize = command.length() + 2 ; // this is the eISCP data size

    int eiscpMsgSize = eiscpDataSize + 1 + 16 ; // this is the size of the entire eISCP msg

    /* This is where I construct the entire message

        character by character. Each char is represented by a 2 disgit hex value */

    sb.append("ISCP");

    // the following are all in HEX representing one char

    // 4 char Big Endian Header

    sb.append((char)Integer.parseInt("00", 16));

    sb.append((char)Integer.parseInt("00", 16));

    sb.append((char)Integer.parseInt("00", 16));

    sb.append((char)Integer.parseInt("10", 16));

    // 4 char  Big Endian data size

    sb.append((char)Integer.parseInt("00", 16));

    sb.append((char)Integer.parseInt("00", 16));

    sb.append((char)Integer.parseInt("00", 16));

    // the official ISCP docs say this is supposed to be just the data size  (eiscpDataSize)

    // ** BUT **

    // It only works if you send the size of the entire Message size (eiscpMsgSize)

    sb.append((char)Integer.parseInt(Integer.toHexString(eiscpMsgSize), 16));

    // eiscp_version = "01";

    sb.append((char)Integer.parseInt("01", 16));

    // 3 chars reserved = "00"+"00"+"00";

    sb.append((char)Integer.parseInt("00", 16));

    sb.append((char)Integer.parseInt("00", 16));

    sb.append((char)Integer.parseInt("00", 16));

    //  eISCP data

    // Start Character

    sb.append("!");

    // eISCP data - unittype char '1' is receiver

    sb.append("1");

    // eISCP data - 3 char command and param    ie PWR01

    sb.append( command);

    // msg end - this can be a few different cahrs depending on you receiver

    // my NR5008 works when I use  'EOF'

    sb.append((char)Integer.parseInt("0D", 16));

    System.out.println("eISCP data size: "+eiscpDataSize +"(0x"+Integer.toHexString(eiscpDataSize) +") chars");

    System.out.println("eISCP msg size: "+sb.length() +"(0x"+Integer.toHexString(sb.length()) +") chars");

    return sb;

  }