Alexei Frolov | 5d6d392 | 2020-05-08 13:57:02 -0700 | [diff] [blame] | 1 | // Copyright 2020 The Pigweed Authors |
| 2 | // |
| 3 | // Licensed under the Apache License, Version 2.0 (the "License"); you may not |
| 4 | // use this file except in compliance with the License. You may obtain a copy of |
| 5 | // the License at |
| 6 | // |
| 7 | // https://www.apache.org/licenses/LICENSE-2.0 |
| 8 | // |
| 9 | // Unless required by applicable law or agreed to in writing, software |
| 10 | // distributed under the License is distributed on an "AS IS" BASIS, WITHOUT |
| 11 | // WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the |
| 12 | // License for the specific language governing permissions and limitations under |
| 13 | // the License. |
| 14 | |
| 15 | #include "pw_rpc/internal/packet.h" |
| 16 | |
| 17 | #include "gtest/gtest.h" |
Wyatt Hepler | 0f26235 | 2020-07-29 09:51:27 -0700 | [diff] [blame] | 18 | #include "pw_bytes/array.h" |
Wyatt Hepler | 142616c | 2020-06-01 10:16:04 -0700 | [diff] [blame] | 19 | #include "pw_protobuf/wire_format.h" |
Alexei Frolov | 5d6d392 | 2020-05-08 13:57:02 -0700 | [diff] [blame] | 20 | |
| 21 | namespace pw::rpc::internal { |
| 22 | namespace { |
| 23 | |
Alexei Frolov | 5ebf8ad | 2021-09-02 16:55:15 -0700 | [diff] [blame] | 24 | using protobuf::FieldKey; |
Alexei Frolov | 5d6d392 | 2020-05-08 13:57:02 -0700 | [diff] [blame] | 25 | using std::byte; |
| 26 | |
Wyatt Hepler | 0f26235 | 2020-07-29 09:51:27 -0700 | [diff] [blame] | 27 | constexpr auto kPayload = bytes::Array<0x82, 0x02, 0xff, 0xff>(); |
Wyatt Hepler | 142616c | 2020-06-01 10:16:04 -0700 | [diff] [blame] | 28 | |
Wyatt Hepler | 0f26235 | 2020-07-29 09:51:27 -0700 | [diff] [blame] | 29 | constexpr auto kEncoded = bytes::Array< |
Wyatt Hepler | 142616c | 2020-06-01 10:16:04 -0700 | [diff] [blame] | 30 | // Payload |
Alexei Frolov | 5ebf8ad | 2021-09-02 16:55:15 -0700 | [diff] [blame] | 31 | uint32_t(FieldKey(5, protobuf::WireType::kDelimited)), |
Wyatt Hepler | 0f26235 | 2020-07-29 09:51:27 -0700 | [diff] [blame] | 32 | 0x04, |
| 33 | 0x82, |
| 34 | 0x02, |
| 35 | 0xff, |
| 36 | 0xff, |
Wyatt Hepler | 142616c | 2020-06-01 10:16:04 -0700 | [diff] [blame] | 37 | |
| 38 | // Packet type |
Alexei Frolov | 5ebf8ad | 2021-09-02 16:55:15 -0700 | [diff] [blame] | 39 | uint32_t(FieldKey(1, protobuf::WireType::kVarint)), |
Wyatt Hepler | 0f26235 | 2020-07-29 09:51:27 -0700 | [diff] [blame] | 40 | 1, // RESPONSE |
Wyatt Hepler | 142616c | 2020-06-01 10:16:04 -0700 | [diff] [blame] | 41 | |
| 42 | // Channel ID |
Alexei Frolov | 5ebf8ad | 2021-09-02 16:55:15 -0700 | [diff] [blame] | 43 | uint32_t(FieldKey(2, protobuf::WireType::kVarint)), |
Wyatt Hepler | 0f26235 | 2020-07-29 09:51:27 -0700 | [diff] [blame] | 44 | 1, |
Wyatt Hepler | 142616c | 2020-06-01 10:16:04 -0700 | [diff] [blame] | 45 | |
| 46 | // Service ID |
Alexei Frolov | 5ebf8ad | 2021-09-02 16:55:15 -0700 | [diff] [blame] | 47 | uint32_t(FieldKey(3, protobuf::WireType::kFixed32)), |
Wyatt Hepler | 0f26235 | 2020-07-29 09:51:27 -0700 | [diff] [blame] | 48 | 42, |
| 49 | 0, |
| 50 | 0, |
| 51 | 0, |
Wyatt Hepler | 142616c | 2020-06-01 10:16:04 -0700 | [diff] [blame] | 52 | |
| 53 | // Method ID |
Alexei Frolov | 5ebf8ad | 2021-09-02 16:55:15 -0700 | [diff] [blame] | 54 | uint32_t(FieldKey(4, protobuf::WireType::kFixed32)), |
Wyatt Hepler | 0f26235 | 2020-07-29 09:51:27 -0700 | [diff] [blame] | 55 | 100, |
| 56 | 0, |
| 57 | 0, |
Wyatt Hepler | 5ba8064 | 2021-06-18 12:56:17 -0700 | [diff] [blame] | 58 | 0 |
Wyatt Hepler | 142616c | 2020-06-01 10:16:04 -0700 | [diff] [blame] | 59 | |
Wyatt Hepler | 5ba8064 | 2021-06-18 12:56:17 -0700 | [diff] [blame] | 60 | // Status (not encoded if it is zero) |
Alexei Frolov | 5ebf8ad | 2021-09-02 16:55:15 -0700 | [diff] [blame] | 61 | // FieldKey(6, protobuf::WireType::kVarint), |
Wyatt Hepler | 5ba8064 | 2021-06-18 12:56:17 -0700 | [diff] [blame] | 62 | // 0x00 |
| 63 | >(); |
Wyatt Hepler | 142616c | 2020-06-01 10:16:04 -0700 | [diff] [blame] | 64 | |
Wyatt Hepler | ba43a3c | 2020-08-13 12:45:25 -0700 | [diff] [blame] | 65 | // Test that a default-constructed packet sets its members to the default |
Wyatt Hepler | 8664c66 | 2020-08-12 18:40:48 -0700 | [diff] [blame] | 66 | // protobuf values. |
| 67 | static_assert(Packet().type() == PacketType{}); |
| 68 | static_assert(Packet().channel_id() == 0); |
| 69 | static_assert(Packet().service_id() == 0); |
| 70 | static_assert(Packet().method_id() == 0); |
| 71 | static_assert(Packet().status() == static_cast<Status::Code>(0)); |
| 72 | static_assert(Packet().payload().empty()); |
| 73 | |
Wyatt Hepler | 142616c | 2020-06-01 10:16:04 -0700 | [diff] [blame] | 74 | TEST(Packet, Encode) { |
| 75 | byte buffer[64]; |
| 76 | |
Wyatt Hepler | 0f26235 | 2020-07-29 09:51:27 -0700 | [diff] [blame] | 77 | Packet packet(PacketType::RESPONSE, 1, 42, 100, kPayload); |
Wyatt Hepler | 142616c | 2020-06-01 10:16:04 -0700 | [diff] [blame] | 78 | |
Alexei Frolov | 3f2d008 | 2020-10-04 22:30:39 -0700 | [diff] [blame] | 79 | auto result = packet.Encode(buffer); |
Wyatt Hepler | 1b3da3a | 2021-01-07 13:26:57 -0800 | [diff] [blame] | 80 | ASSERT_EQ(OkStatus(), result.status()); |
Alexei Frolov | 3f2d008 | 2020-10-04 22:30:39 -0700 | [diff] [blame] | 81 | ASSERT_EQ(kEncoded.size(), result.value().size()); |
Wyatt Hepler | 0f26235 | 2020-07-29 09:51:27 -0700 | [diff] [blame] | 82 | EXPECT_EQ(std::memcmp(kEncoded.data(), buffer, kEncoded.size()), 0); |
Wyatt Hepler | 142616c | 2020-06-01 10:16:04 -0700 | [diff] [blame] | 83 | } |
| 84 | |
Wyatt Hepler | 712d367 | 2020-07-13 15:52:11 -0700 | [diff] [blame] | 85 | TEST(Packet, Encode_BufferTooSmall) { |
| 86 | byte buffer[2]; |
| 87 | |
Wyatt Hepler | 0f26235 | 2020-07-29 09:51:27 -0700 | [diff] [blame] | 88 | Packet packet(PacketType::RESPONSE, 1, 42, 100, kPayload); |
Wyatt Hepler | 712d367 | 2020-07-13 15:52:11 -0700 | [diff] [blame] | 89 | |
Alexei Frolov | 3f2d008 | 2020-10-04 22:30:39 -0700 | [diff] [blame] | 90 | auto result = packet.Encode(buffer); |
| 91 | EXPECT_EQ(Status::ResourceExhausted(), result.status()); |
Wyatt Hepler | 712d367 | 2020-07-13 15:52:11 -0700 | [diff] [blame] | 92 | } |
| 93 | |
| 94 | TEST(Packet, Decode_ValidPacket) { |
Alexei Frolov | 3f2d008 | 2020-10-04 22:30:39 -0700 | [diff] [blame] | 95 | auto result = Packet::FromBuffer(kEncoded); |
| 96 | ASSERT_TRUE(result.ok()); |
Wyatt Hepler | 142616c | 2020-06-01 10:16:04 -0700 | [diff] [blame] | 97 | |
Alexei Frolov | 3f2d008 | 2020-10-04 22:30:39 -0700 | [diff] [blame] | 98 | auto& packet = result.value(); |
Wyatt Hepler | 0f26235 | 2020-07-29 09:51:27 -0700 | [diff] [blame] | 99 | EXPECT_EQ(PacketType::RESPONSE, packet.type()); |
Wyatt Hepler | 142616c | 2020-06-01 10:16:04 -0700 | [diff] [blame] | 100 | EXPECT_EQ(1u, packet.channel_id()); |
| 101 | EXPECT_EQ(42u, packet.service_id()); |
| 102 | EXPECT_EQ(100u, packet.method_id()); |
| 103 | ASSERT_EQ(sizeof(kPayload), packet.payload().size()); |
Wyatt Hepler | 0f26235 | 2020-07-29 09:51:27 -0700 | [diff] [blame] | 104 | EXPECT_EQ( |
| 105 | 0, |
| 106 | std::memcmp(packet.payload().data(), kPayload.data(), kPayload.size())); |
Wyatt Hepler | 142616c | 2020-06-01 10:16:04 -0700 | [diff] [blame] | 107 | } |
| 108 | |
Wyatt Hepler | 712d367 | 2020-07-13 15:52:11 -0700 | [diff] [blame] | 109 | TEST(Packet, Decode_InvalidPacket) { |
| 110 | byte bad_data[] = {byte{0xFF}, byte{0x00}, byte{0x00}, byte{0xFF}}; |
Alexei Frolov | 3f2d008 | 2020-10-04 22:30:39 -0700 | [diff] [blame] | 111 | EXPECT_EQ(Status::DataLoss(), Packet::FromBuffer(bad_data).status()); |
Wyatt Hepler | 712d367 | 2020-07-13 15:52:11 -0700 | [diff] [blame] | 112 | } |
| 113 | |
Alexei Frolov | 5d6d392 | 2020-05-08 13:57:02 -0700 | [diff] [blame] | 114 | TEST(Packet, EncodeDecode) { |
| 115 | constexpr byte payload[]{byte(0x00), byte(0x01), byte(0x02), byte(0x03)}; |
| 116 | |
Wyatt Hepler | 712d367 | 2020-07-13 15:52:11 -0700 | [diff] [blame] | 117 | Packet packet; |
Alexei Frolov | 5d6d392 | 2020-05-08 13:57:02 -0700 | [diff] [blame] | 118 | packet.set_channel_id(12); |
| 119 | packet.set_service_id(0xdeadbeef); |
| 120 | packet.set_method_id(0x03a82921); |
| 121 | packet.set_payload(payload); |
Wyatt Hepler | d78f7c6 | 2020-09-28 14:27:32 -0700 | [diff] [blame] | 122 | packet.set_status(Status::Unavailable()); |
Alexei Frolov | 5d6d392 | 2020-05-08 13:57:02 -0700 | [diff] [blame] | 123 | |
| 124 | byte buffer[128]; |
Alexei Frolov | 3f2d008 | 2020-10-04 22:30:39 -0700 | [diff] [blame] | 125 | Result result = packet.Encode(buffer); |
Wyatt Hepler | 1b3da3a | 2021-01-07 13:26:57 -0800 | [diff] [blame] | 126 | ASSERT_EQ(result.status(), OkStatus()); |
Alexei Frolov | 5d6d392 | 2020-05-08 13:57:02 -0700 | [diff] [blame] | 127 | |
Alexei Frolov | 3f2d008 | 2020-10-04 22:30:39 -0700 | [diff] [blame] | 128 | std::span<byte> packet_data(buffer, result.value().size()); |
| 129 | auto decode_result = Packet::FromBuffer(packet_data); |
| 130 | ASSERT_TRUE(decode_result.ok()); |
Alexei Frolov | 5d6d392 | 2020-05-08 13:57:02 -0700 | [diff] [blame] | 131 | |
Alexei Frolov | 3f2d008 | 2020-10-04 22:30:39 -0700 | [diff] [blame] | 132 | auto& decoded = decode_result.value(); |
Alexei Frolov | 5d6d392 | 2020-05-08 13:57:02 -0700 | [diff] [blame] | 133 | EXPECT_EQ(decoded.type(), packet.type()); |
| 134 | EXPECT_EQ(decoded.channel_id(), packet.channel_id()); |
| 135 | EXPECT_EQ(decoded.service_id(), packet.service_id()); |
| 136 | EXPECT_EQ(decoded.method_id(), packet.method_id()); |
| 137 | ASSERT_EQ(decoded.payload().size(), packet.payload().size()); |
| 138 | EXPECT_EQ(std::memcmp(decoded.payload().data(), |
| 139 | packet.payload().data(), |
| 140 | packet.payload().size()), |
| 141 | 0); |
Wyatt Hepler | d78f7c6 | 2020-09-28 14:27:32 -0700 | [diff] [blame] | 142 | EXPECT_EQ(decoded.status(), Status::Unavailable()); |
Alexei Frolov | 5d6d392 | 2020-05-08 13:57:02 -0700 | [diff] [blame] | 143 | } |
| 144 | |
Wyatt Hepler | 671946e | 2020-06-09 14:39:33 -0700 | [diff] [blame] | 145 | constexpr size_t kReservedSize = 2 /* type */ + 2 /* channel */ + |
Wyatt Hepler | 712d367 | 2020-07-13 15:52:11 -0700 | [diff] [blame] | 146 | 5 /* service */ + 5 /* method */ + |
Wyatt Hepler | 671946e | 2020-06-09 14:39:33 -0700 | [diff] [blame] | 147 | 2 /* payload key */ + 2 /* status */; |
Wyatt Hepler | 142616c | 2020-06-01 10:16:04 -0700 | [diff] [blame] | 148 | |
| 149 | TEST(Packet, PayloadUsableSpace_ExactFit) { |
Wyatt Hepler | 671946e | 2020-06-09 14:39:33 -0700 | [diff] [blame] | 150 | EXPECT_EQ(kReservedSize, |
Wyatt Hepler | 0f26235 | 2020-07-29 09:51:27 -0700 | [diff] [blame] | 151 | Packet(PacketType::RESPONSE, 1, 42, 100).MinEncodedSizeBytes()); |
Wyatt Hepler | 142616c | 2020-06-01 10:16:04 -0700 | [diff] [blame] | 152 | } |
| 153 | |
| 154 | TEST(Packet, PayloadUsableSpace_LargerVarints) { |
Wyatt Hepler | 0f26235 | 2020-07-29 09:51:27 -0700 | [diff] [blame] | 155 | EXPECT_EQ( |
| 156 | kReservedSize + 2 /* channel */, // service and method are Fixed32 |
| 157 | Packet(PacketType::RESPONSE, 17000, 200, 200).MinEncodedSizeBytes()); |
Wyatt Hepler | 142616c | 2020-06-01 10:16:04 -0700 | [diff] [blame] | 158 | } |
| 159 | |
Alexei Frolov | 5d6d392 | 2020-05-08 13:57:02 -0700 | [diff] [blame] | 160 | } // namespace |
| 161 | } // namespace pw::rpc::internal |