example: add support plot

Signed-off-by: YoungSoo Shin <shinys000114@gmail.com>

example/logger/README.md

@@ -9,13 +9,13 @@ Based on this script, you can monitor power consumption and implement graph plot
 ```shell
 sudo apt install virtualenv
 virtualenv venv
-. venv/bin/activate
+source venv/bin/activate
 ```
 
 ### Install require package
 
 ```shell
-pip install grpcio-tools requests websockets protobuf
+pip install grpcio-tools requests websockets protobuf pandas matplotlib
 ```
 
 ### Build `status_pb2.py`
@@ -26,7 +26,16 @@ python -m grpc_tools.protoc -I ../../proto --python_out=. status.proto
 
 ### Execute script
 
+#### Power consumption collection
 ```shell
-# python3 logger.py -u <username> -p <password> <address>
+# python3 logger.py -u <username> -o <name.csv> -p <password> <address>
-python3 logger.py -u admin -p password 192.168.30.5
+python3 logger.py -u admin -p password -o test.csv 192.168.30.5 
 ```
+
+#### Plot data
+
+```shell
+python3 csv_2_plot.py test.csv plot.png
+```
+
+![plot.png](plot.png)

example/logger/csv_2_plot.py

@@ -0,0 +1,95 @@
+import argparse
+import matplotlib.dates as mdates
+import matplotlib.pyplot as plt
+import os
+import pandas as pd
+
+
+def plot_power_data(csv_path, output_path):
+    """
+    Reads power data from a CSV file and generates a plot image.
+
+    Args:
+        csv_path (str): The path to the input CSV file.
+        output_path (str): The path to save the output plot image.
+    """
+    try:
+        # Read the CSV file into a pandas DataFrame
+        # The 'timestamp' column is parsed as dates
+        df = pd.read_csv(csv_path, parse_dates=['timestamp'])
+        print(f"Successfully loaded {len(df)} records from '{csv_path}'")
+    except FileNotFoundError:
+        print(f"Error: The file '{csv_path}' was not found.")
+        return
+    except Exception as e:
+        print(f"An error occurred while reading the CSV file: {e}")
+        return
+
+    # Create a figure and a set of subplots (3 rows, 1 column)
+    # sharex=True makes all subplots share the same x-axis (time)
+    fig, axes = plt.subplots(3, 1, figsize=(15, 18), sharex=True)
+
+    # --- Plot 1: Power (W) ---
+    ax1 = axes[0]
+    ax1.plot(df['timestamp'], df['vin_power'], label='VIN', color='red')
+    ax1.plot(df['timestamp'], df['main_power'], label='MAIN', color='green')
+    ax1.plot(df['timestamp'], df['usb_power'], label='USB', color='blue')
+    ax1.set_title('Power Consumption')
+    ax1.set_ylabel('Power (W)')
+    ax1.legend()
+    ax1.grid(True, which='both', linestyle='--', linewidth=0.5)
+
+    # --- Plot 2: Voltage (V) ---
+    ax2 = axes[1]
+    ax2.plot(df['timestamp'], df['vin_voltage'], label='VIN', color='red')
+    ax2.plot(df['timestamp'], df['main_voltage'], label='MAIN', color='green')
+    ax2.plot(df['timestamp'], df['usb_voltage'], label='USB', color='blue')
+    ax2.set_title('Voltage')
+    ax2.set_ylabel('Voltage (V)')
+    ax2.legend()
+    ax2.grid(True, which='both', linestyle='--', linewidth=0.5)
+
+    # --- Plot 3: Current (A) ---
+    ax3 = axes[2]
+    ax3.plot(df['timestamp'], df['vin_current'], label='VIN', color='red')
+    ax3.plot(df['timestamp'], df['main_current'], label='MAIN', color='green')
+    ax3.plot(df['timestamp'], df['usb_current'], label='USB', color='blue')
+    ax3.set_title('Current')
+    ax3.set_ylabel('Current (A)')
+    ax3.legend()
+    ax3.grid(True, which='both', linestyle='--', linewidth=0.5)
+
+    # --- Formatting the x-axis (Time) ---
+    # Improve date formatting on the x-axis
+    ax3.xaxis.set_major_formatter(mdates.DateFormatter('%H:%M:%S'))
+    ax3.xaxis.set_major_locator(plt.MaxNLocator(15))  # Limit the number of ticks
+    plt.xlabel('Time')
+    plt.xticks(rotation=45)
+
+    # Add a main title to the figure
+    start_time = df['timestamp'].iloc[0].strftime('%Y-%m-%d %H:%M:%S')
+    end_time = df['timestamp'].iloc[-1].strftime('%H:%M:%S')
+    fig.suptitle(f'ODROID Power Log ({start_time} to {end_time})', fontsize=16, y=0.95)
+
+    # Adjust layout to prevent titles/labels from overlapping
+    plt.tight_layout(rect=[0, 0, 1, 0.94])
+
+    # --- Save the plot to a file ---
+    try:
+        plt.savefig(output_path, dpi=150)
+        print(f"Plot successfully saved to '{output_path}'")
+    except Exception as e:
+        print(f"An error occurred while saving the plot: {e}")
+
+
+def main():
+    parser = argparse.ArgumentParser(description="Generate a plot from an Odroid PowerMate CSV log file.")
+    parser.add_argument("input_csv", help="Path to the input CSV log file.")
+    parser.add_argument("output_image", help="Path to save the output plot image (e.g., plot.png).")
+    args = parser.parse_args()
+
+    plot_power_data(args.input_csv, args.output_image)
+
+
+if __name__ == "__main__":
+    main()

example/logger/logger.py

@@ -1,11 +1,13 @@
 import argparse
 import asyncio
+import csv
 import requests
+import websockets
+from datetime import datetime
+
 # Import the status_pb2.py file generated by `protoc`.
 # This file must be in the same directory as logger.py.
 import status_pb2
-import websockets
-from datetime import datetime
 
 
 class OdroidPowerLogger:
@@ -16,12 +18,13 @@ class OdroidPowerLogger:
     3. Receives and decodes binary data in Protobuf format, then prints it.
     """
 
-    def __init__(self, host, username, password):
+    def __init__(self, host, username, password, output_file=None):
         self.host = host
         self.username = username
         self.password = password
         self.base_url = f"http://{self.host}"
         self.ws_url = f"ws://{self.host}/ws"
+        self.output_file = output_file
         self.token = None
 
     def login(self):
@@ -54,7 +57,33 @@ class OdroidPowerLogger:
         # Add the authentication token as a query parameter
         uri = f"{self.ws_url}?token={self.token}"
 
+        csv_file = None
+        csv_writer = None
+
         try:
+            # --- CSV File Handling ---
+            if self.output_file:
+                try:
+                    # Open the file in write mode, with newline='' to prevent extra blank rows
+                    csv_file = open(self.output_file, 'w', newline='', encoding='utf-8')
+                    csv_writer = csv.writer(csv_file)
+
+                    # Write header
+                    header = [
+                        'timestamp', 'uptime_sec',
+                        'vin_voltage', 'vin_current', 'vin_power',
+                        'main_voltage', 'main_current', 'main_power',
+                        'usb_voltage', 'usb_current', 'usb_power'
+                    ]
+                    csv_writer.writerow(header)
+                    print(f"Logging data to {self.output_file}")
+                except IOError as e:
+                    print(f"Error opening CSV file: {e}")
+                    # If file can't be opened, disable CSV writing
+                    csv_file = None
+                    csv_writer = None
+            # --- End CSV File Handling ---
+
             async with websockets.connect(uri) as websocket:
                 print(f"Connected to WebSocket: {uri}")
                 while True:
@@ -68,9 +97,10 @@ class OdroidPowerLogger:
                     # Process only if the payload type is 'sensor_data'
                     if status_message.WhichOneof('payload') == 'sensor_data':
                         sensor_data = status_message.sensor_data
-                        ts = datetime.fromtimestamp(sensor_data.timestamp).strftime('%Y-%m-%d %H:%M:%S')
+                        ts_dt = datetime.fromtimestamp(sensor_data.timestamp)
+                        ts_str = ts_dt.strftime('%Y-%m-%d %H:%M:%S')
 
-                        print(f"--- {ts} (Uptime: {sensor_data.uptime_sec}s) ---")
+                        print(f"--- {ts_str} (Uptime: {sensor_data.uptime_sec}s) ---")
 
                         # Print data for each channel
                         for name, channel in [('VIN', sensor_data.vin), ('MAIN', sensor_data.main),
@@ -78,10 +108,24 @@ class OdroidPowerLogger:
                             print(
                                 f"  {name:<4}: {channel.voltage:5.2f} V | {channel.current:5.3f} A | {channel.power:5.2f} W")
 
+                        # Write to CSV if enabled
+                        if csv_writer:
+                            row = [
+                                ts_dt.isoformat(), sensor_data.uptime_sec,
+                                sensor_data.vin.voltage, sensor_data.vin.current, sensor_data.vin.power,
+                                sensor_data.main.voltage, sensor_data.main.current, sensor_data.main.power,
+                                sensor_data.usb.voltage, sensor_data.usb.current, sensor_data.usb.power
+                            ]
+                            csv_writer.writerow(row)
+
         except websockets.exceptions.ConnectionClosed as e:
             print(f"WebSocket connection closed: {e}")
         except Exception as e:
             print(f"Error during WebSocket processing: {e}")
+        finally:
+            if csv_file:
+                csv_file.close()
+                print(f"\nCSV file '{self.output_file}' saved.")
 
     async def run(self):
         """Runs the logger."""
@@ -94,9 +138,10 @@ async def main():
     parser.add_argument("host", help="Server's host address or IP (e.g., 192.168.1.10)")
     parser.add_argument("-u", "--username", required=True, help="Login username")
     parser.add_argument("-p", "--password", required=True, help="Login password")
+    parser.add_argument("-o", "--output", help="Path to the output CSV file.")
     args = parser.parse_args()
 
-    logger = OdroidPowerLogger(host=args.host, username=args.username, password=args.password)
+    logger = OdroidPowerLogger(host=args.host, username=args.username, password=args.password, output_file=args.output)
     await logger.run()