David Beck | 1b61be5 | 2018-11-08 09:19:14 +0000 | [diff] [blame] | 1 | // |
| 2 | // Copyright © 2017 Arm Ltd. All rights reserved. |
| 3 | // SPDX-License-Identifier: MIT |
| 4 | // |
| 5 | |
| 6 | #include "ClBackendContext.hpp" |
Derek Lamberti | 836b27b | 2019-11-20 10:51:57 +0000 | [diff] [blame] | 7 | #include "ClContextControl.hpp" |
Derek Lamberti | 0844697 | 2019-11-26 16:38:31 +0000 | [diff] [blame] | 8 | |
| 9 | #include <armnn/Logging.hpp> |
Narumol Prangnawarat | ac2770a | 2020-04-01 16:51:23 +0100 | [diff] [blame] | 10 | #include <armnn/utility/Assert.hpp> |
Jan Eilers | bb446e5 | 2020-04-02 13:56:54 +0100 | [diff] [blame] | 11 | #include <armnn/utility/PolymorphicDowncast.hpp> |
Derek Lamberti | 0844697 | 2019-11-26 16:38:31 +0000 | [diff] [blame] | 12 | |
David Beck | 1b61be5 | 2018-11-08 09:19:14 +0000 | [diff] [blame] | 13 | #include <arm_compute/core/CL/OpenCL.h> |
| 14 | #include <arm_compute/core/CL/CLKernelLibrary.h> |
| 15 | #include <arm_compute/runtime/CL/CLScheduler.h> |
Derek Lamberti | 836b27b | 2019-11-20 10:51:57 +0000 | [diff] [blame] | 16 | #include <arm_compute/runtime/CL/CLTunerTypes.h> |
| 17 | |
David Beck | 1b61be5 | 2018-11-08 09:19:14 +0000 | [diff] [blame] | 18 | namespace armnn |
| 19 | { |
| 20 | |
| 21 | struct ClBackendContext::ClContextControlWrapper |
| 22 | { |
Derek Lamberti | 836b27b | 2019-11-20 10:51:57 +0000 | [diff] [blame] | 23 | ClContextControlWrapper(arm_compute::CLTuner* tuner, |
David Beck | 1b61be5 | 2018-11-08 09:19:14 +0000 | [diff] [blame] | 24 | bool profilingEnabled) |
Derek Lamberti | 836b27b | 2019-11-20 10:51:57 +0000 | [diff] [blame] | 25 | : m_ClContextControl(tuner, profilingEnabled) |
David Beck | 1b61be5 | 2018-11-08 09:19:14 +0000 | [diff] [blame] | 26 | {} |
| 27 | |
| 28 | bool Sync() |
| 29 | { |
David Beck | 1b61be5 | 2018-11-08 09:19:14 +0000 | [diff] [blame] | 30 | if (arm_compute::CLScheduler::get().context()() != NULL) |
| 31 | { |
| 32 | // Waits for all queued CL requests to finish before unloading the network they may be using. |
| 33 | try |
| 34 | { |
| 35 | // Coverity fix: arm_compute::CLScheduler::sync() may throw an exception of type cl::Error. |
| 36 | arm_compute::CLScheduler::get().sync(); |
| 37 | } |
| 38 | catch (const cl::Error&) |
| 39 | { |
Derek Lamberti | 0844697 | 2019-11-26 16:38:31 +0000 | [diff] [blame] | 40 | ARMNN_LOG(warning) << "Runtime::UnloadNetwork(): an error occurred while waiting for " |
| 41 | "the queued CL requests to finish"; |
David Beck | 1b61be5 | 2018-11-08 09:19:14 +0000 | [diff] [blame] | 42 | return false; |
| 43 | } |
| 44 | } |
Aron Virginas-Tar | d46e647 | 2018-11-16 10:26:23 +0000 | [diff] [blame] | 45 | |
David Beck | 1b61be5 | 2018-11-08 09:19:14 +0000 | [diff] [blame] | 46 | return true; |
| 47 | } |
| 48 | |
| 49 | void ClearClCache() |
| 50 | { |
David Beck | 1b61be5 | 2018-11-08 09:19:14 +0000 | [diff] [blame] | 51 | if (arm_compute::CLScheduler::get().context()() != NULL) |
| 52 | { |
| 53 | // There are no loaded networks left, so clear the CL cache to free up memory |
| 54 | m_ClContextControl.ClearClCache(); |
| 55 | } |
David Beck | 1b61be5 | 2018-11-08 09:19:14 +0000 | [diff] [blame] | 56 | } |
| 57 | |
David Beck | 1b61be5 | 2018-11-08 09:19:14 +0000 | [diff] [blame] | 58 | ClContextControl m_ClContextControl; |
| 59 | }; |
| 60 | |
Derek Lamberti | 836b27b | 2019-11-20 10:51:57 +0000 | [diff] [blame] | 61 | std::string LowerString(std::string value) |
| 62 | { |
| 63 | std::transform(value.begin(), value.end(), value.begin(), |
| 64 | [](unsigned char c){ return std::tolower(c); }); |
| 65 | |
| 66 | return value; |
| 67 | } |
| 68 | |
| 69 | enum class TuningLevel |
| 70 | { |
| 71 | None, |
| 72 | Rapid, |
| 73 | Normal, |
| 74 | Exhaustive |
| 75 | }; |
| 76 | |
| 77 | |
| 78 | TuningLevel ParseTuningLevel(const BackendOptions::Var& value, TuningLevel defaultValue) |
| 79 | { |
| 80 | if (value.IsInt()) |
| 81 | { |
alered01 | a7227ac | 2020-05-07 14:58:29 +0100 | [diff] [blame] | 82 | int v = value.AsInt(); |
Derek Lamberti | 836b27b | 2019-11-20 10:51:57 +0000 | [diff] [blame] | 83 | if (v > static_cast<int>(TuningLevel::Exhaustive) || |
| 84 | v < static_cast<int>(TuningLevel::None)) |
| 85 | { |
| 86 | ARMNN_LOG(warning) << "Invalid GpuAcc tuning level ("<< v << ") selected. " |
| 87 | "Using default(" << static_cast<int>(defaultValue) << ")"; |
| 88 | } else |
| 89 | { |
| 90 | return static_cast<TuningLevel>(v); |
| 91 | } |
| 92 | } |
| 93 | return defaultValue; |
| 94 | } |
| 95 | |
| 96 | bool ParseBoolean(const BackendOptions::Var& value, bool defaultValue) |
| 97 | { |
| 98 | if (value.IsBool()) |
| 99 | { |
| 100 | return value.AsBool(); |
| 101 | } |
Derek Lamberti | 836b27b | 2019-11-20 10:51:57 +0000 | [diff] [blame] | 102 | return defaultValue; |
| 103 | } |
| 104 | |
| 105 | std::string ParseFile(const BackendOptions::Var& value, std::string defaultValue) |
| 106 | { |
| 107 | if (value.IsString()) |
| 108 | { |
| 109 | return value.AsString(); |
| 110 | } |
| 111 | return defaultValue; |
| 112 | } |
| 113 | |
Derek Lamberti | 5c510f8 | 2020-02-11 12:56:52 +0000 | [diff] [blame] | 114 | void ConfigureTuner(arm_compute::CLTuner &tuner, TuningLevel level) |
| 115 | { |
| 116 | tuner.set_tune_new_kernels(true); // Turn on tuning initially. |
| 117 | |
| 118 | switch (level) |
| 119 | { |
| 120 | case TuningLevel::Rapid: |
Jan Eilers | 2cd1847 | 2020-12-15 10:42:38 +0000 | [diff] [blame^] | 121 | ARMNN_LOG(info) << "Gpu tuning is activated. TuningLevel: Rapid (1)"; |
Derek Lamberti | 5c510f8 | 2020-02-11 12:56:52 +0000 | [diff] [blame] | 122 | tuner.set_tuner_mode(arm_compute::CLTunerMode::RAPID); |
| 123 | break; |
| 124 | case TuningLevel::Normal: |
Jan Eilers | 2cd1847 | 2020-12-15 10:42:38 +0000 | [diff] [blame^] | 125 | ARMNN_LOG(info) << "Gpu tuning is activated. TuningLevel: Normal (2)"; |
Derek Lamberti | 5c510f8 | 2020-02-11 12:56:52 +0000 | [diff] [blame] | 126 | tuner.set_tuner_mode(arm_compute::CLTunerMode::NORMAL); |
| 127 | break; |
| 128 | case TuningLevel::Exhaustive: |
Jan Eilers | 2cd1847 | 2020-12-15 10:42:38 +0000 | [diff] [blame^] | 129 | ARMNN_LOG(info) << "Gpu tuning is activated. TuningLevel: Exhaustive (3)"; |
Derek Lamberti | 5c510f8 | 2020-02-11 12:56:52 +0000 | [diff] [blame] | 130 | tuner.set_tuner_mode(arm_compute::CLTunerMode::EXHAUSTIVE); |
| 131 | break; |
| 132 | case TuningLevel::None: |
| 133 | default: |
| 134 | tuner.set_tune_new_kernels(false); // Turn off tuning. Set to "use" only mode. |
| 135 | break; |
| 136 | } |
| 137 | } |
| 138 | |
David Beck | 1b61be5 | 2018-11-08 09:19:14 +0000 | [diff] [blame] | 139 | ClBackendContext::ClBackendContext(const IRuntime::CreationOptions& options) |
| 140 | : IBackendContext(options) |
Derek Lamberti | 5c510f8 | 2020-02-11 12:56:52 +0000 | [diff] [blame] | 141 | , m_TuningFile() |
David Beck | 1b61be5 | 2018-11-08 09:19:14 +0000 | [diff] [blame] | 142 | { |
Derek Lamberti | 836b27b | 2019-11-20 10:51:57 +0000 | [diff] [blame] | 143 | bool kernelProfiling = options.m_EnableGpuProfiling; |
Derek Lamberti | 836b27b | 2019-11-20 10:51:57 +0000 | [diff] [blame] | 144 | |
Derek Lamberti | 836b27b | 2019-11-20 10:51:57 +0000 | [diff] [blame] | 145 | arm_compute::CLTuner* tuner = nullptr; |
Derek Lamberti | ef7e6b6 | 2020-02-04 14:49:16 +0000 | [diff] [blame] | 146 | bool useLegacyTunerAPI = options.m_GpuAccTunedParameters.get() != nullptr; |
| 147 | if (useLegacyTunerAPI) |
Derek Lamberti | 836b27b | 2019-11-20 10:51:57 +0000 | [diff] [blame] | 148 | { |
Jan Eilers | bb446e5 | 2020-04-02 13:56:54 +0100 | [diff] [blame] | 149 | auto clTunerParams = PolymorphicDowncast<ClTunedParameters*>( |
Derek Lamberti | ef7e6b6 | 2020-02-04 14:49:16 +0000 | [diff] [blame] | 150 | options.m_GpuAccTunedParameters.get()); |
Derek Lamberti | 5c510f8 | 2020-02-11 12:56:52 +0000 | [diff] [blame] | 151 | tuner = &clTunerParams->m_Tuner; |
Derek Lamberti | 836b27b | 2019-11-20 10:51:57 +0000 | [diff] [blame] | 152 | |
Derek Lamberti | 5c510f8 | 2020-02-11 12:56:52 +0000 | [diff] [blame] | 153 | if (tuner) |
Derek Lamberti | 836b27b | 2019-11-20 10:51:57 +0000 | [diff] [blame] | 154 | { |
Derek Lamberti | 5c510f8 | 2020-02-11 12:56:52 +0000 | [diff] [blame] | 155 | auto ConvertTuningLevel = [](IGpuAccTunedParameters::TuningLevel level, |
| 156 | armnn::IGpuAccTunedParameters::Mode mode) |
Derek Lamberti | 836b27b | 2019-11-20 10:51:57 +0000 | [diff] [blame] | 157 | { |
Derek Lamberti | 5c510f8 | 2020-02-11 12:56:52 +0000 | [diff] [blame] | 158 | if (mode == armnn::IGpuAccTunedParameters::Mode::UseTunedParameters) |
| 159 | { |
| 160 | return TuningLevel::None; |
| 161 | } |
| 162 | |
Derek Lamberti | ef7e6b6 | 2020-02-04 14:49:16 +0000 | [diff] [blame] | 163 | switch(level) |
Derek Lamberti | 836b27b | 2019-11-20 10:51:57 +0000 | [diff] [blame] | 164 | { |
Derek Lamberti | ef7e6b6 | 2020-02-04 14:49:16 +0000 | [diff] [blame] | 165 | case IGpuAccTunedParameters::TuningLevel::Rapid: |
Derek Lamberti | 5c510f8 | 2020-02-11 12:56:52 +0000 | [diff] [blame] | 166 | return TuningLevel::Rapid; |
Derek Lamberti | ef7e6b6 | 2020-02-04 14:49:16 +0000 | [diff] [blame] | 167 | case IGpuAccTunedParameters::TuningLevel::Normal: |
Derek Lamberti | 5c510f8 | 2020-02-11 12:56:52 +0000 | [diff] [blame] | 168 | return TuningLevel::Normal; |
Derek Lamberti | ef7e6b6 | 2020-02-04 14:49:16 +0000 | [diff] [blame] | 169 | case IGpuAccTunedParameters::TuningLevel::Exhaustive: |
Derek Lamberti | 5c510f8 | 2020-02-11 12:56:52 +0000 | [diff] [blame] | 170 | return TuningLevel::Exhaustive; |
Derek Lamberti | ef7e6b6 | 2020-02-04 14:49:16 +0000 | [diff] [blame] | 171 | default: |
| 172 | { |
Narumol Prangnawarat | ac2770a | 2020-04-01 16:51:23 +0100 | [diff] [blame] | 173 | ARMNN_ASSERT_MSG(false, "Tuning level not recognised."); |
Derek Lamberti | 5c510f8 | 2020-02-11 12:56:52 +0000 | [diff] [blame] | 174 | return TuningLevel::None; |
Derek Lamberti | ef7e6b6 | 2020-02-04 14:49:16 +0000 | [diff] [blame] | 175 | } |
Derek Lamberti | 836b27b | 2019-11-20 10:51:57 +0000 | [diff] [blame] | 176 | } |
Derek Lamberti | ef7e6b6 | 2020-02-04 14:49:16 +0000 | [diff] [blame] | 177 | }; |
Derek Lamberti | 836b27b | 2019-11-20 10:51:57 +0000 | [diff] [blame] | 178 | |
Derek Lamberti | 5c510f8 | 2020-02-11 12:56:52 +0000 | [diff] [blame] | 179 | TuningLevel tuningLevel = ConvertTuningLevel(clTunerParams->m_TuningLevel, clTunerParams->m_Mode); |
| 180 | ConfigureTuner(*tuner, tuningLevel); |
Derek Lamberti | ef7e6b6 | 2020-02-04 14:49:16 +0000 | [diff] [blame] | 181 | } |
| 182 | } |
| 183 | else //New backend options API |
| 184 | { |
Derek Lamberti | 5c510f8 | 2020-02-11 12:56:52 +0000 | [diff] [blame] | 185 | const TuningLevel defaultTuningLevel = TuningLevel::None; |
| 186 | auto tuningLevel = defaultTuningLevel; |
| 187 | |
Derek Lamberti | ef7e6b6 | 2020-02-04 14:49:16 +0000 | [diff] [blame] | 188 | ParseOptions(options.m_BackendOptions, "GpuAcc", [&](std::string name, const BackendOptions::Var& value) |
Derek Lamberti | 836b27b | 2019-11-20 10:51:57 +0000 | [diff] [blame] | 189 | { |
Derek Lamberti | ef7e6b6 | 2020-02-04 14:49:16 +0000 | [diff] [blame] | 190 | if (name == "KernelProfilingEnabled") |
| 191 | { |
| 192 | kernelProfiling |= ParseBoolean(value, false); |
| 193 | } else if (name == "TuningFile") |
| 194 | { |
| 195 | m_TuningFile = ParseFile(value, ""); |
| 196 | } else if (name == "TuningLevel") |
| 197 | { |
| 198 | tuningLevel = ParseTuningLevel(value, defaultTuningLevel); |
| 199 | } |
| 200 | }); |
Derek Lamberti | 836b27b | 2019-11-20 10:51:57 +0000 | [diff] [blame] | 201 | |
Derek Lamberti | ef7e6b6 | 2020-02-04 14:49:16 +0000 | [diff] [blame] | 202 | // Create the tuner, in tuning mode initially. |
| 203 | m_Tuner = std::make_unique<arm_compute::CLTuner>(true); |
| 204 | |
Derek Lamberti | 5c510f8 | 2020-02-11 12:56:52 +0000 | [diff] [blame] | 205 | ConfigureTuner(*(m_Tuner.get()), tuningLevel); |
Derek Lamberti | ef7e6b6 | 2020-02-04 14:49:16 +0000 | [diff] [blame] | 206 | |
alered01 | a7227ac | 2020-05-07 14:58:29 +0100 | [diff] [blame] | 207 | if (!m_TuningFile.empty() && tuningLevel == TuningLevel::None) |
Derek Lamberti | ef7e6b6 | 2020-02-04 14:49:16 +0000 | [diff] [blame] | 208 | { |
Derek Lamberti | 836b27b | 2019-11-20 10:51:57 +0000 | [diff] [blame] | 209 | try |
| 210 | { |
Jan Eilers | 2cd1847 | 2020-12-15 10:42:38 +0000 | [diff] [blame^] | 211 | ARMNN_LOG(info) << "Loading Gpu tuning data from file: " << m_TuningFile; |
Derek Lamberti | 836b27b | 2019-11-20 10:51:57 +0000 | [diff] [blame] | 212 | m_Tuner->load_from_file(m_TuningFile.c_str()); |
alered01 | a7227ac | 2020-05-07 14:58:29 +0100 | [diff] [blame] | 213 | } |
| 214 | catch (const std::exception& e) |
Derek Lamberti | 836b27b | 2019-11-20 10:51:57 +0000 | [diff] [blame] | 215 | { |
| 216 | ARMNN_LOG(warning) << "Could not load GpuAcc tuner data file."; |
| 217 | } |
Derek Lamberti | 836b27b | 2019-11-20 10:51:57 +0000 | [diff] [blame] | 218 | } |
alered01 | a7227ac | 2020-05-07 14:58:29 +0100 | [diff] [blame] | 219 | tuner = m_Tuner.get(); |
Derek Lamberti | 836b27b | 2019-11-20 10:51:57 +0000 | [diff] [blame] | 220 | } |
| 221 | |
| 222 | m_ClContextControlWrapper = std::make_unique<ClContextControlWrapper>( |
| 223 | tuner, |
| 224 | kernelProfiling |
| 225 | ); |
David Beck | 1b61be5 | 2018-11-08 09:19:14 +0000 | [diff] [blame] | 226 | } |
| 227 | |
| 228 | bool ClBackendContext::BeforeLoadNetwork(NetworkId) |
| 229 | { |
| 230 | return true; |
| 231 | } |
| 232 | |
| 233 | bool ClBackendContext::AfterLoadNetwork(NetworkId networkId) |
| 234 | { |
| 235 | { |
| 236 | std::lock_guard<std::mutex> lockGuard(m_Mutex); |
| 237 | m_NetworkIds.insert(networkId); |
| 238 | } |
| 239 | return true; |
| 240 | } |
| 241 | |
| 242 | bool ClBackendContext::BeforeUnloadNetwork(NetworkId) |
| 243 | { |
| 244 | return m_ClContextControlWrapper->Sync(); |
| 245 | } |
| 246 | |
| 247 | bool ClBackendContext::AfterUnloadNetwork(NetworkId networkId) |
| 248 | { |
| 249 | bool clearCache = false; |
| 250 | { |
| 251 | std::lock_guard<std::mutex> lockGuard(m_Mutex); |
| 252 | m_NetworkIds.erase(networkId); |
| 253 | clearCache = m_NetworkIds.empty(); |
| 254 | } |
| 255 | |
| 256 | if (clearCache) |
| 257 | { |
| 258 | m_ClContextControlWrapper->ClearClCache(); |
| 259 | } |
| 260 | |
| 261 | return true; |
| 262 | } |
| 263 | |
| 264 | ClBackendContext::~ClBackendContext() |
| 265 | { |
Derek Lamberti | 836b27b | 2019-11-20 10:51:57 +0000 | [diff] [blame] | 266 | if (m_Tuner && !m_TuningFile.empty()) |
| 267 | { |
| 268 | try |
| 269 | { |
| 270 | m_Tuner->save_to_file(m_TuningFile.c_str()); |
| 271 | } |
| 272 | catch(const std::exception& e) |
| 273 | { |
| 274 | ARMNN_LOG(warning) << "Could not save GpuAcc tuner data to file " << m_TuningFile; |
| 275 | } |
| 276 | } |
David Beck | 1b61be5 | 2018-11-08 09:19:14 +0000 | [diff] [blame] | 277 | } |
| 278 | |
| 279 | } // namespace armnn |