Варианты подключения

К Repka Pi можно подключаться как напрямую, через монитор и периферию, так и удаленно по сети. Для первичной настройки удобнее использовать прямое подключение, а для повседневной работы и администрирования чаще подходят SSH, VNC или отладочная консоль по Debug-UART.

Основное подключение - монитор, мышь и клавиатура #

Это самый простой и наглядный способ первого запуска.

• Подключите монитор по HDMI Repka Pi (3 / 4 / 5) или DSI (только в Repka Pi 5).
• Подключите мышь и клавиатуру в USB-порты Repka Pi (3 / 4 / 5).
• При необходимости подключите плату к локальной сети через Ethernet порт Repka Pi (3 / 4 / 5) патч-кордом.

Такой вариант рекомендуется для первого включения, когда нужно:

• убедиться, что система загрузилась корректно;
• пройти первичную настройку;
• настроить сеть;
• узнать IP-адрес устройства для дальнейшего удаленного доступа.

Если вы только начинаете работу с платой, лучше сначала выполнить именно это подключение, а уже затем переходить к удаленному управлению.

Как узнать IP-адрес устройства #

Чтобы подключиться к Repka Pi по SSH или VNC, нужно узнать IP-адрес устройства в локальной сети.

Сделать это можно несколькими способами.

Через графический интерфейс #

Если к плате подключены монитор, мышь и клавиатура, IP-адрес обычно проще всего посмотреть в параметрах сети:

• откройте настройки сети;

• выберите активное подключение Ethernet или Wi-Fi;

• найдите строку с IPv4-адресом.

  

Через терминал на самой Repka Pi #

Если у вас уже открыт терминал на устройстве, можно выполнить одну из команд:

ip -4 a

или:

ip a

или чуть менее подробно:

Команда ip -4 a выводит IPv4-адреса устройства. Пример вывода:

1: lo: <LOOPBACK,UP,LOWER_UP> mtu 65536 qdisc noqueue state UNKNOWN group default qlen 1000
    inet 127.0.0.1/8 scope host lo
       valid_lft forever preferred_lft forever
6: wlx60e3270f2a24: <BROADCAST,MULTICAST,UP,LOWER_UP> mtu 1500 qdisc mq state UP group default qlen 1000
    inet 10.64.11.76/23 brd 10.64.11.255 scope global dynamic noprefixroute wlx60e3270f2a24
       valid_lft 2546sec preferred_lft 2546sec

Команда ip a показывает подробную информацию по всем сетевым интерфейсам. Пример вывода:

1: lo: <LOOPBACK,UP,LOWER_UP> mtu 65536 qdisc noqueue state UNKNOWN group default qlen 1000
    link/loopback 00:00:00:00:00:00 brd 00:00:00:00:00:00
    inet 127.0.0.1/8 scope host lo
       valid_lft forever preferred_lft forever
    inet6 ::1/128 scope host 
       valid_lft forever preferred_lft forever
2: eth0: <NO-CARRIER,BROADCAST,MULTICAST,UP> mtu 1500 qdisc mq state DOWN group default qlen 1000
    link/ether 02:01:b8:70:43:aa brd ff:ff:ff:ff:ff:ff
5: wlan0: <NO-CARRIER,BROADCAST,MULTICAST,UP,LOWER_UP> mtu 1500 qdisc fq_codel state DORMANT group default qlen 1000
    link/ether 08:fb:ea:88:f1:a0 brd ff:ff:ff:ff:ff:ff
6: wlx60e3270f2a24: <BROADCAST,MULTICAST,UP,LOWER_UP> mtu 1500 qdisc mq state UP group default qlen 1000
    link/ether 60:e3:27:0f:2a:24 brd ff:ff:ff:ff:ff:ff
    inet 10.64.11.76/23 brd 10.64.11.255 scope global dynamic noprefixroute wlx60e3270f2a24
       valid_lft 2155sec preferred_lft 2155sec
    inet6 fe80::9668:9319:da9f:12f/64 scope link noprefixroute 
       valid_lft forever preferred_lft forever

Из примера искомый адрес - 10.64.11.76 у вас он будет другой.

127.0.0.1 - внутренний loopback-интерфейс (localhost) он всегда один и тот же.

После того как IP-адрес найден, его можно использовать для подключения по SSH или VNC.

Удаленное подключение #

Удаленное подключение удобно, если Repka Pi работает без постоянно подключенного монитора, клавиатуры и мыши. Обычно для этого используется сеть по Ethernet или Wi-Fi. Для отдельных сценариев можно также настроить сетевой доступ через OTG.

VNC #

VNC позволяет подключиться к графическому рабочему столу Repka Pi с другого компьютера. Это полезно, когда:

• требуется работа с графическим интерфейсом;
• нужно удаленно помогать пользователю;
• плата установлена в корпусе или в труднодоступном месте.

Нужно учитывать, что VNC требовательнее к качеству сети, чем SSH. Если соединение нестабильно, для администрирования и настройки надежнее использовать SSH.

Перед использованием VNC нужно:

1. Подключить Repka Pi к сети по Ethernet или Wi-Fi.
2. Узнать IP-адрес платы (клик).

Установка #

sudo apt install x11vnc

Запуск VNC #

После установки задайте пароль для VNC:

x11vnc -storepasswd

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

root@Repka-Pi:~# x11vnc -storepasswd
Enter VNC password: 
Verify password:    
Write password to /root/.vnc/passwd?  [y]/n y
Password written to: /root/.vnc/passwd

Команда x11vnc -storepasswd только сохраняет пароль и не пытается подключаться к графической сессии.

После этого можно отдельно запустить сам VNC-сервер:

x11vnc -display :0 -auth guess -forever -usepw

Здесь:

• -display :0 - подключение к основному графическому экрану системы;
• -auth guess - попытка автоматически найти файл авторизации X-сессии;
• -forever - сервер не завершится после отключения первого клиента;
• -usepw - использовать ранее сохраненный VNC-пароль.

Если монитор планируется использовать вместе с VNC, надежнее подключать его до загрузки графической оболочки.

Подключение с Linux #

На компьютере с Linux в качестве клиента удобно использовать gnome-connections:

sudo apt install gnome-connections

Запустите gnome-connections. Дальше порядок такой:

1. Нажмите + для создания нового подключения.
2. Введите адрес Repka Pi. В некоторых клиентах достаточно IP_ADDRESS, в некоторых можно указать root@IP_ADDRESS.
3. В качестве типа подключения выберите VNC.
4. Нажмите Connect.

Далее пройдите аутентификацию:

1. Введите пароль, который был сохранен командой x11vnc -storepasswd.
2. Нажмите Authenticate.

Если соединение установилось успешно, откроется удаленный рабочий стол Repka Pi.

Подключение с Windows #

На Windows можно использовать любой VNC-клиент. Один из распространенных вариантов - TightVNC.

Порядок подключения:

1. Установите VNC-клиент на компьютер с Windows.

2. Запустите программу.

3. В поле Remote Host укажите IP-адрес Repka Pi.

4. При необходимости явно укажите порт 5900, например IP_ADDRESS:5900 - формат зависит от клиента.

5. Нажмите Connect.

   

6. Введите пароль, который был задан на Repka Pi.

   

Порт 5900 обычно используется VNC по умолчанию.

Автозапуск VNC сервера как приложения #

После установки VNC сервера нам необходимо зайти в настройки операционной системы Repka OS и выбрать опцию “Сеансы и запуск”. Здесь при помощи нескольких простых шагов мы зададим конфигурацию сервера.

По результатам этой операции мы увидим окно, в котором необходимо нажать на кнопку “Добавить”.

После нажатия на эту кнопку появится всплывающее окно “Добавить приложение”, которое позволит нам ввести необходимые параметры конфигурации VNC сервера.

Заполняем форму. “Имя” и “Описание” могут быть любыми - главное, чтобы по этим полям мы могли понять, что данная запись отвечает за VNC сервер. А вот содержимое поля “Команда” определяется достаточно жестко:

x11vnc -usepw -display :0 -q -forever

Будьте внимательны: пропущенный пробел, лишний пробел, пропущенное двоеточие приведут к тому, что подключение будет отклонено. Правильный вид команды в окне подключений приведен ниже. Одна из частых ошибок - пропущенный пробел после слова display.

После ввода данных и тщательной их проверки необходимо нажать на Ок, чтобы сохранить созданную конфигурацию, перезапустить компьютер Repka Pi, чтобы эту конфигурацию применить.

Более надежный вариант для headless-сценариев - настроить запуск VNC как службы systemd. Тогда сервер будет подниматься автоматически после загрузки системы, и к Repka Pi можно будет подключаться без ручного запуска x11vnc.

Автозапуск VNC сервера в качестве службы #

Чтобы x11vnc запускался автоматически как служба, сначала создайте отдельный файл пароля для службы:

sudo x11vnc -storepasswd /etc/x11vnc.pass

После этого создайте unit-файл systemd:

sudo nano /etc/systemd/system/x11vnc.service

Добавьте в него:

[Unit]
Description=Repka VNC Service
# Запускать службу только вместе с графическим менеджером входа
Requires=display-manager.service
# Стартовать x11vnc после запуска графической подсистемы
After=display-manager.service

[Service]
Type=simple
# Подключиться к дисплею :0 и использовать отдельный файл пароля службы
ExecStart=/usr/bin/x11vnc -xkb -noxrecord -noxfixes -noxdamage -auth guess -rfbauth /etc/x11vnc.pass -display :0 -q -forever
# Перезапускать службу, если x11vnc завершился с ошибкой
Restart=on-failure
# Пауза 2 секунды перед повторным запуском
RestartSec=2

[Install]
# Запускать службу при обычной многопользовательской загрузке системы
WantedBy=multi-user.target

Сохраните файл, затем выполните:

sudo systemctl daemon-reload
sudo systemctl enable x11vnc.service
sudo systemctl start x11vnc.service

Проверить, что служба запустилась, можно командой:

sudo systemctl status x11vnc.service

Если служба работает корректно, после следующей перезагрузки x11vnc будет запускаться автоматически.

SSH #

SSH - это основной способ удаленного администрирования Repka Pi из терминала. Он полезен, когда:

• нужен доступ к командной строке без монитора и клавиатуры;
• нужно настраивать систему, редактировать файлы и запускать команды;
• требуется передавать файлы или управлять платой удаленно.

Перед использованием SSH нужно:

1. Подключить Repka Pi к сети по Ethernet или Wi-Fi.
2. Узнать IP-адрес платы (клик).

Запуск SSH #

На Repka Pi SSH обычно работает как системная служба ssh. Проверить её состояние можно командой:

sudo systemctl status ssh

Если служба не запущена, выполните:

sudo systemctl start ssh

Подключение с Linux #

На компьютере с Linux SSH-клиент обычно уже установлен. Для подключения достаточно открыть терминал и выполнить:

ssh root@IP_ADDRESS

Здесь:

• ssh - клиентская программа для удаленного входа;
• root - имя пользователя на Repka Pi;
• IP_ADDRESS - IP-адрес платы в локальной сети.

При первом подключении система может спросить подтверждение ключа хоста:

Are you sure you want to continue connecting (yes/no/[fingerprint])?

Нужно ввести:

yes

После этого потребуется ввести пароль пользователя. При вводе в терминале символы не отображаются - это нормально.

Если соединение установилось успешно, откроется командная строка Repka Pi.

Подключение с Windows #

На Windows можно использовать встроенный OpenSSH-клиент в PowerShell или командной строке:

ssh root@IP_ADDRESS

Здесь:

• ssh - клиентская программа для удаленного входа;
• root - имя пользователя на Repka Pi;
• IP_ADDRESS - IP-адрес платы в локальной сети.

Если удобнее использовать графический клиент, можно подключаться через PuTTY.

Порядок подключения в PuTTY:

1. В поле Host Name (or IP address) введите IP-адрес платы.

2. Убедитесь, что выбран тип подключения SSH.

3. Нажмите Open.

   

4. При первом подключении подтвердите ключ сервера.

   

5. Введите имя пользователя и пароль.

Если соединение установилось успешно, откроется терминальная сессия Repka Pi.

Запуск SSH после загрузки системы #

Если служба ssh включена через systemctl enable ssh, она будет запускаться автоматически после каждой загрузки.

Проверить это можно командой:

sudo systemctl is-enabled ssh

Если в ответ выводится enabled, автозапуск настроен.

Если disabled, то чтобы SSH запускался автоматически после загрузки системы:

sudo systemctl enable ssh

Отладочный порт Debug-UART #

Для начала работы нам потребуется программа PuTTY и USB to TTL конвертер с кабелем.

Скачиваем и устанавливаем программу PuTTY с официального сайта.

USB to TTL конвертер популярны на двух чипах CH340G и PL2303HX

Так же имеется конвертеры уже с проводами и в корпусе на чипе PL2303HX, рекомендуем брать именно такой вариант.

Код рейт 115200

Debug-UART нужен для низкоуровневой диагностики, когда графический вывод еще недоступен или сетевое подключение не настроено. Через этот порт можно увидеть:

• сообщения загрузчиков SPL и U-Boot;
• сообщения ядра Linux при старте;
• текстовую консоль системы.

Отладочный вывод связан с UART0 (ttyS0). В Repka OS можно управлять выводом сообщений на этот порт через repka-config.

Для подключения на Repka Pi 3 и 4 используются линии UART на 40-pin разъеме:

• UART0_TX - пин 8;
• UART0_RX - пин 10;
• GND - любой общий пин земли.

Для Repka Pi 5 отдельный от 40 pin разъем как на Raspberry.

При работе с Debug-UART:

1. Подключите USB-UART адаптер к пинам TX, RX и GND.
2. Откройте терминальную программу на компьютере.
3. Включите или перезагрузите Repka Pi и наблюдайте за сообщениями загрузки.

Используйте USB-UART адаптер с TTL-уровнями 3.3 В. Подключать к этим пинам классический RS-232 напрямую нельзя.

Debug-UART особенно полезен, если:

• на экране нет изображения;
• SSH недоступен;
• нужно понять, на каком этапе останавливается загрузка;
• требуется отладка раннего старта системы.

Если этот UART нужен не для отладки, а для пользовательского оборудования, вывод отладочных сообщений в него следует отключить, чтобы системные сообщения не смешивались с данными вашего устройства.