s2-python 0.2.2__tar.gz → 0.3.1__tar.gz

{s2_python-0.2.2 → s2_python-0.3.1}/PKG-INFO

@@ -1,6 +1,6 @@
-Metadata-Version: 2.1
+Metadata-Version: 2.2
 Name: s2-python
-Version: 0.2.2
+Version: 0.3.1
 Summary: S2 Protocol Python Wrapper
 Home-page: https://github.com/flexiblepower/s2-ws-json-python
 Author: Flexiblepower

{s2_python-0.2.2 → s2_python-0.3.1}/setup.cfg

@@ -8,7 +8,7 @@ license_files = LICENSE.txt
 long_description = file: README.rst
 long_description_content_type = text/x-rst; charset=UTF-8
 url = https://github.com/flexiblepower/s2-ws-json-python
-version = 0.2.2
+version = 0.3.1
 platforms = Linux
 classifiers = 
 	Development Status :: 4 - Beta

{s2_python-0.2.2 → s2_python-0.3.1}/src/s2_python.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
-Metadata-Version: 2.1
+Metadata-Version: 2.2
 Name: s2-python
-Version: 0.2.2
+Version: 0.3.1
 Summary: S2 Protocol Python Wrapper
 Home-page: https://github.com/flexiblepower/s2-ws-json-python
 Author: Flexiblepower

{s2_python-0.2.2 → s2_python-0.3.1}/src/s2_python.egg-info/SOURCES.txt

@@ -58,4 +58,14 @@ src/s2python/frbc/frbc_usage_forecast.py
 src/s2python/frbc/frbc_usage_forecast_element.py
 src/s2python/frbc/rm.py
 src/s2python/generated/__init__.py
-src/s2python/generated/gen_s2.py
+src/s2python/generated/gen_s2.py
+src/s2python/ppbc/__init__.py
+src/s2python/ppbc/ppbc_end_interruption_instruction.py
+src/s2python/ppbc/ppbc_power_profile_definition.py
+src/s2python/ppbc/ppbc_power_profile_status.py
+src/s2python/ppbc/ppbc_power_sequence.py
+src/s2python/ppbc/ppbc_power_sequence_container.py
+src/s2python/ppbc/ppbc_power_sequence_container_status.py
+src/s2python/ppbc/ppbc_power_sequence_element.py
+src/s2python/ppbc/ppbc_schedule_instruction.py
+src/s2python/ppbc/ppbc_start_interruption_instruction.py

s2_python-0.3.1/src/s2python/ppbc/__init__.py

@@ -0,0 +1,12 @@
+from s2python.ppbc.ppbc_schedule_instruction import PPBCScheduleInstruction
+from s2python.ppbc.ppbc_end_interruption_instruction import (
+    PPBCEndInterruptionInstruction,
+)
+from s2python.ppbc.ppbc_power_profile_definition import PPBCPowerProfileDefinition
+from s2python.ppbc.ppbc_power_sequence_container import PPBCPowerSequenceContainer
+from s2python.ppbc.ppbc_power_sequence import PPBCPowerSequence
+from s2python.ppbc.ppbc_power_profile_status import PPBCPowerProfileStatus
+from s2python.ppbc.ppbc_power_sequence_container_status import (
+    PPBCPowerSequenceContainerStatus,
+)
+from s2python.ppbc.ppbc_power_sequence_element import PPBCPowerSequenceElement

s2_python-0.3.1/src/s2python/ppbc/ppbc_end_interruption_instruction.py

@@ -0,0 +1,32 @@
+import uuid
+
+from s2python.generated.gen_s2 import (
+    PPBCEndInterruptionInstruction as GenPPBCEndInterruptionInstruction,
+)
+
+from s2python.validate_values_mixin import (
+    S2Message,
+    catch_and_convert_exceptions,
+)
+
+
+@catch_and_convert_exceptions
+class PPBCEndInterruptionInstruction(
+    GenPPBCEndInterruptionInstruction, S2Message["PPBCEndInterruptionInstruction"]
+):
+    model_config = GenPPBCEndInterruptionInstruction.model_config
+    model_config["validate_assignment"] = True
+
+    id: uuid.UUID = GenPPBCEndInterruptionInstruction.model_fields["id"]  # type: ignore[assignment]
+    power_profile_id: uuid.UUID = GenPPBCEndInterruptionInstruction.model_fields[
+        "power_profile_id"
+    ]  # type: ignore[assignment]
+    sequence_container_id: uuid.UUID = GenPPBCEndInterruptionInstruction.model_fields[
+        "sequence_container_id"
+    ]  # type: ignore[assignment]
+    power_sequence_id: uuid.UUID = GenPPBCEndInterruptionInstruction.model_fields[
+        "power_sequence_id"
+    ]  # type: ignore[assignment]
+    abnormal_condition: bool = GenPPBCEndInterruptionInstruction.model_fields[
+        "abnormal_condition"
+    ]  # type: ignore[assignment]

s2_python-0.3.1/src/s2python/ppbc/ppbc_power_profile_definition.py

@@ -0,0 +1,27 @@
+from typing import List
+import uuid
+
+from s2python.generated.gen_s2 import (
+    PPBCPowerProfileDefinition as GenPPBCPowerProfileDefinition,
+)
+
+from s2python.validate_values_mixin import (
+    S2Message,
+    catch_and_convert_exceptions,
+)
+
+from s2python.ppbc.ppbc_power_sequence_container import PPBCPowerSequenceContainer
+
+
+@catch_and_convert_exceptions
+class PPBCPowerProfileDefinition(
+    GenPPBCPowerProfileDefinition, S2Message["PPBCPowerProfileDefinition"]
+):
+    model_config = GenPPBCPowerProfileDefinition.model_config
+    model_config["validate_assignment"] = True
+
+    message_id: uuid.UUID = GenPPBCPowerProfileDefinition.model_fields["message_id"]  # type: ignore[assignment]
+    id: uuid.UUID = GenPPBCPowerProfileDefinition.model_fields["id"]  # type: ignore[assignment]
+    power_sequences_containers: List[PPBCPowerSequenceContainer] = (
+        GenPPBCPowerProfileDefinition.model_fields["power_sequences_containers"]  # type: ignore[assignment]
+    )

s2_python-0.3.1/src/s2python/ppbc/ppbc_power_profile_status.py

@@ -0,0 +1,26 @@
+from typing import List
+
+from s2python.generated.gen_s2 import (
+    PPBCPowerProfileStatus as GenPPBCPowerProfileStatus,
+)
+
+from s2python.validate_values_mixin import (
+    S2Message,
+    catch_and_convert_exceptions,
+)
+
+from s2python.ppbc.ppbc_power_sequence_container_status import (
+    PPBCPowerSequenceContainerStatus,
+)
+
+
+@catch_and_convert_exceptions
+class PPBCPowerProfileStatus(
+    GenPPBCPowerProfileStatus, S2Message["PPBCPowerProfileStatus"]
+):
+    model_config = GenPPBCPowerProfileStatus.model_config
+    model_config["validate_assignment"] = True
+
+    sequence_container_status: List[PPBCPowerSequenceContainerStatus] = (
+        GenPPBCPowerProfileStatus.model_fields["sequence_container_status"]  # type: ignore[assignment]
+    )

s2_python-0.3.1/src/s2python/ppbc/ppbc_power_sequence.py

@@ -0,0 +1,30 @@
+from typing import List
+import uuid
+
+from s2python.generated.gen_s2 import (
+    PPBCPowerSequence as GenPPBCPowerSequence,
+)
+
+from s2python.validate_values_mixin import (
+    S2Message,
+    catch_and_convert_exceptions,
+)
+
+from s2python.ppbc.ppbc_power_sequence_element import PPBCPowerSequenceElement
+from s2python.common import Duration
+
+
+@catch_and_convert_exceptions
+class PPBCPowerSequence(GenPPBCPowerSequence, S2Message["PPBCPowerSequence"]):
+    model_config = GenPPBCPowerSequence.model_config
+    model_config["validate_assignment"] = True
+
+    id: uuid.UUID = GenPPBCPowerSequence.model_fields["id"]  # type: ignore[assignment]
+    elements: List[PPBCPowerSequenceElement] = GenPPBCPowerSequence.model_fields[
+        "elements"
+    ]  # type: ignore[assignment]
+    is_interruptible: bool = GenPPBCPowerSequence.model_fields["is_interruptible"]  # type: ignore[assignment]
+    max_pause_before: Duration = GenPPBCPowerSequence.model_fields["max_pause_before"]  # type: ignore[assignment]
+    abnormal_condition_only: bool = GenPPBCPowerSequence.model_fields[
+        "abnormal_condition_only"
+    ]  # type: ignore[assignment]

s2_python-0.3.1/src/s2python/ppbc/ppbc_power_sequence_container.py

@@ -0,0 +1,27 @@
+from typing import List
+import uuid
+
+
+from s2python.generated.gen_s2 import (
+    PPBCPowerSequenceContainer as GenPPBCPowerSequenceContainer,
+)
+
+from s2python.validate_values_mixin import (
+    S2Message,
+    catch_and_convert_exceptions,
+)
+
+from s2python.ppbc.ppbc_power_sequence import PPBCPowerSequence
+
+
+@catch_and_convert_exceptions
+class PPBCPowerSequenceContainer(
+    GenPPBCPowerSequenceContainer, S2Message["PPBCPowerSequenceContainer"]
+):
+    model_config = GenPPBCPowerSequenceContainer.model_config
+    model_config["validate_assignment"] = True
+
+    id: uuid.UUID = GenPPBCPowerSequenceContainer.model_fields["id"]  # type: ignore[assignment]
+    power_sequences: List[PPBCPowerSequence] = (
+        GenPPBCPowerSequenceContainer.model_fields["power_sequences"]  # type: ignore[assignment]
+    )

s2_python-0.3.1/src/s2python/ppbc/ppbc_power_sequence_container_status.py

@@ -0,0 +1,32 @@
+import uuid
+from typing import Union
+
+from s2python.generated.gen_s2 import (
+    PPBCPowerSequenceContainerStatus as GenPPBCPowerSequenceContainerStatus,
+)
+
+from s2python.validate_values_mixin import (
+    S2Message,
+    catch_and_convert_exceptions,
+)
+
+
+@catch_and_convert_exceptions
+class PPBCPowerSequenceContainerStatus(
+    GenPPBCPowerSequenceContainerStatus, S2Message["PPBCPowerSequenceContainerStatus"]
+):
+    model_config = GenPPBCPowerSequenceContainerStatus.model_config
+    model_config["validate_assignment"] = True
+
+    power_profile_id: uuid.UUID = GenPPBCPowerSequenceContainerStatus.model_fields[
+        "power_profile_id"  # type: ignore[assignment]
+    ]
+    sequence_container_id: uuid.UUID = GenPPBCPowerSequenceContainerStatus.model_fields[
+        "sequence_container_id"  # type: ignore[assignment]
+    ]
+    selected_sequence_id: Union[uuid.UUID, None] = (
+        GenPPBCPowerSequenceContainerStatus.model_fields["selected_sequence_id"]  # type: ignore[assignment]
+    )
+    progress: Union[uuid.UUID, None] = GenPPBCPowerSequenceContainerStatus.model_fields[
+        "progress"  # type: ignore[assignment]
+    ]

s2_python-0.3.1/src/s2python/ppbc/ppbc_power_sequence_element.py

@@ -0,0 +1,25 @@
+from typing import List
+
+from s2python.generated.gen_s2 import (
+    PPBCPowerSequenceElement as GenPPBCPowerSequenceElement,
+)
+
+from s2python.validate_values_mixin import (
+    S2Message,
+    catch_and_convert_exceptions,
+)
+
+from s2python.common import Duration, PowerForecastValue
+
+
+@catch_and_convert_exceptions
+class PPBCPowerSequenceElement(
+    GenPPBCPowerSequenceElement, S2Message["PPBCPowerSequenceElement"]
+):
+    model_config = GenPPBCPowerSequenceElement.model_config
+    model_config["validate_assignment"] = True
+
+    duration: Duration = GenPPBCPowerSequenceElement.model_fields["duration"]  # type: ignore[assignment]
+    power_values: List[PowerForecastValue] = GenPPBCPowerSequenceElement.model_fields[
+        "power_values"
+    ]  # type: ignore[assignment]

s2_python-0.3.1/src/s2python/ppbc/ppbc_schedule_instruction.py

@@ -0,0 +1,33 @@
+import uuid
+
+from s2python.generated.gen_s2 import (
+    PPBCScheduleInstruction as GenPPBCScheduleInstruction,
+)
+from s2python.validate_values_mixin import (
+    catch_and_convert_exceptions,
+    S2Message,
+)
+
+
+@catch_and_convert_exceptions
+class PPBCScheduleInstruction(
+    GenPPBCScheduleInstruction, S2Message["PPBCScheduleInstruction"]
+):
+    model_config = GenPPBCScheduleInstruction.model_config
+    model_config["validate_assignment"] = True
+
+    id: uuid.UUID = GenPPBCScheduleInstruction.model_fields["id"]  # type: ignore[assignment]
+
+    power_profile_id: uuid.UUID = GenPPBCScheduleInstruction.model_fields[
+        "power_profile_id"
+    ]  # type: ignore[assignment]
+
+    message_id: uuid.UUID = GenPPBCScheduleInstruction.model_fields["message_id"]  # type: ignore[assignment]
+
+    sequence_container_id: uuid.UUID = GenPPBCScheduleInstruction.model_fields[
+        "sequence_container_id"
+    ]  # type: ignore[assignment]
+
+    power_sequence_id: uuid.UUID = GenPPBCScheduleInstruction.model_fields[
+        "power_sequence_id"
+    ]  # type: ignore[assignment]

s2_python-0.3.1/src/s2python/ppbc/ppbc_start_interruption_instruction.py

@@ -0,0 +1,32 @@
+import uuid
+
+from s2python.generated.gen_s2 import (
+    PPBCStartInterruptionInstruction as GenPPBCStartInterruptionInstruction,
+)
+
+from s2python.validate_values_mixin import (
+    S2Message,
+    catch_and_convert_exceptions,
+)
+
+
+@catch_and_convert_exceptions
+class PPBCStartInterruptionInstruction(
+    GenPPBCStartInterruptionInstruction, S2Message["PPBCStartInterruptionInstruction"]
+):
+    model_config = GenPPBCStartInterruptionInstruction.model_config
+    model_config["validate_assignment"] = True
+
+    id: uuid.UUID = GenPPBCStartInterruptionInstruction.model_fields["id"]  # type: ignore[assignment]
+    power_profile_id: uuid.UUID = GenPPBCStartInterruptionInstruction.model_fields[
+        "power_profile_id"
+    ]  # type: ignore[assignment]
+    sequence_container_id: uuid.UUID = GenPPBCStartInterruptionInstruction.model_fields[
+        "sequence_container_id"
+    ]  # type: ignore[assignment]
+    power_sequence_id: uuid.UUID = GenPPBCStartInterruptionInstruction.model_fields[
+        "power_sequence_id"
+    ]  # type: ignore[assignment]
+    abnormal_condition: bool = GenPPBCStartInterruptionInstruction.model_fields[
+        "abnormal_condition"
+    ]  # type: ignore[assignment]

{s2_python-0.2.2 → s2_python-0.3.1}/src/s2python/s2_connection.py

@@ -1,6 +1,7 @@
 import asyncio
 import json
 import logging
+import time
 import threading
 import uuid
 from dataclasses import dataclass
@@ -180,6 +181,7 @@ class MessageHandlers:
 
 class S2Connection:  # pylint: disable=too-many-instance-attributes
     url: str
+    reconnect: bool
     reception_status_awaiter: ReceptionStatusAwaiter
     ws: Optional[WSConnection]
     s2_parser: S2Parser
@@ -195,16 +197,20 @@ class S2Connection:  # pylint: disable=too-many-instance-attributes
 
     _eventloop: asyncio.AbstractEventLoop
     _stop_event: asyncio.Event
+    _restart_connection_event: asyncio.Event
 
-    def __init__(
+    def __init__(  # pylint: disable=too-many-arguments
         self,
         url: str,
         role: EnergyManagementRole,
         control_types: List[S2ControlType],
         asset_details: AssetDetails,
+        reconnect: bool = False,
     ) -> None:
         self.url = url
+        self.reconnect = reconnect
         self.reception_status_awaiter = ReceptionStatusAwaiter()
+        self.ws = None
         self.s2_parser = S2Parser()
 
         self._handlers = MessageHandlers()
@@ -221,14 +227,13 @@ class S2Connection:  # pylint: disable=too-many-instance-attributes
         self._handlers.register_handler(HandshakeResponse, self.handle_handshake_response_as_rm)
 
     def start_as_rm(self) -> None:
-        self._thread = threading.Thread(target=self._run_eventloop, daemon=False)
-        self._thread.start()
-        logger.debug("Started eventloop thread!")
+        self._run_eventloop(self._run_as_rm())
 
-    def _run_eventloop(self) -> None:
+    def _run_eventloop(self, main_task: Awaitable[None]) -> None:
+        self._thread = threading.current_thread()
         logger.debug("Starting eventloop")
         try:
-            self._eventloop.run_until_complete(self._run_as_rm())
+            self._eventloop.run_until_complete(main_task)
         except asyncio.CancelledError:
             pass
         logger.debug("S2 connection thread has stopped.")
@@ -256,45 +261,69 @@ class S2Connection:  # pylint: disable=too-many-instance-attributes
 
     async def _run_as_rm(self) -> None:
         logger.debug("Connecting as S2 resource manager.")
-        self._received_messages = asyncio.Queue()
+
         self._stop_event = asyncio.Event()
-        await self.connect_ws()
 
-        background_tasks = []
-        background_tasks.append(self._eventloop.create_task(self._receive_messages()))
-        background_tasks.append(self._eventloop.create_task(self._handle_received_messages()))
+        first_run = True
 
-        async def wait_till_stop() -> None:
-            await self._stop_event.wait()
+        while (first_run or self.reconnect) and not self._stop_event.is_set():
+            first_run = False
+            self._restart_connection_event = asyncio.Event()
+            await self._connect_and_run()
+            time.sleep(1)
 
-        background_tasks.append(self._eventloop.create_task(wait_till_stop()))
+        logger.debug("Finished S2 connection eventloop.")
 
-        await self.connect_as_rm()
-        (done, pending) = await asyncio.wait(background_tasks, return_when=asyncio.FIRST_COMPLETED)
-        for task in done:
-            try:
-                await task
-            except asyncio.CancelledError:
-                pass
-            except websockets.ConnectionClosedError:
-                logger.info("The other party closed the websocket connection.c")
+    async def _connect_and_run(self) -> None:
+        self._received_messages = asyncio.Queue()
+        await self._connect_ws()
+        if self.ws:
 
-        for task in pending:
-            try:
-                task.cancel()
-                await task
-            except asyncio.CancelledError:
-                pass
+            async def wait_till_stop() -> None:
+                await self._stop_event.wait()
+
+            async def wait_till_connection_restart() -> None:
+                await self._restart_connection_event.wait()
+
+            background_tasks = [
+                self._eventloop.create_task(self._receive_messages()),
+                self._eventloop.create_task(wait_till_stop()),
+                self._eventloop.create_task(self._connect_as_rm()),
+                self._eventloop.create_task(wait_till_connection_restart()),
+            ]
+
+            (done, pending) = await asyncio.wait(
+                background_tasks, return_when=asyncio.FIRST_COMPLETED
+            )
+            if self._current_control_type:
+                self._current_control_type.deactivate(self)
+                self._current_control_type = None
+
+            for task in done:
+                try:
+                    await task
+                except asyncio.CancelledError:
+                    pass
+                except (websockets.ConnectionClosedError, websockets.ConnectionClosedOK):
+                    logger.info("The other party closed the websocket connection.")
+
+            for task in pending:
+                try:
+                    task.cancel()
+                    await task
+                except asyncio.CancelledError:
+                    pass
 
-        if self.ws:
             await self.ws.close()
             await self.ws.wait_closed()
-        logger.debug("Finished S2 connection eventloop.")
 
-    async def connect_ws(self) -> None:
-        self.ws = await ws_connect(uri=self.url)
+    async def _connect_ws(self) -> None:
+        try:
+            self.ws = await ws_connect(uri=self.url)
+        except (EOFError, OSError) as e:
+            logger.info("Could not connect due to: %s", str(e))
 
-    async def connect_as_rm(self) -> None:
+    async def _connect_as_rm(self) -> None:
         await self.send_msg_and_await_reception_status_async(
             Handshake(
                 message_id=uuid.uuid4(), role=self.role, supported_protocol_versions=[S2_VERSION]
@@ -302,6 +331,8 @@ class S2Connection:  # pylint: disable=too-many-instance-attributes
         )
         logger.debug("Send handshake to CEM. Expecting Handshake and HandshakeResponse from CEM.")
 
+        await self._handle_received_messages()
+
     async def handle_handshake(
         self, _: "S2Connection", message: S2Message, send_okay: Awaitable[None]
     ) -> None:
@@ -427,7 +458,11 @@ class S2Connection:  # pylint: disable=too-many-instance-attributes
 
         json_msg = s2_msg.to_json()
         logger.debug("Sending message %s", json_msg)
-        await self.ws.send(json_msg)
+        try:
+            await self.ws.send(json_msg)
+        except websockets.ConnectionClosedError as e:
+            logger.error("Unable to send message %s due to %s", s2_msg, str(e))
+            self._restart_connection_event.set()
 
     async def respond_with_reception_status(
         self, subject_message_id: str, status: ReceptionStatusValues, diagnostic_label: str
@@ -458,9 +493,17 @@ class S2Connection:  # pylint: disable=too-many-instance-attributes
             s2_msg.message_id,  # type: ignore[attr-defined]
             timeout_reception_status,
         )
-        reception_status = await self.reception_status_awaiter.wait_for_reception_status(
-            s2_msg.message_id, timeout_reception_status  # type: ignore[attr-defined]
-        )
+        try:
+            reception_status = await self.reception_status_awaiter.wait_for_reception_status(
+                s2_msg.message_id, timeout_reception_status  # type: ignore[attr-defined]
+            )
+        except TimeoutError:
+            logger.error(
+                "Did not receive a reception status on time for %s",
+                s2_msg.message_id,  # type: ignore[attr-defined]
+            )
+            self._stop_event.set()
+            raise
 
         if reception_status.status != ReceptionStatusValues.OK and raise_on_error:
             raise RuntimeError(f"ReceptionStatus was not OK but rather {reception_status.status}")

{s2_python-0.2.2 → s2_python-0.3.1}/src/s2python/s2_control_type.py

@@ -3,6 +3,7 @@ import typing
 
 from s2python.common import ControlType as ProtocolControlType
 from s2python.frbc import FRBCInstruction
+from s2python.ppbc import PPBCScheduleInstruction
 from s2python.validate_values_mixin import S2Message
 
 if typing.TYPE_CHECKING:
@@ -36,10 +37,33 @@ class FRBCControlType(S2ControlType):
     ) -> None: ...
 
     @abc.abstractmethod
-    def activate(self, conn: "S2Connection") -> None: ...
+    def activate(self, conn: "S2Connection") -> None:
+        """Overwrite with the actual dctivation logic of your Resource Manager for this particular control type."""
 
     @abc.abstractmethod
-    def deactivate(self, conn: "S2Connection") -> None: ...
+    def deactivate(self, conn: "S2Connection") -> None:
+        """Overwrite with the actual deactivation logic of your Resource Manager for this particular control type."""
+
+
+class PPBCControlType(S2ControlType):
+    def get_protocol_control_type(self) -> ProtocolControlType:
+        return ProtocolControlType.POWER_PROFILE_BASED_CONTROL
+
+    def register_handlers(self, handlers: "MessageHandlers") -> None:
+        handlers.register_handler(PPBCScheduleInstruction, self.handle_instruction)
+
+    @abc.abstractmethod
+    def handle_instruction(
+        self, conn: "S2Connection", msg: S2Message, send_okay: typing.Callable[[], None]
+    ) -> None: ...
+
+    @abc.abstractmethod
+    def activate(self, conn: "S2Connection") -> None:
+        """Overwrite with the actual dctivation logic of your Resource Manager for this particular control type."""
+
+    @abc.abstractmethod
+    def deactivate(self, conn: "S2Connection") -> None:
+        """Overwrite with the actual deactivation logic of your Resource Manager for this particular control type."""
 
 
 class NoControlControlType(S2ControlType):

{s2_python-0.2.2 → s2_python-0.3.1}/src/s2python/s2_parser.py

@@ -24,6 +24,8 @@ from s2python.frbc import (
     FRBCTimerStatus,
     FRBCUsageForecast,
 )
+from s2python.ppbc import PPBCScheduleInstruction
+
 from s2python.validate_values_mixin import S2Message
 from s2python.s2_validation_error import S2ValidationError
 
@@ -44,6 +46,7 @@ TYPE_TO_MESSAGE_CLASS: Dict[str, Type[S2Message]] = {
     "FRBC.SystemDescription": FRBCSystemDescription,
     "FRBC.TimerStatus": FRBCTimerStatus,
     "FRBC.UsageForecast": FRBCUsageForecast,
+    "PPBC.ScheduleInstruction": PPBCScheduleInstruction,
     "Handshake": Handshake,
     "HandshakeResponse": HandshakeResponse,
     "InstructionStatusUpdate": InstructionStatusUpdate,
@@ -86,7 +89,9 @@ class S2Parser:
         return TYPE_TO_MESSAGE_CLASS[message_type].model_validate(message_json)
 
     @staticmethod
-    def parse_as_message(unparsed_message: Union[dict, str, bytes], as_message: Type[M]) -> M:
+    def parse_as_message(
+        unparsed_message: Union[dict, str, bytes], as_message: Type[M]
+    ) -> M:
         """Parse the message to a specific S2 python message.
 
         :param unparsed_message: The message as a JSON-formatted string or as a JSON-parsed dictionary.
@@ -98,7 +103,9 @@ class S2Parser:
         return as_message.from_dict(message_json)
 
     @staticmethod
-    def parse_message_type(unparsed_message: Union[dict, str, bytes]) -> Optional[S2MessageType]:
+    def parse_message_type(
+        unparsed_message: Union[dict, str, bytes],
+    ) -> Optional[S2MessageType]:
         """Parse only the message type from the unparsed message.
 
         This is useful to call before `parse_as_message` to retrieve the message type and allows for strictly-typed