+import argparse
import asyncio
import logging
from datetime import datetime, timezone
-from threading import Timer
+from functools import partial
+from typing import Optional
import ocpp.v201
import websockets
Action,
AuthorizationStatusType,
ClearCacheStatusType,
+ GenericDeviceModelStatusType,
RegistrationStatusType,
+ ReportBaseType,
TransactionEventType,
)
from websockets import ConnectionClosed
+from timer import Timer
+
# Setting up the logging configuration to display debug level messages.
logging.basicConfig(level=logging.DEBUG)
ChargePoints = set()
-class RepeatTimer(Timer):
- """Class that inherits from the Timer class. It will run a
- function at regular intervals."""
-
- def run(self):
- while not self.finished.wait(self.interval):
- self.function(*self.args, **self.kwargs)
-
-
# Define a ChargePoint class inheriting from the OCPP 2.0.1 ChargePoint class.
class ChargePoint(ocpp.v201.ChargePoint):
+ _command_timer: Optional[Timer]
+
+ def __init__(self, connection):
+ super().__init__(connection.path.strip("/"), connection)
+ self._command_timer = None
+
# Message handlers to receive OCPP messages.
@on(Action.BootNotification)
async def on_boot_notification(self, charging_station, reason, **kwargs):
return ocpp.v201.call_result.MeterValues()
# Request handlers to emit OCPP messages.
- async def send_clear_cache(self):
+ async def _send_clear_cache(self):
request = ocpp.v201.call.ClearCache()
response = await self.call(request)
else:
logging.info("%s failed", Action.ClearCache)
+ async def _send_get_base_report(self):
+ request = ocpp.v201.call.GetBaseReport(
+ request_id=1, report_base=ReportBaseType.full_inventory
+ )
+ response = await self.call(request)
+
+ if response.status == GenericDeviceModelStatusType.accepted:
+ logging.info("%s successful", Action.GetBaseReport)
+ else:
+ logging.info("%s failed", Action.GetBaseReport)
+
+ async def _send_command(self, command_name: Action):
+ logging.debug("Sending OCPP command %s", command_name)
+ match command_name:
+ case Action.ClearCache:
+ await self._send_clear_cache()
+ case Action.GetBaseReport:
+ await self._send_get_base_report()
+ case _:
+ logging.info(f"Not supported command {command_name}")
+
+ async def send_command(
+ self, command_name: Action, delay: Optional[float], period: Optional[float]
+ ):
+ if not delay and not period:
+ raise ValueError("Either delay or period must be defined")
+ if delay and delay <= 0:
+ raise ValueError("Delay must be a positive number")
+ if period and period <= 0:
+ raise ValueError("Period must be a positive number")
+ try:
+ if delay and not self._command_timer:
+ self._command_timer = Timer(
+ delay,
+ False,
+ self._send_command,
+ [command_name],
+ )
+ if period and not self._command_timer:
+ self._command_timer = Timer(
+ period,
+ True,
+ self._send_command,
+ [command_name],
+ )
+ except ConnectionClosed:
+ self.handle_connection_closed()
+
+ def handle_connection_closed(self):
+ logging.info("ChargePoint %s closed connection", self.id)
+ if self._command_timer:
+ self._command_timer.cancel()
+ ChargePoints.remove(self)
+ logging.debug("Connected ChargePoint(s): %d", len(ChargePoints))
+
# Function to handle new WebSocket connections.
-async def on_connect(websocket, path):
+async def on_connect(
+ websocket,
+ command_name: Optional[Action],
+ delay: Optional[float],
+ period: Optional[float],
+):
"""For every new charge point that connects, create a ChargePoint instance and start
listening for messages."""
try:
)
return await websocket.close()
- charge_point_id = path.strip("/")
- cp = ChargePoint(charge_point_id, websocket)
+ cp = ChargePoint(websocket)
+ if command_name:
+ await cp.send_command(command_name, delay, period)
+
ChargePoints.add(cp)
+
try:
await cp.start()
except ConnectionClosed:
- logging.info("ChargePoint %s closed connection", cp.id)
- ChargePoints.remove(cp)
- logging.debug("Connected ChargePoint(s): %d", len(ChargePoints))
+ cp.handle_connection_closed()
# Main function to start the WebSocket server.
async def main():
+ parser = argparse.ArgumentParser(description="OCPP2 Server")
+ parser.add_argument("-c", "--command", type=Action, help="OCPP2 Command Name")
+ parser.add_argument("-d", "--delay", type=float, help="Delay in seconds")
+ parser.add_argument("-p", "--period", type=float, help="Period in seconds")
+
+ args = parser.parse_args()
+
# Create the WebSocket server and specify the handler for new connections.
server = await websockets.serve(
- on_connect,
+ partial(
+ on_connect, command_name=args.command, delay=args.delay, period=args.period
+ ),
"127.0.0.1", # Listen on loopback.
9000, # Port number.
subprotocols=["ocpp2.0", "ocpp2.0.1"], # Specify OCPP 2.0.1 subprotocols.
)
logging.info("WebSocket Server Started")
+
# Wait for the server to close (runs indefinitely).
await server.wait_closed()