You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: en/services/ftp.md
+10-10Lines changed: 10 additions & 10 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -508,21 +508,21 @@ The sequence of operations is:
508
508
509
509
The GSC should create a timeout after the `RemoveDirectory` command is sent and resend the message as needed (and [described above](#timeouts)).
510
510
511
-
## Virtual Drives (Directory Alias)
511
+
## Virtual Directory Entries (Directory Alias)
512
512
513
-
MAVFTP supports the concept of "standard" virtual drives for storing particular types of data in a flight-stack-independent and file-system-independent location.
513
+
MAVFTP supports the concept of "standard" virtual directories for storing particular types of data in a flight-stack-independent and file-system-independent location.
514
514
This allows a GCS to provision or fetch data without having to know how or where it is stored in the target component.
515
515
516
516
::: info
517
517
MAVFTP represents storage on a remote component as a single entity accessible via a directory structure that the protocol exposes.
518
518
In order to represent multiple physical drives supported by the component, such as "c" or "d" drives, these can be abstracted to this structure.
519
-
Similarly, in order to support virtual drives, components must abstract the syntax that indicates the drive, and map it to their physical file system(s).
519
+
Similarly, in order to support virtual directories, components must abstract the syntax that indicates their location, and map it to their physical file system(s).
520
520
:::
521
521
522
-
In the [MAVLink FTP URL Scheme](#mavlink-ftp-url-scheme) a virtual drive is specified using the `@<drive>` prefix, such as `@MAV_LOG` for log files.
522
+
In the [MAVLink FTP URL Scheme](#mavlink-ftp-url-scheme) a virtual directory is specified using the `@<directory>` prefix, such as `@MAV_LOG` for log files.
523
523
When encoded in the [FILE_TRANSFER_PROTOCOL](#FILE_TRANSFER_PROTOCOL) this prefix should be prepended when a path is being specified.
524
524
For example, when [Listing a directory](#list_directory) the request might encode `data[0]` as `@MAV_LOG/path_in_log/`, and the recipient would be expected to map this to the underlying file system.
525
-
If the full path including drive is not known, the recipient would NAK with [FileNotFound](#error_codes) (this is just another "not found" error case).
525
+
If the full path including virtual directory is not known, the recipient would NAK with [FileNotFound](#error_codes) (this is just another "not found" error case).
526
526
527
527
The following standard directory locations are defined:
528
528
@@ -559,17 +559,17 @@ The CRC32 algorithm used by MAVLink FTP is described in [MAVLink CRCs](../guide/
559
559
Resources to be downloaded using MAVLink FTP can be referenced using the following URL-like format:
560
560
561
561
```txt
562
-
mftp://[;comp=<id>][/@<drive>]/<path>
562
+
mftp://[;comp=<id>][/@<directory>]/<path>
563
563
```
564
564
565
565
Where:
566
566
567
-
-`path`: the location of the resource on the target component andvirtual drive.
567
+
-`path`: the location of the resource on the target component and/or in the virtual directory.
568
568
-`id`: target _component ID_ of the component hosting the resource.
569
569
The `;comp=<id>` part is optional (if omitted, the resource is downloaded from the current component).
570
570
It should be specified if the request must be redirected
571
-
-`drive`: A [virtual drive](#virtual-drives-directory-alias) on the target source.
572
-
The `@<drive>` part is optional (if omitted, the resource is downloaded from the "normal" drive).
571
+
-`directory`: A [virtual directory](#virtual-directory-entries-directory-alias) on the target source.
572
+
The `@<directory>` part is optional (if omitted, the resource is downloaded from the "normal" directory path).
573
573
574
574
For example:
575
575
@@ -590,6 +590,6 @@ For example:
590
590
- A GCS wanting to download a log might use
591
591
592
592
```txt
593
-
## FTP resource '2024.log' from @MAV_LOG virtual drive
593
+
## FTP resource '2024.log' from @MAV_LOG virtual directory
0 commit comments