feat: image rotation 180° switch for ceiling-mounted indoor cameras

Adds a per-camera switch (Indoor only — Gen1 360 + Gen2 Indoor II) that
rotates the camera image 180° for upside-down ceiling mounting. Bosch
firmware exposes no native rotation API, so this is implemented client-
side at three layers:

- Lovelace card: CSS transform rotate(180deg) on <video> + <img>.
  Zero CPU, zero latency, GPU-composited; toggle is instant with no
  stream restart and no re-encode.
- Snapshot path: PIL rotation in camera.async_camera_image() so push
  notifications, NAS clips, and other consumers see the right-way-up
  image (~15-30 ms per snapshot).
- 360 PTZ pan: BoschPanNumber inverts the slider sign when rotation is
  on, so "right" stays "right" on screen even upside-down.

State persists across HA restarts via RestoreEntity. Default OFF.
Outdoor cameras (Gen1 Eyes Außenkamera, Gen2 Eyes Außenkamera II) do
not get the switch — fixed mounting orientation by design.

Card v2.11.1 ships alongside.

Author: mosandlt

CHANGELOG.md

@@ -7,6 +7,18 @@ versions see this file or the [GitHub Releases page](https://github.com/mosandlt
 
 ---
 
+## v10.6.0
+
+**Image rotation 180° for ceiling-mounted indoor cameras.** New per-camera switch `switch.bosch_<cam>_bild_180deg_drehen` that rotates the camera image by 180° for upside-down (ceiling) mounting. Indoor-only — outdoor cameras have a fixed mounting orientation and don't get the switch. Three layers of effect, all client-side (Bosch firmware does not expose any image-rotation API):
+
+- **Lovelace card** applies a CSS `transform: rotate(180deg)` to the `<video>` and `<img>` elements. Zero CPU, zero latency, GPU-composited — the toggle is instant with no stream restart and no re-encode.
+- **Snapshot path** rotates the JPEG via PIL before serving it through `camera.async_camera_image()`, so push notifications, NAS clip uploads, and any other consumer that reads the camera entity also see the right-way-up image. ~15-30 ms per snapshot.
+- **PTZ pan inversion** — for the Gen1 360 camera, `BoschPanNumber` automatically inverts the slider sign when the rotation switch is on, so "right" on the slider stays "right" on the user's screen even when the camera is upside-down.
+
+State persists across HA restarts via `RestoreEntity`. Default OFF. Available on Gen1 360 Innenkamera and Gen2 Eyes Innenkamera II.
+
+**Card v2.11.1** ships alongside.
+
 ## v10.5.4
 
 **Stream switch unblocked when prior session has expired upstream.** When a previous live session had its underlying URL invalidated (e.g. the relay-side lifetime cap was reached while the switch was still ON), HA's `Stream.stop()` could block waiting for a stuck FFmpeg reconnect-loop to exit. Both teardown paths (`_tear_down_live_stream` shared exit, fresh-toggle stale-Stream invalidation in `_try_live_connection_inner`) now wrap the call in `asyncio.wait_for(timeout=5)` and force-detach on timeout. Without this, a single hung `stream.stop()` held the per-camera setup lock for >5 minutes and every subsequent switch-ON returned `try_live_connection: already in progress for ... — skipping`.

README.md

@@ -1116,8 +1116,8 @@ Features investigated or intentionally parked — listed here so the direction i
 
 ## Releases
 
-Latest stable: **v10.5.4** — see the GitHub release page for full notes:
-[**v10.5.4 release notes →**](https://github.com/mosandlt/Bosch-Smart-Home-Camera-Tool-HomeAssistant/releases/tag/v10.5.4)
+Latest stable: **v10.6.0** — see the GitHub release page for full notes:
+[**v10.6.0 release notes →**](https://github.com/mosandlt/Bosch-Smart-Home-Camera-Tool-HomeAssistant/releases/tag/v10.6.0)
 
 | | |
 |---|---|

custom_components/bosch_shc_camera/__init__.py

@@ -411,6 +411,12 @@ def __init__(self, hass: HomeAssistant, entry: ConfigEntry) -> None:
         self._audio_cache: dict[str, dict] = {}
         # Motion light cache — keyed by cam_id, from GET /lighting/motion (Gen2 only)
         self._motion_light_cache: dict[str, dict] = {}
+        # Image rotation 180° flag — keyed by cam_id, indoor cameras only.
+        # No API call — purely a client-side display flag for ceiling-mounted cams.
+        # Read by camera.async_camera_image (rotates JPEG via PIL) and by the
+        # Pan number entity (inverts sign so "right" stays "right" on screen).
+        # State is owned by BoschImageRotation180Switch (RestoreEntity).
+        self._image_rotation_180: dict[str, bool] = {}
         # Ambient lighting config cache — keyed by cam_id, from GET /lighting/ambient (Gen2 only)
         self._ambient_lighting_cache: dict[str, dict] = {}
         # Lighting switch cache — keyed by cam_id, from GET /lighting/switch (Gen2 only)

custom_components/bosch_shc_camera/camera.py

@@ -43,6 +43,26 @@
 IDLE_FRAME_INTERVAL     = 60    # seconds — how often HA's camera proxy calls async_camera_image
 
 
+def _rotate_jpeg_180(jpeg_bytes: bytes) -> bytes:
+    """Rotate a JPEG image by 180° using PIL. Sync — call via executor.
+
+    Used by async_camera_image when the user enabled the Bild 180° drehen
+    switch (ceiling-mounted indoor cameras). Typical 1280×720 JPEG: ~15-30 ms
+    with libjpeg-turbo. Returns the original bytes if rotation fails.
+    """
+    try:
+        from PIL import Image
+        from io import BytesIO
+        img = Image.open(BytesIO(jpeg_bytes))
+        rotated = img.rotate(180)
+        out = BytesIO()
+        rotated.save(out, format="JPEG", quality=90)
+        return out.getvalue()
+    except Exception as err:  # noqa: BLE001
+        _LOGGER.debug("rotate_jpeg_180 failed (%s) — returning original", err)
+        return jpeg_bytes
+
+
 async def async_setup_entry(
     hass: HomeAssistant,
     config_entry: ConfigEntry,
@@ -515,15 +535,21 @@ async def async_camera_image(
         """
         try:
             result = await self._async_camera_image_impl(width, height)
-            return result if result else self._PLACEHOLDER_JPEG
+            jpeg = result if result else self._PLACEHOLDER_JPEG
         except asyncio.CancelledError:
             raise  # let cancellation propagate cleanly
         except Exception as err:  # noqa: BLE001
             _LOGGER.debug(
                 "%s: async_camera_image failed (%s) — serving placeholder",
                 self._attr_name, err,
             )
-            return self._cached_image or self._PLACEHOLDER_JPEG
+            jpeg = self._cached_image or self._PLACEHOLDER_JPEG
+        # Apply 180° rotation if the user enabled it via the Bild 180° drehen
+        # switch (ceiling-mounted indoor cameras). Skip the placeholder JPEG.
+        rotate = bool(getattr(self.coordinator, "_image_rotation_180", {}).get(self._cam_id))
+        if rotate and jpeg is not self._PLACEHOLDER_JPEG and jpeg:
+            jpeg = await self.hass.async_add_executor_job(_rotate_jpeg_180, jpeg)
+        return jpeg
 
     async def _async_camera_image_impl(
         self, width: int | None = None, height: int | None = None

custom_components/bosch_shc_camera/const.py

@@ -5,7 +5,7 @@
 # Lovelace card version — must match CARD_VERSION in src/bosch-camera-card.js.
 # Bumped here alongside every card release so the auto-registered resource URL
 # changes and browsers fetch the new file (HA serves www/ with max-age=31 days).
-CARD_VERSION = "2.10.21"
+CARD_VERSION = "2.11.1"
 CLOUD_API = "https://residential.cbs.boschsecurity.com"
 
 ALL_PLATFORMS = [

custom_components/bosch_shc_camera/manifest.json

@@ -10,5 +10,5 @@
   "issue_tracker": "https://github.com/mosandlt/Bosch-Smart-Home-Camera-Tool-HomeAssistant/issues",
   "loggers": ["bosch_shc_camera"],
   "requirements": ["requests>=2.28.0", "firebase-messaging>=0.4.0", "smbprotocol>=1.10.0"],
-  "version": "10.5.4"
+  "version": "10.6.0"
 }

custom_components/bosch_shc_camera/number.py

@@ -110,9 +110,21 @@ def device_info(self) -> dict:
             "connections":  {("mac", self._mac)} if self._mac else set(),
         }
 
+    def _rotation_180(self) -> bool:
+        """Return True if the camera is configured as ceiling-mounted (image
+        rotated 180°). When True, the slider sign is inverted so that "right"
+        on the slider stays "right" on the user's screen.
+        """
+        return bool(
+            getattr(self.coordinator, "_image_rotation_180", {}).get(self._cam_id)
+        )
+
     @property
     def native_value(self) -> float | None:
-        return self.coordinator._pan_cache.get(self._cam_id)
+        raw = self.coordinator._pan_cache.get(self._cam_id)
+        if raw is None:
+            return None
+        return -raw if self._rotation_180() else raw
 
     @property
     def available(self) -> bool:
@@ -122,7 +134,10 @@ def available(self) -> bool:
         )
 
     async def async_set_native_value(self, value: float) -> None:
-        await self.coordinator.async_cloud_set_pan(self._cam_id, int(value))
+        # Invert sign when the camera is ceiling-mounted so the user-visible
+        # direction matches the camera-physical pan direction.
+        actual = -int(value) if self._rotation_180() else int(value)
+        await self.coordinator.async_cloud_set_pan(self._cam_id, actual)
 
 
 # ─────────────────────────────────────────────────────────────────────────────

custom_components/bosch_shc_camera/switch.py

@@ -40,6 +40,7 @@
 from homeassistant.exceptions import ServiceValidationError
 from homeassistant.helpers.entity import EntityCategory
 from homeassistant.helpers.entity_platform import AddEntitiesCallback
+from homeassistant.helpers.restore_state import RestoreEntity
 from homeassistant.helpers.update_coordinator import CoordinatorEntity
 
 from . import DOMAIN, get_options, CLOUD_API
@@ -48,6 +49,7 @@
 
 
 _GEN2_INDOOR_HW = {"HOME_Eyes_Indoor", "CAMERA_INDOOR_GEN2"}
+_INDOOR_HW = {"INDOOR", "CAMERA_360", "HOME_Eyes_Indoor", "CAMERA_INDOOR_GEN2"}
 
 
 def _is_gen2_indoor(entity) -> bool:
@@ -212,6 +214,13 @@ async def async_setup_entry(
             entities.append(BoschAlarmModeSwitch(coordinator, cam_id, config_entry))
             entities.append(BoschPreAlarmSwitch(coordinator, cam_id, config_entry))
             entities.append(BoschAudioAlarmSwitch(coordinator, cam_id, config_entry))
+        # Image rotation 180° — only for indoor cameras (Gen1 360 + Gen2 Indoor II).
+        # Outdoor cameras have a fixed mounting orientation by design and don't
+        # need this. The switch is purely client-side display state — the card
+        # applies CSS transform, the snapshot path applies PIL rotation, and
+        # (for Gen1 360) the pan slider sign is inverted.
+        if hw_version in _INDOOR_HW:
+            entities.append(BoschImageRotation180Switch(coordinator, cam_id, config_entry))
     async_add_entities(entities, update_before_add=False)
 
 
@@ -1684,3 +1693,62 @@ async def async_turn_on(self, **kwargs):
 
     async def async_turn_off(self, **kwargs):
         await self._set(False)
+
+
+# ─────────────────────────────────────────────────────────────────────────────
+class BoschImageRotation180Switch(_BoschSwitchBase, RestoreEntity):
+    """Switch: ON = display the camera image rotated 180° (ceiling mount).
+
+    Indoor-only — outdoor cameras have a fixed mounting orientation. Bosch's
+    Cloud API does not expose any image-rotation field; this switch is a
+    pure client-side display flag with three effects:
+
+      1. The Lovelace card applies `transform: rotate(180deg)` to its <video>
+         and <img> elements (zero CPU, zero latency, GPU-composited).
+      2. `camera.async_camera_image()` rotates the snapshot JPEG via PIL
+         before serving it (so push notifications, NAS clips, and other
+         consumers see the right-way-up image too).
+      3. For PTZ cameras (Gen1 360), `BoschPanNumber` inverts the sign of
+         the pan value so "right" on the slider stays "right" on screen
+         even when the camera is upside-down.
+
+    State persists across restarts via RestoreEntity. Default: OFF.
+    """
+
+    def __init__(self, coordinator, cam_id: str, entry: ConfigEntry) -> None:
+        super().__init__(coordinator, cam_id, entry)
+        self._attr_name            = f"Bosch {self._cam_title} Bild 180° drehen"
+        self._attr_unique_id       = f"bosch_shc_camera_{cam_id}_image_rotation_180"
+        self._attr_icon            = "mdi:image-auto-adjust"
+        self._attr_translation_key = "image_rotation_180"
+        self._attr_entity_category = EntityCategory.CONFIG
+
+    @property
+    def is_on(self) -> bool:
+        return bool(self.coordinator._image_rotation_180.get(self._cam_id, False))
+
+    @property
+    def available(self) -> bool:
+        # Always available — pure client-side flag, no API dependency
+        return self.coordinator.last_update_success
+
+    async def async_added_to_hass(self) -> None:
+        await super().async_added_to_hass()
+        last = await self.async_get_last_state()
+        if last is not None and last.state == "on":
+            self.coordinator._image_rotation_180[self._cam_id] = True
+            _LOGGER.debug(
+                "image_rotation_180: restored ON for %s from previous state",
+                self._cam_id[:8],
+            )
+
+    async def async_turn_on(self, **kwargs):
+        self.coordinator._image_rotation_180[self._cam_id] = True
+        self.async_write_ha_state()
+        # Notify pan number entity to refresh display value (sign flips).
+        self.coordinator.async_update_listeners()
+
+    async def async_turn_off(self, **kwargs):
+        self.coordinator._image_rotation_180[self._cam_id] = False
+        self.async_write_ha_state()
+        self.coordinator.async_update_listeners()

custom_components/bosch_shc_camera/translations/de.json

@@ -220,6 +220,9 @@
       "intrusion_detection": {
         "name": "Einbrucherkennung"
       },
+      "image_rotation_180": {
+        "name": "Bild 180° drehen"
+      },
       "alarm_system_arm": {
         "name": "Alarmanlage"
       },

custom_components/bosch_shc_camera/translations/en.json

@@ -220,6 +220,9 @@
       "intrusion_detection": {
         "name": "Intrusion Detection"
       },
+      "image_rotation_180": {
+        "name": "Rotate Image 180°"
+      },
       "alarm_system_arm": {
         "name": "Alarm System"
       },