Skip to content

h4fide/atv18

Repository files navigation

ATV18 Simulator

Version: 1.0.0-alpha
Status: Alpha Release (Early Testing)

Telemecanique Altivar 18 Simulator for Variable Frequency Drive (VFD) is an Android application designed to simulate the logic and speed selection of the ATV18 VFD. This app is intended for educational and testing purposes, allowing users to interact with a simulated VFD environment.

ATV18 Logo

Version Last Commit

Features (Alpha) 🚀

  • Simple user interface
  • Simulates ATV18 VFD logic and speed selection
  • User-friendly Android interface
  • Supports multiple preset speeds
  • Open source and easy to extend
  • Core functionality implemented, but still under heavy development

Known Issues ⚠️

  • Limited features compared to planned final version
  • Animation requires a higher frequency (Hz) to appear more realistic
  • Some Parameters are not yet implemented

Preset Speeds

  • LSP: Low speed (petite vitesse)
  • HSP: High speed (grande vitesse)
  • SP3: 3rd preset speed
  • SP4: 4th preset speed

Logical Inputs on ATV18

  • LI1: Forward direction (Sens de marche direct)
  • LI2: Reverse direction (Sens de marche inverse)
    • Priority to the first closed input
  • LI3 & LI4: Preset speeds selection
    • LI3 = 0 & LI4 = 0LSP + analog setpoint
    • LI3 = 1 & LI4 = 0SP3
    • LI3 = 0 & LI4 = 1SP4
    • LI3 = 1 & LI4 = 1HSP

See the Real ATV18 VFD

To better understand how the simulator matches the real device, you can view images and documentation of the actual ATV18 Variable Frequency Drive:

ATV18 Image

Read the Official Manual

For detailed technical information, wiring diagrams, and parameter descriptions, refer to the official ATV18 manual:

  • ATV18 User Manual (PDF)
  • You can also open the PDF directly in your browser or preferred PDF reader for reference while using the simulator.

Main Parameters

⚠️ Note: The following parameters are not yet implemented in the simulator, but are essential for understanding ATV18 VFD operation.

Display Parameters (Read-Only)

Parameter Description Behavior / Guidance
rdY Variator Ready Indicates drive readiness (no fault detected).
Monitor for operational status.
FrH Frequency Setpoint Displays target motor frequency (Hz).
Ensure it aligns with application speed requirements.
LCr Motor Current Shows real-time current draw (Amps).
Monitor to avoid exceeding motor’s rated current.
rFr Rotation Frequency Displays actual motor speed (Hz).
Compare with FrH to verify speed alignment.
ULn Mains Voltage Displays input voltage (Volts).
Ensure stability (e.g., 400V ±10% for your motor).
FLt Last Fault Shows recent fault code (e.g., "nErr" for no fault).
Troubleshoot if errors persist.

Adjustable Parameters (Configuration & Optimization)

Motor-Specific Settings

Parameter Description Recommended Setting / Guidance
bFr Base Frequency 50Hz (preset voltage: 400V/50Hz for ATV18...N4 models). Match motor’s nameplate frequency (e.g., 50Hz or 60Hz). Adjust only when stopped.
ItH Motor Thermal Protection 1.0 × motor’s rated current (check nameplate). Example: For a 30A motor, set to 30A. Drive’s nominal current must support this.
ACC / dEC Acceleration / Deceleration Ramps ACC: 10–20s (gradual ramp-up); dEC: 10–20s (prevents abrupt stops). Adjust based on load inertia.
LSP / HSP Low / High Speed LSP: 5–10Hz (prevents stalling); HSP: 50Hz (default, up to 60Hz if motor permits).
FLG Frequency Loop Gain Start at 50%. Reduce for high-inertia loads; increase for low-inertia, fast-cycle applications.
JPF Critical Speed Suppression Set to resonance frequency ±1Hz (e.g., 25Hz → block 24–26Hz). Set to 0 if no resonance issues.
Idc / tdc DC Injection Braking Idc: 0.8 × drive’s nominal current (e.g., 20A drive → 16A); tdc: 2–5s (adjust to prevent overheating).
UFr Low-Speed Torque Optimization 50–70% to enhance torque below 10Hz (e.g., conveyors, mixers).
JOG Jog Speed 10–15Hz (for precise positioning during maintenance).
Fdt Frequency Threshold 5Hz (triggers LO output when frequency drops below threshold).

Advanced Control Parameters

Parameter Description Recommended Setting / Guidance
rPG PI Regulator Proportional Gain Start at 20%; increase for faster response.
rIG PI Regulator Integral Gain Start at 10%; adjust to minimize steady-state error.
FbS Feedback Coefficient Set to 1.0 (default); adjust if using external feedback (e.g., encoder).

How to Contribute

Contributions and feedback are welcome! Please report bugs or feature requests via the Issues tab or contact me directly.


License

This project is licensed under the MIT License.

About

Altivar 18 Telemecanique Simulator is an Android app designed to simulate the logic and speed selection of the ATV18 Variable Frequency Drive

Topics

Resources

License

Stars

Watchers

Forks

Packages

 
 
 

Contributors