untested EPI 33

libESTA/acn/README.md

@@ -29,3 +29,7 @@ Operation on UDP
 
 * EPI 18. Operation of SDT on UDP Networks
  * `sdt-udp.h`: [`ACN::SDT::UDP`]
+
+
+* EPI 33. ACN Root Layer Protocol Operation on TCP
+ * `rlp-tcp.h`: [`ACN::RLP::TCP`]

libESTA/acn/acn.h

@@ -23,12 +23,13 @@
 */
 #pragma once
 
+#include "dmp.h"
 #include "pdu.h"
 #include "rlp.h"
+#include "rlp-tcp.h"
 #include "rlp-udp.h"
 #include "sdt.h"
 #include "sdt-udp.h"
-#include "dmp.h"
 
 // ANSI E1.17- 2015, Architecture for Control Networks
 namespace ACN {

libESTA/acn/rlp-tcp.cpp

@@ -0,0 +1,56 @@
+/*
+  rlp-tcp.cpp
+
+  Copyright (c) 2020 Kevin Matz (kevin.matz@gmail.com)
+
+  Permission is hereby granted, free of charge, to any person obtaining a copy
+  of this software and associated documentation files (the "Software"), to deal
+  in the Software without restriction, including without limitation the rights
+  to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+  copies of the Software, and to permit persons to whom the Software is
+  furnished to do so, subject to the following conditions:
+
+  The above copyright notice and this permission notice shall be included in all
+  copies or substantial portions of the Software.
+
+  THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+  IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+  FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+  AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+  LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+  OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+  SOFTWARE.
+*/
+
+#include "rlp-tcp.h"
+#include <cstring>
+
+namespace ACN {
+namespace RLP {
+namespace TCP {
+
+preamble_t::preamble_t(PDU::Stream stream) {
+  stream->read(acn_id, sizeof(acn_id));
+  if (stream->gcount() != 12)
+    stream->setstate(stream->rdstate() | std::ios_base::failbit);
+  length = stream->read32();
+}
+
+
+/*
+  Validate compliance with ACN EPI 33. ACN Root Layer Protocol Operation on TCP
+  4.2. Reception
+*/
+preamble_t::operator bool () {
+  // 2. Preamble Format: The ACN Packet Identifier shall be the text string
+  // “ASC-E1.17\0\0\0” encoded in [ASCII].
+  if (memcmp(acn_id, ACN_PACKET_IDENTIFIER, 12))
+    return false;
+
+  return true;
+}
+
+
+} // TCP
+} // RLP
+} // ACN

libESTA/acn/rlp-tcp.h

@@ -0,0 +1,55 @@
+/*
+  rlp-tcp.h
+
+  Copyright (c) 2021 Kevin Matz (kevin.matz@gmail.com)
+
+  Permission is hereby granted, free of charge, to any person obtaining a copy
+  of this software and associated documentation files (the "Software"), to deal
+  in the Software without restriction, including without limitation the rights
+  to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+  copies of the Software, and to permit persons to whom the Software is
+  furnished to do so, subject to the following conditions:
+
+  The above copyright notice and this permission notice shall be included in all
+  copies or substantial portions of the Software.
+
+  THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+  IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+  FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+  AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+  LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+  OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+  SOFTWARE.
+*/
+#pragma once
+
+#include <cstdint>
+#include "rlp.h"
+#include "pdu.h"
+
+// EPI 33. ACN Root Layer Protocol Operation on TCP
+
+namespace ACN {
+namespace RLP {
+namespace TCP {
+
+// 3. Frame Preamble Format
+struct preamble_t {
+  uint8_t  acn_id[12];    // 3.1 Packet Identifier
+  uint32_t length;        // 3.2 PDU Block Size
+  preamble_t(PDU::Stream);
+  operator bool();
+};
+
+// 3.1 Packet Identifier
+// The ACN Packet Identifier shall be the text string
+// “ASC-E1.17\0\0\0” encoded in [ASCII].
+static constexpr uint8_t ACN_PACKET_IDENTIFIER[] = { 0x41, 0x53, 0x43, 0x2d, 0x45, 0x31, 0x2e, 0x31, 0x37, 0x00, 0x00, 0x00 };
+
+// 3.2 PDU Block Size
+static const uint32_t INDEFINITE = 0xffffffff;
+
+
+} // TCP
+} // RLP
+} // ACN