How korenkov/haas_mdc works
Main Components
a. External CNC Machine
– The actual HAAS VF-2 CNC hardware, reachable over Ethernet or wireless.
b. Data Collection Service
– data_collection/main.py: orchestrates periodic data pulls.
– telnet.py + cnc_emulator*.py: encapsulate the Telnet protocol (production and emulators for testing).
– configs/network.ini & params.ini: supply connection settings and macro variable lists.
– create_schema.py: initializes the SQLite (or similar) database schema.
c. Database (Data Store)
– A lightweight file-based database (e.g., SQLite) created/updated by the Data Collection Service.
d. Visualization Web Service
– visualization/main.py: a small HTTP server (e.g., Flask or Bottle) serving dashboards.
– visualization/db.py: data-access layer for querying stored CNC data.
– visualization/chartjs.py + utils.py: build Chart.js data payloads.
– templates/*.html: Jinja2 templates for the UI pages.
e. Client Browser
– End user’s browser rendering the HTML + Chart.js charts served by the Visualization Web Service.
Relationships & Data Flows
– CNC Machine → (Telnet) → Data Collection Service
– Data Collection Service → (Write) → Database
– Visualization Web Service → (Read) → Database
– Visualization Web Service → (HTTP Response) → Client Browser
– Client Browser → (HTTP Request) → Visualization Web Service
Architectural Patterns
– Separation of concerns:
• Data Ingestion Layer (data_collection)
• Data Persistence Layer (database)
• Presentation Layer (visualization + browser)
– Configuration-driven behavior via INI files.
– Modular emulation for testing (cnc_emulator modules).
– Simple request-response web service (Flask/Bottle style).
– Client-side chart rendering with Chart.js (embedded via templates).
Relevant Technologies
– Telnet protocol (Python telnetlib wrapper in telnet.py)
– SQLite (or similar) for local storage
– Flask or Bottle for the HTTP server in visualization/main.py
– Jinja2 for HTML templates
– Chart.js for dynamic charts in the browser
– Python 3.x (see requirements.txt for versions)