example application to demonstrate the use of FEO framework... (#23)

- an ad-demo application that runs 3 activities.
- one of the activity sends a location message from an mcap,
  iteratively on every step of activity cycle.
- a python script creates a foxglove server that forwards
  this mcap message to be visualized in Lichtblick.
- Instructions for running the whole chain is available in the
  README files.

Author: praxhna

.gitignore

@@ -38,6 +38,7 @@
 bazel-*
 MODULE.bazel.lock
 user.bazelrc
+external
 
 # Ruff
 .ruff_cache
@@ -54,5 +55,12 @@ styles/
 
 # Python
 .venv
+venv/*
 __pycache__/
 /.coverage
+
+# Rust
+rust-project.json
+
+# vscode
+.vscode/

BUILD

@@ -26,6 +26,7 @@ setup_starpls(
 copyright_checker(
     name = "copyright",
     srcs = [
+        "feo/ad-demo",
         "scorex",
         "src",
         "tests",

MODULE.bazel

@@ -123,3 +123,37 @@ use_repo(
     go_deps,
     "com_github_spf13_cobra",
 )
+
+#### Following section for Feo framework examples ###
+bazel_dep(name = "score_crates", version = "0.0.6")
+
+crate = use_extension("@rules_rust//crate_universe:extensions.bzl", "crate")
+crate.from_cargo(
+    name = "ad-demo-local-crates",
+    cargo_lockfile = "//feo/ad-demo:Cargo.lock",
+    manifests = [
+        "//feo/ad-demo:Cargo.toml",
+    ],
+)
+use_repo(crate, "ad-demo-local-crates")
+
+# Override feo's dependency on score_docs_as_code to use 2.3.3
+single_version_override(
+    module_name = "score_docs_as_code",
+    version = "2.3.3",
+)
+
+bazel_dep(name = "feo", version = "1.0.1")
+git_override(
+    module_name = "feo",
+    commit = "05702d0a386daf23912c26ccb2b35b584d3a9e8c",
+    remote = "https://github.com/eclipse-score/feo.git",
+)
+
+pip = use_extension("@rules_python//python/extensions:pip.bzl", "pip")
+pip.parse(
+    hub_name = "lichtblick_com_pypi",
+    python_version = "3.12",
+    requirements_lock = "//feo/ad-demo/lichtblick-com:requirements_lock.txt",
+)
+use_repo(pip, "lichtblick_com_pypi")

README.md

@@ -256,6 +256,7 @@ QNX cross-compilation requires:
 Future extensions planned for SCRAMPLE:
 
 - Additional S-CORE platform module demonstrations
+    - [FEO demo application](feo/ad-demo/README.md)
 - More complex communication patterns
 - Performance benchmarking utilities
 - Integration with other S-CORE components

feo/ad-demo/BUILD.bazel

@@ -0,0 +1,84 @@
+# *******************************************************************************
+# Copyright (c) 2026 Contributors to the Eclipse Foundation
+#
+# See the NOTICE file(s) distributed with this work for additional
+# information regarding copyright ownership.
+#
+# This program and the accompanying materials are made available under the
+# terms of the Apache License Version 2.0 which is available at
+# https://www.apache.org/licenses/LICENSE-2.0
+#
+# SPDX-License-Identifier: Apache-2.0
+# *******************************************************************************
+
+load("@rules_rust//rust:defs.bzl", "rust_binary", "rust_library")
+
+rust_library(
+    name = "activities_lib",
+    srcs = [
+        "src/activities/application_config.rs",
+        "src/activities/camera_activity.rs",
+        "src/activities/common.rs",
+        "src/activities/mcap_activity.rs",
+        "src/activities/messages.rs",
+        "src/activities/mod.rs",
+        "src/activities/render_activity.rs",
+        "src/lib.rs",
+    ],
+    crate_features = [
+        "com_iox2",
+        "signalling_relayed_tcp",
+    ],
+    crate_name = "ad_demo",
+    data = ["src/assets/gps_route.mcap"],
+    visibility = ["//visibility:public"],
+    deps = [
+        "@ad-demo-local-crates//:camino",
+        "@ad-demo-local-crates//:mcap",
+        "@ad-demo-local-crates//:memmap2",
+        "@feo//feo:libfeo_rust",
+        "@feo//feo-com:libfeo_com_rust",
+        "@feo//feo-log:libfeo_log_rust",
+        "@feo//feo-logger:libfeo_logger_rust",
+        "@feo//feo-time:libfeo_time_rust",
+        "@feo//feo-tracing:libfeo_tracing_rust",
+        "@score_crates//:anyhow",
+        "@score_crates//:postcard",
+        "@score_crates//:rand",
+        "@score_crates//:serde",
+        "@score_crates//:serde_json",
+        "@score_crates//:tracing",
+    ],
+)
+
+rust_binary(
+    name = "agent_primary",
+    srcs = [
+        "src/agents/primary.rs",
+    ],
+    visibility = ["//visibility:public"],
+    deps = [
+        ":activities_lib",
+        "@feo//feo:libfeo_rust",
+        "@feo//feo-log:libfeo_log_rust",
+        "@feo//feo-logger:libfeo_logger_rust",
+        "@feo//feo-time:libfeo_time_rust",
+        "@feo//feo-tracing:libfeo_tracing_rust",
+    ],
+)
+
+rust_binary(
+    name = "agent_secondary",
+    srcs = [
+        "src/agents/secondary.rs",
+    ],
+    visibility = ["//visibility:public"],
+    deps = [
+        ":activities_lib",
+        "@feo//feo:libfeo_rust",
+        "@feo//feo-log:libfeo_log_rust",
+        "@feo//feo-logger:libfeo_logger_rust",
+        "@feo//feo-time:libfeo_time_rust",
+        "@feo//feo-tracing:libfeo_tracing_rust",
+    ],
+)