feat: add profiling header and setup for tracepoints

Enable conditional profiling via SConstruct by defining
ACL_PROFILE_ENABLE and ACL_PROFILE_LEVEL macros based on build-time
environment variables. Also introduce the acl_profile.h header to
establish the foundation for upcoming tracepoint instrumentation.

Partially Resolves: COMPMID-8330
Signed-off-by: Walid Ben Romdhane <[email protected]>
Change-Id: I47ceeacf17dd4762d2cdded2042cebe48173d6e8
Reviewed-on: https://review.mlplatform.org/c/ml/ComputeLibrary/+/14671
Comments-Addressed: Arm Jenkins <[email protected]>
Tested-by: Arm Jenkins <[email protected]>
Reviewed-by: Gunes Bayir <[email protected]>
Benchmark: Arm Jenkins <[email protected]>

Author: walidbr

SConstruct

@@ -92,6 +92,8 @@ def update_data_type_layout_flags(env, data_types, data_layouts):
 vars = Variables("scons")
 vars.AddVariables(
     BoolVariable("debug", "Debug", False),
+    BoolVariable("profile", "Profile using Perfetto, forces C++17", False),
+    EnumVariable("profile_level", "Profile level. If not set, defaults to 0", allowed_values=("0", "1", "2"), default="0"),
     BoolVariable("asserts", "Enable asserts (this flag is forced to 1 for debug=1)", False),
     BoolVariable("logging", "Enable Logging", False),
     EnumVariable("arch", "Target Architecture. The x86_32 and x86_64 targets can only be used with neon=0 and opencl=1.", "armv7a",
@@ -250,6 +252,9 @@ env.Append(CXXFLAGS = ['-DARCH_ARM',
 if not 'windows' in env['os']:
     env.Append(CXXFLAGS = ['-Wall','-std=c++14', '-pedantic' ])
 
+if env['profile']:
+    env.Append(CXXFLAGS = ['-std=c++17', '-DACL_PROFILE_ENABLE'])
+    env.Append(CXXFLAGS = ['-DACL_PROFILE_LEVEL=%d' % int(env['profile_level'])])
 
 cpp_tool = {'linux': 'g++', 'android' : 'clang++',
              'tizen': 'g++', 'macos':'clang++',

src/common/utils/profile/acl_profile.h

@@ -0,0 +1,52 @@
+/*
+ * Copyright (c) 2025 Arm Limited.
+ *
+ * SPDX-License-Identifier: MIT
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to
+ * deal in the Software without restriction, including without limitation the
+ * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or
+ * sell copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included in all
+ * copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ * SOFTWARE.
+ */
+
+#ifndef ACL_SRC_COMMON_UTILS_PROFILE_ACL_PROFILE_H
+#define ACL_SRC_COMMON_UTILS_PROFILE_ACL_PROFILE_H
+
+#define ARM_COMPUTE_TRACE_EVENT(category, level, name) \
+    (void)category;                                    \
+    (void)name;                                        \
+    (void)level
+#define ARM_COMPUTE_TRACE_EVENT_BEGIN(category, level, name) \
+    (void)category;                                          \
+    (void)name;                                              \
+    (void)level
+#define ARM_COMPUTE_TRACE_EVENT_END(category, level) \
+    (void)category;                                  \
+    (void)level
+#define ARM_COMPUTE_PROFILE_INIT() \
+    do                             \
+    {                              \
+    } while (0)
+#define ARM_COMPUTE_PROFILE_STATIC_STORAGE() \
+    do                                       \
+    {                                        \
+    } while (0)
+#define ARM_COMPUTE_PROFILE_FINISH() \
+    do                               \
+    {                                \
+    } while (0)
+
+#endif // ACL_SRC_COMMON_UTILS_PROFILE_ACL_PROFILE_H