---
title: Installing Machine Drivers using File-based data exchange in Alleantia Core
description: Many industrial systems 'speak' through files - CSV, TXT etc.. This article describes how to install a file-based R/W machine driver
---

[Skip to content](https://kb.alleantia.com/file-driver-management-through-alleantia#main-content)

English

Show submenu for translations

![Alleantia\_ATJ\_whitelogocolorbandtrasnpbg\_HR-Oct-21-2021-02-02-26-19-PM.png\]](https://kb.alleantia.com/hs-fs/hubfs/Alleantia_ATJ_whitelogocolorbandtrasnpbg_HR-Oct-21-2021-02-02-26-19-PM.png?height=40&name=Alleantia_ATJ_whitelogocolorbandtrasnpbg_HR-Oct-21-2021-02-02-26-19-PM.png)

Open main navigation

Close main navigation

- English
  
  Show submenu for translations
- [Visit our site](https://www.alleantia.com/)

[Visit our site](https://www.alleantia.com/)

 Welcome to Alleantia, Industrial IoT Edge Gateway. How can we help you?

- There are no suggestions because the search field is empty.

1. [Alleantia Knowledge Base](https://kb.alleantia.com/)
2. [Machine Drivers](https://kb.alleantia.com/machine-drivers)
3. [How can I create a driver with Driver Editor?](https://kb.alleantia.com/machine-drivers#how-can-i-create-a-driver-with-driver-editor)

# Installing Machine Drivers using File-based data exchange in Alleantia Core

## Many industrial systems 'speak' through files - CSV, TXT etc.. This article describes how to install a file-based R/W machine driver

### **Overview**

#### **Supported File Types**

Alleantia enables data exchange with various file types, including:

- CSV
- XML
- INI
- Properties
- TXT

#### **Limitations**:

- We cannot read files without one of such extensions or other extensions.
- Extension must be the same for read (from machine to IoT Gateway) and write (from IoT Gateway to machine) files
- For each machine, the machine driver can only read one file in Read Mode at a time. If the machine generates multiple files in output, there must be configured as many devices as the number of files to read.
- For each machine, the machine driver can only create one file in Write Mode at a time. If the machine expects multiple files in input, there must be configured as many devices as the number of files to send.
- Nevertheless, it is possible to create an integrated driver using data export via MQTT or OPCUA and reading from them (ask us for support).

#### **Supported File Exchange Protocols**

Alleantia supports various network protocols to access shared folders containing files. These protocols include:

- Samba 2
- FTP (File Transfer Protocol)
- Folder access
- SFTP (SSH File Transfer Protocol)

![](https://kb.alleantia.com/hs-fs/hubfs/Protocollo-Lettura_ENG-JPG.png?width=383&height=531&name=Protocollo-Lettura_ENG-JPG.png)

### **Create a File-Based Machine Driver**

Driver editor will be ready soon.

### **File Management**

To manage properly the machine input and output files, it is essential to understand the various possible operations and file structures.

#### Reading

**Reading All Rows at a time:**

- It is necessary to know in advance the maximum number of file rows, that should be read.
- The number of variables used in ISC is the Cartesian product of rows and columns. E.g. a file with 8 rows and 20 columns will consume 8x20 = 160 variables

**Reading a Single Row file :**

- Configuration of the command to parse the row directly on the driver is required.

**Reading a Multi-Row file (append), one row at a Time:**

- Involves reading one row at a time and updating the read value each time.

![](https://kb.alleantia.com/hs-fs/hubfs/modo-Lettura-JPG.png?width=382&height=535&name=modo-Lettura-JPG.png)

**Reading XML files:**

- It is necessary to know the XML tag path to be inserted into the driver.

**For INI and Properties files:**

- Configuration of the parameter to be read directly on the driver is required.
- Knowledge of the file structure is essential for correct reading.

#### **Writing**

- It is possible to add variables to the driver for writing to the generated file.
- The management system must write the required variables to be written along with the variable containing the filename (including the extension) and a trigger variable.
- The trigger variable is necessary to be written after the others to avoid inconsistent writes. 
    - The "trigger" variable is not among the parameters provided by the machine but represents an additional element to be defined within the editor. Once mapped in the editor, this variable plays a key role in the process of generating the file intended for the machine. After completing the definition of the machine variables and assigning them the appropriate values, activating the "trigger" variable enables the creation of the final file to be supplied to the machine, containing the desired values.

### **Driver Installation and Configuration**

**Network Paths and Credentials**

Ensure that you have detailed information about the network **paths of shared folders and their corresponding access credentials**. This information is essential to ensure reliable connectivity and proper file access.

#### **Configuration of 'Read' File**

After installing the new device using the file-based driver, clicking the 'Param' button. The following mask opens, where to configure protocol, machine IP address and folder, and file type

**![](https://kb.alleantia.com/hs-fs/hubfs/Lettura_ENG-JPG.png?width=383&height=535&name=Lettura_ENG-JPG.png)**

Please note that if after reading, Alleantia ISC is set to delete the file, a backup is possible (see below) . 

#### **Writing Configuration**

Clicking the 'Param' button, this mask opens where to configure protocol, machine IP address and folder path, access credentials, file type for writing to the machine. 

![](https://kb.alleantia.com/hs-fs/hubfs/Scrittura_ENG-JPG.png?width=383&height=448&name=Scrittura_ENG-JPG.png)

#### **File Backup**

In case the reading procedure includes file deletion, the backup configuration can define a storage procedure for the old read files.

![](https://kb.alleantia.com/hs-fs/hubfs/Backup-JPG.png?width=382&height=396&name=Backup-JPG.png)

- [Industrial IoT Connectivity in 4 steps](https://kb.alleantia.com/industrial-iot-connectivity-in-4-steps#main-content)

    - [Industrial Connectivity in 5 minutes - Configuration Steps](https://kb.alleantia.com/industrial-iot-connectivity-in-4-steps#industrial-connectivity-in-5-minutes-configuration-steps)
- [Alleantia Platform Overview](https://kb.alleantia.com/alleantia-platform-overview#main-content)

    - [Alleantia Core](https://kb.alleantia.com/alleantia-platform-overview#alleantia-core)
    - [Cloud Portal](https://kb.alleantia.com/alleantia-platform-overview#cloud-portal)
    - [Machine Drivers](https://kb.alleantia.com/alleantia-platform-overview#machine-drivers)
    - [IIoT Apps - Connect Business Apps](https://kb.alleantia.com/alleantia-platform-overview#iiot-apps-connect-business-apps)
    - [Site Manager](https://kb.alleantia.com/alleantia-platform-overview#site-manager)
- [Alleantia Core](https://kb.alleantia.com/alleantia-core#main-content)

    - [Alleantia Core - Download and Configurations](https://kb.alleantia.com/alleantia-core#alleantia-core-download-and-configurations)
- [Licenses and Free Version](https://kb.alleantia.com/licenses-and-free-version#main-content)

    - [License Management](https://kb.alleantia.com/licenses-and-free-version#license-management)
    - [Alleantia Core - Free Version](https://kb.alleantia.com/licenses-and-free-version#alleantia-core-free-version)
- [Machine Drivers](https://kb.alleantia.com/machine-drivers#main-content)

    - [How can I create a driver with spreadsheet template??](https://kb.alleantia.com/machine-drivers#how-can-i-create-a-driver-with-spreadsheet-template)
    - [How can I create a driver with Driver Editor?](https://kb.alleantia.com/machine-drivers#how-can-i-create-a-driver-with-driver-editor)
    - [Private Library](https://kb.alleantia.com/machine-drivers#private-library)
    - [Machines connection configurations](https://kb.alleantia.com/machine-drivers#machines-connection-configurations)
- [Stream Data - IIoT Apps](https://kb.alleantia.com/stream-data-iiot-apps#main-content)

    - [API REST](https://kb.alleantia.com/stream-data-iiot-apps#api-rest)
    - [Modbus](https://kb.alleantia.com/stream-data-iiot-apps#modbus)
    - [OPC UA](https://kb.alleantia.com/stream-data-iiot-apps#opc-ua)
    - [AWS](https://kb.alleantia.com/stream-data-iiot-apps#aws)
    - [Boomi](https://kb.alleantia.com/stream-data-iiot-apps#boomi)
    - [Microsoft Azure](https://kb.alleantia.com/stream-data-iiot-apps#microsoft-azure)
    - [Dropbox](https://kb.alleantia.com/stream-data-iiot-apps#dropbox)
    - [MQTT](https://kb.alleantia.com/stream-data-iiot-apps#mqtt)
    - [SQL](https://kb.alleantia.com/stream-data-iiot-apps#sql)
    - [OneDrive for Business](https://kb.alleantia.com/stream-data-iiot-apps#onedrive-for-business)
    - [TeamViewer](https://kb.alleantia.com/stream-data-iiot-apps#teamviewer)
- [Alleantia Certified Hardware](https://kb.alleantia.com/alleantia-certified-hardware#main-content)

    - [Advantech](https://kb.alleantia.com/alleantia-certified-hardware#advantech)
    - [Cisco](https://kb.alleantia.com/alleantia-certified-hardware#cisco)
    - [Dell](https://kb.alleantia.com/alleantia-certified-hardware#dell)
    - [Eurotech](https://kb.alleantia.com/alleantia-certified-hardware#eurotech)
    - [Lenovo](https://kb.alleantia.com/alleantia-certified-hardware#lenovo)
    - [Portwell](https://kb.alleantia.com/alleantia-certified-hardware#portwell)
    - [Stratus](https://kb.alleantia.com/alleantia-certified-hardware#stratus)
- [Simulators and Starter Kit Industria 4.0](https://kb.alleantia.com/simulators-and-starter-kit-industria-4-0#main-content)

    - [Simulators - PLCs, CNC, Energy meters](https://kb.alleantia.com/simulators-and-starter-kit-industria-4-0#simulators-plcs-cnc-energy-meters)
    - [Starter Kit Industria 4.0](https://kb.alleantia.com/simulators-and-starter-kit-industria-4-0#starter-kit-industria-4-0)
- [Edge Operational Applications](https://kb.alleantia.com/edge-operational-applications#main-content)

    - [Cobot Smart Service](https://kb.alleantia.com/edge-operational-applications#cobot-smart-service)
- [FAQs - Trouble Shooting](https://kb.alleantia.com/faqs-trouble-shooting#main-content)

    - [Configurations](https://kb.alleantia.com/faqs-trouble-shooting#configurations)
    - [System Setup](https://kb.alleantia.com/faqs-trouble-shooting#system-setup)
    - [Interfaces to IIoT Apps](https://kb.alleantia.com/faqs-trouble-shooting#interfaces-to-iiot-apps)
    - [Interfaces to Industrial Devices](https://kb.alleantia.com/faqs-trouble-shooting#interfaces-to-industrial-devices)
- [Connectivity](https://kb.alleantia.com/connectivity)

[![Chill listening crop-3](https://kb.alleantia.com/hs-fs/hubfs/Alleantia_ATJ_transpbg_HD-1.jpg?width=120&height=55&name=Alleantia_ATJ_transpbg_HD-1.jpg "Chill listening crop-3")](http://www.alleantia.com)

© 2024 Alleantia s.r.l

<https://www.linkedin.com/company/2293482/admin/> <https://twitter.com/Alleantiasrl> <https://www.facebook.com/Alleantia>

Copyright © 2026, ALLEANTIA SRL