Общая информация

Для установки приложения на робота требуется загрузить файлы собранного приложения в определённые директории на роботе.

Загружать файлы на робота можно двумя способами:

• вручную – с помощью USB-накопителя (этот способ описан по ссылке: Запуск приложения на роботе);
• через SFTP-протокол (способ описан в этой статье).

Для подключения к SFTP-серверу требуется созданный пользователь upload.

Установка и настройка SFTP-сервера на роботе, а также создание пользователя upload выполняется техническим специалистом Promobot.

Подключение к роботу по SFTP

Поскольку передача файлов выполняется через SFTP-сервер, для подключения также требуется SFTP-клиент.

В некоторых версиях ОС linux есть предустановленный SFTP-клиент, помимо этого, можно использовать сторонние клиенты (например, FileZilla, PuTTY, WinSCP и др.).

Пример подключения по SFTP-протоколу в Ubuntu:

1. Откройте терминал и запустите подключение через SFTP-клиент.

Для этого в терминале надо ввести:

sftp <user>@<host>
Пример: sftp upload@192.168.0.2:9044
В поле <user> надо указать пользователя upload, а в поле <host> – IP-адрес робота в сети и порт 9044.

2. При первом подключении возникнет оповещение о добавлении сервера в список известных хостов. Для подтверждения введите yes.

3. Введите пароль от пользователя upload.

Пароль предоставляется техническим специалистом компании Promobot.

Загрузка файлов на робота

После подключения появится возможность передачи файлов через SFTP-протокол. Загруженные файлы сразу же синхронизируются с корневыми директориями в хранилище робота.

Приложения хранятся на роботе в двух директориях:

• /opt/promobot/plugin/ – Promobot GUI приложения, плагины для запуска JS приложений (so-файлы).
• /var/www/ – JS приложения.

Таким образом, для загрузки Promobot GUI (C++) приложения, собранные файлы приложения достаточно переместить в директорию /opt/promobot/plugin/. Для загрузки приложения, разработанного под JS API, плагин приложения должен быть помещён в /opt/promobot/plugin/, а само приложение в директорию /var/www/.

Передача файлов осуществляется командой:

put -r <dir_name>
Пример: put -r exampleApp
dir_name – директория, в которой располагаются передаваемые файлы.

Pagetitle
Uploading files to the robot via SFTP-protocol Uploading files to the robot via SFTP-protocol

General Information

To install an application on a robot, you need to upload the files of the builded application to certain directories on the robot.

You can upload the files on the robot in two ways:

• manually – using USB-drive (this method is described by the link: How to run an application on a robot);
• via SFTP-protocol (this method is described in this article).

You need to have user named uploadon robot to connect to SFTP-server.

Installation and configuration of the SFTP-server on the robot, as well as the creation of the upload user is performed by a Promobot technical specialist.

Connecting to a robot via SFTP

Since file transfer is done via an SFTP-server, an SFTP-client is required as well.

Some versions of linux OS have a pre-installed SFTP-client, and of course you can use third-party SFTP-clients (e.g, FileZilla, PuTTY, WinSCP etc.).

An example of an SFTP-connection in Ubuntu:

1. Open a terminal and start a connection via an SFTP-client.

To do this, enter this command in the terminal:

sftp <user>@<host>
Example: sftp upload@192.168.0.2:9044
You should fill in the <user> field with upload value, and <host> field – with IP-address of robot in the network and port 9044.

2. When you connect for the first time, you will receive a notification that the server has been added to the list of known hosts. To confirm, type Yes.

3. Enter upload user password.

The password is provided by the Promobot technical specialist.

Uploading files to the robot

After connecting, it will be possible to transfer files via the SFTP-protocol. The downloaded files are immediately synchronized with the root directories in the robot storage.

Applications are stored in two directories:

• /opt/promobot/plugin/ – Promobot GUI applications, plugins for launching JS-applications (so-files).
• /var/www/ – JS-applications.

So, to upload a Promobot GUI application you need to place so-file into /opt/promobot/plugin/ directory. To upload JS API application you need to place so-file into /opt/promobot/plugin/ directory and place application files into /var/www/ directory.

Use this terminal command to transfer files:

put -r <dir_name>
Example: put -r exampleApp
dir_name – the directory where the transferred files are located.