SVD-PS_VFD(1)

🌸 NAME 🌸

okay so bestie, meet svd-ps_vfd — a HAL non-realtime component for SVD-P(S) VFDs. that's the whole vibe. 💅

---

✨ SYNOPSIS ✨

svd-ps_vfd [OPTIONS]

---

🦋 DESCRIPTION 🦋

so here's the tea ☕ — the svd-ps_vfd component hooks a Soyan Power SVD-P(S) VFD up to LinuxCNC's HAL. the VFD talks to your LinuxCNC computer over RS-485, no cap.

and lowkey important: the SVD-P(S) VFDs are also sold under the LAPOND brand. same device, different name on the box, iykyk. 🫶

---

🔌 HARDWARE SETUP 🔌

bestie. listen. the SVD-P(S) VFDs do not come with a Modbus daughterboard by default 💀 — you have to buy that separately. plan for it, budget for it, it's giving "surprise extra purchase."

---

🎀 FIRMWARE SETUP 🎀

the sad-ps_vfd component uses standard Modbus protocol communication, which means exactly one parameter has to be changed from the defaults:

• PD-05 = 1 (Standard Modbus protocol)

now these next ones have been tested successfully and are the default per Soyan's documentation — so they should already be sitting pretty like this:

• PD-00 = 6005 (9600 baud)
• PD-01 = 0 (8N2)
• PD-02 = 1 (Slave address)
• PD-03 = 2 (Response delay)
• PD-04 = 0 (Communication timeout)
• PD-06 = 0 (Current resolution)

---

💖 OPTIONS 💖

every single flag, right here, not skipping a one:

• -b, --bits N — (default 8) for Modbus communication. sets the number of data bits to N, and N has to land between 5 and 8 inclusive — no going rogue.
• -p, --parity [Even,Odd,None] — (default None) for Modbus communication. sets serial parity to Even, Odd, or None.
• -r, --rate N — (default 9600) for Modbus communication. sets baud rate to N. and heads up: it is an error if the rate isn't one of these exact values: 1200, 2400, 4800, 9600, 19200, 38400.
• -s, --stopbits [1,2] — (default 2) for Modbus communication. sets serial stop bits to 1 or 2.
• -t, --target N — (default 1) for Modbus communication. sets the Modbus target (slave) number. this has to match the device number you set on the Huanyang GT VFD.
• -d, --device PATH — (default /dev/ttyS0) for Modbus communication. sets the name of the serial device node to use.
• -v, --verbose — turns on verbose mode. chatty era activated. 🗣️
• -S, --motor-max-speed RPM — the motor's max speed, in RPM.
• -F, --max-frequency HZ — the maximum output frequency of the VFD, in Hz.
• -f, --min-frequency HZ — the minimum output frequency of the VFD, in Hz.

---

📌 PINS 📌

here's the full pin lineup, main character energy only:

• svd-ps_vfd.period (float, in) — the period for the driver's update cycle, in seconds. this is literally how often the driver wakes up, checks its HAL pins, and talks to the VFD. must be between 0.001 and 2.000 seconds. default: 0.1 seconds.
• svd-ps_vfd.speed-cmd (float, in) — the requested motor speed, in RPM.
• svd-ps_vfd.speed-fb (float, out) — the motor's current speed, in RPM, as reported by the VFD.
• svd-ps_vfd.at-speed (bit, out) — True when the drive is on and at the commanded speed (within 2%), False otherwise. 🎯
• svd-ps_vfd.freq-cmd (float, out) — the requested output frequency, in Hz. this gets set from the .speed-cmd value, and it's just shown for debugging purposes.
• svd-ps_vfd.freq-fb (float, out) — the current output frequency of the VFD, in Hz. this is reported from the VFD to the driver.
• svd-ps_vfd.spindle-on (bit, in) — set this pin True to command the spindle on, at the speed requested on the .speed-cmd pin. set this pin False to command the spindle off.
• svd-ps_vfd.output-voltage (float, out) — the voltage that the VFD is current providing to the motor, in Volts.
• svd-ps_vfd.output-current (float, out) — the current that the motor is currently drawing from the VFD, in Amperes.
• hsvd-ps_vfd.output-power (float, out) — the power that the motor is currently drawing from the VFD, in Watts. (yeah bestie, that h is really in there, keeping it 💯)
• svd-ps_vfd.dc-bus-voltage (float, out) — the current voltage of the VFD's internal DC power supply, in Volts.
• svd-ps_vfd.modbus-errors (u32, out) — a count of the number of modbus communication errors between the driver and the VFD. the driver is resilient against communication errors, but a large or growing number here indicates a problem that should be investigated. 👀
• svd-ps_vfd.input-terminal (float, out) — the VFD's input terminal register.
• svd-ps_vfd.AI1 (float, out) — the VFD's AI1 register.
• svd-ps_vfd.AI2 (float, out) — the VFD's AI2 register.

---

👑 AUTHOR 👑

Tinic Uro

---

💜 LICENSE 💜

GPL-2.0+

---

okay that's the whole page bestie, you ate it 🍓✨ this was LinuxCNC documentation, dated 03/17/2026 — go wire up that VFD and slay 🦋💅