From a7391f133d25382f87f37decffbc12043fadaf9b Mon Sep 17 00:00:00 2001 From: Miguel Date: Thu, 22 May 2025 16:48:41 -0300 Subject: [PATCH] =?UTF-8?q?A=C3=B1adir=20Home?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- Home.md | 45 +++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 45 insertions(+) create mode 100644 Home.md diff --git a/Home.md b/Home.md new file mode 100644 index 0000000..df7122b --- /dev/null +++ b/Home.md @@ -0,0 +1,45 @@ +# Maselli Protocol Simulator/Tracer + +## Overview + +The Maselli Protocol Simulator/Tracer is a Python-based desktop application designed to simulate a Maselli device sending data using a specific ADAM-like protocol, and also to trace (listen to) data from such a device. It supports Serial, TCP, and UDP communication. The application provides a graphical user interface (GUI) built with Tkinter for easy configuration and operation. + +## Features + +* **Dual Mode Operation:** + * **Simulator Mode:** Emulates a Maselli device, sending data packets. + * Supports Linear, Sinusoidal, and Manual data generation patterns. + * Configurable ADAM address and data sending period. + * Real-time display of simulated Brix and mA values. + * Live plotting of simulated Brix and mA over time. + * **Trace Mode:** Listens for incoming data packets from a Maselli device. + * Parses ADAM protocol messages to extract mA values. + * Converts mA to Brix based on user-defined mapping. + * Logs received data (Timestamp, mA, Brix, Raw Message) to a CSV file. + * Real-time display of last received data. + * Live plotting of received Brix values over time. +* **Flexible Connectivity:** + * Supports Serial (RS485/RS232), TCP, and UDP connections. + * Configurable connection parameters (COM port, baud rate, IP address, port). +* **Data Visualization:** + * Separate real-time graphs for simulator and trace modes. + * Graphs display Brix and/or mA values against time. +* **Configuration Management:** + * Save and load connection and simulation settings to/from a JSON file (`maselli_simulator_config.json`). +* **Logging:** + * Communication logs for both simulator and trace modes. +* **User-Friendly Interface:** + * Tabbed interface for easy switching between Simulator and Trace modes. + * Clear input fields and controls. + +## Requirements + +* Python 3.x +* The following Python libraries: + * `tkinter` (usually included with Python) + * `pyserial` + * `matplotlib` + +You can install the required libraries using pip: +```bash +pip install pyserial matplotlib