Upload, download & backup files

Transfer TP programs, variable files, and backups between your PC and a Fanuc controller using FTP or CGTP.

FTP : Full file management
CGTP : File download via HTTP
Protocol comparison

Upload, download, and backup controller files on your Fanuc robot using FTP and CGTP.

FTP : Full file management

FTP provides complete file management: upload, download, delete, rename, and directory operations.

using UnderAutomation.Fanuc;

public class FtpFileManagement
{
  static void Main()
  {
    FanucRobot robot = new FanucRobot();
    ConnectionParameters parameters = new ConnectionParameters("192.168.0.1");
    parameters.Ftp.Enable = true;
    parameters.Ftp.FtpUser = "";
    parameters.Ftp.FtpPassword = "";
    robot.Connect(parameters);

    
    // Upload a TP program to the controller
    robot.Ftp.DirectFileHandling.UploadFileToController(@"C:\Programs\MyPrg.tp", "md:/MyPrg.tp");

    // Download a file from the robot
    robot.Ftp.DirectFileHandling.DownloadFileFromController(@"C:\Backup\Backup.va", "md:/Backup.va");

    // Delete a file
    robot.Ftp.DirectFileHandling.DeleteFile("md:/OldProgram.tp");

    // List files in a directory
    var items = robot.Ftp.DirectFileHandling.GetListing("md:/");
    foreach (var item in items)
      Console.WriteLine($"{item.Name} ({item.Type})");

    // Create and delete directories
    robot.Ftp.DirectFileHandling.CreateDirectory("md:/NewFolder");

    // Rename a file
    robot.Ftp.DirectFileHandling.Rename("md:/old.tp", "md:/new.tp");

    // Check file existence
    bool exists = robot.Ftp.DirectFileHandling.FileExists("md:/MyPrg.tp");
    
  }
}

FanucRobot robot = new FanucRobot();
robot.Connect("192.168.0.1");
// Backup: list all files and download
FtpListItem[] files = robot.Ftp.DirectFileHandling.GetListing("md:/");
foreach (var file in files)
{
    robot.Ftp.DirectFileHandling.DownloadFileFromController($"backup/{file.Name}", $"md:/{file.Name}");
}

// Upload a .tp file
robot.Ftp.DirectFileHandling.UploadFileToController("C:/programs/MY_PROGRAM.tp", "md:/MY_PROGRAM.tp");

// Download specific variable files
robot.Ftp.DirectFileHandling.DownloadFileFromController(out byte[] numreg, "md:/numreg.va");
robot.Ftp.DirectFileHandling.DownloadFileFromController(out byte[] posreg, "md:/posreg.va");

// Or use convenience methods
NumregFile regs = robot.Ftp.KnownVariableFiles.GetNumregFile();
}
}

Click to see the full code

CGTP : File download via HTTP

CGTP provides file listing and download through the robot's web server:

FanucRobot robot = new FanucRobot();
robot.Connect("192.168.0.1");
// List TP programs
CgtpAsciiFileItem[] programs = robot.Cgtp.Http.ListTpPrograms();

// Download a file as string
string content = robot.Cgtp.Http.DownloadAsString("numreg.va");

// Download a file as bytes
byte[] data = robot.Cgtp.Http.DownloadAsBytes("posreg.va");

// List files via CGTP protocol
string[] files = robot.Cgtp.ListFiles("MD:");
}
}

Click to see the full code

Protocol comparison

Feature	FTP	CGTP
Upload	Yes	No
Download	Yes	Yes
Delete	Yes	Only jobs
Rename	Yes	Only jobs
Directory ops	Yes	No
List files	Yes	Yes
Authentication	Optional	Optional

Any question?

AbbVie

GE

Lockheed Martin

Microsoft

Nissan

Stellantis

Upload, download & backup files

FTP : Full file management

CGTP : File download via HTTP

Protocol comparison