simple_message.h
Go to the documentation of this file.
00001 /*
00002  * Software License Agreement (BSD License)
00003  *
00004  * Copyright (c) 2011, Southwest Research Institute
00005  * All rights reserved.
00006  *
00007  * Redistribution and use in source and binary forms, with or without
00008  * modification, are permitted provided that the following conditions are met:
00009  *
00010  *       * Redistributions of source code must retain the above copyright
00011  *       notice, this list of conditions and the following disclaimer.
00012  *       * Redistributions in binary form must reproduce the above copyright
00013  *       notice, this list of conditions and the following disclaimer in the
00014  *       documentation and/or other materials provided with the distribution.
00015  *       * Neither the name of the Southwest Research Institute, nor the names
00016  *       of its contributors may be used to endorse or promote products derived
00017  *       from this software without specific prior written permission.
00018  *
00019  * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
00020  * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
00021  * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
00022  * ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE
00023  * LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
00024  * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
00025  * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
00026  * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
00027  * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
00028  * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
00029  * POSSIBILITY OF SUCH DAMAGE.
00030  */
00031 
00032 #ifndef SIMPLE_MSG_H
00033 #define SIMPLE_MSG_H
00034 
00035 #ifdef ROS
00036 
00037 #include "simple_message/simple_serialize.h"
00038 #include "simple_message/byte_array.h"
00039 #include "simple_message/shared_types.h"
00040 
00041 #endif
00042 
00043 #ifdef MOTOPLUS
00044 
00045 #include "simple_serialize.h"
00046 #include "byte_array.h"
00047 #include "shared_types.h"
00048 
00049 #endif
00050 
00051 
00052 namespace industrial
00053 {
00054 
00055 namespace simple_message
00056 {
00057 
00062 namespace StandardMsgTypes
00063 {
00064   enum StandardMsgType
00065   {
00066  INVALID = 0,
00067  PING = 1,
00068 
00069  //TODO: Keeping these message type for the time being.  Refactoring
00070  // the messages should remove the need for this message.
00071  JOINT_POSITION = 10,
00072  JOINT = 10, 
00073  READ_INPUT = 20,
00074  WRITE_OUTPUT = 21,
00075 
00076  JOINT_TRAJ_PT = 11,  //Joint trajectory point message (typically for streaming)
00077  JOINT_TRAJ = 12,         //Joint trajectory message (typically for trajectory downloading)
00078 
00079  // Begin vendor specific message types (only define the beginning enum value,
00080  // specific enum values should be defined locally, within in the range reserved
00081  // here.  Each vendor can reserve up 1000 types
00082 
00083  SWRI_MSG_BEGIN = 1000,
00084  MOTOMAN_MSG_BEGIN = 2000
00085   };
00086 }
00087 typedef StandardMsgTypes::StandardMsgType StandardMsgType;
00088 
00092 namespace CommTypes
00093 {
00094   enum CommType
00095   {
00096  INVALID = 0,
00097  TOPIC = 1,
00098  SERVICE_REQUEST = 2,
00099  SERVICE_REPLY = 3
00100   };
00101 }
00102 typedef CommTypes::CommType CommType;
00103 
00108 namespace ReplyTypes
00109 {
00110   enum ReplyType
00111   {
00112  INVALID = 0,
00113  SUCCESS = 1,
00114  FAILURE = 2
00115   };
00116 }
00117 typedef ReplyTypes::ReplyType ReplyType;
00118 
00119 
00120 
00125 class SimpleMessage
00126 {
00127 
00128   //* SimpleMessage
00165 public:
00166         SimpleMessage();
00167         ~SimpleMessage(void);
00168 
00169         bool init(int msgType, int commType, int replyCode,
00170                   industrial::byte_array::ByteArray &data );
00171         bool init(int msgType, int commType, int replyCode);
00172         bool init(industrial::byte_array::ByteArray & msg);
00173 
00174         void toByteArray(industrial::byte_array::ByteArray & msg);
00175 
00176         static unsigned int getHeaderSize() { return SimpleMessage::HEADER_SIZE; };
00177         static unsigned int getLengthSize() { return SimpleMessage::LENGTH_SIZE; };
00178 
00179         int getMessageType() {return this->message_type_;};
00180         int getCommType() {return this->comm_type_;};
00181         int getReplyCode() {return this->reply_code_;};
00182         int getMsgLength() {return this->getHeaderSize() + this->data_.getBufferSize();};
00183         int getDataLength() {return this->data_.getBufferSize();};
00184         industrial::byte_array::ByteArray & getData() {return this->data_;};
00185         
00192         bool validateMessage();
00193         
00194 
00195 
00196 private:
00197 
00198         industrial::shared_types::shared_int message_type_;
00199         industrial::shared_types::shared_int comm_type_;
00200         industrial::shared_types::shared_int reply_code_;
00201         industrial::byte_array::ByteArray data_;
00202 
00203         static const unsigned int HEADER_SIZE = sizeof(industrial::shared_types::shared_int) +
00204             sizeof(industrial::shared_types::shared_int) +
00205             sizeof(industrial::shared_types::shared_int);
00206         static const unsigned int LENGTH_SIZE = sizeof(industrial::shared_types::shared_int);
00207 
00208         void setMessageType(int msgType) {this->message_type_ = msgType;};
00209         void setCommType(int commType) {this->comm_type_ = commType;};
00210         void setReplyCode(int replyCode) {this->reply_code_ = replyCode;};
00211         void setData(industrial::byte_array::ByteArray & data);
00212 };
00213 
00214 }//namespace simple_message
00215 }//namespace industrial
00216 
00217 #endif //SIMPLE_MSG_


dx100
Author(s): Shaun Edwards (Southwest Research Institute)
autogenerated on Thu Jan 2 2014 11:29:36