pw_bluetooth_sapphire: Create size report

Change-Id: Idc17d1415b1d67f377b34ac144b36237d7e23221
Reviewed-on: https://pigweed-review.googlesource.com/c/pigweed/pigweed/+/239506
Reviewed-by: Lulu Wang <luluwang@google.com>
Reviewed-by: Kayce Basques <kayce@google.com>
Commit-Queue: Ben Lawson <benlawson@google.com>
Lint: Lint 🤖 <android-build-ayeaye@system.gserviceaccount.com>

Author: BenjaminLawson

docs/module_metadata.json

@@ -129,7 +129,7 @@
   "pw_bluetooth_sapphire": {
     "tagline": "Battle-tested Bluetooth with rock-solid reliability",
     "status": "unstable",
-    "size": "1.5 to 2 mB",
+    "size": "500 to 700 kB",
     "languages": [
       "C++17"
     ]

pw_bluetooth_sapphire/BUILD.gn

@@ -13,18 +13,12 @@
 # the License.
 
 import("//build_overrides/pigweed.gni")
+import("$dir_pw_bluetooth_sapphire/sapphire.gni")
 import("$dir_pw_build/module_config.gni")
 import("$dir_pw_build/target_types.gni")
 import("$dir_pw_docgen/docs.gni")
 import("$dir_pw_unit_test/test.gni")
 
-declare_args() {
-  # The build target that overrides the default configuration options for this
-  # module. This should point to a source set that provides defines through a
-  # public config (which may -include a file or add defines directly).
-  pw_bluetooth_sapphire_CONFIG = pw_build_DEFAULT_MODULE_CONFIG
-}
-
 config("public_include_path") {
   include_dirs = [ "public" ]
 }
@@ -58,7 +52,9 @@ pw_doc_group("docs") {
     "host/att/docs.rst",
     "host/gap/docs.rst",
     "host/l2cap/docs.rst",
+    "size_report.rst",
   ]
+  report_deps = [ "size_report:host_size_diff" ]
 }
 
 # Satisfies source_is_in_gn_build lint, which doesn't know about the BUILD.gn

pw_bluetooth_sapphire/docs.rst

@@ -258,6 +258,10 @@ Roadmap
 .. toctree::
    :maxdepth: 1
 
-   Fuchsia Development <fuchsia>
+   fuchsia
+   size_report
 
+.. _fuchsia/prebuilt/bt-host: https://chrome-infra-packages.appspot.com/p/fuchsia/prebuilt/bt-host
+.. _fuchsia/prebuilt/bt-hci-virtual: https://chrome-infra-packages.appspot.com/p/fuchsia/prebuilt/bt-hci-virtual
+.. _pigweed-linux-bazel-bthost: https://ci.chromium.org/ui/p/pigweed/builders/pigweed.ci/pigweed-linux-bazel-bthost
 .. _GN presubmit step: https://cs.opensource.google/pigweed/pigweed/+/main:pw_presubmit/py/pw_presubmit/pigweed_presubmit.py?q=gn_chre_googletest_nanopb_sapphire_build

pw_bluetooth_sapphire/host/BUILD.gn

@@ -18,14 +18,11 @@ import("//build_overrides/pigweed.gni")
 import("$dir_pigweed/third_party/emboss/emboss.gni")
 import("$dir_pw_assert/backend.gni")
 import("$dir_pw_async/backend.gni")
+import("$dir_pw_bluetooth_sapphire/sapphire.gni")
 import("$dir_pw_function/function.gni")
 import("$dir_pw_fuzzer/fuzzer.gni")
 import("$dir_pw_unit_test/test.gni")
 
-declare_args() {
-  pw_bluetooth_sapphire_ENABLED = false
-}
-
 # LINT.IfChange(copts)
 # Common C++ flags used in bt-host to ensure it builds in Pigweed and downstreams.
 # Note Fuchsia upstream has its own version of copts since this file is not

pw_bluetooth_sapphire/sapphire.gni

@@ -0,0 +1,25 @@
+# Copyright 2024 The Pigweed Authors
+#
+# Licensed under the Apache License, Version 2.0 (the "License"); you may not
+# use this file except in compliance with the License. You may obtain a copy of
+# the License at
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
+# WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the
+# License for the specific language governing permissions and limitations under
+# the License.
+
+import("//build_overrides/pigweed.gni")
+import("$dir_pw_build/module_config.gni")
+
+declare_args() {
+  pw_bluetooth_sapphire_ENABLED = false
+
+  # The build target that overrides the default configuration options for this
+  # module. This should point to a source set that provides defines through a
+  # public config (which may -include a file or add defines directly).
+  pw_bluetooth_sapphire_CONFIG = pw_build_DEFAULT_MODULE_CONFIG
+}

pw_bluetooth_sapphire/size_report.rst

@@ -0,0 +1,9 @@
+.. _module-pw_bluetooth_sapphire-size_report:
+
+===========
+Size report
+===========
+.. pigweed-module-subpage::
+   :name: pw_bluetooth_sapphire
+
+.. include:: size_report/host_size_diff

pw_bluetooth_sapphire/size_report/BUILD.bazel

@@ -0,0 +1,21 @@
+# Copyright 2024 The Pigweed Authors
+#
+# Licensed under the Apache License, Version 2.0 (the "License"); you may not
+# use this file except in compliance with the License. You may obtain a copy of
+# the License at
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
+# WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the
+# License for the specific language governing permissions and limitations under
+# the License.
+
+filegroup(
+    name = "satisfy_presubmit",
+    srcs = [
+        "host.cc",
+        "wrap_getentropy.cc",
+    ],
+)

pw_bluetooth_sapphire/size_report/BUILD.gn

@@ -0,0 +1,63 @@
+# Copyright 2024 The Pigweed Authors
+#
+# Licensed under the Apache License, Version 2.0 (the "License"); you may not
+# use this file except in compliance with the License. You may obtain a copy of
+# the License at
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
+# WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the
+# License for the specific language governing permissions and limitations under
+# the License.
+
+import("//build_overrides/pigweed.gni")
+import("$dir_pw_bloat/bloat.gni")
+import("$dir_pw_bluetooth_sapphire/sapphire.gni")
+import("$dir_pw_build/target_types.gni")
+
+config("getentropy_wrap_config") {
+  ldflags = [ "-Wl,--wrap=getentropy" ]
+  visibility = [ ":*" ]
+}
+
+pw_source_set("wrap_getentropy") {
+  all_dependent_configs = [ ":getentropy_wrap_config" ]
+  sources = [ "wrap_getentropy.cc" ]
+}
+
+pw_executable("host") {
+  sources = [ "host.cc" ]
+  deps = [
+    ":wrap_getentropy",
+    "$dir_pw_bloat:bloat_this_binary",
+    "$dir_pw_bluetooth_sapphire/host",
+  ]
+}
+
+# We can only compute size when Sapphire is enabled, implying that all the
+# necessary GN args and dependencies (e.g. emboss, boringssl) are configured.
+if (pw_bluetooth_sapphire_ENABLED) {
+  pw_size_diff("host_size_diff") {
+    title = "Host Size Report"
+    base = "$dir_pw_bloat:bloat_base"
+    binaries = [
+      {
+        target = ":host"
+        label = "Create and initialize host"
+      },
+    ]
+  }
+} else {
+  pw_size_diff("host_size_diff") {
+    title = "Host Size Report"
+    base = "$dir_pw_bloat:bloat_base"
+    binaries = [
+      {
+        target = "$dir_pw_bloat:bloat_base"
+        label = "Packages not configured"
+      },
+    ]
+  }
+}

pw_bluetooth_sapphire/size_report/host.cc

@@ -0,0 +1,55 @@
+// Copyright 2024 The Pigweed Authors
+//
+// Licensed under the Apache License, Version 2.0 (the "License"); you may not
+// use this file except in compliance with the License. You may obtain a copy of
+// the License at
+//
+//     https://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
+// WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the
+// License for the specific language governing permissions and limitations under
+// the License.
+
+#include "pw_bloat/bloat_this_binary.h"
+#include "pw_bluetooth_sapphire/internal/host/common/random.h"
+#include "pw_bluetooth_sapphire/internal/host/gap/adapter.h"
+#include "pw_random/random.h"
+
+namespace {
+class BloatRandomGenerator final : public pw::random::RandomGenerator {
+ public:
+  void Get(pw::ByteSpan dest) override {}
+  void InjectEntropyBits(uint32_t /*data*/,
+                         uint_fast8_t /*num_bits*/) override {}
+};
+
+class BloatDispatcher final : public pw::async::Dispatcher {
+ public:
+  void PostAt(pw::async::Task& task,
+              pw::chrono::SystemClock::time_point time) override {}
+  bool Cancel(pw::async::Task& task) override { return true; }
+  pw::chrono::SystemClock::time_point now() override {
+    return pw::chrono::SystemClock::time_point::min();
+  }
+};
+}  // namespace
+
+int main() {
+  pw::bloat::BloatThisBinary();
+
+  BloatDispatcher dispatcher;
+  BloatRandomGenerator random_generator;
+  bt::set_random_generator(&random_generator);
+  std::unique_ptr<bt::hci::Transport> transport;
+  std::unique_ptr<bt::gatt::GATT> gatt;
+
+  bt::gap::Adapter::Config config{};
+  std::unique_ptr<bt::gap::Adapter> adapter = bt::gap::Adapter::Create(
+      dispatcher, transport->GetWeakPtr(), gatt->GetWeakPtr(), config);
+  auto gap_init_cb = [](bool success) {};
+  auto transport_closed_cb = []() {};
+  adapter->Initialize(std::move(gap_init_cb), std::move(transport_closed_cb));
+  return 0;
+}

pw_bluetooth_sapphire/size_report/wrap_getentropy.cc

@@ -0,0 +1,22 @@
+// Copyright 2024 The Pigweed Authors
+//
+// Licensed under the Apache License, Version 2.0 (the "License"); you may not
+// use this file except in compliance with the License. You may obtain a copy of
+// the License at
+//
+//     https://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
+// WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the
+// License for the specific language governing permissions and limitations under
+// the License.
+
+// This file provides an implementation of getentropy that can be
+// used with ld's --wrap option.
+
+#include <unistd.h>
+
+extern "C" int __wrap_getentropy(void* /*buffer*/, size_t /*length*/) {
+  return 0;
+}