Wrap Qualcomm options C enums into C++.

LiteRT-PiperOrigin-RevId: 826495047

Author: gcarranza-1

litert/cc/options/litert_qualcomm_options.cc

@@ -46,16 +46,35 @@ Expected<QualcommOptions> QualcommOptions::Create() {
   return QualcommOptions(options, litert::OwnHandle::kYes);
 }
 
+void QualcommOptions::SetLogLevel(QualcommOptions::LogLevel log_level) {
+  internal::AssertOk(LiteRtQualcommOptionsSetLogLevel, Data(),
+                     static_cast<LiteRtQualcommOptionsLogLevel>(log_level));
+}
+
 void QualcommOptions::SetLogLevel(LiteRtQualcommOptionsLogLevel log_level) {
   internal::AssertOk(LiteRtQualcommOptionsSetLogLevel, Data(), log_level);
 }
 
+QualcommOptions::LogLevel QualcommOptions::GetLogLevelCC() {
+  LiteRtQualcommOptionsLogLevel log_level;
+  internal::AssertOk(LiteRtQualcommOptionsGetLogLevel, Data(), &log_level);
+  return static_cast<QualcommOptions::LogLevel>(log_level);
+}
+
 LiteRtQualcommOptionsLogLevel QualcommOptions::GetLogLevel() {
   LiteRtQualcommOptionsLogLevel log_level;
   internal::AssertOk(LiteRtQualcommOptionsGetLogLevel, Data(), &log_level);
   return log_level;
 }
 
+void QualcommOptions::SetHtpPerformanceMode(
+    QualcommOptions::HtpPerformanceMode htp_performance_mode) {
+  internal::AssertOk(
+      LiteRtQualcommOptionsSetHtpPerformanceMode, Data(),
+      static_cast<LiteRtQualcommOptionsHtpPerformanceMode>(
+          htp_performance_mode));
+}
+
 void QualcommOptions::SetHtpPerformanceMode(
     LiteRtQualcommOptionsHtpPerformanceMode htp_performance_mode) {
   internal::AssertOk(LiteRtQualcommOptionsSetHtpPerformanceMode, Data(),
@@ -106,10 +125,21 @@ bool QualcommOptions::GetUseQint16AsQuint16() {
   return use_qin16_as_quint16;
 }
 
+void QualcommOptions::SetProfiling(QualcommOptions::Profiling profiling) {
+  internal::AssertOk(LiteRtQualcommOptionsSetProfiling, Data(),
+                     static_cast<LiteRtQualcommOptionsProfiling>(profiling));
+}
+
 void QualcommOptions::SetProfiling(LiteRtQualcommOptionsProfiling profiling) {
   internal::AssertOk(LiteRtQualcommOptionsSetProfiling, Data(), profiling);
 }
 
+QualcommOptions::Profiling QualcommOptions::GetProfilingCC() {
+  LiteRtQualcommOptionsProfiling profiling;
+  internal::AssertOk(LiteRtQualcommOptionsGetProfiling, Data(), &profiling);
+  return static_cast<QualcommOptions::Profiling>(profiling);
+}
+
 LiteRtQualcommOptionsProfiling QualcommOptions::GetProfiling() {
   LiteRtQualcommOptionsProfiling profiling;
   internal::AssertOk(LiteRtQualcommOptionsGetProfiling, Data(), &profiling);
@@ -170,12 +200,27 @@ std::uint32_t QualcommOptions::GetNumHvxThreads() {
   return num_hvx_threads;
 }
 
+void QualcommOptions::SetOptimizationLevel(
+    QualcommOptions::OptimizationLevel optimization_level) {
+  internal::AssertOk(
+      LiteRtQualcommOptionsSetOptimizationLevel, Data(),
+      static_cast<LiteRtQualcommOptionsOptimizationLevel>(optimization_level));
+}
+
 void QualcommOptions::SetOptimizationLevel(
     LiteRtQualcommOptionsOptimizationLevel optimization_level) {
   internal::AssertOk(LiteRtQualcommOptionsSetOptimizationLevel, Data(),
                      optimization_level);
 }
 
+QualcommOptions::OptimizationLevel QualcommOptions::GetOptimizationLevelCC() {
+  LiteRtQualcommOptionsOptimizationLevel optimization_level;
+  internal::AssertOk(LiteRtQualcommOptionsGetOptimizationLevel, Data(),
+                     &optimization_level);
+  return static_cast<QualcommOptions::OptimizationLevel>(
+      optimization_level);
+}
+
 LiteRtQualcommOptionsOptimizationLevel QualcommOptions::GetOptimizationLevel() {
   LiteRtQualcommOptionsOptimizationLevel optimization_level;
   internal::AssertOk(LiteRtQualcommOptionsGetOptimizationLevel, Data(),

litert/cc/options/litert_qualcomm_options.h

@@ -41,29 +41,97 @@ class QualcommOptions : public OpaqueOptions {
 
   static Expected<QualcommOptions> Create();
 
+  // This determines the logging level of all underlying qualcomm sdk libraries.
+  // Does not effect litert logging. Defaults to INFO.
+  enum class LogLevel : int {
+    kOff = kLiteRtQualcommLogOff,
+    kError = kLiteRtQualcommLogLevelError,
+    kWarn = kLiteRtQualcommLogLevelWarn,
+    kInfo = kLiteRtQualcommLogLevelInfo,
+    kVerbose = kLiteRtQualcommLogLevelVerbose,
+    kDebug = kLiteRtQualcommLogLevelDebug,
+  };
+
+  void SetLogLevel(LogLevel log_level);
+
+  [[deprecated("Use SetLogLevel(QualcommOptionsLogLevel) instead.")]]
   void SetLogLevel(LiteRtQualcommOptionsLogLevel log_level);
+
+  // TODO(b/454666070): Rename to GetLogLevel once the deprecated function is
+  // removed.
+  LogLevel GetLogLevelCC();
+
+  [[deprecated("Use GetLogLevelCC() instead.")]]
   LiteRtQualcommOptionsLogLevel GetLogLevel();
 
+  // This option controls whether to convert a LiteRt operation to QNN
+  // operations which are preferred by the HTP backend. Defaults to false.
+  enum class HtpPerformanceMode : int {
+    kDefault = kLiteRtQualcommHtpPerformanceModeDefault,
+    kSustainedHighPerformance =
+        kLiteRtQualcommHtpPerformanceModeSustainedHighPerformance,
+    kBurst = kLiteRtQualcommHtpPerformanceModeBurst,
+    kHighPerformance = kLiteRtQualcommHtpPerformanceModeHighPerformance,
+    kPowerSaver = kLiteRtQualcommHtpPerformanceModePowerSaver,
+    kLowPowerSaver = kLiteRtQualcommHtpPerformanceModeLowPowerSaver,
+    kHighPowerSaver = kLiteRtQualcommHtpPerformanceModeHighPowerSaver,
+    kLowBalanced = kLiteRtQualcommHtpPerformanceModeLowBalanced,
+    kBalanced = kLiteRtQualcommHtpPerformanceModeBalanced,
+    kExtremePowerSaver = kLiteRtQualcommHtpPerformanceModeExtremePowerSaver,
+  };
+
+  void SetHtpPerformanceMode(HtpPerformanceMode htp_performance_mode);
+
+  [[deprecated("Use SetLogLevel(QualcommOptionsLogLevel) instead.")]]
   void SetHtpPerformanceMode(
       LiteRtQualcommOptionsHtpPerformanceMode htp_performance_mode);
   LiteRtQualcommOptionsHtpPerformanceMode GetHtpPerformanceMode();
 
   void SetUseHtpPreference(bool use_htp_preference);
   bool GetUseHtpPreference();
 
+  // This option controls whether to convert a quantized int16 model to a
+  // quantized uint16 model. Defaults to false.
   void SetUseQint16AsQuint16(bool use_qin16_as_quint16);
   bool GetUseQint16AsQuint16();
 
+  // Weight sharing indicates whether different subgraphs may share weight
+  // tensors. This is only supported on x86 AOT. Defaults to false.
   void SetEnableWeightSharing(bool weight_sharing_enabled);
   bool GetEnableWeightSharing();
 
+  // When using short conv hmx, one might have better performance, but
+  // convolution that have short depth and/or weights that are not symmetric
+  // could exhibit inaccurate results.
   void SetUseConvHMX(bool use_conv_hmx);
   bool GetUseConvHMX();
 
+  // When using fold relu, one might have better performance. This optimization
+  // is correct when quantization ranges for convolution are equal to or are
+  // subset of the Relu operation.
   void SetUseFoldReLU(bool use_fold_relu);
   bool GetUseFoldReLU();
 
+  // This option controls the profiling level. A higher level results in a more
+  // detailed report after execution. Defaults to off.
+  enum class Profiling : int {
+    kOff = kLiteRtQualcommProfilingOff,
+    kBasic = kLiteRtQualcommProfilingBasic,
+    kDetailed = kLiteRtQualcommProfilingDetailed,
+    kLinting = kLiteRtQualcommProfilingLinting,
+    kOptrace = kLiteRtQualcommProfilingOptrace,
+  };
+
+  void SetProfiling(Profiling profiling);
+
+  [[deprecated("Use SetProfiling(QualcommOptionsProfiling) instead.")]]
   void SetProfiling(LiteRtQualcommOptionsProfiling profiling);
+
+  // TODO(b/454666070): Rename to GetProfiling once the deprecated function is
+  // removed.
+  Profiling GetProfilingCC();
+
+  [[deprecated("Use GetProfilingCC() instead.")]]
   LiteRtQualcommOptionsProfiling GetProfiling();
 
   void SetDumpTensorIds(const std::vector<std::int32_t>& ids);
@@ -78,8 +146,25 @@ class QualcommOptions : public OpaqueOptions {
   void SetNumHvxThreads(std::uint32_t num_hvx_threads);
   std::uint32_t GetNumHvxThreads();
 
+  enum class OptimizationLevel : int {
+    kOptimizeForInference = kHtpOptimizeForInference,
+    kOptimizeForPrepare = kHtpOptimizeForPrepare,
+    kOptimizeForInferenceO3 = kHtpOptimizeForInferenceO3,
+  };
+
+  void SetOptimizationLevel(OptimizationLevel optimization_level);
+
+  [[deprecated(
+      "Use SetOptimizationLevel(QualcommOptionsOptimizationLevel) "
+      "instead.")]]
   void SetOptimizationLevel(
       LiteRtQualcommOptionsOptimizationLevel optimization_level);
+
+  // TODO(b/454666070): Rename to GetOptimizationLevel once the deprecated
+  // function is removed.
+  OptimizationLevel GetOptimizationLevelCC();
+
+  [[deprecated("Use GetOptimizationLevelCC() instead.")]]
   LiteRtQualcommOptionsOptimizationLevel GetOptimizationLevel();
 
  private: