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 ( |
Table format | Long format only |
Delimiter | Semicolon ( |
Header |
|
Timestamp | ISO 8601 UTC format. Example: |
Metric | A human-readable, unique identifier, defined during your onboarding setup. |
Value | Floating-point number, using a dot ( |
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 |
|
Port |
|
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.