XML Message Set

The bsSerialMsgs.xml specification defines the set of messages for BotSense virtual connections exstablished between BotSense clients and raw RS-232 serial devices proxied by the bsProxy server.

The serial messages are terminated between the BotSense client libbsclient_serial.so shared library or libbsclient_serial.a static library and the bsProxy plug-in libbsserver_serial.so interface module DLL.

The message encoding is 8-bit Id-Type-Value (itv). All message fields are packed in big-endian order.

<?xml version="1.0" encoding="UTF-8" ?>
<!DOCTYPE netmsgs PUBLIC "-//www.roadnarrows.com//DTD NETMSGS 1.0//EN"
          "http://www.roadnarrows.com/xml/netmsgs/1.0/netmsgs.dtd">

<!--
 - Package: BotSense
 - Module:  bsSerial
 - File:    bsSerialMsgs.xml
 -

/*!
 \file

  $LastChangedDate: 2010-09-13 10:25:05 -0600 (Mon, 13 Sep 2010) $
  $Rev: 581 $

  \brief Client - bsProxy server raw RS-232 serial messages.
  
  \author Robin Knight (robin.knight@roadnarrows.com)
  
 -  \copyright
 -    \h_copy 2010-2017. RoadNarrows LLC.\n
 -    http://www.roadnarrows.com\n
 -    All Rights Reserved
*/

 - Permission is hereby granted, without written agreement and without
 - license or royalty fees, to use, copy, modify, and distribute this
 - software and its documentation for any purpose, provided that
 - (1) The above copyright notice and the following two paragraphs
 - appear in all copies of the source code and (2) redistributions
 - including binaries reproduces these notices in the supporting
 - documentation.   Substantial modifications to this software may be
 - copyrighted by their authors and need not follow the licensing terms
 - described here, provided that the new terms are clearly indicated in
 - all files where they apply.
 -
 - IN NO EVENT SHALL THE AUTHOR, ROADNARROWS LLC, OR ANY MEMBERS/EMPLOYEES
 - OF ROADNARROW LLC OR DISTRIBUTORS OF THIS SOFTWARE BE LIABLE TO ANY
 - PARTY FOR DIRECT, INDIRECT, SPECIAL, INCIDENTAL, OR CONSEQUENTIAL
 - DAMAGES ARISING OUT OF THE USE OF THIS SOFTWARE AND ITS DOCUMENTATION,
 - EVEN IF THE AUTHORS OR ANY OF THE ABOVE PARTIES HAVE BEEN ADVISED OF
 - THE POSSIBILITY OF SUCH DAMAGE.
 -
 - THE AUTHOR AND ROADNARROWS LLC SPECIFICALLY DISCLAIM ANY WARRANTIES,
 - INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND
 - FITNESS FOR A PARTICULAR PURPOSE. THE SOFTWARE PROVIDED HEREUNDER IS ON AN
 - "AS IS" BASIS, AND THE AUTHORS AND DISTRIBUTORS HAVE NO OBLIGATION TO
 - PROVIDE MAINTENANCE, SUPPORT, UPDATES, ENHANCEMENTS, OR MODIFICATIONS.
 -
-->

<netmsgs encoding="itv" endian="big">

  <!-- ........................................................................
    - Meta Data to Tweak Source Generation
    ....................................................................... -->
  <meta>
    <brief>
      BotSense bsProxy server - client raw serial NetMsgs XML Definition
    </brief>
    <ns>BsSerial</ns>
    <prologue lang="h">
      #include "botsense/BotSense.h"
    </prologue>
    <epilogue lang="h"></epilogue>
    <prologue lang="c"></prologue>
    <epilogue lang="c"></epilogue>
    <prologue lang="python">
## maximum vector length
NMFVAL_LEN_MAX_VECTOR = nmBase.NMVectorMaxCount
    </prologue>
    <epilogue lang="python"></epilogue>
  </meta>

  <!-- ........................................................................
    - Extended Field Types (Optional)
    ....................................................................... -->
  <field_types>
  </field_types>


  <!-- ........................................................................
    - Message Definitions
    ....................................................................... -->
  <msg_types>

    <!-- Serial Open Request Arguments Sub-Message -->
    <msgdef msgid="ReqOpenArgs">
      <fielddef fname="baudrate"  ftype="u32" />
      <fielddef fname="bytesize"  ftype="u8" />
      <fielddef fname="parity"    ftype="char" />
      <fielddef fname="stopbits"  ftype="u8" />
      <fielddef fname="rtscts"    ftype="bool" />
      <fielddef fname="xonxoff"   ftype="bool" />
    </msgdef>

      <!-- Serial Read Request -->
    <msgdef msgid="ReqRead">
      <fielddef fname="readlen" ftype="u8">
        <min>1</min>
        <max>NMFVAL_LEN_MAX_VECTOR</max>
      </fielddef>
    </msgdef>

    <!-- Serial Transaction Request -->
    <msgdef msgid="ReqTrans">
      <fielddef fname="writebuf" ftype="u8[]" />
      <fielddef fname="readlen" ftype="u8">
        <min>1</min>
        <max>NMFVAL_LEN_MAX_VECTOR</max>
      </fielddef>
    </msgdef>

    <!-- Serial Read/Transaction Response -->
    <msgdef msgid="RspRead">
      <fielddef fname="readbuf" ftype="u8[]" />
    </msgdef>

    <!-- Serial Write Request -->
    <msgdef msgid="ReqWrite">
      <fielddef fname="writebuf" ftype="u8[]" />
    </msgdef>

    <!-- Serial Write Response -->
    <msgdef msgid="RspWrite">
      <fielddef fname="byteswritten" ftype="u8" />
    </msgdef>

  </msg_types>

</netmsgs>