Skip to content
Contact us
  • There are no suggestions because the search field is empty.

Data Connection: SFTP User Guide

Learn how to upload BESS measurement data to the TWAICE SFTP server, including file format requirements and connection details.

On this page

Overview

The TWAICE SFTP server provides a secure way to transfer large volumes of time-series battery data into the TWAICE Cloud. It is built on the AWS Transfer Family and supports CSV-based data at scale for performance, state-of-health, and safety analysis.

Data Format Requirements

To ensure smooth processing and compatibility with our systems, your data must meet the following formatting standards:

Field Requirement
File type CSV (.csv) or GZIP (.gz)
Table format Long format only
Delimiter Semicolon (;)
Header timestamp;metric;value
Timestamp ISO 8601 UTC format. Example: 2022-03-07T13:00:00.000Z
Metric A human-readable, unique identifier, defined during your onboarding setup.
Value Floating-point number, using a dot (.) as the decimal separator. Example: 4000.20

 

Note: Keep the file size below 200MB to ensure fast data processing. To reduce file size, compress CSV files with GZIP before transferring.

Uploading Files to the SFTP Server

You can upload your data using standard SFTP clients (like FileZilla) or programmatically via scripting tools (such as Python, Bash, or PowerShell).

Connection Details

Field Value
SFTP Host sftp-v2.twaice.cloud
Port 2222 or 443
Username Your registered email address
Password Set by you during onboarding, after receiving an invitation to the TWAICE platform

 

Once connected, you’ll have access to your dedicated directory on the TWAICE server. From there, drag and drop files directly, or upload them via script.

Email address (username) constraints:

  • Email must be a minimum of 3 and a maximum of 100 characters.

  • Allowed characters: a-z, A-Z, 0-9, underscore (_), hyphen (-), period (.), and at sign (@).

  • Cannot start with a hyphen (-), period (.), or at sign (@).

File Structure Example

Sample data:

timestamp;metric;value
2025-01-01T01:07:43.000Z;string:01:voltage;225.3
2025-01-01T01:07:43.000Z;string:02:voltage;225.4
2025-01-01T01:07:43.000Z;string:03:voltage;225.9
2025-01-01T01:07:43.000Z;string:01:current;0.0
2025-01-01T01:07:43.000Z;string:02:current;0.0
2025-01-01T01:07:43.000Z;string:03:current;0.0
2025-01-01T01:07:45.000Z;string:01:voltage;225.3
2025-01-01T01:07:45.000Z;string:02:voltage;225.4
2025-01-01T01:07:45.000Z;string:03:voltage;225.9

 

Make sure all rows follow the same structure and format, and double-check timestamps and metric identifiers for accuracy.

Need Help?

Contact your TWAICE representative or email support@twaice.com.