Add extracted tools: CitrineOS, OpenOCPP, ShapeShifter

- CitrineOS core extracted (CSMS OCPP 2.0.1)
- OpenOCPP extracted (firmware OCPP 1.6J/2.0.1)
- ShapeShifter library installed (pip install -e)
- ShapeShifter specification extracted
- EVerest extracted

TODO updated with progress

tools/EVerest-main/lib/everest/util/tests/math/comparison_tests.cpp

@@ -0,0 +1,105 @@
+#include <everest/util/math/comparison.hpp>
+#include <gtest/gtest.h>
+
+namespace everest::lib::util {
+
+class ComparisonTest : public ::testing::Test {};
+
+// --- Floating Point & almost_eq Tests ---
+
+TEST_F(ComparisonTest, RangeLimit) {
+    EXPECT_NEAR(range_limit<double>(1), 0.1, 1e-9);
+    EXPECT_NEAR(range_limit<double>(3), 0.001, 1e-9);
+    EXPECT_EQ(range_limit<double>(0), 1.0);
+    EXPECT_DOUBLE_EQ(range_limit<double>(-1), 10.0);
+    EXPECT_DOUBLE_EQ(range_limit<double>(-2), 100.0);
+    EXPECT_DOUBLE_EQ(range_limit<double>(-3), 1000.0);
+}
+
+TEST_F(ComparisonTest, AlmostEqBasic) {
+    // 3 digits of precision = 0.001 threshold
+    EXPECT_TRUE((almost_eq<3>(1.0001, 1.0002)));
+    EXPECT_FALSE((almost_eq<3>(1.0, 1.002)));
+}
+
+TEST_F(ComparisonTest, AlmostEqNegativePrecision) {
+    // -2 digits of precision = 100.0 threshold
+    EXPECT_TRUE((almost_eq<-2>(207.0, 250.0)));
+    EXPECT_FALSE((almost_eq<-2>(100.0, 250.0)));
+
+    // -1 digit of precision = 10.0 threshold
+    EXPECT_TRUE((almost_eq<-1>(15.0, 22.0)));  // diff 7 < 10
+    EXPECT_FALSE((almost_eq<-1>(15.0, 28.0))); // diff 13 > 10
+}
+
+TEST_F(ComparisonTest, AlmostEqOptional) {
+    std::optional<double> a = 1.0001;
+    std::optional<double> b = 1.0002;
+    std::optional<double> empty;
+
+    EXPECT_TRUE(almost_eq<3>(a, b));
+    EXPECT_TRUE(almost_eq<3>(empty, empty));
+    EXPECT_FALSE(almost_eq<3>(a, empty));
+}
+
+// --- Min/Max Optional Tests ---
+
+TEST_F(ComparisonTest, MinOptional) {
+    std::optional<float> low = 10.0f;
+    std::optional<float> high = 20.0f;
+    std::optional<float> empty;
+
+    // Optional & Optional
+    EXPECT_EQ(min_optional(low, high).value(), 10.0f);
+    EXPECT_EQ(min_optional(low, empty).value(), 10.0f);
+    EXPECT_FALSE(min_optional(empty, empty).has_value());
+
+    // Value & Optional
+    EXPECT_EQ(min_optional(15.0f, high), 15.0f);
+    EXPECT_EQ(min_optional(25.0f, high), 20.0f);
+    EXPECT_EQ(min_optional(25.0f, empty), 25.0f);
+}
+
+TEST_F(ComparisonTest, MaxOptional) {
+    std::optional<float> low = 10.0f;
+    std::optional<float> empty;
+
+    EXPECT_EQ(max_optional(low, 5.0f), 10.0f);
+    EXPECT_EQ(max_optional(low, 15.0f), 15.0f);
+    EXPECT_EQ(max_optional(empty, 15.0f), 15.0f);
+}
+
+// --- Clamping Tests ---
+
+TEST_F(ComparisonTest, ClampOptional) {
+    std::optional<double> min_limit = 10.0;
+    std::optional<double> max_limit = 20.0;
+    std::optional<double> no_limit;
+
+    // Inside range
+    EXPECT_DOUBLE_EQ(clamp_optional(15.0, min_limit, max_limit), 15.0);
+
+    // Underflow
+    EXPECT_DOUBLE_EQ(clamp_optional(5.0, min_limit, max_limit), 10.0);
+
+    // Overflow
+    EXPECT_DOUBLE_EQ(clamp_optional(25.0, min_limit, max_limit), 20.0);
+
+    // One-sided clamping
+    EXPECT_DOUBLE_EQ(clamp_optional(5.0, no_limit, max_limit), 5.0);
+    EXPECT_DOUBLE_EQ(clamp_optional(25.0, min_limit, no_limit), 25.0);
+
+    // No limits
+    EXPECT_DOUBLE_EQ(clamp_optional(100.0, no_limit, no_limit), 100.0);
+}
+
+// --- Noise Range Tests ---
+
+TEST_F(ComparisonTest, InNoiseRange) {
+    EXPECT_TRUE(in_noise_range(10.0, 10.05, 0.1));
+    EXPECT_FALSE(in_noise_range(10.0, 10.11, 0.1));
+    // Exact boundary
+    EXPECT_TRUE(in_noise_range(10.0, 10.1, 0.1));
+}
+
+} // namespace everest::lib::util