4 // Fraunhofer Institute for Open Communication Systems (FOKUS)
5 // Competence Center NETwork research (NET), St. Augustin, GERMANY
6 // Thorsten Horstmann <tho@berlios.de>
8 // This program is free software; you can redistribute it and/or modify
9 // it under the terms of the GNU General Public License as published by
10 // the Free Software Foundation; either version 2 of the License, or
11 // (at your option) any later version.
13 // This program is distributed in the hope that it will be useful,
14 // but WITHOUT ANY WARRANTY; without even the implied warranty of
15 // MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
16 // GNU General Public License for more details.
18 // You should have received a copy of the GNU General Public License
19 // along with this program; if not, write to the
20 // Free Software Foundation, Inc.,
21 // 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.
24 \brief MIH protocol public header */
26 #ifndef HH_SENF_Packets_80221Bundle_MIHPacket_
27 #define HH_SENF_Packets_80221Bundle_MIHPacket_ 1
30 #include "../../Packets/Packets.hh"
31 #include "../../Socket/Protocols/Raw/MACAddress.hh"
32 #include "../../Socket/Protocols/INet/INet4Address.hh"
33 #include "../../Socket/Protocols/INet/INet6Address.hh"
34 #include "TLVPacket.hh"
35 #include <boost/function_output_iterator.hpp>
36 #include <boost/iterator/filter_iterator.hpp>
39 //#include "MIHPacket.mpp"
40 ///////////////////////////////hh.p////////////////////////////////////////
44 struct MIHMessageRegistry {
45 // MIH messages registry
46 typedef boost::uint16_t key_t;
49 # define SENF_MIH_PACKET_REGISTRY_REGISTER( packetType ) \
50 SENF_PACKET_REGISTRY_REGISTER( \
51 senf::MIHMessageRegistry, packetType::type::MESSAGE_ID, packetType )
53 /** \brief Parse a MIHF_ID
55 the maximum length of a MIHF_ID is 253 octets (see F.3.11 in 802.21)
56 we could set maxLengthValue in init(), but for the most MIHF_IDs the default
57 maximum length of 127 should be enough.
59 \note you must call mihfIdPacket.maxLengthValue( 253) *before*
60 setting longer MIHF_IDs values.
62 class MIHFId_TLVParser : public BaseTLVPacketParser
64 # include SENF_PARSER()
65 SENF_PARSER_INHERIT ( BaseTLVPacketParser );
66 SENF_PARSER_SKIP ( length(), 0 );
67 SENF_PARSER_FINALIZE ( MIHFId_TLVParser );
69 std::string asString() const;
70 void setString(std::string const &id);
72 senf::MACAddress asMACAddress() const;
73 void setMACAddress(senf::MACAddress const &mac);
75 senf::INet4Address asINet4Address() const;
76 void setINet4Address(senf::INet4Address const &addr);
78 senf::INet6Address asINet6Address() const;
79 void setINet6Address(senf::INet6Address const &addr);
82 template <class OutputIterator>
83 struct binaryNAIEncoder {
84 binaryNAIEncoder(OutputIterator &i) : i_(i) {}
85 void operator()(const boost::uint8_t &v) const {
91 template <class OutputIterator>
92 static boost::function_output_iterator<binaryNAIEncoder<OutputIterator> > getNAIEncodedOutputIterator(OutputIterator i) {
93 return boost::make_function_output_iterator(binaryNAIEncoder<OutputIterator>(i));
96 struct binaryNAIDecoder {
97 binaryNAIDecoder() : readNextByte_(true) {}
98 bool operator()(const boost::uint8_t &v) {
99 readNextByte_ = readNextByte_ ? false : true;
100 return readNextByte_;
104 template <class Iterator>
105 static boost::filter_iterator<binaryNAIDecoder, Iterator> getNAIDecodedIterator(Iterator begin, Iterator end) {
106 return boost::make_filter_iterator<binaryNAIDecoder>(begin, end);
110 /** \brief Parse a MIH packet
112 Parser implementing the MIH header. The fields implemented are:
113 \image html MIHPacket.png
117 struct MIHPacketParser : public PacketParserBase
119 # include SENF_PARSER()
121 SENF_PARSER_BITFIELD_RO ( version, 4, unsigned );
122 SENF_PARSER_BITFIELD ( ackRequest, 1, bool );
123 SENF_PARSER_BITFIELD ( ackResponse, 1, bool );
124 SENF_PARSER_BITFIELD ( uir, 1, bool );
125 SENF_PARSER_BITFIELD ( moreFragment, 1, bool );
126 SENF_PARSER_BITFIELD ( fragmentNr, 7, unsigned );
127 SENF_PARSER_SKIP_BITS ( 1 );
129 // MIH message ID (MID)
130 SENF_PARSER_FIELD ( messageId, UInt16Parser ); //<pkgdraw:hide
131 SENF_PARSER_GOTO ( messageId );
132 SENF_PARSER_BITFIELD ( sid, 4, unsigned );
133 SENF_PARSER_BITFIELD ( opcode, 2, unsigned );
134 SENF_PARSER_BITFIELD ( aid, 10, unsigned );
136 SENF_PARSER_SKIP_BITS ( 4 );
137 SENF_PARSER_BITFIELD ( transactionId, 12, unsigned );
138 SENF_PARSER_FIELD_RO ( payloadLength, UInt16Parser );
140 SENF_PARSER_GOTO_OFFSET( 8, 8); // just to limit the offset calculation
143 SENF_PARSER_FIELD ( src_mihfId, MIHFId_TLVParser );
144 // Destination MIHF Id
145 SENF_PARSER_FIELD ( dst_mihfId, MIHFId_TLVParser );
147 SENF_PARSER_FINALIZE ( MIHPacketParser );
151 src_mihfId().type() = 1;
152 dst_mihfId().type() = 2;
155 friend class MIHPacketType;
158 /** \brief MIH packet
160 \par Packet type (typedef):
166 \ingroup protocolbundle_80221
169 : public PacketTypeBase,
170 public PacketTypeMixin<MIHPacketType, MIHMessageRegistry>
173 typedef PacketTypeMixin<MIHPacketType, MIHMessageRegistry> mixin;
175 typedef ConcretePacket<MIHPacketType> packet; ///< MIH packet typedef
176 typedef MIHPacketParser parser; ///< typedef to the parser of MIH packet
178 using mixin::nextPacketRange;
180 using mixin::initSize;
182 /** \brief Dump given MIH packet in readable form to given output stream */
183 static void dump(packet p, std::ostream &os);
184 static void finalize(packet p);
185 static factory_t nextPacketType(packet p);
187 enum ResponseStatus { Success, UnspecifiedFailure, Rejected, AuthorizationFailure, NetworkError };
190 /** \brief MIH packet typedef */
191 typedef ConcretePacket<MIHPacketType> MIHPacket;
194 struct MIHPayloadPacketParser : public PacketParserBase
196 # include SENF_PARSER()
197 SENF_PARSER_LIST ( tlv_list, packetSize(), GenericTLVPacketParser );
199 SENF_PARSER_FINALIZE ( MIHPayloadPacketParser );
202 struct MIHPayloadPacketType
203 : public PacketTypeBase,
204 public PacketTypeMixin<MIHPayloadPacketType>
207 typedef PacketTypeMixin<MIHPayloadPacketType> mixin;
209 typedef ConcretePacket<MIHPayloadPacketType> packet; ///< MIH Payload packet typedef
210 typedef MIHPayloadPacketParser parser; ///< typedef to the parser of MIH Payload packet
212 using mixin::nextPacketRange;
214 using mixin::initSize;
216 /** \brief Dump given MIHPayload in readable form to given output stream */
217 static void dump(packet p, std::ostream &os);
220 /** \brief MIH Payload packet typedef */
221 typedef ConcretePacket<MIHPayloadPacketType> MIHPayloadPacket;
225 ///////////////////////////////hh.e////////////////////////////////////////
227 #ifndef SENF_PACKETS_DECL_ONLY
228 //#include "MIHPacket.cci"
229 //#include "MIHPacket.ct"
230 //#include "MIHPacket.cti"
238 // c-file-style: "senf"
239 // indent-tabs-mode: nil
240 // ispell-local-dictionary: "american"
241 // compile-command: "scons -u test"
242 // comment-column: 40