anycubic-cloud-api 0.4.8__tar.gz → 0.4.9__tar.gz

{anycubic_cloud_api-0.4.8/src/anycubic_cloud_api.egg-info → anycubic_cloud_api-0.4.9}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: anycubic-cloud-api
-Version: 0.4.8
+Version: 0.4.9
 Summary: Async client for the Anycubic Cloud API and its MQTT stream
 Author: WaresWichall, Nino Bondonno
 Maintainer: Nino Bondonno

{anycubic_cloud_api-0.4.8 → anycubic_cloud_api-0.4.9}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "anycubic-cloud-api"
-version = "0.4.8"
+version = "0.4.9"
 description = "Async client for the Anycubic Cloud API and its MQTT stream"
 readme = "README.md"
 requires-python = ">=3.12"

{anycubic_cloud_api-0.4.8 → anycubic_cloud_api-0.4.9}/src/anycubic_cloud_api/api/functions.py

@@ -513,6 +513,121 @@ class AnycubicAPIFunctions(AnycubicAPIBase):
             ),
         )
 
+    async def _send_order_set_temperature(
+        self,
+        printer: AnycubicPrinter,
+        target_nozzle_temp: int | None = None,
+        target_hotbed_temp: int | None = None,
+    ) -> str | None:
+        """Set nozzle and/or bed temperature, with or without a print job.
+
+        Distinct from PRINT_SETTINGS, which the server refuses with "Print
+        task does not exist" unless a job is running. This is what the
+        slicer's One-Click Preheat uses, captured from its own traffic:
+
+            {"type": 0, "target_hotbed_temp": 0,  "target_nozzle_temp": 230}
+            {"type": 1, "target_hotbed_temp": 90, "target_nozzle_temp": 0}
+            {"type": 2, "target_hotbed_temp": 60, "target_nozzle_temp": 200}
+
+        `type` says which of the two the printer should act on -- 0 nozzle,
+        1 bed, 2 both -- and the unused figure is sent as 0 rather than
+        omitted.
+        """
+        if not printer:
+            return None
+
+        if target_nozzle_temp is None and target_hotbed_temp is None:
+            return None
+
+        if target_hotbed_temp is None:
+            heat_type = 0
+        elif target_nozzle_temp is None:
+            heat_type = 1
+        else:
+            heat_type = 2
+
+        return await self._send_anycubic_order(
+            order_request=AnycubicProjectOrderRequest(
+                order_id=AnycubicOrderID.SET_TEMPERATURE,
+                printer_id=printer.id,
+                project_id=0,
+                order_data={
+                    'type': heat_type,
+                    'target_hotbed_temp': int(target_hotbed_temp or 0),
+                    'target_nozzle_temp': int(target_nozzle_temp or 0),
+                },
+            ),
+        )
+
+    async def _send_order_set_fan_speed(
+        self,
+        printer: AnycubicPrinter,
+        fan_speed_pct: int | None = None,
+        aux_fan_speed_pct: int | None = None,
+        box_fan_level: int | None = None,
+    ) -> str | None:
+        """Set one fan, without needing a print job.
+
+        The slicer sends exactly one key per call -- {"fan_speed_pct": 40} --
+        rather than a combined object, so this mirrors that.
+        """
+        if not printer:
+            return None
+
+        data: dict[str, Any] = {}
+
+        if fan_speed_pct is not None:
+            data['fan_speed_pct'] = int(fan_speed_pct)
+        elif aux_fan_speed_pct is not None:
+            data['aux_fan_speed_pct'] = int(aux_fan_speed_pct)
+        elif box_fan_level is not None:
+            data['box_fan_level'] = int(box_fan_level)
+        else:
+            return None
+
+        return await self._send_anycubic_order(
+            order_request=AnycubicProjectOrderRequest(
+                order_id=AnycubicOrderID.SET_FAN_SPEED,
+                printer_id=printer.id,
+                project_id=0,
+                order_data=data,
+            ),
+        )
+
+    async def _send_order_move_axis(
+        self,
+        printer: AnycubicPrinter,
+        axis: int,
+        move_type: int,
+        distance: int = 0,
+    ) -> str | None:
+        """Move or home an axis.
+
+            {"axis": 1|2|3|4, "move_type": 0|1|2, "distance": mm}
+
+        axis      1 X, 2 Y, 3 Z, 4 all
+        move_type 0 minus, 1 plus, 2 home (distance ignored)
+
+        ⚠ The printer refuses moves until it has been homed, and its own UI
+        warns about nozzle-to-bed collisions -- so callers should home first
+        and keep steps small.
+        """
+        if not printer:
+            return None
+
+        return await self._send_anycubic_order(
+            order_request=AnycubicProjectOrderRequest(
+                order_id=AnycubicOrderID.MOVE_AXLE,
+                printer_id=printer.id,
+                project_id=0,
+                order_data={
+                    'axis': int(axis),
+                    'move_type': int(move_type),
+                    'distance': int(distance),
+                },
+            ),
+        )
+
     async def _send_order_multi_color_box_dry(
         self,
         printer: AnycubicPrinter,

{anycubic_cloud_api-0.4.8 → anycubic_cloud_api-0.4.9}/src/anycubic_cloud_api/const/enums.py

@@ -57,6 +57,13 @@ class AnycubicOrderID(IntEnum):
     MOVE_AXLE_TURN_OFF = 1213  # Not handled
     QUERY_AXIS_POSITION = 1214  # Replies over MQTT with axis/query
     FILAMENT_CONTROL = 1215  # Not handled
+    # Set temperatures directly, with no print job. This is NOT
+    # PRINT_SETTINGS -- that one is refused unless a job is running, which
+    # is why preheating an idle printer looked impossible until the
+    # slicer's own traffic showed this order.
+    SET_TEMPERATURE = 1216
+    # Fan speeds directly, again without needing a running job.
+    SET_FAN_SPEED = 1221
     FEED_RESIN = 1224  # Not handled
     M7_AUTO_OPERATION = 1225  # Not handled
     CYCLIC_CLEANING = 1226  # Not handled

{anycubic_cloud_api-0.4.8 → anycubic_cloud_api-0.4.9}/src/anycubic_cloud_api/data_models/printer.py

@@ -2945,6 +2945,54 @@ class AnycubicPrinter:
             slot_index_list=slot_index_list,
         )
 
+    async def set_target_temperature(
+        self,
+        target_nozzle_temp: int | None = None,
+        target_hotbed_temp: int | None = None,
+    ) -> str | None:
+        """Heat the nozzle and/or bed, print job or not.
+
+        Unlike change_print_setting_target_* this works on an idle printer --
+        it is the order the slicer's One-Click Preheat uses.
+        """
+        return await self._api_parent._send_order_set_temperature(
+            printer=self,
+            target_nozzle_temp=target_nozzle_temp,
+            target_hotbed_temp=target_hotbed_temp,
+        )
+
+    async def set_fan_speed(
+        self,
+        fan_speed_pct: int | None = None,
+        aux_fan_speed_pct: int | None = None,
+        box_fan_level: int | None = None,
+    ) -> str | None:
+        """Set one fan, print job or not."""
+        return await self._api_parent._send_order_set_fan_speed(
+            printer=self,
+            fan_speed_pct=fan_speed_pct,
+            aux_fan_speed_pct=aux_fan_speed_pct,
+            box_fan_level=box_fan_level,
+        )
+
+    async def move_axis(
+        self,
+        axis: int,
+        move_type: int,
+        distance: int = 0,
+    ) -> str | None:
+        """Jog or home an axis. See _send_order_move_axis for the codes."""
+        return await self._api_parent._send_order_move_axis(
+            printer=self,
+            axis=axis,
+            move_type=move_type,
+            distance=distance,
+        )
+
+    async def home_axis(self, axis: int = 4) -> str | None:
+        """Home an axis, or all of them. Required before any jog works."""
+        return await self.move_axis(axis=axis, move_type=2, distance=0)
+
     async def change_print_setting_speed_mode(
         self,
         new_speed: int

{anycubic_cloud_api-0.4.8 → anycubic_cloud_api-0.4.9/src/anycubic_cloud_api.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: anycubic-cloud-api
-Version: 0.4.8
+Version: 0.4.9
 Summary: Async client for the Anycubic Cloud API and its MQTT stream
 Author: WaresWichall, Nino Bondonno
 Maintainer: Nino Bondonno