libximc 3.0.4__tar.gz → 3.1.2__tar.gz

{libximc-3.0.4 → libximc-3.1.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: libximc
-Version: 3.0.4
+Version: 3.1.2
 Summary: Package for operating STANDA 8SMC5 controllers
 Author-email: STANDA LTD <8smc4@standa.lt>
 License: Copyright (c) 2023 STANDA LTD

{libximc-3.0.4 → libximc-3.1.2}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "libximc"
-version = "3.0.4"
+version = "3.1.2"
 authors = [
   { name="STANDA LTD", email="8smc4@standa.lt" },
 ]

{libximc-3.0.4 → libximc-3.1.2}/src/libximc/highlevel/_flag_enumerations.py

@@ -155,14 +155,15 @@ class MoveFlags(StrictIntFlag):
 
 
 class EngineFlags(StrictIntFlag):
-    ENGINE_REVERSE = 0x01
-    ENGINE_CURRENT_AS_RMS = 0x02
-    ENGINE_MAX_SPEED = 0x04
-    ENGINE_ANTIPLAY = 0x08
-    ENGINE_ACCEL_ON = 0x10
-    ENGINE_LIMIT_VOLT = 0x20
-    ENGINE_LIMIT_CURR = 0x40
-    ENGINE_LIMIT_RPM = 0x80
+    ENGINE_REVERSE = 0x001
+    ENGINE_CURRENT_AS_RMS = 0x002
+    ENGINE_MAX_SPEED = 0x004
+    ENGINE_ANTIPLAY = 0x008
+    ENGINE_ACCEL_ON = 0x010
+    ENGINE_LIMIT_VOLT = 0x020
+    ENGINE_LIMIT_CURR = 0x040
+    ENGINE_LIMIT_RPM = 0x080
+    ENGINE_USE_PEAK_CURRENT = 0x100
 
 
 class MicrostepMode(IntEnum):

{libximc-3.0.4 → libximc-3.1.2}/src/libximc/highlevel/_highlevel.py

@@ -376,7 +376,8 @@ class Axis:
                                                int(settings.EngineFlags),
                                                settings.Antiplay,
                                                int(settings.MicrostepMode),
-                                               settings.StepsPerRev)
+                                               settings.StepsPerRev,
+                                               settings.PeakCurrent)
         _check_result(lib.set_engine_settings(self._device_id, byref(engine_settings)))
 
     def set_engine_settings_calb(self, settings: engine_settings_calb_t) -> None:
@@ -400,7 +401,8 @@ class Axis:
                                                     int(settings.EngineFlags),
                                                     settings.Antiplay,
                                                     int(settings.MicrostepMode),
-                                                    settings.StepsPerRev)
+                                                    settings.StepsPerRev,
+                                                    settings.PeakCurrent)
         _check_result(lib.set_engine_settings_calb(self._device_id, byref(engine_settings), byref(self._calib)))
 
     def get_engine_settings(self) -> engine_settings_t:
@@ -422,7 +424,8 @@ class Axis:
                                  engine_settings.EngineFlags,
                                  engine_settings.Antiplay,
                                  engine_settings.MicrostepMode,
-                                 engine_settings.StepsPerRev)
+                                 engine_settings.StepsPerRev,
+                                 engine_settings.PeakCurrent)
 
     def get_engine_settings_calb(self) -> engine_settings_calb_t:
         """Read user unit engine settings.
@@ -442,7 +445,8 @@ class Axis:
                                       engine_settings.EngineFlags,
                                       engine_settings.Antiplay,
                                       engine_settings.MicrostepMode,
-                                      engine_settings.StepsPerRev)
+                                      engine_settings.StepsPerRev,
+                                      engine_settings.PeakCurrent)
 
     def set_entype_settings(self, settings: entype_settings_t) -> None:
         """Set engine type and driver type.

{libximc-3.0.4 → libximc-3.1.2}/src/libximc/highlevel/_structure_types.py

@@ -700,7 +700,8 @@ class engine_settings_t:
             EngineFlags: flag_enumerations.EngineFlags = NOT_INITIALIZED,
             Antiplay: int = NOT_INITIALIZED,
             MicrostepMode: flag_enumerations.MicrostepMode = NOT_INITIALIZED,
-            StepsPerRev: int = NOT_INITIALIZED):
+            StepsPerRev: int = NOT_INITIALIZED,
+            PeakCurrent: int = NOT_INITIALIZED):
         """Movement limitations and settings related to the motor.
 
         This structure contains useful motor settings. These settings specify the motor shaft movement algorithm, list
@@ -734,6 +735,8 @@ class engine_settings_t:
         :type MicrostepMode: libximc.highlevel.MicrostepMode
         :param StepsPerRev: Number of full steps per revolution (Used with stepper motor only). Range: 1..65535.
         :type StepsPerRev: int
+        :param PeakCurrent: Peak current value, mA. Current can be increased up to this value for short periods of time if ENGINE_USE_PEAK_CURRENT is set
+        :type PeakCurrent: int
         """
         self.NomVoltage = NomVoltage
         self.NomCurrent = NomCurrent
@@ -743,6 +746,7 @@ class engine_settings_t:
         self.Antiplay = Antiplay
         self.MicrostepMode = MicrostepMode
         self.StepsPerRev = StepsPerRev
+        self.PeakCurrent = PeakCurrent
 
     # getters
     @property
@@ -776,6 +780,10 @@ class engine_settings_t:
     @property
     def StepsPerRev(self) -> int:
         return self._StepsPerRev
+    
+    @property
+    def PeakCurrent(self) -> int:
+        return self._PeakCurrent
 
     # setters
     @NomVoltage.setter
@@ -830,6 +838,11 @@ class engine_settings_t:
         _check_noncontainer_castability(val, c_uint16, varname="StepsPerRev")
         self._StepsPerRev = val
 
+    @PeakCurrent.setter
+    def PeakCurrent(self, val):
+        _check_noncontainer_castability(val, c_uint16, varname="PeakCurrent")
+        self._PeakCurrent = val
+
     def __repr__(self) -> str:
         result = ""
         for key_value_pair in self.__dict__.items():
@@ -846,7 +859,8 @@ class engine_settings_calb_t:
             EngineFlags: flag_enumerations.EngineFlags = NOT_INITIALIZED,
             Antiplay: float = NOT_INITIALIZED,
             MicrostepMode: flag_enumerations.MicrostepMode = NOT_INITIALIZED,
-            StepsPerRev: int = NOT_INITIALIZED):
+            StepsPerRev: int = NOT_INITIALIZED,
+            PeakCurrent: int = NOT_INITIALIZED):
         """Movement limitations and settings, related to the motor. In user units.
 
         This structure contains useful motor settings. These settings specify the motor shaft movement algorithm, list
@@ -876,6 +890,8 @@ class engine_settings_calb_t:
         :type MicrostepMode: libximc.highlevel.MicrostepMode
         :param StepsPerRev: Number of full steps per revolution (Used with stepper motor only). Range: 1..65535.
         :type StepsPerRev: int
+        :param PeakCurrent: Peak current value, mA. Current can be increased up to this value for short periods of time if ENGINE_USE_PEAK_CURRENT is set
+        :type PeakCurrent: int
         """
         self.NomVoltage = NomVoltage
         self.NomCurrent = NomCurrent
@@ -884,6 +900,7 @@ class engine_settings_calb_t:
         self.Antiplay = Antiplay
         self.MicrostepMode = MicrostepMode
         self.StepsPerRev = StepsPerRev
+        self.PeakCurrent = PeakCurrent
 
     # getters
     @property
@@ -914,6 +931,10 @@ class engine_settings_calb_t:
     def StepsPerRev(self) -> int:
         return self._StepsPerRev
 
+    @property
+    def PeakCurrent(self) -> int:
+        return self._PeakCurrent
+    
     # setters
     @NomVoltage.setter
     def NomVoltage(self, val):
@@ -962,6 +983,12 @@ class engine_settings_calb_t:
         _check_noncontainer_castability(val, c_uint16, varname="StepsPerRev")
         self._StepsPerRev = val
 
+    @PeakCurrent.setter
+    def PeakCurrent(self, val):
+        _check_noncontainer_castability(val, c_uint16, varname="PeakCurrent")
+        self._PeakCurrent = val
+
+
     def __repr__(self) -> str:
         result = ""
         for key_value_pair in self.__dict__.items():

{libximc-3.0.4/src/libximc/library-files/macosx/libximc.framework/Versions/7 → libximc-3.1.2/src/libximc/library-files/macosx/libximc.framework}/Headers/ximc.h

@@ -347,12 +347,12 @@ extern "C"
 
 
 /** @cond DO_NOT_WANT */
-#define LIBXIMC_VERSION 3.0.4
+#define LIBXIMC_VERSION 3.1.2
 /** @endcond */
 
 
 /** @cond DO_NOT_WANT */
-#define LIBXIMC_PROTOCOL_VERSION 20.14
+#define LIBXIMC_PROTOCOL_VERSION 20.15
 /** @endcond */
 
 
@@ -660,14 +660,15 @@ extern "C"
 	* @see engine_settings_t::EngineFlags, get_engine_settings, set_engine_settings
 	*/
 //@{
-#define ENGINE_REVERSE          0x01 	/**< \english Reverse flag. It determines motor shaft rotation direction that corresponds to feedback counts increasing. If not set (default), motor shaft rotation direction under positive voltage corresponds to feedback counts increasing and vice versa. Change it if you see that positive directions on motor and feedback are opposite. \endenglish \russian Флаг реверса. Связывает направление вращения мотора с направлением счета текущей позиции. При сброшенном флаге (по умолчанию) прикладываемое к мотору положительное напряжение увеличивает счетчик позиции. И наоборот, при установленном флаге счетчик позиции увеличивается, когда к мотору приложено отрицательное напряжение. Измените состояние флага, если положительное вращение мотора уменьшает счетчик позиции. \endrussian */
-#define ENGINE_CURRENT_AS_RMS   0x02 	/**< \english Engine current meaning flag. If the flag is unset, then the engine's current value is interpreted as the maximum amplitude value. If the flag is set, then the engine current value is interpreted as the root-mean-square current value (for stepper) or as the current value calculated from the maximum heat dissipation (BLDC). \endenglish \russian Флаг интерпретации значения тока. Если флаг снят, то задаваемое значение тока интерпретируется как максимальная амплитуда тока. Если флаг установлен, то задаваемое значение тока интерпретируется как среднеквадратичное значение тока (для шагового) или как значение тока, посчитанное из максимального тепловыделения (BLDC). \endrussian */
-#define ENGINE_MAX_SPEED        0x04 	/**< \english Max speed flag. If it is set, the engine uses the maximum speed achievable with the present engine settings as its nominal speed. \endenglish \russian Флаг максимальной скорости. Если флаг установлен, движение происходит на максимальной скорости. \endrussian */
-#define ENGINE_ANTIPLAY         0x08 	/**< \english Play compensation flag. If it is set, the engine makes backlash (play) compensation and reaches the predetermined position accurately at low speed. \endenglish \russian Компенсация люфта. Если флаг установлен, позиционер будет подходить к заданной точке всегда с одной стороны. Например, при подходе слева никаких дополнительных действий не совершается, а при подходе справа позиционер проходит целевую позицию на заданное расстояния и возвращается к ней опять же справа. \endrussian */
-#define ENGINE_ACCEL_ON         0x10 	/**< \english Acceleration enable flag. If it set, motion begins with acceleration and ends with deceleration. \endenglish \russian Ускорение. Если флаг установлен, движение происходит с ускорением. \endrussian */
-#define ENGINE_LIMIT_VOLT       0x20 	/**< \english Maximum motor voltage limit enable flag (is only used with DC motor). \endenglish \russian Номинальное напряжение мотора. Если флаг установлен, напряжение на моторе ограничивается заданным номинальным значением (используется только с DC-двигателем). \endrussian */
-#define ENGINE_LIMIT_CURR       0x40 	/**< \english Maximum motor current limit enable flag (is only used with DC motor). \endenglish \russian Номинальный ток мотора. Если флаг установлен, ток через мотор ограничивается заданным номинальным значением (используется только с DC-двигателем). \endrussian */
-#define ENGINE_LIMIT_RPM        0x80 	/**< \english Maximum motor speed limit enable flag. \endenglish \russian Номинальная частота вращения мотора. Если флаг установлен, частота вращения ограничивается заданным номинальным значением. \endrussian */
+#define ENGINE_REVERSE            0x001 	/**< \english Reverse flag. It determines motor shaft rotation direction that corresponds to feedback counts increasing. If not set (default), motor shaft rotation direction under positive voltage corresponds to feedback counts increasing and vice versa. Change it if you see that positive directions on motor and feedback are opposite. \endenglish \russian Флаг реверса. Связывает направление вращения мотора с направлением счета текущей позиции. При сброшенном флаге (по умолчанию) прикладываемое к мотору положительное напряжение увеличивает счетчик позиции. И наоборот, при установленном флаге счетчик позиции увеличивается, когда к мотору приложено отрицательное напряжение. Измените состояние флага, если положительное вращение мотора уменьшает счетчик позиции. \endrussian */
+#define ENGINE_CURRENT_AS_RMS     0x002 	/**< \english Engine current meaning flag. If the flag is unset, then the engine's current value is interpreted as the maximum amplitude value. If the flag is set, then the engine current value is interpreted as the root-mean-square current value (for stepper) or as the current value calculated from the maximum heat dissipation (BLDC). \endenglish \russian Флаг интерпретации значения тока. Если флаг снят, то задаваемое значение тока интерпретируется как максимальная амплитуда тока. Если флаг установлен, то задаваемое значение тока интерпретируется как среднеквадратичное значение тока (для шагового) или как значение тока, посчитанное из максимального тепловыделения (BLDC). \endrussian */
+#define ENGINE_MAX_SPEED          0x004 	/**< \english Max speed flag. If it is set, the engine uses the maximum speed achievable with the present engine settings as its nominal speed. \endenglish \russian Флаг максимальной скорости. Если флаг установлен, движение происходит на максимальной скорости. \endrussian */
+#define ENGINE_ANTIPLAY           0x008 	/**< \english Play compensation flag. If it is set, the engine makes backlash (play) compensation and reaches the predetermined position accurately at low speed. \endenglish \russian Компенсация люфта. Если флаг установлен, позиционер будет подходить к заданной точке всегда с одной стороны. Например, при подходе слева никаких дополнительных действий не совершается, а при подходе справа позиционер проходит целевую позицию на заданное расстояния и возвращается к ней опять же справа. \endrussian */
+#define ENGINE_ACCEL_ON           0x010 	/**< \english Acceleration enable flag. If it set, motion begins with acceleration and ends with deceleration. \endenglish \russian Ускорение. Если флаг установлен, движение происходит с ускорением. \endrussian */
+#define ENGINE_LIMIT_VOLT         0x020 	/**< \english Maximum motor voltage limit enable flag (is only used with DC motor). \endenglish \russian Номинальное напряжение мотора. Если флаг установлен, напряжение на моторе ограничивается заданным номинальным значением (используется только с DC-двигателем). \endrussian */
+#define ENGINE_LIMIT_CURR         0x040 	/**< \english Maximum motor current limit enable flag (is only used with DC motor). \endenglish \russian Номинальный ток мотора. Если флаг установлен, ток через мотор ограничивается заданным номинальным значением (используется только с DC-двигателем). \endrussian */
+#define ENGINE_LIMIT_RPM          0x080 	/**< \english Maximum motor speed limit enable flag. \endenglish \russian Номинальная частота вращения мотора. Если флаг установлен, частота вращения ограничивается заданным номинальным значением. \endrussian */
+#define ENGINE_USE_PEAK_CURRENT   0x100 	/**< \english Enable peak current usage. \endenglish \russian Разрешить использование пикового тока. \endrussian */
 //@}
 
 
@@ -1488,6 +1489,7 @@ extern "C"
 		int Antiplay;	/**< \english Number of pulses or steps for backlash (play) compensation procedure. Used if ENGINE_ANTIPLAY flag is set. \endenglish \russian Количество шагов двигателя или импульсов энкодера, на которое позиционер будет отъезжать от заданной позиции для подхода к ней с одной и той же стороны. Используется, если установлен флаг ENGINE_ANTIPLAY. \endrussian */
 		unsigned int MicrostepMode;	/**< \english \ref flagset_microstepmode "Flags of microstep mode". \endenglish \russian \ref flagset_microstepmode "Флаги параметров микрошагового режима". \endrussian */
 		unsigned int StepsPerRev;	/**< \english Number of full steps per revolution (Used with stepper motor only). Range: 1..65535. \endenglish \russian Количество полных шагов на оборот (используется только с шаговым двигателем). Диапазон: 1..65535. \endrussian */
+		unsigned int PeakCurrent;	/**< \english Rated peak current (in mA). Controller is allowed to apply peak current while maintaining 10-second average current below nominal if USE_PEAK_CURRENT flag is set. \endenglish \russian Номинальный пиковый ток (в мА). Контроллеру разрешается подавать пиковый ток, поддерживая при этом средний ток за 10 секунд ниже номинального, если установлен флаг USE_PEAK_CURRENT. \endrussian */
 	} engine_settings_t;
 
 /** 
@@ -1516,6 +1518,7 @@ extern "C"
 		float Antiplay;	/**< \english Number of pulses or steps for backlash (play) compensation procedure. Used if ENGINE_ANTIPLAY flag is set. \endenglish \russian Количество шагов двигателя или импульсов энкодера, на которое позиционер будет отъезжать от заданной позиции для подхода к ней с одной и той же стороны. Используется, если установлен флаг ENGINE_ANTIPLAY. \endrussian */
 		unsigned int MicrostepMode;	/**< \english \ref flagset_microstepmode "Flags of microstep mode". \endenglish \russian \ref flagset_microstepmode "Флаги параметров микрошагового режима". \endrussian */
 		unsigned int StepsPerRev;	/**< \english Number of full steps per revolution (Used with stepper motor only). Range: 1..65535. \endenglish \russian Количество полных шагов на оборот (используется только с шаговым двигателем). Диапазон: 1..65535. \endrussian */
+		unsigned int PeakCurrent;	/**< \english Rated peak current (in mA). Controller is allowed to apply peak current while maintaining 10-second average current below nominal if USE_PEAK_CURRENT flag is set. \endenglish \russian Номинальный пиковый ток (в мА). Контроллеру разрешается подавать пиковый ток, поддерживая при этом средний ток за 10 секунд ниже номинального, если установлен флаг USE_PEAK_CURRENT. \endrussian */
 	} engine_settings_calb_t;
 
 /** 
@@ -3712,7 +3715,7 @@ extern "C"
 	* \endenglish
 	* \russian
 	* Команда чтения пароля к веб-странице. Используется только производителем.
-	* Эта функция пользователяет прочитать пользовательский пароль к веб-странице из памяти контроллера.
+	* Эта функция позволяет прочитать пользовательский пароль к веб-странице из памяти контроллера.
 	* @param UserPassword[20] Строчка-пароль для доступа к веб-странице
 	* \endrussian
 	*/

{libximc-3.0.4/src/libximc/library-files/macosx/libximc.framework/Versions/Current → libximc-3.1.2/src/libximc/library-files/macosx/libximc.framework/Versions/7}/Headers/ximc.h

@@ -347,12 +347,12 @@ extern "C"
 
 
 /** @cond DO_NOT_WANT */
-#define LIBXIMC_VERSION 3.0.4
+#define LIBXIMC_VERSION 3.1.2
 /** @endcond */
 
 
 /** @cond DO_NOT_WANT */
-#define LIBXIMC_PROTOCOL_VERSION 20.14
+#define LIBXIMC_PROTOCOL_VERSION 20.15
 /** @endcond */
 
 
@@ -660,14 +660,15 @@ extern "C"
 	* @see engine_settings_t::EngineFlags, get_engine_settings, set_engine_settings
 	*/
 //@{
-#define ENGINE_REVERSE          0x01 	/**< \english Reverse flag. It determines motor shaft rotation direction that corresponds to feedback counts increasing. If not set (default), motor shaft rotation direction under positive voltage corresponds to feedback counts increasing and vice versa. Change it if you see that positive directions on motor and feedback are opposite. \endenglish \russian Флаг реверса. Связывает направление вращения мотора с направлением счета текущей позиции. При сброшенном флаге (по умолчанию) прикладываемое к мотору положительное напряжение увеличивает счетчик позиции. И наоборот, при установленном флаге счетчик позиции увеличивается, когда к мотору приложено отрицательное напряжение. Измените состояние флага, если положительное вращение мотора уменьшает счетчик позиции. \endrussian */
-#define ENGINE_CURRENT_AS_RMS   0x02 	/**< \english Engine current meaning flag. If the flag is unset, then the engine's current value is interpreted as the maximum amplitude value. If the flag is set, then the engine current value is interpreted as the root-mean-square current value (for stepper) or as the current value calculated from the maximum heat dissipation (BLDC). \endenglish \russian Флаг интерпретации значения тока. Если флаг снят, то задаваемое значение тока интерпретируется как максимальная амплитуда тока. Если флаг установлен, то задаваемое значение тока интерпретируется как среднеквадратичное значение тока (для шагового) или как значение тока, посчитанное из максимального тепловыделения (BLDC). \endrussian */
-#define ENGINE_MAX_SPEED        0x04 	/**< \english Max speed flag. If it is set, the engine uses the maximum speed achievable with the present engine settings as its nominal speed. \endenglish \russian Флаг максимальной скорости. Если флаг установлен, движение происходит на максимальной скорости. \endrussian */
-#define ENGINE_ANTIPLAY         0x08 	/**< \english Play compensation flag. If it is set, the engine makes backlash (play) compensation and reaches the predetermined position accurately at low speed. \endenglish \russian Компенсация люфта. Если флаг установлен, позиционер будет подходить к заданной точке всегда с одной стороны. Например, при подходе слева никаких дополнительных действий не совершается, а при подходе справа позиционер проходит целевую позицию на заданное расстояния и возвращается к ней опять же справа. \endrussian */
-#define ENGINE_ACCEL_ON         0x10 	/**< \english Acceleration enable flag. If it set, motion begins with acceleration and ends with deceleration. \endenglish \russian Ускорение. Если флаг установлен, движение происходит с ускорением. \endrussian */
-#define ENGINE_LIMIT_VOLT       0x20 	/**< \english Maximum motor voltage limit enable flag (is only used with DC motor). \endenglish \russian Номинальное напряжение мотора. Если флаг установлен, напряжение на моторе ограничивается заданным номинальным значением (используется только с DC-двигателем). \endrussian */
-#define ENGINE_LIMIT_CURR       0x40 	/**< \english Maximum motor current limit enable flag (is only used with DC motor). \endenglish \russian Номинальный ток мотора. Если флаг установлен, ток через мотор ограничивается заданным номинальным значением (используется только с DC-двигателем). \endrussian */
-#define ENGINE_LIMIT_RPM        0x80 	/**< \english Maximum motor speed limit enable flag. \endenglish \russian Номинальная частота вращения мотора. Если флаг установлен, частота вращения ограничивается заданным номинальным значением. \endrussian */
+#define ENGINE_REVERSE            0x001 	/**< \english Reverse flag. It determines motor shaft rotation direction that corresponds to feedback counts increasing. If not set (default), motor shaft rotation direction under positive voltage corresponds to feedback counts increasing and vice versa. Change it if you see that positive directions on motor and feedback are opposite. \endenglish \russian Флаг реверса. Связывает направление вращения мотора с направлением счета текущей позиции. При сброшенном флаге (по умолчанию) прикладываемое к мотору положительное напряжение увеличивает счетчик позиции. И наоборот, при установленном флаге счетчик позиции увеличивается, когда к мотору приложено отрицательное напряжение. Измените состояние флага, если положительное вращение мотора уменьшает счетчик позиции. \endrussian */
+#define ENGINE_CURRENT_AS_RMS     0x002 	/**< \english Engine current meaning flag. If the flag is unset, then the engine's current value is interpreted as the maximum amplitude value. If the flag is set, then the engine current value is interpreted as the root-mean-square current value (for stepper) or as the current value calculated from the maximum heat dissipation (BLDC). \endenglish \russian Флаг интерпретации значения тока. Если флаг снят, то задаваемое значение тока интерпретируется как максимальная амплитуда тока. Если флаг установлен, то задаваемое значение тока интерпретируется как среднеквадратичное значение тока (для шагового) или как значение тока, посчитанное из максимального тепловыделения (BLDC). \endrussian */
+#define ENGINE_MAX_SPEED          0x004 	/**< \english Max speed flag. If it is set, the engine uses the maximum speed achievable with the present engine settings as its nominal speed. \endenglish \russian Флаг максимальной скорости. Если флаг установлен, движение происходит на максимальной скорости. \endrussian */
+#define ENGINE_ANTIPLAY           0x008 	/**< \english Play compensation flag. If it is set, the engine makes backlash (play) compensation and reaches the predetermined position accurately at low speed. \endenglish \russian Компенсация люфта. Если флаг установлен, позиционер будет подходить к заданной точке всегда с одной стороны. Например, при подходе слева никаких дополнительных действий не совершается, а при подходе справа позиционер проходит целевую позицию на заданное расстояния и возвращается к ней опять же справа. \endrussian */
+#define ENGINE_ACCEL_ON           0x010 	/**< \english Acceleration enable flag. If it set, motion begins with acceleration and ends with deceleration. \endenglish \russian Ускорение. Если флаг установлен, движение происходит с ускорением. \endrussian */
+#define ENGINE_LIMIT_VOLT         0x020 	/**< \english Maximum motor voltage limit enable flag (is only used with DC motor). \endenglish \russian Номинальное напряжение мотора. Если флаг установлен, напряжение на моторе ограничивается заданным номинальным значением (используется только с DC-двигателем). \endrussian */
+#define ENGINE_LIMIT_CURR         0x040 	/**< \english Maximum motor current limit enable flag (is only used with DC motor). \endenglish \russian Номинальный ток мотора. Если флаг установлен, ток через мотор ограничивается заданным номинальным значением (используется только с DC-двигателем). \endrussian */
+#define ENGINE_LIMIT_RPM          0x080 	/**< \english Maximum motor speed limit enable flag. \endenglish \russian Номинальная частота вращения мотора. Если флаг установлен, частота вращения ограничивается заданным номинальным значением. \endrussian */
+#define ENGINE_USE_PEAK_CURRENT   0x100 	/**< \english Enable peak current usage. \endenglish \russian Разрешить использование пикового тока. \endrussian */
 //@}
 
 
@@ -1488,6 +1489,7 @@ extern "C"
 		int Antiplay;	/**< \english Number of pulses or steps for backlash (play) compensation procedure. Used if ENGINE_ANTIPLAY flag is set. \endenglish \russian Количество шагов двигателя или импульсов энкодера, на которое позиционер будет отъезжать от заданной позиции для подхода к ней с одной и той же стороны. Используется, если установлен флаг ENGINE_ANTIPLAY. \endrussian */
 		unsigned int MicrostepMode;	/**< \english \ref flagset_microstepmode "Flags of microstep mode". \endenglish \russian \ref flagset_microstepmode "Флаги параметров микрошагового режима". \endrussian */
 		unsigned int StepsPerRev;	/**< \english Number of full steps per revolution (Used with stepper motor only). Range: 1..65535. \endenglish \russian Количество полных шагов на оборот (используется только с шаговым двигателем). Диапазон: 1..65535. \endrussian */
+		unsigned int PeakCurrent;	/**< \english Rated peak current (in mA). Controller is allowed to apply peak current while maintaining 10-second average current below nominal if USE_PEAK_CURRENT flag is set. \endenglish \russian Номинальный пиковый ток (в мА). Контроллеру разрешается подавать пиковый ток, поддерживая при этом средний ток за 10 секунд ниже номинального, если установлен флаг USE_PEAK_CURRENT. \endrussian */
 	} engine_settings_t;
 
 /** 
@@ -1516,6 +1518,7 @@ extern "C"
 		float Antiplay;	/**< \english Number of pulses or steps for backlash (play) compensation procedure. Used if ENGINE_ANTIPLAY flag is set. \endenglish \russian Количество шагов двигателя или импульсов энкодера, на которое позиционер будет отъезжать от заданной позиции для подхода к ней с одной и той же стороны. Используется, если установлен флаг ENGINE_ANTIPLAY. \endrussian */
 		unsigned int MicrostepMode;	/**< \english \ref flagset_microstepmode "Flags of microstep mode". \endenglish \russian \ref flagset_microstepmode "Флаги параметров микрошагового режима". \endrussian */
 		unsigned int StepsPerRev;	/**< \english Number of full steps per revolution (Used with stepper motor only). Range: 1..65535. \endenglish \russian Количество полных шагов на оборот (используется только с шаговым двигателем). Диапазон: 1..65535. \endrussian */
+		unsigned int PeakCurrent;	/**< \english Rated peak current (in mA). Controller is allowed to apply peak current while maintaining 10-second average current below nominal if USE_PEAK_CURRENT flag is set. \endenglish \russian Номинальный пиковый ток (в мА). Контроллеру разрешается подавать пиковый ток, поддерживая при этом средний ток за 10 секунд ниже номинального, если установлен флаг USE_PEAK_CURRENT. \endrussian */
 	} engine_settings_calb_t;
 
 /** 
@@ -3712,7 +3715,7 @@ extern "C"
 	* \endenglish
 	* \russian
 	* Команда чтения пароля к веб-странице. Используется только производителем.
-	* Эта функция пользователяет прочитать пользовательский пароль к веб-странице из памяти контроллера.
+	* Эта функция позволяет прочитать пользовательский пароль к веб-странице из памяти контроллера.
 	* @param UserPassword[20] Строчка-пароль для доступа к веб-странице
 	* \endrussian
 	*/

{libximc-3.0.4/src/libximc/library-files/macosx/libximc.framework → libximc-3.1.2/src/libximc/library-files/macosx/libximc.framework/Versions/Current}/Headers/ximc.h

@@ -347,12 +347,12 @@ extern "C"
 
 
 /** @cond DO_NOT_WANT */
-#define LIBXIMC_VERSION 3.0.4
+#define LIBXIMC_VERSION 3.1.2
 /** @endcond */
 
 
 /** @cond DO_NOT_WANT */
-#define LIBXIMC_PROTOCOL_VERSION 20.14
+#define LIBXIMC_PROTOCOL_VERSION 20.15
 /** @endcond */
 
 
@@ -660,14 +660,15 @@ extern "C"
 	* @see engine_settings_t::EngineFlags, get_engine_settings, set_engine_settings
 	*/
 //@{
-#define ENGINE_REVERSE          0x01 	/**< \english Reverse flag. It determines motor shaft rotation direction that corresponds to feedback counts increasing. If not set (default), motor shaft rotation direction under positive voltage corresponds to feedback counts increasing and vice versa. Change it if you see that positive directions on motor and feedback are opposite. \endenglish \russian Флаг реверса. Связывает направление вращения мотора с направлением счета текущей позиции. При сброшенном флаге (по умолчанию) прикладываемое к мотору положительное напряжение увеличивает счетчик позиции. И наоборот, при установленном флаге счетчик позиции увеличивается, когда к мотору приложено отрицательное напряжение. Измените состояние флага, если положительное вращение мотора уменьшает счетчик позиции. \endrussian */
-#define ENGINE_CURRENT_AS_RMS   0x02 	/**< \english Engine current meaning flag. If the flag is unset, then the engine's current value is interpreted as the maximum amplitude value. If the flag is set, then the engine current value is interpreted as the root-mean-square current value (for stepper) or as the current value calculated from the maximum heat dissipation (BLDC). \endenglish \russian Флаг интерпретации значения тока. Если флаг снят, то задаваемое значение тока интерпретируется как максимальная амплитуда тока. Если флаг установлен, то задаваемое значение тока интерпретируется как среднеквадратичное значение тока (для шагового) или как значение тока, посчитанное из максимального тепловыделения (BLDC). \endrussian */
-#define ENGINE_MAX_SPEED        0x04 	/**< \english Max speed flag. If it is set, the engine uses the maximum speed achievable with the present engine settings as its nominal speed. \endenglish \russian Флаг максимальной скорости. Если флаг установлен, движение происходит на максимальной скорости. \endrussian */
-#define ENGINE_ANTIPLAY         0x08 	/**< \english Play compensation flag. If it is set, the engine makes backlash (play) compensation and reaches the predetermined position accurately at low speed. \endenglish \russian Компенсация люфта. Если флаг установлен, позиционер будет подходить к заданной точке всегда с одной стороны. Например, при подходе слева никаких дополнительных действий не совершается, а при подходе справа позиционер проходит целевую позицию на заданное расстояния и возвращается к ней опять же справа. \endrussian */
-#define ENGINE_ACCEL_ON         0x10 	/**< \english Acceleration enable flag. If it set, motion begins with acceleration and ends with deceleration. \endenglish \russian Ускорение. Если флаг установлен, движение происходит с ускорением. \endrussian */
-#define ENGINE_LIMIT_VOLT       0x20 	/**< \english Maximum motor voltage limit enable flag (is only used with DC motor). \endenglish \russian Номинальное напряжение мотора. Если флаг установлен, напряжение на моторе ограничивается заданным номинальным значением (используется только с DC-двигателем). \endrussian */
-#define ENGINE_LIMIT_CURR       0x40 	/**< \english Maximum motor current limit enable flag (is only used with DC motor). \endenglish \russian Номинальный ток мотора. Если флаг установлен, ток через мотор ограничивается заданным номинальным значением (используется только с DC-двигателем). \endrussian */
-#define ENGINE_LIMIT_RPM        0x80 	/**< \english Maximum motor speed limit enable flag. \endenglish \russian Номинальная частота вращения мотора. Если флаг установлен, частота вращения ограничивается заданным номинальным значением. \endrussian */
+#define ENGINE_REVERSE            0x001 	/**< \english Reverse flag. It determines motor shaft rotation direction that corresponds to feedback counts increasing. If not set (default), motor shaft rotation direction under positive voltage corresponds to feedback counts increasing and vice versa. Change it if you see that positive directions on motor and feedback are opposite. \endenglish \russian Флаг реверса. Связывает направление вращения мотора с направлением счета текущей позиции. При сброшенном флаге (по умолчанию) прикладываемое к мотору положительное напряжение увеличивает счетчик позиции. И наоборот, при установленном флаге счетчик позиции увеличивается, когда к мотору приложено отрицательное напряжение. Измените состояние флага, если положительное вращение мотора уменьшает счетчик позиции. \endrussian */
+#define ENGINE_CURRENT_AS_RMS     0x002 	/**< \english Engine current meaning flag. If the flag is unset, then the engine's current value is interpreted as the maximum amplitude value. If the flag is set, then the engine current value is interpreted as the root-mean-square current value (for stepper) or as the current value calculated from the maximum heat dissipation (BLDC). \endenglish \russian Флаг интерпретации значения тока. Если флаг снят, то задаваемое значение тока интерпретируется как максимальная амплитуда тока. Если флаг установлен, то задаваемое значение тока интерпретируется как среднеквадратичное значение тока (для шагового) или как значение тока, посчитанное из максимального тепловыделения (BLDC). \endrussian */
+#define ENGINE_MAX_SPEED          0x004 	/**< \english Max speed flag. If it is set, the engine uses the maximum speed achievable with the present engine settings as its nominal speed. \endenglish \russian Флаг максимальной скорости. Если флаг установлен, движение происходит на максимальной скорости. \endrussian */
+#define ENGINE_ANTIPLAY           0x008 	/**< \english Play compensation flag. If it is set, the engine makes backlash (play) compensation and reaches the predetermined position accurately at low speed. \endenglish \russian Компенсация люфта. Если флаг установлен, позиционер будет подходить к заданной точке всегда с одной стороны. Например, при подходе слева никаких дополнительных действий не совершается, а при подходе справа позиционер проходит целевую позицию на заданное расстояния и возвращается к ней опять же справа. \endrussian */
+#define ENGINE_ACCEL_ON           0x010 	/**< \english Acceleration enable flag. If it set, motion begins with acceleration and ends with deceleration. \endenglish \russian Ускорение. Если флаг установлен, движение происходит с ускорением. \endrussian */
+#define ENGINE_LIMIT_VOLT         0x020 	/**< \english Maximum motor voltage limit enable flag (is only used with DC motor). \endenglish \russian Номинальное напряжение мотора. Если флаг установлен, напряжение на моторе ограничивается заданным номинальным значением (используется только с DC-двигателем). \endrussian */
+#define ENGINE_LIMIT_CURR         0x040 	/**< \english Maximum motor current limit enable flag (is only used with DC motor). \endenglish \russian Номинальный ток мотора. Если флаг установлен, ток через мотор ограничивается заданным номинальным значением (используется только с DC-двигателем). \endrussian */
+#define ENGINE_LIMIT_RPM          0x080 	/**< \english Maximum motor speed limit enable flag. \endenglish \russian Номинальная частота вращения мотора. Если флаг установлен, частота вращения ограничивается заданным номинальным значением. \endrussian */
+#define ENGINE_USE_PEAK_CURRENT   0x100 	/**< \english Enable peak current usage. \endenglish \russian Разрешить использование пикового тока. \endrussian */
 //@}
 
 
@@ -1488,6 +1489,7 @@ extern "C"
 		int Antiplay;	/**< \english Number of pulses or steps for backlash (play) compensation procedure. Used if ENGINE_ANTIPLAY flag is set. \endenglish \russian Количество шагов двигателя или импульсов энкодера, на которое позиционер будет отъезжать от заданной позиции для подхода к ней с одной и той же стороны. Используется, если установлен флаг ENGINE_ANTIPLAY. \endrussian */
 		unsigned int MicrostepMode;	/**< \english \ref flagset_microstepmode "Flags of microstep mode". \endenglish \russian \ref flagset_microstepmode "Флаги параметров микрошагового режима". \endrussian */
 		unsigned int StepsPerRev;	/**< \english Number of full steps per revolution (Used with stepper motor only). Range: 1..65535. \endenglish \russian Количество полных шагов на оборот (используется только с шаговым двигателем). Диапазон: 1..65535. \endrussian */
+		unsigned int PeakCurrent;	/**< \english Rated peak current (in mA). Controller is allowed to apply peak current while maintaining 10-second average current below nominal if USE_PEAK_CURRENT flag is set. \endenglish \russian Номинальный пиковый ток (в мА). Контроллеру разрешается подавать пиковый ток, поддерживая при этом средний ток за 10 секунд ниже номинального, если установлен флаг USE_PEAK_CURRENT. \endrussian */
 	} engine_settings_t;
 
 /** 
@@ -1516,6 +1518,7 @@ extern "C"
 		float Antiplay;	/**< \english Number of pulses or steps for backlash (play) compensation procedure. Used if ENGINE_ANTIPLAY flag is set. \endenglish \russian Количество шагов двигателя или импульсов энкодера, на которое позиционер будет отъезжать от заданной позиции для подхода к ней с одной и той же стороны. Используется, если установлен флаг ENGINE_ANTIPLAY. \endrussian */
 		unsigned int MicrostepMode;	/**< \english \ref flagset_microstepmode "Flags of microstep mode". \endenglish \russian \ref flagset_microstepmode "Флаги параметров микрошагового режима". \endrussian */
 		unsigned int StepsPerRev;	/**< \english Number of full steps per revolution (Used with stepper motor only). Range: 1..65535. \endenglish \russian Количество полных шагов на оборот (используется только с шаговым двигателем). Диапазон: 1..65535. \endrussian */
+		unsigned int PeakCurrent;	/**< \english Rated peak current (in mA). Controller is allowed to apply peak current while maintaining 10-second average current below nominal if USE_PEAK_CURRENT flag is set. \endenglish \russian Номинальный пиковый ток (в мА). Контроллеру разрешается подавать пиковый ток, поддерживая при этом средний ток за 10 секунд ниже номинального, если установлен флаг USE_PEAK_CURRENT. \endrussian */
 	} engine_settings_calb_t;
 
 /** 
@@ -3712,7 +3715,7 @@ extern "C"
 	* \endenglish
 	* \russian
 	* Команда чтения пароля к веб-странице. Используется только производителем.
-	* Эта функция пользователяет прочитать пользовательский пароль к веб-странице из памяти контроллера.
+	* Эта функция позволяет прочитать пользовательский пароль к веб-странице из памяти контроллера.
 	* @param UserPassword[20] Строчка-пароль для доступа к веб-странице
 	* \endrussian
 	*/

{libximc-3.0.4 → libximc-3.1.2}/src/libximc/lowlevel/_lowlevel.py

@@ -1,6 +1,7 @@
 import os
 import struct
 import sys
+import winreg
 from ctypes import *
 
 
@@ -28,6 +29,24 @@ def _check_if_vc2013_is_installed():
         raise RuntimeError(error_msg)
 
 
+def _check_if_vc2015_2022_is_installed():
+    registry_path = (r"SOFTWARE\Microsoft\VisualStudio\14.0\VC\Runtimes\x64" if _get_os_bit() == 64 else
+                     r"SOFTWARE\Microsoft\VisualStudio\14.0\VC\Runtimes\x86")
+    try:
+        with winreg.OpenKey(winreg.HKEY_LOCAL_MACHINE, registry_path) as key:
+            installed, _ = winreg.QueryValueEx(key, "Installed")
+            if installed == 1:
+                return True
+    except OSError:
+        pass
+    
+    link = ("https://aka.ms/vs/17/release/vc_redist.x64.exe" if _get_os_bit() == 64 else
+            "https://aka.ms/vs/17/release/vc_redist.x86.exe")
+    error_msg = ("Microsoft Visual C++ Redistributable 2015-2022 is not installed in the OS. "
+                 "This may lead to the DLL load failure. Download it from {}").format(link)
+    raise RuntimeError(error_msg)
+
+
 def _get_os_bit() -> int:
     return 8 * struct.calcsize("P")
 
@@ -39,6 +58,7 @@ def _load_lib():
     os_kind = system().lower()
     if os_kind == "windows":
         _check_if_vc2013_is_installed()
+        _check_if_vc2015_2022_is_installed()
 
         ximc_root_path = r"..\..\..\..\.."
         if sys.version_info[0] == 3 and sys.version_info[1] >= 8:
@@ -245,14 +265,15 @@ class MoveFlags:
     RPM_DIV_1000    = 0x01
 
 class EngineFlags:
-    ENGINE_REVERSE           = 0x01
-    ENGINE_CURRENT_AS_RMS    = 0x02
-    ENGINE_MAX_SPEED         = 0x04
-    ENGINE_ANTIPLAY          = 0x08
-    ENGINE_ACCEL_ON          = 0x10
-    ENGINE_LIMIT_VOLT        = 0x20
-    ENGINE_LIMIT_CURR        = 0x40
-    ENGINE_LIMIT_RPM         = 0x80
+    ENGINE_REVERSE           = 0x001
+    ENGINE_CURRENT_AS_RMS    = 0x002
+    ENGINE_MAX_SPEED         = 0x004
+    ENGINE_ANTIPLAY          = 0x008
+    ENGINE_ACCEL_ON          = 0x010
+    ENGINE_LIMIT_VOLT        = 0x020
+    ENGINE_LIMIT_CURR        = 0x040
+    ENGINE_LIMIT_RPM         = 0x080
+    ENGINE_USE_PEAK_CURRENT  = 0x100
 
 class MicrostepMode:
     MICROSTEP_MODE_FULL        = 0x01
@@ -499,6 +520,7 @@ class engine_settings_t(Structure):
         ("Antiplay", c_int),
         ("MicrostepMode", c_uint),
         ("StepsPerRev", c_uint),
+        ("PeakCurrent", c_uint),
     ]
 
 class engine_settings_calb_t(Structure):
@@ -510,6 +532,7 @@ class engine_settings_calb_t(Structure):
         ("Antiplay", c_float),
         ("MicrostepMode", c_uint),
         ("StepsPerRev", c_uint),
+        ("PeakCurrent", c_uint),
     ]
 
 class entype_settings_t(Structure):