# Установка PiSunRPI

##### <span style="color: #000000;">Установка PiSunRPI вручную</span>

<span style="color: rgb(0, 0, 0);">Перед установкой PiSun переведите UART в режим последовательного порта. Выполните следующие шаги:</span>

1. <span style="color: rgb(0, 0, 0);">Подключитесь к Raspberry и перейдите в терминал.</span>
2. <span style="color: rgb(0, 0, 0);">Перейдите в утилиту для конфигурации Raspberry. Для этого введите команду:</span>

<span style="color: rgb(0, 0, 0);"> *$ sudo raspi-config*</span>

3. <span style="color: rgb(0, 0, 0);">Выберите пункт меню: Interface Options.</span>
4. <span style="color: rgb(0, 0, 0);">Выберите пункт меню: Serial Port.</span>

<span style="color: rgb(0, 0, 0);">Затем будет выведен запрос на доступ к shell через последовательный порт. Выберите «Нет» , как показано ниже.</span>

[![Снимок экрана 2024-11-12 170142.png](https://wiki.pidt.net/uploads/images/gallery/2024-11/scaled-1680-/snimok-ekrana-2024-11-12-170142.png)](https://wiki.pidt.net/uploads/images/gallery/2024-11/snimok-ekrana-2024-11-12-170142.png)

<span style="color: rgb(0, 0, 0);">В завершение процесса вам будет предложено включить аппаратный последовательный порт. Выберите «Да».</span>

[![Снимок экрана 2024-11-12 170206.png](https://wiki.pidt.net/uploads/images/gallery/2024-11/scaled-1680-/snimok-ekrana-2024-11-12-170206.png)](https://wiki.pidt.net/uploads/images/gallery/2024-11/snimok-ekrana-2024-11-12-170206.png)

<span style="color: rgb(0, 0, 0);">После применения настроек появится уведомление о том, что изменения успешно применены. Нажмите «ОК», а затем перезагрузите Raspberry. После этой операции плата PiHatel будет без проблем работать через UART Raspberry.</span>

<span style="color: rgb(0, 0, 0);">Для установки всех необходимых компонентов при помощи командной строки следует выполнить следующие команды:</span>

<span style="color: rgb(0, 0, 0);">*sudo apt install git python3 python3-pip python3-venv*</span>  
<span style="color: rgb(0, 0, 0);">*git clone https://gitlab.com/piall1/pisun.git*</span>  
<span style="color: rgb(0, 0, 0);">*cd pisun*</span>  
<span style="color: rgb(0, 0, 0);">*python3 -m venv venv*</span>  
<span style="color: rgb(0, 0, 0);">*venv/bin/pip3 install -r requirements.txt*</span>  
<span style="color: rgb(0, 0, 0);">*sudo bash ./scripts/install.sh*</span>

<span style="color: rgb(0, 0, 0);">В момент установки настраивается автозапуск при загрузке. Полезные команды для управления автозапуском программы:</span>

<span style="color: rgb(0, 0, 0);">*sudo systemctl status pisun.service - посмотреть статус работы программы*</span>  
<span style="color: rgb(0, 0, 0);">*sudo systemctl restart pisun.service - перезапустить программу*</span>  
<span style="color: rgb(0, 0, 0);">*sudo systemctl stop pisun.service - остановить выполнение программы*</span>  
<span style="color: rgb(0, 0, 0);">*sudo systemctl disable pisun.service - выключить автозагрузку программы*</span>  
<span style="color: rgb(0, 0, 0);">*sudo systemctl enable pisun.service - включить автозагрузку программы*</span>

<span style="color: rgb(0, 0, 0);">Для запуска программы вручную из терминала, находясь в корне репозитория, выполнить следующую команду:</span>

<span style="color: rgb(0, 0, 0);">*sudo ./venv/bin/python3 StartPiSunRPI.py*</span>

<span style="color: rgb(0, 0, 0);">Далее для входа в интерфейс управления необходимо подключиться ПК или мобильным устройством к той же сети, где находится PiSunRPI. Для этого необходимо в браузере указать IP вашей Raspberry Pi или hostname.local.</span>

##### <span style="color: #000000;">Образ PiSun RPi</span>

<span style="color: #000000;">Образ с предустановленным PiSun можно скачать по ссылке </span>[<span style="text-decoration: underline;"><span style="color: rgb(35, 111, 161);">Образ PiSun RPi</span></span>](https://t.me/pifiles/571)<span style="color: #000000;">. Протестирован на Raspberry Pi 3-4. Всё что нужно это записать образ и запустить Raspberry.</span>

<span style="color: rgb(0, 0, 0);">Для записи образа следует выполнить следующие шаги:</span>

1. <span style="color: rgb(0, 0, 0);"> Установить программу <span style="text-decoration: underline; color: rgb(35, 111, 161);">[Raspberry Pi Imager](https://www.raspberrypi.com/software/)</span>.</span>
2. <span style="color: rgb(0, 0, 0);">Выбрать устройство (необязательно).</span>
3. <span style="color: rgb(0, 0, 0);">Выбрать операционную систему.</span><span style="color: rgb(0, 0, 0);">  
    </span><span style="color: rgb(0, 0, 0);">Выбрать ОС -&gt; Использовать настраиваемый образ (Use custom) -&gt; Путь к образу (pisun.img.xz)</span>
    
    <span style="color: rgb(0, 0, 0);">  
    </span>
    
    [![Снимок экрана 2023-12-27 140111.png](https://wiki.pidt.net/uploads/images/gallery/2023-12/scaled-1680-/snimok-ekrana-2023-12-27-140111.png)](https://wiki.pidt.net/uploads/images/gallery/2023-12/snimok-ekrana-2023-12-27-140111.png)
4. <span style="color: rgb(0, 0, 0);">Выбрать запоминающее устройство.</span>
5. <span style="color: rgb(0, 0, 0); text-align: justify;">Настроить параметры.</span>

<span style="color: rgb(0, 0, 0);">После выбора ОС и флешки, нажмите кнопку "далее". В окне появится возможность перейти в настройки. Перед записью образа, следует сохранить следующие параметры:</span>

<span style="color: rgb(0, 0, 0);">В разделе общие:</span>

<span style="color: rgb(0, 0, 0);">**Имя хоста:** pihatel (имя устройства, можно любое)  
**Пароль и логин:** указать имя пользователя и пароль для входа по SSH (придумайте имя пользователя и пароль, они будут использоваться для доступа к устройству через терминал)  
**WI-FI:** указать логин и пароль для подключения к вашей сети. Устройство может быть подключено по WI-FI или по кабелю Ethernet. Страну WI-FI указывать необязательно.</span>

[![Снимок экрана 2023-12-27 135923.png](https://wiki.pidt.net/uploads/images/gallery/2023-12/scaled-1680-/snimok-ekrana-2023-12-27-135923.png)](https://wiki.pidt.net/uploads/images/gallery/2023-12/snimok-ekrana-2023-12-27-135923.png)

<span style="color: rgb(0, 0, 0);">  
</span><span style="text-decoration: underline;"><span style="color: rgb(0, 0, 0); text-decoration: underline;">В разделе службы:</span></span><span style="color: rgb(0, 0, 0);">  
</span><span style="color: rgb(0, 0, 0);">**SSH:** Аутентификация по паролю.</span><span style="color: rgb(0, 0, 0);">  
</span>

[![Снимок экрана 2023-12-27 135947.png](https://wiki.pidt.net/uploads/images/gallery/2023-12/scaled-1680-/snimok-ekrana-2023-12-27-135947.png)](https://wiki.pidt.net/uploads/images/gallery/2023-12/snimok-ekrana-2023-12-27-135947.png)

<span style="color: rgb(0, 0, 0);">Далее нажмите кнопку "Записать" и дождитесь окончания процесса, программа уведомит вас, когда флешку можно вытаскивать. </span><span style="color: rgb(0, 0, 0);">Вставьте флеш-накопитель в Raspberry Pi и подключите питание. </span>

<p class="callout info"><span style="color: rgb(0, 0, 0);">Не пугайтесь, первый запуск займет какое-то время (2-5 минут), устройство перезагрузится ещё раз и после этого можно подключаться к интерфейсу управления.  
</span></p>

<span style="color: rgb(0, 0, 0);">Находясь в одной сети с Raspberry, откройте браузер и впишите следующее HOSTNAME.local (где HOSTNAME это имя устройства, указанное в момент настройки параметров записи образа) или впишите туда IP адрес устройства (можно посмотреть в настройках роутера)</span>

<span style="color: rgb(0, 0, 0);">Ознакомиться с возможностями программы можно в статье <span style="text-decoration: underline;"><span style="color: rgb(35, 111, 161); text-decoration: underline;">["PiSun Raspberry PI"](https://wiki.pidt.net/books/pisun-otkrytyi-kod-dlya-pigopidata/page/pisun-raspberry-pi)</span></span>.</span>