XModem file upload - Longus/FluidNC GitHub Wiki

XModem file upload

You can use xmodem via serial port to upload files to the localfs. This can be helpful to upload config files. you must be in the Idle or Alarm states

Sending a File to FluidNC

Before files are sent to the FluidNC controller you must enter the $Xmodem/Receive=<filename> (or $XR=<filename>) command. You will see the 'C' character outputting on the terminal. You must then initiate the xmodem transfer on your terminal program. It will timeout if the transfer is not started after a period of time.

?<Idle|WPos:0.000,0.000,-3.000|FS:0.000,0>

$XModem/Receive=new.yaml
[MSG:INFO: Receiving new.yaml via XModem]
C[MSG:INFO: Received 5433 bytes]
ok
?<Idle|WPos:0.000,0.000,-3.000|FS:0.000,0>
$localfs/list

[FILE:/foo.12|SIZE:0]
[FILE:/foo.1|SIZE:0]
[FILE:/foo.yam|SIZE:0]
[FILE:/test.yaml|SIZE:5]
[FILE:/favicon.ico|SIZE:1150]
[FILE:/index.html.gz|SIZE:116657]
[FILE:/new.yaml|SIZE:5433]
[Local FS Free:46.08 KB Used:123.29 KB Total:169.38 KB]
ok

Downloading a file from FluidNC

Enter the $XModem/Send=<filename> command. Then start the xmodem receive on your terminal program.

?<Idle|WPos:0.000,0.000,-3.000|FS:0.000,0>
$XModem/Send=index.html.gz
[MSG:INFO: Sending index.html.gz via XModem]
[MSG:INFO: Sent 116736 bytes]
ok
?<Idle|WPos:0.000,0.000,-3.000|FS:0.000,0|WCO:0.000,0.000,3.000>

Terminal Programs that support Xmodem

⚠️ **GitHub.com Fallback** ⚠️