[mce] Add charging hysteresis control D-Bus constants. JB#58372

Constants related to exposing charging hysteresis control on D-Bus.

Signed-off-by: Martin Kampas <martin.kampas@jolla.com>

debian/changelog

@@ -1,3 +1,21 @@
+mce-dev (1.30.0) unstable; urgency=low
+
+  * [mce] Add charging hysteresis state D-Bus constants. JB#40062
+
+ -- Simo Piiroinen <simo.piiroinen@jolla.com>  Tue, 22 Feb 2022 04:19:53 +0200
+
+mce-dev (1.29.0) unstable; urgency=low
+
+  * [mce] Add mouse availability state D-Bus constants. JB#55866
+
+ -- Simo Piiroinen <simo.piiroinen@jolla.com>  Mon, 25 Oct 2021 18:09:15 +0300
+
+mce-dev (1.28.3) unstable; urgency=low
+
+  * [mce-dev] Set rpm build arch to noarch
+
+ -- Simo Piiroinen <simo.piiroinen@jollamobile.com>  Tue, 01 Sep 2020 11:42:42 +0300
+
 mce-dev (1.28.2) unstable; urgency=low
 
   * [aarch64] Specify pcdir with use of libdir. Contributes to JB#49681

include/mce/dbus-names.h

@@ -4,8 +4,8 @@
  * <p>
  * This file is part of mce-dev
  * <p>
- * Copyright © 2004-2011 Nokia Corporation and/or its subsidiary(-ies).
- * Copyright (C) 2013-2019 Jolla Ltd.
+ * Copyright (c) 2004 - 2011 Nokia Corporation and/or its subsidiary(-ies).
+ * Copyright (c) 2013 - 2022 Jolla Ltd.
  * Copyright (c) 2019 Open Mobile Platform LLC.
  * <p>
  * @author David Weinehall <david.weinehall@nokia.com>
@@ -919,6 +919,122 @@
  */
 # define MCE_CHARGER_TYPE_SIG             "charger_type_ind"
 
+/** Query current charging hysteresis mode
+ *
+ * @since mce 1.112.0
+ *
+ * @return string: charging hysteresis policy state, one of:
+ * - #MCE_CHARGING_MODE_DISABLE
+ * - #MCE_CHARGING_MODE_ENABLE
+ * - #MCE_CHARGING_MODE_APPLY_THRESHOLDS
+ * - #MCE_CHARGING_MODE_APPLY_THRESHOLDS_AFTER_FULL
+ */
+# define MCE_CHARGING_MODE_GET           "get_charging_mode"
+
+/** Set charging hysteresis mode
+ *
+ * @since mce 1.112.0
+ *
+ * @param string: charging hysteresis policy mode, one of:
+ * - #MCE_CHARGING_MODE_DISABLE
+ * - #MCE_CHARGING_MODE_ENABLE
+ * - #MCE_CHARGING_MODE_APPLY_THRESHOLDS
+ * - #MCE_CHARGING_MODE_APPLY_THRESHOLDS_AFTER_FULL
+ *
+ * @return boolean: success, or error reply in case of failure
+ */
+# define MCE_CHARGING_MODE_SET           "set_charging_mode"
+
+/** Signal that indicates that charging hysteresis mode has changed
+ *
+ * Charging hysteresis policy decision.
+ *
+ * @since mce 1.112.0
+ *
+ * @param string: charging hysteresis policy mode, one of:
+ * - #MCE_CHARGING_MODE_DISABLE
+ * - #MCE_CHARGING_MODE_ENABLE
+ * - #MCE_CHARGING_MODE_APPLY_THRESHOLDS
+ * - #MCE_CHARGING_MODE_APPLY_THRESHOLDS_AFTER_FULL
+ */
+# define MCE_CHARGING_MODE_SIG           "charging_mode_ind"
+
+/** Query current charging hysteresis limit to enable charging
+ *
+ * @since mce 1.112.0
+ *
+ * @return int: charging hysteresis limit to enable charging
+ */
+# define MCE_CHARGING_LIMIT_ENABLE_GET   "get_charging_limit_enable"
+
+/** Set charging hysteresis limit to enable charging
+ *
+ * @since mce 1.112.0
+ *
+ * @param int: charging hysteresis limit to enable charging
+ *
+ * @return boolean: success, or error reply in case of failure
+ */
+# define MCE_CHARGING_LIMIT_ENABLE_SET   "set_charging_limit_enable"
+
+/** Signal that indicates that charging hysteresis limit to enable charging has changed
+ *
+ * @since mce 1.112.0
+ *
+ * @param int: charging hysteresis limit to enable charging
+ */
+# define MCE_CHARGING_LIMIT_ENABLE_SIG   "charging_limit_enable_ind"
+
+/** Query current charging hysteresis limit to disable charging
+ *
+ * @since mce 1.112.0
+ *
+ * @return int: charging hysteresis limit to disable charging
+ */
+# define MCE_CHARGING_LIMIT_DISABLE_GET   "get_charging_limit_disable"
+
+/** Set charging hysteresis limit to disable charging
+ *
+ * @since mce 1.112.0
+ *
+ * @param int: charging hysteresis limit to disable charging
+ *
+ * @return boolean: success, or error reply in case of failure
+ */
+# define MCE_CHARGING_LIMIT_DISABLE_SET   "set_charging_limit_disable"
+
+/** Signal that indicates that charging hysteresis limit to disable charging has changed
+ *
+ * @since mce 1.112.0
+ *
+ * @param int: charging hysteresis limit to disable charging
+ */
+# define MCE_CHARGING_LIMIT_DISABLE_SIG   "charging_limit_disable_ind"
+
+/** Query current charging hysteresis state
+ *
+ * @since mce 1.110.0
+ *
+ * @return string: charging hysteresis policy state, one of:
+ * - #MCE_CHARGING_STATE_UNKNOWN
+ * - #MCE_CHARGING_STATE_ENABLED
+ * - #MCE_CHARGING_STATE_DISABLED
+ */
+# define MCE_CHARGING_STATE_GET           "get_charging_state"
+
+/** Signal that indicates that charging hysteresis state has changed
+ *
+ * Charging hysteresis policy decision.
+ *
+ * @since mce 1.110.0
+ *
+ * @param string: charging hysteresis policy state, one of:
+ * - #MCE_CHARGING_STATE_UNKNOWN
+ * - #MCE_CHARGING_STATE_ENABLED
+ * - #MCE_CHARGING_STATE_DISABLED
+ */
+# define MCE_CHARGING_STATE_SIG           "charging_state_ind"
+
 /*@}*/
 
 /////////////////////////////////////////////////////////////////////////////
@@ -1153,6 +1269,44 @@
 
 /*@}*/
 
+/////////////////////////////////////////////////////////////////////////////
+/////////////////////////////////////////////////////////////////////////////
+/** @name Hardware Mouse Availability
+ *
+ *@{
+ */
+
+/** Query HW mouse availability
+ *
+ * @since mce 1.109.0
+ *
+ * Mouse present
+ *
+ * Used for example in evaluating whether mouse pointer
+ * should be shown or not.
+ *
+ * @return string: availability state, one of:
+ * - #MCE_HARDWARE_MOUSE_UNDEF
+ * - #MCE_HARDWARE_MOUSE_AVAILABLE
+ * - #MCE_HARDWARE_MOUSE_NOT_AVAILABLE
+ */
+# define MCE_HARDWARE_MOUSE_STATE_GET      "mouse_available_state_req"
+
+/** Notify changes in HW mouse availability
+ *
+ * @since mce 1.109.0
+ *
+ * Mouse present
+ *
+ * @return string: availability state, one of:
+ * - #MCE_HARDWARE_MOUSE_UNDEF
+ * - #MCE_HARDWARE_MOUSE_AVAILABLE
+ * - #MCE_HARDWARE_MOUSE_NOT_AVAILABLE
+ */
+# define MCE_HARDWARE_MOUSE_STATE_SIG      "mouse_available_state_ind"
+
+/*@}*/
+
 /////////////////////////////////////////////////////////////////////////////
 /////////////////////////////////////////////////////////////////////////////
 /** @name Sliding Keyboard State

include/mce/mode-names.h

@@ -4,8 +4,8 @@
  * <p>
  * This file is part of mce-dev
  * <p>
- * Copyright © 2004-2011 Nokia Corporation and/or its subsidiary(-ies).
- * Copyright (C) 2012-2019 Jolla Ltd.
+ * Copyright (c) 2004 - 2011 Nokia Corporation and/or its subsidiary(-ies).
+ * Copyright (c) 2012 - 2022 Jolla Ltd.
  * Copyright (c) 2019 Open Mobile Platform LLC.
  * <p>
  * @author David Weinehall <david.weinehall@nokia.com>
@@ -482,6 +482,64 @@
 
 /*@}*/
 
+/////////////////////////////////////////////////////////////////////////////
+/////////////////////////////////////////////////////////////////////////////
+/** @name Charging Hysteresis Mode Constants
+ *
+ *@{
+ */
+
+/** Charging hysteresis policy is to keep charger enabled (default behavior)
+ *
+ * @since mce 1.112.0
+ */
+# define MCE_CHARGING_MODE_ENABLE               "enable"
+
+/** Charging hysteresis policy is to keep charger disabled
+ *
+ * @since mce 1.112.0
+ */
+# define MCE_CHARGING_MODE_DISABLE              "disable"
+
+/** Charging hysteresis policy is to apply thresholds
+ *
+ * @since mce 1.112.0
+ */
+# define MCE_CHARGING_MODE_APPLY_THRESHOLDS     "apply-thresholds"
+
+/** Charging hysteresis policy is to apply thresholds once fully charged
+ *
+ * @since mce 1.112.0
+ */
+# define MCE_CHARGING_MODE_APPLY_THRESHOLDS_AFTER_FULL  "apply-thresholds-after-full"
+/*@}*/
+
+/////////////////////////////////////////////////////////////////////////////
+/////////////////////////////////////////////////////////////////////////////
+/** @name Charging Hysteresis State Constants
+ *
+ *@{
+ */
+
+/** Charging hysteresis policy state is not known
+ *
+ * @since mce 1.110.0
+ */
+# define MCE_CHARGING_STATE_UNKNOWN              "unknown"
+
+/** Charging hysteresis policy allows charging
+ *
+ * @since mce 1.110.0
+ */
+# define MCE_CHARGING_STATE_ENABLED              "enabled"
+
+/** Charging hysteresis policy denies charging
+ *
+ * @since mce 1.110.0
+ */
+# define MCE_CHARGING_STATE_DISABLED             "disabled"
+/*@}*/
+
 /////////////////////////////////////////////////////////////////////////////
 /////////////////////////////////////////////////////////////////////////////
 /** @name Battery Status Constants
@@ -634,6 +692,32 @@
 # define MCE_HARDWARE_KEYBOARD_NOT_AVAILABLE     "not-available"
 /*@}*/
 
+/////////////////////////////////////////////////////////////////////////////
+/////////////////////////////////////////////////////////////////////////////
+/** @name Hardware Mouse Availability Constants
+ *
+ *@{
+ */
+
+/** Hardware Mouse availability is not known
+ *
+ * @since mce 1.109.0
+ */
+# define MCE_HARDWARE_MOUSE_UNDEF                "undef"
+
+/** Hardware Mouse is available
+ *
+ * @since mce 1.109.0
+ */
+# define MCE_HARDWARE_MOUSE_AVAILABLE            "available"
+
+/** Hardware Mouse is not available
+ *
+ * @since mce 1.109.0
+ */
+# define MCE_HARDWARE_MOUSE_NOT_AVAILABLE        "not-available"
+/*@}*/
+
 /////////////////////////////////////////////////////////////////////////////
 /////////////////////////////////////////////////////////////////////////////
 /** @name Feedback Event Name Constants

mce.pc

@@ -3,7 +3,7 @@ includedir=${prefix}/include
 
 Name: mce
 Description: Mode Control Entity
-Version: 1.28.2
+Version: 1.30.0
 Requires:
 Libs:
 Cflags: -I${includedir}

rpm/mce-headers.spec

@@ -1,11 +1,12 @@
 Name:       mce-headers
 Summary:    Development files for mce
-Version:    1.28.2
+Version:    1.30.0
 Release:    1
 Group:      Development/Libraries
 License:    LGPLv2
 URL:        https://git.sailfishos.org/mer-core/mce-dev
 Source0:    %{name}-%{version}.tar.bz2
+BuildArch:  noarch
 BuildRequires:  doxygen
 
 %description