blob: 046f7c154aab873b15d1392fa015d0181ab7c758 [file] [log] [blame]
John Park398c74a2018-10-20 21:17:39 -07001#include "aos/configuration.h"
Brian Silverman66f079a2013-08-26 16:24:30 -07002
Brian Silverman66f079a2013-08-26 16:24:30 -07003#include <arpa/inet.h>
4#include <ifaddrs.h>
Austin Schuhf1fff282020-03-28 16:57:32 -07005#include <netinet/in.h>
Austin Schuhf1fff282020-03-28 16:57:32 -07006#include <sys/types.h>
Brian Silverman66f079a2013-08-26 16:24:30 -07007#include <unistd.h>
Austin Schuhe84c3ed2019-12-14 15:29:48 -08008
Tyler Chatowbf0609c2021-07-31 16:13:27 -07009#include <cstdlib>
10#include <cstring>
Austin Schuh68d98592020-11-01 23:22:57 -080011#include <map>
Austin Schuhe84c3ed2019-12-14 15:29:48 -080012#include <set>
Austin Schuhef38cd22021-07-21 15:24:23 -070013#include <string>
James Kuszmaul3ae42262019-11-08 12:33:41 -080014#include <string_view>
Austin Schuhef38cd22021-07-21 15:24:23 -070015#include <vector>
Brian Silverman66f079a2013-08-26 16:24:30 -070016
Austin Schuhcb108412019-10-13 16:09:54 -070017#include "absl/container/btree_set.h"
Austin Schuha81454b2020-05-12 19:58:36 -070018#include "absl/strings/str_cat.h"
Austin Schuhef38cd22021-07-21 15:24:23 -070019#include "absl/strings/str_join.h"
20#include "absl/strings/str_split.h"
Austin Schuhcb108412019-10-13 16:09:54 -070021#include "aos/configuration_generated.h"
22#include "aos/flatbuffer_merge.h"
23#include "aos/json_to_flatbuffer.h"
Austin Schuh217a9782019-12-21 23:02:50 -080024#include "aos/network/team_number.h"
Austin Schuhcb108412019-10-13 16:09:54 -070025#include "aos/unique_malloc_ptr.h"
26#include "aos/util/file.h"
Austin Schuh217a9782019-12-21 23:02:50 -080027#include "gflags/gflags.h"
Austin Schuhcb108412019-10-13 16:09:54 -070028#include "glog/logging.h"
Austin Schuh217a9782019-12-21 23:02:50 -080029
Brian Silverman66f079a2013-08-26 16:24:30 -070030namespace aos {
Austin Schuh15182322020-10-10 15:25:21 -070031namespace {
32bool EndsWith(std::string_view str, std::string_view end) {
33 if (str.size() < end.size()) {
34 return false;
35 }
36 if (str.substr(str.size() - end.size(), end.size()) != end) {
37 return false;
38 }
39 return true;
40}
41
42std::string MaybeReplaceExtension(std::string_view filename,
43 std::string_view extension,
44 std::string_view replacement) {
45 if (!EndsWith(filename, extension)) {
46 return std::string(filename);
47 }
48 filename.remove_suffix(extension.size());
49 return absl::StrCat(filename, replacement);
50}
51
52FlatbufferDetachedBuffer<Configuration> ReadConfigFile(std::string_view path,
53 bool binary) {
54 if (binary) {
55 FlatbufferVector<Configuration> config =
56 FileToFlatbuffer<Configuration>(path);
57 return CopySpanAsDetachedBuffer(config.span());
58 }
59
60 flatbuffers::DetachedBuffer buffer = JsonToFlatbuffer(
61 util::ReadFileToStringOrDie(path), ConfigurationTypeTable());
62
63 CHECK_GT(buffer.size(), 0u) << ": Failed to parse JSON file";
64
65 return FlatbufferDetachedBuffer<Configuration>(std::move(buffer));
66}
67
68} // namespace
Austin Schuhcb108412019-10-13 16:09:54 -070069
Austin Schuh40485ed2019-10-26 21:51:44 -070070// Define the compare and equal operators for Channel and Application so we can
Austin Schuhcb108412019-10-13 16:09:54 -070071// insert them in the btree below.
Austin Schuh40485ed2019-10-26 21:51:44 -070072bool operator<(const FlatbufferDetachedBuffer<Channel> &lhs,
73 const FlatbufferDetachedBuffer<Channel> &rhs) {
Austin Schuhcb108412019-10-13 16:09:54 -070074 int name_compare = lhs.message().name()->string_view().compare(
75 rhs.message().name()->string_view());
76 if (name_compare == 0) {
77 return lhs.message().type()->string_view() <
78 rhs.message().type()->string_view();
79 } else if (name_compare < 0) {
80 return true;
81 } else {
82 return false;
83 }
84}
85
Austin Schuh40485ed2019-10-26 21:51:44 -070086bool operator==(const FlatbufferDetachedBuffer<Channel> &lhs,
87 const FlatbufferDetachedBuffer<Channel> &rhs) {
Austin Schuhcb108412019-10-13 16:09:54 -070088 return lhs.message().name()->string_view() ==
89 rhs.message().name()->string_view() &&
90 lhs.message().type()->string_view() ==
91 rhs.message().type()->string_view();
92}
93
Austin Schuha7996eb2021-10-11 19:03:24 -070094bool operator<(const FlatbufferDetachedBuffer<Connection> &lhs,
95 const FlatbufferDetachedBuffer<Connection> &rhs) {
96 return lhs.message().name()->string_view() <
97 rhs.message().name()->string_view();
98}
99
100bool operator==(const FlatbufferDetachedBuffer<Connection> &lhs,
101 const FlatbufferDetachedBuffer<Connection> &rhs) {
102 return lhs.message().name()->string_view() ==
103 rhs.message().name()->string_view();
104}
105
Austin Schuh40485ed2019-10-26 21:51:44 -0700106bool operator==(const FlatbufferDetachedBuffer<Application> &lhs,
107 const FlatbufferDetachedBuffer<Application> &rhs) {
Austin Schuhcb108412019-10-13 16:09:54 -0700108 return lhs.message().name()->string_view() ==
109 rhs.message().name()->string_view();
110}
111
Austin Schuh40485ed2019-10-26 21:51:44 -0700112bool operator<(const FlatbufferDetachedBuffer<Application> &lhs,
113 const FlatbufferDetachedBuffer<Application> &rhs) {
Austin Schuhcb108412019-10-13 16:09:54 -0700114 return lhs.message().name()->string_view() <
115 rhs.message().name()->string_view();
116}
117
Austin Schuh217a9782019-12-21 23:02:50 -0800118bool operator==(const FlatbufferDetachedBuffer<Node> &lhs,
119 const FlatbufferDetachedBuffer<Node> &rhs) {
120 return lhs.message().name()->string_view() ==
121 rhs.message().name()->string_view();
122}
123
124bool operator<(const FlatbufferDetachedBuffer<Node> &lhs,
125 const FlatbufferDetachedBuffer<Node> &rhs) {
126 return lhs.message().name()->string_view() <
127 rhs.message().name()->string_view();
128}
129
Brian Silverman66f079a2013-08-26 16:24:30 -0700130namespace configuration {
131namespace {
132
Austin Schuhcb108412019-10-13 16:09:54 -0700133// Extracts the folder part of a path. Returns ./ if there is no path.
Austin Schuhf1fff282020-03-28 16:57:32 -0700134std::string_view ExtractFolder(const std::string_view filename) {
Austin Schuhcb108412019-10-13 16:09:54 -0700135 auto last_slash_pos = filename.find_last_of("/\\");
136
James Kuszmaul3ae42262019-11-08 12:33:41 -0800137 return last_slash_pos == std::string_view::npos
138 ? std::string_view("./")
Austin Schuhcb108412019-10-13 16:09:54 -0700139 : filename.substr(0, last_slash_pos + 1);
140}
141
James Kuszmaulc0c08da2020-05-10 18:56:07 -0700142std::string AbsolutePath(const std::string_view filename) {
143 // Uses an std::string so that we know the input will be null-terminated.
144 const std::string terminated_file(filename);
145 char buffer[PATH_MAX];
146 PCHECK(NULL != realpath(terminated_file.c_str(), buffer));
147 return buffer;
148}
149
Austin Schuhef38cd22021-07-21 15:24:23 -0700150std::string RemoveDotDots(const std::string_view filename) {
151 std::vector<std::string> split = absl::StrSplit(filename, '/');
152 auto iterator = split.begin();
153 while (iterator != split.end()) {
154 if (iterator->empty()) {
155 iterator = split.erase(iterator);
156 } else if (*iterator == ".") {
157 iterator = split.erase(iterator);
158 } else if (*iterator == "..") {
159 CHECK(iterator != split.begin())
160 << ": Import path may not start with ..: " << filename;
161 auto previous = iterator;
162 --previous;
163 split.erase(iterator);
164 iterator = split.erase(previous);
165 } else {
166 ++iterator;
167 }
168 }
169 return absl::StrJoin(split, "/");
170}
171
Austin Schuh40485ed2019-10-26 21:51:44 -0700172FlatbufferDetachedBuffer<Configuration> ReadConfig(
James Kuszmaulc0c08da2020-05-10 18:56:07 -0700173 const std::string_view path, absl::btree_set<std::string> *visited_paths,
174 const std::vector<std::string_view> &extra_import_paths) {
Austin Schuh15182322020-10-10 15:25:21 -0700175 std::string binary_path = MaybeReplaceExtension(path, ".json", ".bfbs");
Austin Schuhef38cd22021-07-21 15:24:23 -0700176 VLOG(1) << "Looking up: " << path << ", starting with: " << binary_path;
Austin Schuh15182322020-10-10 15:25:21 -0700177 bool binary_path_exists = util::PathExists(binary_path);
James Kuszmaulc0c08da2020-05-10 18:56:07 -0700178 std::string raw_path(path);
Austin Schuh15182322020-10-10 15:25:21 -0700179 // For each .json file, look and see if we can find a .bfbs file next to it
180 // with the same base name. If we can, assume it is the same and use it
181 // instead. It is much faster to load .bfbs files than .json files.
182 if (!binary_path_exists && !util::PathExists(raw_path)) {
183 const bool path_is_absolute = raw_path.size() > 0 && raw_path[0] == '/';
James Kuszmaulc0c08da2020-05-10 18:56:07 -0700184 if (path_is_absolute) {
185 CHECK(extra_import_paths.empty())
186 << "Can't specify extra import paths if attempting to read a config "
187 "file from an absolute path (path is "
Austin Schuh15182322020-10-10 15:25:21 -0700188 << raw_path << ").";
James Kuszmaulc0c08da2020-05-10 18:56:07 -0700189 }
190
191 bool found_path = false;
192 for (const auto &import_path : extra_import_paths) {
Austin Schuhef38cd22021-07-21 15:24:23 -0700193 raw_path = std::string(import_path) + "/" + RemoveDotDots(path);
Austin Schuh15182322020-10-10 15:25:21 -0700194 binary_path = MaybeReplaceExtension(raw_path, ".json", ".bfbs");
Austin Schuhef38cd22021-07-21 15:24:23 -0700195 VLOG(1) << "Checking: " << binary_path;
Austin Schuh15182322020-10-10 15:25:21 -0700196 binary_path_exists = util::PathExists(binary_path);
197 if (binary_path_exists) {
198 found_path = true;
199 break;
200 }
Austin Schuhef38cd22021-07-21 15:24:23 -0700201 VLOG(1) << "Checking: " << raw_path;
James Kuszmaulc0c08da2020-05-10 18:56:07 -0700202 if (util::PathExists(raw_path)) {
203 found_path = true;
204 break;
205 }
206 }
207 CHECK(found_path) << ": Failed to find file " << path << ".";
208 }
Alex Perrycb7da4b2019-08-28 19:35:56 -0700209
Austin Schuh15182322020-10-10 15:25:21 -0700210 FlatbufferDetachedBuffer<Configuration> config = ReadConfigFile(
211 binary_path_exists ? binary_path : raw_path, binary_path_exists);
James Kuszmaulc0c08da2020-05-10 18:56:07 -0700212
Austin Schuhcb108412019-10-13 16:09:54 -0700213 // Depth first. Take the following example:
214 //
215 // config1.json:
216 // {
Austin Schuh40485ed2019-10-26 21:51:44 -0700217 // "channels": [
Austin Schuhcb108412019-10-13 16:09:54 -0700218 // {
219 // "name": "/foo",
220 // "type": ".aos.bar",
221 // "max_size": 5
222 // }
223 // ],
224 // "imports": [
225 // "config2.json",
226 // ]
227 // }
228 //
229 // config2.json:
230 // {
Austin Schuh40485ed2019-10-26 21:51:44 -0700231 // "channels": [
Austin Schuhcb108412019-10-13 16:09:54 -0700232 // {
233 // "name": "/foo",
234 // "type": ".aos.bar",
235 // "max_size": 7
236 // }
237 // ],
238 // }
239 //
240 // We want the main config (config1.json) to be able to override the imported
241 // config. That means that it needs to be merged into the imported configs,
242 // not the other way around.
243
Austin Schuh15182322020-10-10 15:25:21 -0700244 const std::string absolute_path =
245 AbsolutePath(binary_path_exists ? binary_path : raw_path);
246 // Track that we have seen this file before recursing. Track the path we
247 // actually loaded (which should be consistent if imported twice).
James Kuszmaulc0c08da2020-05-10 18:56:07 -0700248 if (!visited_paths->insert(absolute_path).second) {
249 for (const auto &visited_path : *visited_paths) {
250 LOG(INFO) << "Already visited: " << visited_path;
251 }
252 LOG(FATAL)
253 << "Already imported " << path << " (i.e. " << absolute_path
254 << "). See above for the files that have already been processed.";
255 }
Austin Schuhcb108412019-10-13 16:09:54 -0700256
257 if (config.message().has_imports()) {
258 // Capture the imports.
259 const flatbuffers::Vector<flatbuffers::Offset<flatbuffers::String>> *v =
260 config.message().imports();
261
262 // And then wipe them. This gets GCed when we merge later.
263 config.mutable_message()->clear_imports();
264
265 // Start with an empty configuration to merge into.
Austin Schuh40485ed2019-10-26 21:51:44 -0700266 FlatbufferDetachedBuffer<Configuration> merged_config =
267 FlatbufferDetachedBuffer<Configuration>::Empty();
Austin Schuhcb108412019-10-13 16:09:54 -0700268
James Kuszmaulc0c08da2020-05-10 18:56:07 -0700269 const std::string path_folder(ExtractFolder(path));
Austin Schuhcb108412019-10-13 16:09:54 -0700270 for (const flatbuffers::String *str : *v) {
James Kuszmaulc0c08da2020-05-10 18:56:07 -0700271 const std::string included_config =
272 path_folder + "/" + std::string(str->string_view());
Austin Schuhcb108412019-10-13 16:09:54 -0700273
274 // And them merge everything in.
275 merged_config = MergeFlatBuffers(
James Kuszmaulc0c08da2020-05-10 18:56:07 -0700276 merged_config,
277 ReadConfig(included_config, visited_paths, extra_import_paths));
Austin Schuhcb108412019-10-13 16:09:54 -0700278 }
279
280 // Finally, merge this file in.
281 config = MergeFlatBuffers(merged_config, config);
282 }
283 return config;
284}
285
Alex Perrycb7da4b2019-08-28 19:35:56 -0700286// Compares (c < p) a channel, and a name, type tuple.
287bool CompareChannels(const Channel *c,
James Kuszmaul3ae42262019-11-08 12:33:41 -0800288 ::std::pair<std::string_view, std::string_view> p) {
Alex Perrycb7da4b2019-08-28 19:35:56 -0700289 int name_compare = c->name()->string_view().compare(p.first);
290 if (name_compare == 0) {
291 return c->type()->string_view() < p.second;
292 } else if (name_compare < 0) {
293 return true;
294 } else {
295 return false;
296 }
297};
298
299// Compares for equality (c == p) a channel, and a name, type tuple.
300bool EqualsChannels(const Channel *c,
Austin Schuhf1fff282020-03-28 16:57:32 -0700301 ::std::pair<std::string_view, std::string_view> p) {
Alex Perrycb7da4b2019-08-28 19:35:56 -0700302 return c->name()->string_view() == p.first &&
303 c->type()->string_view() == p.second;
304}
305
306// Compares (c < p) an application, and a name;
James Kuszmaul3ae42262019-11-08 12:33:41 -0800307bool CompareApplications(const Application *a, std::string_view name) {
Alex Perrycb7da4b2019-08-28 19:35:56 -0700308 return a->name()->string_view() < name;
309};
310
311// Compares for equality (c == p) an application, and a name;
James Kuszmaul3ae42262019-11-08 12:33:41 -0800312bool EqualsApplications(const Application *a, std::string_view name) {
Alex Perrycb7da4b2019-08-28 19:35:56 -0700313 return a->name()->string_view() == name;
314}
315
Austin Schuh15182322020-10-10 15:25:21 -0700316void ValidateConfiguration(const Flatbuffer<Configuration> &config) {
317 // No imports should be left.
318 CHECK(!config.message().has_imports());
319
320 // Check that if there is a node list, all the source nodes are filled out and
321 // valid, and all the destination nodes are valid (and not the source). This
322 // is a basic consistency check.
323 if (config.message().has_channels()) {
324 const Channel *last_channel = nullptr;
325 for (const Channel *c : *config.message().channels()) {
326 CHECK(c->has_name());
327 CHECK(c->has_type());
328 if (c->name()->string_view().back() == '/') {
329 LOG(FATAL) << "Channel names can't end with '/'";
330 }
331 if (c->name()->string_view().find("//") != std::string_view::npos) {
332 LOG(FATAL) << ": Invalid channel name " << c->name()->string_view()
333 << ", can't use //.";
334 }
335 for (const char data : c->name()->string_view()) {
336 if (data >= '0' && data <= '9') {
337 continue;
338 }
339 if (data >= 'a' && data <= 'z') {
340 continue;
341 }
342 if (data >= 'A' && data <= 'Z') {
343 continue;
344 }
345 if (data == '-' || data == '_' || data == '/') {
346 continue;
347 }
348 LOG(FATAL) << "Invalid channel name " << c->name()->string_view()
349 << ", can only use [-a-zA-Z0-9_/]";
350 }
351
Austin Schuha156fb22021-10-11 19:23:21 -0700352 if (c->has_logger_nodes()) {
353 // Confirm that we don't have duplicate logger nodes.
354 absl::btree_set<std::string_view> logger_nodes;
355 for (const flatbuffers::String *s : *c->logger_nodes()) {
356 logger_nodes.insert(s->string_view());
357 }
358 CHECK_EQ(static_cast<size_t>(logger_nodes.size()),
359 c->logger_nodes()->size())
360 << ": Found duplicate logger_nodes in "
361 << CleanedChannelToString(c);
362 }
363
364 if (c->has_destination_nodes()) {
365 // Confirm that we don't have duplicate timestamp logger nodes.
Austin Schuh5e95bd62021-10-11 18:40:22 -0700366 for (const Connection *d : *c->destination_nodes()) {
Austin Schuha156fb22021-10-11 19:23:21 -0700367 if (d->has_timestamp_logger_nodes()) {
368 absl::btree_set<std::string_view> timestamp_logger_nodes;
369 for (const flatbuffers::String *s : *d->timestamp_logger_nodes()) {
370 timestamp_logger_nodes.insert(s->string_view());
371 }
372 CHECK_EQ(static_cast<size_t>(timestamp_logger_nodes.size()),
373 d->timestamp_logger_nodes()->size())
374 << ": Found duplicate timestamp_logger_nodes in "
375 << CleanedChannelToString(c);
376 }
377 }
378
379 // There is no good use case today for logging timestamps but not the
380 // corresponding data. Instead of plumbing through all of this on the
381 // reader side, let'd just disallow it for now.
382 if (c->logger() == LoggerConfig::NOT_LOGGED) {
383 for (const Connection *d : *c->destination_nodes()) {
384 CHECK(d->timestamp_logger() == LoggerConfig::NOT_LOGGED)
385 << ": Logging timestamps without data is not supported. If "
386 "you have a good use case, let's talk. "
387 << CleanedChannelToString(c);
388 }
Austin Schuh5e95bd62021-10-11 18:40:22 -0700389 }
390 }
391
Austin Schuh15182322020-10-10 15:25:21 -0700392 // Make sure everything is sorted while we are here... If this fails,
393 // there will be a bunch of weird errors.
394 if (last_channel != nullptr) {
395 CHECK(CompareChannels(
396 last_channel,
397 std::make_pair(c->name()->string_view(), c->type()->string_view())))
398 << ": Channels not sorted!";
399 }
400 last_channel = c;
401 }
402 }
403
404 if (config.message().has_nodes() && config.message().has_channels()) {
405 for (const Channel *c : *config.message().channels()) {
406 CHECK(c->has_source_node()) << ": Channel " << FlatbufferToJson(c)
407 << " is missing \"source_node\"";
408 CHECK(GetNode(&config.message(), c->source_node()->string_view()) !=
409 nullptr)
410 << ": Channel " << FlatbufferToJson(c)
411 << " has an unknown \"source_node\"";
412
413 if (c->has_destination_nodes()) {
414 for (const Connection *connection : *c->destination_nodes()) {
415 CHECK(connection->has_name());
416 CHECK(GetNode(&config.message(), connection->name()->string_view()) !=
417 nullptr)
418 << ": Channel " << FlatbufferToJson(c)
419 << " has an unknown \"destination_nodes\" "
420 << connection->name()->string_view();
421
422 switch (connection->timestamp_logger()) {
423 case LoggerConfig::LOCAL_LOGGER:
424 case LoggerConfig::NOT_LOGGED:
425 CHECK(!connection->has_timestamp_logger_nodes());
426 break;
427 case LoggerConfig::REMOTE_LOGGER:
428 case LoggerConfig::LOCAL_AND_REMOTE_LOGGER:
429 CHECK(connection->has_timestamp_logger_nodes());
430 CHECK_GT(connection->timestamp_logger_nodes()->size(), 0u);
431 for (const flatbuffers::String *timestamp_logger_node :
432 *connection->timestamp_logger_nodes()) {
433 CHECK(GetNode(&config.message(),
434 timestamp_logger_node->string_view()) != nullptr)
435 << ": Channel " << FlatbufferToJson(c)
436 << " has an unknown \"timestamp_logger_node\""
437 << connection->name()->string_view();
438 }
439 break;
440 }
441
442 CHECK_NE(connection->name()->string_view(),
443 c->source_node()->string_view())
444 << ": Channel " << FlatbufferToJson(c)
445 << " is forwarding data to itself";
446 }
447 }
448 }
449 }
450}
451
Alex Perrycb7da4b2019-08-28 19:35:56 -0700452} // namespace
453
Austin Schuh006a9f52021-04-07 16:24:18 -0700454// Maps name for the provided maps. Modifies name.
455void HandleMaps(const flatbuffers::Vector<flatbuffers::Offset<aos::Map>> *maps,
456 std::string *name, std::string_view type, const Node *node) {
457 // For the same reason we merge configs in reverse order, we want to process
458 // maps in reverse order. That lets the outer config overwrite channels from
459 // the inner configs.
460 for (auto i = maps->rbegin(); i != maps->rend(); ++i) {
461 if (!i->has_match() || !i->match()->has_name()) {
462 continue;
463 }
464 if (!i->has_rename() || !i->rename()->has_name()) {
465 continue;
466 }
467
468 // Handle normal maps (now that we know that match and rename are filled
469 // out).
470 const std::string_view match_name = i->match()->name()->string_view();
471 if (match_name != *name) {
472 if (match_name.back() == '*' &&
473 std::string_view(*name).substr(
474 0, std::min(name->size(), match_name.size() - 1)) ==
475 match_name.substr(0, match_name.size() - 1)) {
476 CHECK_EQ(match_name.find('*'), match_name.size() - 1);
477 } else {
478 continue;
479 }
480 }
481
482 // Handle type specific maps.
483 if (i->match()->has_type() && i->match()->type()->string_view() != type) {
484 continue;
485 }
486
487 // Now handle node specific maps.
488 if (node != nullptr && i->match()->has_source_node() &&
489 i->match()->source_node()->string_view() !=
490 node->name()->string_view()) {
491 continue;
492 }
493
494 std::string new_name(i->rename()->name()->string_view());
495 if (match_name.back() == '*') {
496 new_name += std::string(name->substr(match_name.size() - 1));
497 }
498 VLOG(1) << "Renamed \"" << *name << "\" to \"" << new_name << "\"";
499 *name = std::move(new_name);
500 }
501}
502
Austin Schuh40485ed2019-10-26 21:51:44 -0700503FlatbufferDetachedBuffer<Configuration> MergeConfiguration(
Austin Schuhcb108412019-10-13 16:09:54 -0700504 const Flatbuffer<Configuration> &config) {
James Kuszmaul3c998592020-07-27 21:04:47 -0700505 // auto_merge_config will contain all the fields of the Configuration that are
506 // to be passed through unmodified to the result of MergeConfiguration().
507 // In the processing below, we mutate auto_merge_config to remove any fields
508 // which we do need to alter (hence why we can't use the input config
509 // directly), and then merge auto_merge_config back in at the end.
510 aos::FlatbufferDetachedBuffer<aos::Configuration> auto_merge_config =
Austin Schuha4fc60f2020-11-01 23:06:47 -0800511 aos::RecursiveCopyFlatBuffer(&config.message());
James Kuszmaul3c998592020-07-27 21:04:47 -0700512
Austin Schuh40485ed2019-10-26 21:51:44 -0700513 // Store all the channels in a sorted set. This lets us track channels we
Austin Schuhcb108412019-10-13 16:09:54 -0700514 // have seen before and merge the updates in.
Austin Schuh40485ed2019-10-26 21:51:44 -0700515 absl::btree_set<FlatbufferDetachedBuffer<Channel>> channels;
Austin Schuhcb108412019-10-13 16:09:54 -0700516
Austin Schuh40485ed2019-10-26 21:51:44 -0700517 if (config.message().has_channels()) {
James Kuszmaul3c998592020-07-27 21:04:47 -0700518 auto_merge_config.mutable_message()->clear_channels();
Austin Schuh40485ed2019-10-26 21:51:44 -0700519 for (const Channel *c : *config.message().channels()) {
Austin Schuhcb108412019-10-13 16:09:54 -0700520 // Ignore malformed entries.
Austin Schuh40485ed2019-10-26 21:51:44 -0700521 if (!c->has_name()) {
Austin Schuhcb108412019-10-13 16:09:54 -0700522 continue;
523 }
Austin Schuh40485ed2019-10-26 21:51:44 -0700524 if (!c->has_type()) {
Austin Schuhcb108412019-10-13 16:09:54 -0700525 continue;
526 }
527
Brian Silverman77162972020-08-12 19:52:40 -0700528 CHECK_EQ(c->read_method() == ReadMethod::PIN, c->num_readers() != 0)
529 << ": num_readers may be set if and only if read_method is PIN,"
530 " if you want 0 readers do not set PIN: "
531 << CleanedChannelToString(c);
532
Austin Schuh40485ed2019-10-26 21:51:44 -0700533 // Attempt to insert the channel.
Austin Schuha4fc60f2020-11-01 23:06:47 -0800534 auto result = channels.insert(RecursiveCopyFlatBuffer(c));
Austin Schuhcb108412019-10-13 16:09:54 -0700535 if (!result.second) {
536 // Already there, so merge the new table into the original.
Austin Schuh4a5f5d22021-10-12 15:09:35 -0700537 // Schemas merge poorly, so pick the newest one.
538 if (result.first->message().has_schema() && c->has_schema()) {
539 result.first->mutable_message()->clear_schema();
540 }
Austin Schuha7996eb2021-10-11 19:03:24 -0700541 auto merged =
Austin Schuha4fc60f2020-11-01 23:06:47 -0800542 MergeFlatBuffers(*result.first, RecursiveCopyFlatBuffer(c));
Austin Schuha7996eb2021-10-11 19:03:24 -0700543
544 if (merged.message().has_destination_nodes()) {
545 absl::btree_set<FlatbufferDetachedBuffer<Connection>> connections;
546 for (const Connection *connection :
547 *merged.message().destination_nodes()) {
548 auto connection_result =
549 connections.insert(RecursiveCopyFlatBuffer(connection));
550 if (!connection_result.second) {
551 *connection_result.first =
552 MergeFlatBuffers(*connection_result.first,
553 RecursiveCopyFlatBuffer(connection));
554 }
555 }
556 if (static_cast<size_t>(connections.size()) !=
557 merged.message().destination_nodes()->size()) {
558 merged.mutable_message()->clear_destination_nodes();
559 flatbuffers::FlatBufferBuilder fbb;
560 fbb.ForceDefaults(true);
561 std::vector<flatbuffers::Offset<Connection>> connection_offsets;
562 for (const FlatbufferDetachedBuffer<Connection> &connection :
563 connections) {
564 connection_offsets.push_back(
565 RecursiveCopyFlatBuffer(&connection.message(), &fbb));
566 }
567 flatbuffers::Offset<
568 flatbuffers::Vector<flatbuffers::Offset<Connection>>>
569 destination_nodes_offset = fbb.CreateVector(connection_offsets);
570 Channel::Builder channel_builder(fbb);
571 channel_builder.add_destination_nodes(destination_nodes_offset);
572 fbb.Finish(channel_builder.Finish());
573 FlatbufferDetachedBuffer<Channel> destinations_channel(
574 fbb.Release());
575 merged = MergeFlatBuffers(merged, destinations_channel);
576 }
577 }
578
579 *result.first = std::move(merged);
Austin Schuhcb108412019-10-13 16:09:54 -0700580 }
581 }
582 }
583
584 // Now repeat this for the application list.
Austin Schuh40485ed2019-10-26 21:51:44 -0700585 absl::btree_set<FlatbufferDetachedBuffer<Application>> applications;
Austin Schuhcb108412019-10-13 16:09:54 -0700586 if (config.message().has_applications()) {
James Kuszmaul3c998592020-07-27 21:04:47 -0700587 auto_merge_config.mutable_message()->clear_applications();
Austin Schuhcb108412019-10-13 16:09:54 -0700588 for (const Application *a : *config.message().applications()) {
589 if (!a->has_name()) {
590 continue;
591 }
592
Austin Schuha4fc60f2020-11-01 23:06:47 -0800593 auto result = applications.insert(RecursiveCopyFlatBuffer(a));
Austin Schuhcb108412019-10-13 16:09:54 -0700594 if (!result.second) {
Austin Schuha4fc60f2020-11-01 23:06:47 -0800595 *result.first =
596 MergeFlatBuffers(*result.first, RecursiveCopyFlatBuffer(a));
Austin Schuhcb108412019-10-13 16:09:54 -0700597 }
598 }
599 }
600
Austin Schuh217a9782019-12-21 23:02:50 -0800601 // Now repeat this for the node list.
602 absl::btree_set<FlatbufferDetachedBuffer<Node>> nodes;
603 if (config.message().has_nodes()) {
James Kuszmaul3c998592020-07-27 21:04:47 -0700604 auto_merge_config.mutable_message()->clear_nodes();
Austin Schuh217a9782019-12-21 23:02:50 -0800605 for (const Node *n : *config.message().nodes()) {
606 if (!n->has_name()) {
607 continue;
608 }
609
Austin Schuha4fc60f2020-11-01 23:06:47 -0800610 auto result = nodes.insert(RecursiveCopyFlatBuffer(n));
Austin Schuh217a9782019-12-21 23:02:50 -0800611 if (!result.second) {
Austin Schuha4fc60f2020-11-01 23:06:47 -0800612 *result.first =
613 MergeFlatBuffers(*result.first, RecursiveCopyFlatBuffer(n));
Austin Schuh217a9782019-12-21 23:02:50 -0800614 }
615 }
616 }
617
Austin Schuhcb108412019-10-13 16:09:54 -0700618 flatbuffers::FlatBufferBuilder fbb;
Austin Schuhd7b15da2020-02-17 15:06:11 -0800619 fbb.ForceDefaults(true);
Austin Schuhcb108412019-10-13 16:09:54 -0700620
621 // Start by building the vectors. They need to come before the final table.
Austin Schuh40485ed2019-10-26 21:51:44 -0700622 // Channels
623 flatbuffers::Offset<flatbuffers::Vector<flatbuffers::Offset<Channel>>>
624 channels_offset;
Austin Schuhcb108412019-10-13 16:09:54 -0700625 {
Austin Schuh40485ed2019-10-26 21:51:44 -0700626 ::std::vector<flatbuffers::Offset<Channel>> channel_offsets;
627 for (const FlatbufferDetachedBuffer<Channel> &c : channels) {
Austin Schuha4fc60f2020-11-01 23:06:47 -0800628 channel_offsets.emplace_back(
629 RecursiveCopyFlatBuffer<Channel>(&c.message(), &fbb));
Austin Schuhcb108412019-10-13 16:09:54 -0700630 }
Austin Schuh40485ed2019-10-26 21:51:44 -0700631 channels_offset = fbb.CreateVector(channel_offsets);
Austin Schuhcb108412019-10-13 16:09:54 -0700632 }
633
634 // Applications
635 flatbuffers::Offset<flatbuffers::Vector<flatbuffers::Offset<Application>>>
636 applications_offset;
637 {
638 ::std::vector<flatbuffers::Offset<Application>> applications_offsets;
Austin Schuh40485ed2019-10-26 21:51:44 -0700639 for (const FlatbufferDetachedBuffer<Application> &a : applications) {
Austin Schuhcb108412019-10-13 16:09:54 -0700640 applications_offsets.emplace_back(
Austin Schuha4fc60f2020-11-01 23:06:47 -0800641 RecursiveCopyFlatBuffer<Application>(&a.message(), &fbb));
Austin Schuhcb108412019-10-13 16:09:54 -0700642 }
643 applications_offset = fbb.CreateVector(applications_offsets);
644 }
645
Austin Schuh217a9782019-12-21 23:02:50 -0800646 // Nodes
647 flatbuffers::Offset<flatbuffers::Vector<flatbuffers::Offset<Node>>>
648 nodes_offset;
649 {
650 ::std::vector<flatbuffers::Offset<Node>> node_offsets;
651 for (const FlatbufferDetachedBuffer<Node> &n : nodes) {
Austin Schuha4fc60f2020-11-01 23:06:47 -0800652 node_offsets.emplace_back(
653 RecursiveCopyFlatBuffer<Node>(&n.message(), &fbb));
Austin Schuh217a9782019-12-21 23:02:50 -0800654 }
655 nodes_offset = fbb.CreateVector(node_offsets);
656 }
657
Austin Schuhcb108412019-10-13 16:09:54 -0700658 // And then build a Configuration with them all.
659 ConfigurationBuilder configuration_builder(fbb);
Austin Schuh40485ed2019-10-26 21:51:44 -0700660 configuration_builder.add_channels(channels_offset);
Austin Schuh217a9782019-12-21 23:02:50 -0800661 if (config.message().has_applications()) {
662 configuration_builder.add_applications(applications_offset);
663 }
664 if (config.message().has_nodes()) {
665 configuration_builder.add_nodes(nodes_offset);
666 }
Austin Schuhcb108412019-10-13 16:09:54 -0700667
668 fbb.Finish(configuration_builder.Finish());
Austin Schuh217a9782019-12-21 23:02:50 -0800669
James Kuszmaul3c998592020-07-27 21:04:47 -0700670 aos::FlatbufferDetachedBuffer<aos::Configuration> modified_config(
671 fbb.Release());
672
Austin Schuh217a9782019-12-21 23:02:50 -0800673 // Now, validate that if there is a node list, every channel has a source
674 // node.
James Kuszmaul3c998592020-07-27 21:04:47 -0700675 FlatbufferDetachedBuffer<Configuration> result =
676 MergeFlatBuffers(modified_config, auto_merge_config);
Austin Schuh217a9782019-12-21 23:02:50 -0800677
Austin Schuh15182322020-10-10 15:25:21 -0700678 ValidateConfiguration(result);
Austin Schuh217a9782019-12-21 23:02:50 -0800679
680 return result;
Austin Schuhcb108412019-10-13 16:09:54 -0700681}
682
Austin Schuh40485ed2019-10-26 21:51:44 -0700683FlatbufferDetachedBuffer<Configuration> ReadConfig(
James Kuszmaulc0c08da2020-05-10 18:56:07 -0700684 const std::string_view path,
Austin Schuhef38cd22021-07-21 15:24:23 -0700685 const std::vector<std::string_view> &extra_import_paths) {
Austin Schuhcb108412019-10-13 16:09:54 -0700686 // We only want to read a file once. So track the visited files in a set.
687 absl::btree_set<std::string> visited_paths;
Austin Schuh15182322020-10-10 15:25:21 -0700688 FlatbufferDetachedBuffer<Configuration> read_config =
Austin Schuhef38cd22021-07-21 15:24:23 -0700689 ReadConfig(path, &visited_paths, extra_import_paths);
Austin Schuh15182322020-10-10 15:25:21 -0700690
691 // If we only read one file, and it had a .bfbs extension, it has to be a
692 // fully formatted config. Do a quick verification and return it.
693 if (visited_paths.size() == 1 && EndsWith(*visited_paths.begin(), ".bfbs")) {
694 ValidateConfiguration(read_config);
695 return read_config;
696 }
697
698 return MergeConfiguration(read_config);
Austin Schuhcb108412019-10-13 16:09:54 -0700699}
700
Austin Schuh8d6cea82020-02-28 12:17:16 -0800701FlatbufferDetachedBuffer<Configuration> MergeWithConfig(
Brian Silverman24f5aa82020-06-23 16:21:28 -0700702 const Configuration *config, const Flatbuffer<Configuration> &addition) {
703 return MergeConfiguration(MergeFlatBuffers(config, &addition.message()));
704}
705
706FlatbufferDetachedBuffer<Configuration> MergeWithConfig(
Austin Schuh8d6cea82020-02-28 12:17:16 -0800707 const Configuration *config, std::string_view json) {
708 FlatbufferDetachedBuffer<Configuration> addition =
709 JsonToFlatbuffer(json, Configuration::MiniReflectTypeTable());
710
Brian Silverman24f5aa82020-06-23 16:21:28 -0700711 return MergeWithConfig(config, addition);
Austin Schuh8d6cea82020-02-28 12:17:16 -0800712}
713
James Kuszmaul3ae42262019-11-08 12:33:41 -0800714const Channel *GetChannel(const Configuration *config, std::string_view name,
715 std::string_view type,
Austin Schuh0de30f32020-12-06 12:44:28 -0800716 std::string_view application_name, const Node *node,
717 bool quiet) {
Brian Silverman9fcf2c72020-12-21 18:30:58 -0800718 if (!config->has_channels()) {
719 return nullptr;
720 }
721
Austin Schuhbca6cf02019-12-22 17:28:34 -0800722 const std::string_view original_name = name;
Austin Schuhf1fff282020-03-28 16:57:32 -0700723 std::string mutable_name;
Austin Schuh4c3b9702020-08-30 11:34:55 -0700724 if (node != nullptr) {
725 VLOG(1) << "Looking up { \"name\": \"" << name << "\", \"type\": \"" << type
726 << "\" } on " << aos::FlatbufferToJson(node);
727 } else {
728 VLOG(1) << "Looking up { \"name\": \"" << name << "\", \"type\": \"" << type
729 << "\" }";
730 }
Austin Schuhcb108412019-10-13 16:09:54 -0700731
732 // First handle application specific maps. Only do this if we have a matching
733 // application name, and it has maps.
Austin Schuhd2e2f6a2021-02-07 20:46:16 -0800734 {
735 const Application *application =
736 GetApplication(config, node, application_name);
737 if (application != nullptr && application->has_maps()) {
738 mutable_name = std::string(name);
739 HandleMaps(application->maps(), &mutable_name, type, node);
740 name = std::string_view(mutable_name);
Austin Schuhcb108412019-10-13 16:09:54 -0700741 }
742 }
743
744 // Now do global maps.
Austin Schuh40485ed2019-10-26 21:51:44 -0700745 if (config->has_maps()) {
Austin Schuhf1fff282020-03-28 16:57:32 -0700746 mutable_name = std::string(name);
747 HandleMaps(config->maps(), &mutable_name, type, node);
748 name = std::string_view(mutable_name);
Austin Schuhcb108412019-10-13 16:09:54 -0700749 }
750
Austin Schuhbca6cf02019-12-22 17:28:34 -0800751 if (original_name != name) {
752 VLOG(1) << "Remapped to { \"name\": \"" << name << "\", \"type\": \""
753 << type << "\" }";
754 }
Alex Perrycb7da4b2019-08-28 19:35:56 -0700755
James Kuszmaul71a81932020-12-15 21:08:01 -0800756 // Then look for the channel (note that this relies on the channels being
757 // sorted in the config).
Austin Schuh40485ed2019-10-26 21:51:44 -0700758 auto channel_iterator =
Austin Schuhf1fff282020-03-28 16:57:32 -0700759 std::lower_bound(config->channels()->cbegin(), config->channels()->cend(),
Austin Schuh40485ed2019-10-26 21:51:44 -0700760 std::make_pair(name, type), CompareChannels);
Austin Schuhcb108412019-10-13 16:09:54 -0700761
762 // Make sure we actually found it, and it matches.
Austin Schuh40485ed2019-10-26 21:51:44 -0700763 if (channel_iterator != config->channels()->cend() &&
764 EqualsChannels(*channel_iterator, std::make_pair(name, type))) {
Austin Schuhbca6cf02019-12-22 17:28:34 -0800765 if (VLOG_IS_ON(2)) {
766 VLOG(2) << "Found: " << FlatbufferToJson(*channel_iterator);
767 } else if (VLOG_IS_ON(1)) {
768 VLOG(1) << "Found: " << CleanedChannelToString(*channel_iterator);
769 }
Austin Schuh40485ed2019-10-26 21:51:44 -0700770 return *channel_iterator;
Austin Schuhcb108412019-10-13 16:09:54 -0700771 } else {
772 VLOG(1) << "No match for { \"name\": \"" << name << "\", \"type\": \""
773 << type << "\" }";
Austin Schuh0de30f32020-12-06 12:44:28 -0800774 if (original_name != name && !quiet) {
Austin Schuh4b42b252020-10-19 11:35:20 -0700775 LOG(WARNING) << "Remapped from {\"name\": \"" << original_name
776 << "\", \"type\": \"" << type << "\"}, to {\"name\": \""
777 << name << "\", \"type\": \"" << type
778 << "\"}, but no channel by that name exists.";
779 }
Austin Schuhcb108412019-10-13 16:09:54 -0700780 return nullptr;
781 }
782}
783
Austin Schuhc9e10ec2020-01-26 16:08:28 -0800784size_t ChannelIndex(const Configuration *configuration,
785 const Channel *channel) {
786 CHECK(configuration->channels() != nullptr) << ": No channels";
787
788 auto c = std::find(configuration->channels()->begin(),
789 configuration->channels()->end(), channel);
790 CHECK(c != configuration->channels()->end())
791 << ": Channel pointer not found in configuration()->channels()";
792
793 return std::distance(configuration->channels()->begin(), c);
794}
795
Austin Schuhbca6cf02019-12-22 17:28:34 -0800796std::string CleanedChannelToString(const Channel *channel) {
797 FlatbufferDetachedBuffer<Channel> cleaned_channel = CopyFlatBuffer(channel);
798 cleaned_channel.mutable_message()->clear_schema();
799 return FlatbufferToJson(cleaned_channel);
800}
801
Austin Schuha81454b2020-05-12 19:58:36 -0700802std::string StrippedChannelToString(const Channel *channel) {
803 return absl::StrCat("{ \"name\": \"", channel->name()->string_view(),
804 "\", \"type\": \"", channel->type()->string_view(),
805 "\" }");
806}
807
Alex Perrycb7da4b2019-08-28 19:35:56 -0700808FlatbufferDetachedBuffer<Configuration> MergeConfiguration(
809 const Flatbuffer<Configuration> &config,
Austin Schuh0de30f32020-12-06 12:44:28 -0800810 const std::vector<aos::FlatbufferVector<reflection::Schema>> &schemas) {
Alex Perrycb7da4b2019-08-28 19:35:56 -0700811 flatbuffers::FlatBufferBuilder fbb;
Austin Schuhd7b15da2020-02-17 15:06:11 -0800812 fbb.ForceDefaults(true);
Alex Perrycb7da4b2019-08-28 19:35:56 -0700813
Austin Schuh68d98592020-11-01 23:22:57 -0800814 // Cache for holding already inserted schemas.
815 std::map<std::string_view, flatbuffers::Offset<reflection::Schema>>
816 schema_cache;
817
818 CHECK_EQ(Channel::MiniReflectTypeTable()->num_elems, 13u)
819 << ": Merging logic needs to be updated when the number of channel "
820 "fields changes.";
James Kuszmaul3c998592020-07-27 21:04:47 -0700821
Alex Perrycb7da4b2019-08-28 19:35:56 -0700822 flatbuffers::Offset<flatbuffers::Vector<flatbuffers::Offset<Channel>>>
823 channels_offset;
824 if (config.message().has_channels()) {
825 std::vector<flatbuffers::Offset<Channel>> channel_offsets;
826 for (const Channel *c : *config.message().channels()) {
Alex Perrycb7da4b2019-08-28 19:35:56 -0700827 // Search for a schema with a matching type.
Austin Schuh0de30f32020-12-06 12:44:28 -0800828 const aos::FlatbufferVector<reflection::Schema> *found_schema = nullptr;
829 for (const aos::FlatbufferVector<reflection::Schema> &schema : schemas) {
Alex Perrycb7da4b2019-08-28 19:35:56 -0700830 if (schema.message().root_table() != nullptr) {
831 if (schema.message().root_table()->name()->string_view() ==
832 c->type()->string_view()) {
833 found_schema = &schema;
834 }
835 }
836 }
837
838 CHECK(found_schema != nullptr)
839 << ": Failed to find schema for " << FlatbufferToJson(c);
840
Austin Schuh68d98592020-11-01 23:22:57 -0800841 // Now copy the message manually.
842 auto cached_schema = schema_cache.find(c->type()->string_view());
843 flatbuffers::Offset<reflection::Schema> schema_offset;
844 if (cached_schema != schema_cache.end()) {
845 schema_offset = cached_schema->second;
846 } else {
Austin Schuha4fc60f2020-11-01 23:06:47 -0800847 schema_offset = RecursiveCopyFlatBuffer<reflection::Schema>(
848 &found_schema->message(), &fbb);
Austin Schuh68d98592020-11-01 23:22:57 -0800849 schema_cache.emplace(c->type()->string_view(), schema_offset);
850 }
851
852 flatbuffers::Offset<flatbuffers::String> name_offset =
853 fbb.CreateSharedString(c->name()->str());
854 flatbuffers::Offset<flatbuffers::String> type_offset =
855 fbb.CreateSharedString(c->type()->str());
856 flatbuffers::Offset<flatbuffers::String> source_node_offset =
Austin Schuha4fc60f2020-11-01 23:06:47 -0800857 c->has_source_node() ? fbb.CreateSharedString(c->source_node()->str())
858 : 0;
Austin Schuh68d98592020-11-01 23:22:57 -0800859
860 flatbuffers::Offset<flatbuffers::Vector<flatbuffers::Offset<Connection>>>
861 destination_nodes_offset =
Austin Schuh5c255aa2020-11-05 18:32:46 -0800862 aos::RecursiveCopyVectorTable(c->destination_nodes(), &fbb);
Austin Schuh68d98592020-11-01 23:22:57 -0800863
864 flatbuffers::Offset<
865 flatbuffers::Vector<flatbuffers::Offset<flatbuffers::String>>>
866 logger_nodes_offset =
867 aos::CopyVectorSharedString(c->logger_nodes(), &fbb);
868
869 Channel::Builder channel_builder(fbb);
870 channel_builder.add_name(name_offset);
871 channel_builder.add_type(type_offset);
872 if (c->has_frequency()) {
873 channel_builder.add_frequency(c->frequency());
874 }
875 if (c->has_max_size()) {
876 channel_builder.add_max_size(c->max_size());
877 }
878 if (c->has_num_senders()) {
879 channel_builder.add_num_senders(c->num_senders());
880 }
881 if (c->has_num_watchers()) {
882 channel_builder.add_num_watchers(c->num_watchers());
883 }
Alex Perrycb7da4b2019-08-28 19:35:56 -0700884 channel_builder.add_schema(schema_offset);
Austin Schuh68d98592020-11-01 23:22:57 -0800885 if (!source_node_offset.IsNull()) {
886 channel_builder.add_source_node(source_node_offset);
887 }
888 if (!destination_nodes_offset.IsNull()) {
889 channel_builder.add_destination_nodes(destination_nodes_offset);
890 }
891 if (c->has_logger()) {
892 channel_builder.add_logger(c->logger());
893 }
894 if (!logger_nodes_offset.IsNull()) {
895 channel_builder.add_logger_nodes(logger_nodes_offset);
896 }
897 if (c->has_read_method()) {
898 channel_builder.add_read_method(c->read_method());
899 }
900 if (c->has_num_readers()) {
901 channel_builder.add_num_readers(c->num_readers());
902 }
903 channel_offsets.emplace_back(channel_builder.Finish());
Alex Perrycb7da4b2019-08-28 19:35:56 -0700904 }
905 channels_offset = fbb.CreateVector(channel_offsets);
906 }
907
Austin Schuh68d98592020-11-01 23:22:57 -0800908 flatbuffers::Offset<flatbuffers::Vector<flatbuffers::Offset<Map>>>
Austin Schuh5c255aa2020-11-05 18:32:46 -0800909 maps_offset =
910 aos::RecursiveCopyVectorTable(config.message().maps(), &fbb);
Austin Schuh68d98592020-11-01 23:22:57 -0800911
912 flatbuffers::Offset<flatbuffers::Vector<flatbuffers::Offset<Node>>>
Austin Schuh5c255aa2020-11-05 18:32:46 -0800913 nodes_offset =
914 aos::RecursiveCopyVectorTable(config.message().nodes(), &fbb);
Austin Schuh68d98592020-11-01 23:22:57 -0800915
916 flatbuffers::Offset<flatbuffers::Vector<flatbuffers::Offset<Application>>>
917 applications_offset =
Austin Schuh5c255aa2020-11-05 18:32:46 -0800918 aos::RecursiveCopyVectorTable(config.message().applications(), &fbb);
Austin Schuh217a9782019-12-21 23:02:50 -0800919
920 // Now insert everything else in unmodified.
Alex Perrycb7da4b2019-08-28 19:35:56 -0700921 ConfigurationBuilder configuration_builder(fbb);
922 if (config.message().has_channels()) {
923 configuration_builder.add_channels(channels_offset);
924 }
Austin Schuh68d98592020-11-01 23:22:57 -0800925 if (!maps_offset.IsNull()) {
926 configuration_builder.add_maps(maps_offset);
927 }
928 if (!nodes_offset.IsNull()) {
929 configuration_builder.add_nodes(nodes_offset);
930 }
931 if (!applications_offset.IsNull()) {
932 configuration_builder.add_applications(applications_offset);
933 }
934
935 if (config.message().has_channel_storage_duration()) {
936 configuration_builder.add_channel_storage_duration(
937 config.message().channel_storage_duration());
938 }
939
940 CHECK_EQ(Configuration::MiniReflectTypeTable()->num_elems, 6u)
941 << ": Merging logic needs to be updated when the number of configuration "
942 "fields changes.";
943
Alex Perrycb7da4b2019-08-28 19:35:56 -0700944 fbb.Finish(configuration_builder.Finish());
James Kuszmaul3c998592020-07-27 21:04:47 -0700945 aos::FlatbufferDetachedBuffer<aos::Configuration> modified_config(
946 fbb.Release());
947
Austin Schuh68d98592020-11-01 23:22:57 -0800948 return modified_config;
Alex Perrycb7da4b2019-08-28 19:35:56 -0700949}
950
Austin Schuh217a9782019-12-21 23:02:50 -0800951const Node *GetNodeFromHostname(const Configuration *config,
952 std::string_view hostname) {
953 for (const Node *node : *config->nodes()) {
Brian Silvermanaa2633f2020-02-17 21:04:14 -0800954 if (node->has_hostname() && node->hostname()->string_view() == hostname) {
Austin Schuh217a9782019-12-21 23:02:50 -0800955 return node;
956 }
Brian Silvermanaa2633f2020-02-17 21:04:14 -0800957 if (node->has_hostnames()) {
958 for (const auto &candidate : *node->hostnames()) {
959 if (candidate->string_view() == hostname) {
960 return node;
961 }
962 }
963 }
Austin Schuh217a9782019-12-21 23:02:50 -0800964 }
965 return nullptr;
966}
Austin Schuhac0771c2020-01-07 18:36:30 -0800967
Austin Schuh217a9782019-12-21 23:02:50 -0800968const Node *GetMyNode(const Configuration *config) {
969 const std::string hostname = (FLAGS_override_hostname.size() > 0)
970 ? FLAGS_override_hostname
971 : network::GetHostname();
972 const Node *node = GetNodeFromHostname(config, hostname);
973 if (node != nullptr) return node;
974
975 LOG(FATAL) << "Unknown node for host: " << hostname
976 << ". Consider using --override_hostname if hostname detection "
977 "is wrong.";
978 return nullptr;
979}
980
Austin Schuhc9e10ec2020-01-26 16:08:28 -0800981const Node *GetNode(const Configuration *config, const Node *node) {
982 if (!MultiNode(config)) {
983 CHECK(node == nullptr) << ": Provided a node in a single node world.";
984 return nullptr;
985 } else {
986 CHECK(node != nullptr);
987 CHECK(node->has_name());
988 return GetNode(config, node->name()->string_view());
989 }
990}
991
Austin Schuh217a9782019-12-21 23:02:50 -0800992const Node *GetNode(const Configuration *config, std::string_view name) {
Austin Schuhfd960622020-01-01 13:22:55 -0800993 CHECK(config->has_nodes())
994 << ": Asking for a node from a single node configuration.";
Austin Schuh217a9782019-12-21 23:02:50 -0800995 for (const Node *node : *config->nodes()) {
Austin Schuhfd960622020-01-01 13:22:55 -0800996 CHECK(node->has_name()) << ": Malformed node " << FlatbufferToJson(node);
Austin Schuh217a9782019-12-21 23:02:50 -0800997 if (node->name()->string_view() == name) {
998 return node;
999 }
1000 }
1001 return nullptr;
1002}
1003
Austin Schuh0ca1fd32020-12-18 22:53:05 -08001004const Node *GetNode(const Configuration *config, size_t node_index) {
1005 if (!MultiNode(config)) {
1006 CHECK_EQ(node_index, 0u) << ": Invalid node in a single node world.";
1007 return nullptr;
1008 } else {
1009 CHECK_LT(node_index, config->nodes()->size());
1010 return config->nodes()->Get(node_index);
1011 }
1012}
1013
Austin Schuhc9e10ec2020-01-26 16:08:28 -08001014const Node *GetNodeOrDie(const Configuration *config, const Node *node) {
1015 if (!MultiNode(config)) {
1016 CHECK(node == nullptr) << ": Provided a node in a single node world.";
1017 return nullptr;
1018 } else {
1019 const Node *config_node = GetNode(config, node);
1020 if (config_node == nullptr) {
1021 LOG(FATAL) << "Couldn't find node matching " << FlatbufferToJson(node);
1022 }
1023 return config_node;
1024 }
1025}
1026
Austin Schuh8bd96322020-02-13 21:18:22 -08001027namespace {
1028int GetNodeIndexFromConfig(const Configuration *config, const Node *node) {
Austin Schuhc9e10ec2020-01-26 16:08:28 -08001029 int node_index = 0;
1030 for (const Node *iterated_node : *config->nodes()) {
1031 if (iterated_node == node) {
1032 return node_index;
1033 }
1034 ++node_index;
1035 }
Austin Schuh8bd96322020-02-13 21:18:22 -08001036 return -1;
1037}
1038} // namespace
1039
Austin Schuha9df9ad2021-06-16 14:49:39 -07001040aos::FlatbufferDetachedBuffer<aos::Configuration> AddSchema(
1041 std::string_view json,
1042 const std::vector<aos::FlatbufferVector<reflection::Schema>> &schemas) {
1043 FlatbufferDetachedBuffer<Configuration> addition =
1044 JsonToFlatbuffer(json, Configuration::MiniReflectTypeTable());
1045 return MergeConfiguration(addition, schemas);
1046}
1047
Austin Schuh8bd96322020-02-13 21:18:22 -08001048int GetNodeIndex(const Configuration *config, const Node *node) {
1049 if (!MultiNode(config)) {
1050 return 0;
1051 }
1052
1053 {
1054 int node_index = GetNodeIndexFromConfig(config, node);
1055 if (node_index != -1) {
1056 return node_index;
1057 }
1058 }
1059
1060 const Node *result = GetNode(config, node);
1061 CHECK(result != nullptr);
1062
1063 {
Austin Schuh04408fc2020-02-16 21:48:54 -08001064 int node_index = GetNodeIndexFromConfig(config, result);
Austin Schuh8bd96322020-02-13 21:18:22 -08001065 if (node_index != -1) {
1066 return node_index;
1067 }
1068 }
1069
1070 LOG(FATAL) << "Node " << FlatbufferToJson(node)
1071 << " not found in the configuration.";
Austin Schuhc9e10ec2020-01-26 16:08:28 -08001072}
1073
Austin Schuh04408fc2020-02-16 21:48:54 -08001074int GetNodeIndex(const Configuration *config, std::string_view name) {
1075 if (!MultiNode(config)) {
1076 return 0;
1077 }
1078
1079 {
1080 int node_index = 0;
1081 for (const Node *iterated_node : *config->nodes()) {
1082 if (iterated_node->name()->string_view() == name) {
1083 return node_index;
1084 }
1085 ++node_index;
1086 }
1087 }
1088 LOG(FATAL) << "Node " << name << " not found in the configuration.";
1089}
1090
Austin Schuh681a2472020-12-31 23:55:40 -08001091size_t NodesCount(const Configuration *config) {
1092 if (!MultiNode(config)) {
1093 return 1u;
1094 }
1095
1096 return config->nodes()->size();
1097}
1098
Austin Schuhc9e10ec2020-01-26 16:08:28 -08001099std::vector<const Node *> GetNodes(const Configuration *config) {
1100 std::vector<const Node *> nodes;
Austin Schuh8bd96322020-02-13 21:18:22 -08001101 if (MultiNode(config)) {
Austin Schuhc9e10ec2020-01-26 16:08:28 -08001102 for (const Node *node : *config->nodes()) {
1103 nodes.emplace_back(node);
1104 }
1105 } else {
1106 nodes.emplace_back(nullptr);
1107 }
1108 return nodes;
1109}
1110
Austin Schuh65465332020-11-05 17:36:53 -08001111std::vector<const Node *> GetNodesWithTag(const Configuration *config,
1112 std::string_view tag) {
1113 std::vector<const Node *> nodes;
1114 if (!MultiNode(config)) {
1115 nodes.emplace_back(nullptr);
1116 } else {
1117 for (const Node *node : *config->nodes()) {
1118 if (!node->has_tags()) {
1119 continue;
1120 }
1121 bool did_found_tag = false;
1122 for (const flatbuffers::String *found_tag : *node->tags()) {
1123 if (found_tag->string_view() == tag) {
1124 did_found_tag = true;
1125 break;
1126 }
1127 }
1128 if (did_found_tag) {
1129 nodes.emplace_back(node);
1130 }
1131 }
1132 }
1133 return nodes;
1134}
1135
Austin Schuhac0771c2020-01-07 18:36:30 -08001136bool MultiNode(const Configuration *config) { return config->has_nodes(); }
1137
Austin Schuh217a9782019-12-21 23:02:50 -08001138bool ChannelIsSendableOnNode(const Channel *channel, const Node *node) {
Austin Schuhca4828c2019-12-28 14:21:35 -08001139 if (node == nullptr) {
1140 return true;
1141 }
Austin Schuh3c5dae52020-10-06 18:55:18 -07001142 CHECK(channel->has_source_node()) << FlatbufferToJson(channel);
1143 CHECK(node->has_name()) << FlatbufferToJson(node);
Austin Schuh196a4452020-03-15 23:12:03 -07001144 return (CHECK_NOTNULL(channel)->source_node()->string_view() ==
1145 node->name()->string_view());
Austin Schuh217a9782019-12-21 23:02:50 -08001146}
1147
1148bool ChannelIsReadableOnNode(const Channel *channel, const Node *node) {
Austin Schuhca4828c2019-12-28 14:21:35 -08001149 if (node == nullptr) {
1150 return true;
1151 }
1152
Austin Schuh217a9782019-12-21 23:02:50 -08001153 if (channel->source_node()->string_view() == node->name()->string_view()) {
1154 return true;
1155 }
1156
1157 if (!channel->has_destination_nodes()) {
1158 return false;
1159 }
1160
Austin Schuh719946b2019-12-28 14:51:01 -08001161 for (const Connection *connection : *channel->destination_nodes()) {
1162 CHECK(connection->has_name());
1163 if (connection->name()->string_view() == node->name()->string_view()) {
Austin Schuh217a9782019-12-21 23:02:50 -08001164 return true;
1165 }
1166 }
1167
1168 return false;
1169}
1170
Austin Schuh719946b2019-12-28 14:51:01 -08001171bool ChannelMessageIsLoggedOnNode(const Channel *channel, const Node *node) {
Austin Schuh48e94502021-06-18 18:35:53 -07001172 if (node == nullptr) {
Austin Schuh2bb80e02021-03-20 21:46:17 -07001173 // Single node world. If there is a local logger, then we want to use
1174 // it.
Austin Schuh48e94502021-06-18 18:35:53 -07001175 if (channel->logger() == LoggerConfig::LOCAL_LOGGER) {
1176 return true;
1177 } else if (channel->logger() == LoggerConfig::NOT_LOGGED) {
1178 return false;
1179 }
1180 LOG(FATAL) << "Unsupported logging configuration in a single node world: "
1181 << CleanedChannelToString(channel);
Austin Schuh2bb80e02021-03-20 21:46:17 -07001182 }
1183 return ChannelMessageIsLoggedOnNode(
1184 channel, CHECK_NOTNULL(node)->name()->string_view());
1185}
1186
1187bool ChannelMessageIsLoggedOnNode(const Channel *channel,
1188 std::string_view node_name) {
Austin Schuhf1fff282020-03-28 16:57:32 -07001189 switch (channel->logger()) {
Austin Schuh719946b2019-12-28 14:51:01 -08001190 case LoggerConfig::LOCAL_LOGGER:
Austin Schuh2bb80e02021-03-20 21:46:17 -07001191 return channel->source_node()->string_view() == node_name;
Austin Schuh719946b2019-12-28 14:51:01 -08001192 case LoggerConfig::LOCAL_AND_REMOTE_LOGGER:
Austin Schuhda40e472020-03-28 15:15:29 -07001193 CHECK(channel->has_logger_nodes());
1194 CHECK_GT(channel->logger_nodes()->size(), 0u);
Austin Schuh719946b2019-12-28 14:51:01 -08001195
Austin Schuh2bb80e02021-03-20 21:46:17 -07001196 if (channel->source_node()->string_view() == node_name) {
Austin Schuh719946b2019-12-28 14:51:01 -08001197 return true;
1198 }
Austin Schuhda40e472020-03-28 15:15:29 -07001199
1200 [[fallthrough]];
1201 case LoggerConfig::REMOTE_LOGGER:
1202 CHECK(channel->has_logger_nodes());
1203 CHECK_GT(channel->logger_nodes()->size(), 0u);
1204 for (const flatbuffers::String *logger_node : *channel->logger_nodes()) {
Austin Schuh2bb80e02021-03-20 21:46:17 -07001205 if (logger_node->string_view() == node_name) {
Austin Schuhda40e472020-03-28 15:15:29 -07001206 return true;
1207 }
Austin Schuh719946b2019-12-28 14:51:01 -08001208 }
1209
1210 return false;
1211 case LoggerConfig::NOT_LOGGED:
1212 return false;
1213 }
1214
1215 LOG(FATAL) << "Unknown logger config " << static_cast<int>(channel->logger());
1216}
1217
Austin Schuh58646e22021-08-23 23:51:46 -07001218size_t ConnectionCount(const Channel *channel) {
1219 if (!channel->has_destination_nodes()) {
1220 return 0;
1221 }
1222 return channel->destination_nodes()->size();
1223}
1224
Austin Schuh719946b2019-12-28 14:51:01 -08001225const Connection *ConnectionToNode(const Channel *channel, const Node *node) {
1226 if (!channel->has_destination_nodes()) {
1227 return nullptr;
1228 }
1229 for (const Connection *connection : *channel->destination_nodes()) {
1230 if (connection->name()->string_view() == node->name()->string_view()) {
1231 return connection;
1232 }
1233 }
1234 return nullptr;
1235}
1236
1237bool ConnectionDeliveryTimeIsLoggedOnNode(const Channel *channel,
1238 const Node *node,
1239 const Node *logger_node) {
Austin Schuh72211ae2021-08-05 14:02:30 -07001240 return ConnectionDeliveryTimeIsLoggedOnNode(ConnectionToNode(channel, node),
1241 logger_node);
Austin Schuh719946b2019-12-28 14:51:01 -08001242}
1243
1244bool ConnectionDeliveryTimeIsLoggedOnNode(const Connection *connection,
1245 const Node *node) {
Austin Schuh72211ae2021-08-05 14:02:30 -07001246 if (connection == nullptr) {
1247 return false;
1248 }
Austin Schuh719946b2019-12-28 14:51:01 -08001249 switch (connection->timestamp_logger()) {
1250 case LoggerConfig::LOCAL_AND_REMOTE_LOGGER:
Austin Schuhda40e472020-03-28 15:15:29 -07001251 CHECK(connection->has_timestamp_logger_nodes());
1252 CHECK_GT(connection->timestamp_logger_nodes()->size(), 0u);
Austin Schuh719946b2019-12-28 14:51:01 -08001253 if (connection->name()->string_view() == node->name()->string_view()) {
1254 return true;
1255 }
1256
Austin Schuhda40e472020-03-28 15:15:29 -07001257 [[fallthrough]];
1258 case LoggerConfig::REMOTE_LOGGER:
1259 CHECK(connection->has_timestamp_logger_nodes());
1260 CHECK_GT(connection->timestamp_logger_nodes()->size(), 0u);
1261 for (const flatbuffers::String *timestamp_logger_node :
1262 *connection->timestamp_logger_nodes()) {
1263 if (timestamp_logger_node->string_view() ==
1264 node->name()->string_view()) {
1265 return true;
1266 }
Austin Schuh719946b2019-12-28 14:51:01 -08001267 }
1268
1269 return false;
1270 case LoggerConfig::LOCAL_LOGGER:
1271 return connection->name()->string_view() == node->name()->string_view();
Austin Schuh719946b2019-12-28 14:51:01 -08001272 case LoggerConfig::NOT_LOGGED:
1273 return false;
1274 }
1275
1276 LOG(FATAL) << "Unknown logger config "
1277 << static_cast<int>(connection->timestamp_logger());
1278}
1279
Austin Schuhe84c3ed2019-12-14 15:29:48 -08001280std::vector<std::string_view> SourceNodeNames(const Configuration *config,
1281 const Node *my_node) {
1282 std::set<std::string_view> result_set;
1283
1284 for (const Channel *channel : *config->channels()) {
1285 if (channel->has_destination_nodes()) {
1286 for (const Connection *connection : *channel->destination_nodes()) {
1287 if (connection->name()->string_view() ==
1288 my_node->name()->string_view()) {
1289 result_set.insert(channel->source_node()->string_view());
1290 }
1291 }
1292 }
1293 }
1294
1295 std::vector<std::string_view> result;
1296 for (const std::string_view source : result_set) {
1297 VLOG(1) << "Found a source node of " << source;
1298 result.emplace_back(source);
1299 }
1300 return result;
1301}
1302
1303std::vector<std::string_view> DestinationNodeNames(const Configuration *config,
1304 const Node *my_node) {
1305 std::vector<std::string_view> result;
1306
1307 for (const Channel *channel : *config->channels()) {
1308 if (channel->has_source_node() && channel->source_node()->string_view() ==
1309 my_node->name()->string_view()) {
1310 if (!channel->has_destination_nodes()) continue;
1311
1312 if (channel->source_node()->string_view() !=
1313 my_node->name()->string_view()) {
1314 continue;
1315 }
1316
1317 for (const Connection *connection : *channel->destination_nodes()) {
1318 if (std::find(result.begin(), result.end(),
1319 connection->name()->string_view()) == result.end()) {
1320 result.emplace_back(connection->name()->string_view());
1321 }
1322 }
1323 }
1324 }
1325
1326 for (const std::string_view destination : result) {
1327 VLOG(1) << "Found a destination node of " << destination;
1328 }
1329 return result;
1330}
1331
Austin Schuh8d7e0bb2020-10-02 17:57:00 -07001332std::vector<const Node *> TimestampNodes(const Configuration *config,
1333 const Node *my_node) {
1334 if (!configuration::MultiNode(config)) {
1335 CHECK(my_node == nullptr);
1336 return std::vector<const Node *>{};
1337 }
1338
1339 std::set<const Node *> timestamp_logger_nodes;
1340 for (const Channel *channel : *config->channels()) {
1341 if (!configuration::ChannelIsSendableOnNode(channel, my_node)) {
1342 continue;
1343 }
1344 if (!channel->has_destination_nodes()) {
1345 continue;
1346 }
1347 for (const Connection *connection : *channel->destination_nodes()) {
1348 const Node *other_node =
1349 configuration::GetNode(config, connection->name()->string_view());
1350
1351 if (configuration::ConnectionDeliveryTimeIsLoggedOnNode(connection,
1352 my_node)) {
1353 VLOG(1) << "Timestamps are logged from "
1354 << FlatbufferToJson(other_node);
1355 timestamp_logger_nodes.insert(other_node);
1356 }
1357 }
1358 }
1359
1360 std::vector<const Node *> result;
1361 for (const Node *node : timestamp_logger_nodes) {
1362 result.emplace_back(node);
1363 }
1364 return result;
1365}
1366
Austin Schuhc41fa3c2021-10-16 14:35:35 -07001367bool ApplicationShouldStart(const Configuration *config, const Node *my_node,
1368 const Application *application) {
1369 if (MultiNode(config)) {
1370 // Ok, we need
1371 CHECK(application->has_nodes());
1372 CHECK(my_node != nullptr);
1373 for (const flatbuffers::String *str : *application->nodes()) {
1374 if (str->string_view() == my_node->name()->string_view()) {
1375 return true;
1376 }
1377 }
1378 return false;
1379 } else {
1380 return true;
1381 }
1382}
1383
Austin Schuhd2e2f6a2021-02-07 20:46:16 -08001384const Application *GetApplication(const Configuration *config,
1385 const Node *my_node,
1386 std::string_view application_name) {
1387 if (config->has_applications()) {
1388 auto application_iterator = std::lower_bound(
1389 config->applications()->cbegin(), config->applications()->cend(),
1390 application_name, CompareApplications);
1391 if (application_iterator != config->applications()->cend() &&
1392 EqualsApplications(*application_iterator, application_name)) {
Austin Schuhc41fa3c2021-10-16 14:35:35 -07001393 if (ApplicationShouldStart(config, my_node, *application_iterator)) {
Austin Schuhd2e2f6a2021-02-07 20:46:16 -08001394 return *application_iterator;
1395 }
1396 }
1397 }
1398 return nullptr;
1399}
1400
Austin Schuhfc7b6a02021-07-12 21:19:07 -07001401std::vector<size_t> SourceNodeIndex(const Configuration *config) {
1402 CHECK(config->has_channels());
1403 std::vector<size_t> result;
1404 result.resize(config->channels()->size(), 0u);
1405 if (MultiNode(config)) {
1406 for (size_t i = 0; i < config->channels()->size(); ++i) {
1407 result[i] = GetNodeIndex(
1408 config, config->channels()->Get(i)->source_node()->string_view());
1409 }
1410 }
1411 return result;
1412}
1413
Brian Silverman66f079a2013-08-26 16:24:30 -07001414} // namespace configuration
1415} // namespace aos