Add support for PiKVM Switch and related features

This commit introduces several new components and improvements:
- Added Switch module with firmware update and configuration support
- Implemented new media streaming capabilities
- Updated various UI elements and CSS styles
- Enhanced keyboard and mouse event handling
- Added new validators and configuration options
- Updated Python version support to 3.13
- Improved error handling and logging

kvmd/clients/kvmd.py

@@ -183,10 +183,12 @@ class KvmdClientWs:
                 self.__communicated = False
 
     async def send_key_event(self, key: str, state: bool) -> None:
-        await self.__writer_queue.put(bytes([1, state]) + key.encode("ascii"))
+        mask = (0b01 if state else 0)
+        await self.__writer_queue.put(bytes([1, mask]) + key.encode("ascii"))
 
     async def send_mouse_button_event(self, button: str, state: bool) -> None:
-        await self.__writer_queue.put(bytes([2, state]) + button.encode("ascii"))
+        mask = (0b01 if state else 0)
+        await self.__writer_queue.put(bytes([2, mask]) + button.encode("ascii"))
 
     async def send_mouse_move_event(self, to_x: int, to_y: int) -> None:
         await self.__writer_queue.put(struct.pack(">bhh", 3, to_x, to_y))

kvmd/clients/pst.py

@@ -0,0 +1,93 @@
+# ========================================================================== #
+#                                                                            #
+#    KVMD - The main PiKVM daemon.                                           #
+#                                                                            #
+#    Copyright (C) 2020  Maxim Devaev <mdevaev@gmail.com>                    #
+#                                                                            #
+#    This program is free software: you can redistribute it and/or modify    #
+#    it under the terms of the GNU General Public License as published by    #
+#    the Free Software Foundation, either version 3 of the License, or       #
+#    (at your option) any later version.                                     #
+#                                                                            #
+#    This program is distributed in the hope that it will be useful,         #
+#    but WITHOUT ANY WARRANTY; without even the implied warranty of          #
+#    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the           #
+#    GNU General Public License for more details.                            #
+#                                                                            #
+#    You should have received a copy of the GNU General Public License       #
+#    along with this program.  If not, see <https://www.gnu.org/licenses/>.  #
+#                                                                            #
+# ========================================================================== #
+
+
+import os
+import contextlib
+
+from typing import AsyncGenerator
+
+import aiohttp
+
+from .. import htclient
+from .. import htserver
+
+
+# =====
+class PstError(Exception):
+    pass
+
+
+# =====
+class PstClient:
+    def __init__(
+        self,
+        subdir: str,
+        unix_path: str,
+        timeout: float,
+        user_agent: str,
+    ) -> None:
+
+        self.__subdir = subdir
+        self.__unix_path = unix_path
+        self.__timeout = timeout
+        self.__user_agent = user_agent
+
+    async def get_path(self) -> str:
+        async with self.__make_http_session() as session:
+            async with session.get("http://localhost:0/state") as resp:
+                htclient.raise_not_200(resp)
+                path = (await resp.json())["result"]["data"]["path"]
+                return os.path.join(path, self.__subdir)
+
+    @contextlib.asynccontextmanager
+    async def writable(self) -> AsyncGenerator[str, None]:
+        async with self.__inner_writable() as path:
+            path = os.path.join(path, self.__subdir)
+            if not os.path.exists(path):
+                os.mkdir(path)
+            yield path
+
+    @contextlib.asynccontextmanager
+    async def __inner_writable(self) -> AsyncGenerator[str, None]:
+        async with self.__make_http_session() as session:
+            async with session.ws_connect("http://localhost:0/ws") as ws:
+                path = ""
+                async for msg in ws:
+                    if msg.type != aiohttp.WSMsgType.TEXT:
+                        raise PstError(f"Unexpected message type: {msg!r}")
+                    (event_type, event) = htserver.parse_ws_event(msg.data)
+                    if event_type == "storage":
+                        if not event["data"]["write_allowed"]:
+                            raise PstError("Write is not allowed")
+                        path = event["data"]["path"]
+                        break
+                if not path:
+                    raise PstError("WS loop broken without write_allowed=True flag")
+                # TODO: Actually we should follow ws events, but for fast writing we can safely ignore them
+                yield path
+
+    def __make_http_session(self) -> aiohttp.ClientSession:
+        return aiohttp.ClientSession(
+            headers={"User-Agent": self.__user_agent},
+            connector=aiohttp.UnixConnector(path=self.__unix_path),
+            timeout=aiohttp.ClientTimeout(total=self.__timeout),
+        )

kvmd/clients/streamer.py

@@ -63,6 +63,10 @@ class StreamerFormats:
     H264 = 875967048     # V4L2_PIX_FMT_H264
     _MJPEG = 1196444237  # V4L2_PIX_FMT_MJPEG
 
+    @classmethod
+    def is_diff(cls, fmt: int) -> bool:
+        return (fmt == cls.H264)
+
 
 class BaseStreamerClient:
     def get_format(self) -> int: