Проект Pi4J призван обеспечить мост между оборудованием Raspberry Pi и Java с объектно-ориентированным подходом. Pi4J — проект с открытым исходным кодом, разработанный профессиональными инженерами-программистами. В дополнение к базовым функциональным возможностям доступа к аппаратным средствам, этот проект также пытается предоставить набор расширенных функций, которые делают работу с Raspberry Pi простой в использовании и более удобной для Java-разработчиков.
Предпосылки
Java Runtime (JRE/JDK)
Если вы используете недавнюю сборку Raspbian, то Oracle JDK предварительно установлена. А если нет — тогда можно установить OpenJDK с помощью apt-get:
sudo apt-get update sudo apt-get install default-jdk
WiringPi библиотека
Pi4J зависит от библиотеки WiringPi от Гордона Хендерсона. Установить её можно следующим способом:
- Обновите индекс пакетов apt-get:
sudo apt-get update
- Установите GIT:
sudo apt-get install git-core
- Клонируйте WiringPi:
cd git clone git://git.drogon.net/wiringPi
- Установите WiringPi:
cd ~/wiringPi ./build
Для Orange Pi и Banana Pi есть отдельные статьи: Установка и настройка WiringOP/WiringPi на Orange Pi PC и Установка и настройка BPI-WiringPi/WiringPi на Banana Pi соответственно.
Установка Pi4J
Легкая / предпочтительная установка (онлайн)
(ПРИМЕЧАНИЕ. Этот способ установки требует, чтобы ваш Raspberry Pi/Orange Pi/Banana Pi был подключен к Интернету.)
Самый простой способ установить Pi4J на Raspberry Pi — выполнить следующую команду непосредственно на вашем Raspberry Pi.
curl -s get.pi4j.com | sudo bash
Этот метод будет скачать и запустить установочный скрипт, который выполнить следующие действия:
- добавляет репозиторий Pi4J APT в локальные репозитории APT;
- загружает и устанавливает открытый ключ Pi4J GPG для проверки подписи;
- вызывает команду «apt-get update» в репозитории Pt4J APT для обновления базы локальных пакетов;
- вызывает команду «apt-get install pi4j» для выполнения загрузки и установки.
Автономная / ручная установка (офлайн)
Если вам необходимо установить Pi4J на устройство RaspberryPi без подключения к Интернету, следующая инструкция обеспечивает необходимые шаги для установки Pi4J без необходимости подключения к Интернету.
Сначала загрузите копию последнего файла пакета установщика Pi4J Debian / Raspian (.deb) на ваш локальный компьютер. Вы можете загрузить пакет установки Pi4J Debian / Raspian (.deb), используя ваш веб-браузер по следующему URL-адресу:
http://get.pi4j.com/download/pi4j-1.1.deb
Затем вам нужно будет перенести пакет установщика на ваш Raspberry Pi. Вы можете использовать любой способ, который вы предпочитаете, чтобы скопировать файл на ваш Raspberry Pi (USB, SCP, FTP и т. д.).
(ПРИМЕЧАНИЕ. Если у вас установлена предыдущая версия Pi4J, вам сначала нужно её удалить.)
После того, как пакет установки будет доступен на вашем Raspberry Pi, используйте следующую команду на Pi для выполнения установки:
sudo dpkg -i pi4j-1.1.deb
(ПРИМЕЧАНИЕ. Если у вас плата Orange Pi, тогда лучше установить версию 1.2-SNAPSHOT, скачать можно по ссылке: http://get.pi4j.com/download/pi4j-1.2-SNAPSHOT.deb)
sudo dpkg -i pi4j-1.2-SNAPSHOT.deb
Обновление Pi4J (upgrade)
Легкая / предпочтительная установка (онлайн)
Если вы первоначально установили Pi4J с использованием «онлайн» метода, то обновления Pi4J будут доступны в любое время, когда вы будете выполнять системное обновление с помощью sudo apt-get update и sudo update-get upgrade.
Если вы хотите принудительно обновить пакет Pi4J, вы можете сделать это, выполнив следующую команду:
sudo apt-get install pi4j
или
pi4j --update
Автономная / ручная установка
Если вы первоначально установили Pi4J с использованием метода «офлайн», вам необходимо вручную удалить пакет Pi4J и загрузить, перенести и установить пакет новой версии, используя методы удаления и установки «офлайн», описанные здесь на этой странице.
Удаление Pi4J
Легкая / предпочтительная установка (онлайн)
Если вы первоначально установили Pi4J с использованием метода «онлайн», вы можете удалить Pi4J, выполнив следующую команду на вашем Raspberry Pi.
sudo apt-get remove pi4j
или
pi4j --uninstall
Полное удаление
Если вы первоначально установили Pi4J, используя метод «онлайн», и вы хотите удалить все следы Pi4J, включая репозиторий Pi4J в списке репозиториев APT и подпись GPG Pi4J, просто выполните следующую команду на вашем Raspberry Pi.
curl -s get.pi4j.com/uninstall | sudo bash
Автономная / ручная установка (офлайн)
Если вы первоначально установили Pi4J с использованием метода «офлайн», вам необходимо вручную удалить пакет Pi4J, выполнив следующую команду на вашем Raspberry Pi:
sudo dpkg -r pi4j
Место установки / Примеры
Все .jar файлы и примеры программ находятся в следующие папки соответственно:
/opt/pi4j/lib /opt/pi4j/examples
При попытке скомпилировать Java-программу с использованием библиотек Pi4J обязательно включите папку Pi4J lib в classpath:
javac -classpath .:classes:/opt/pi4j/lib/'*' ...
При попытке запустить Java-программу с использованием библиотек Pi4J обязательно включите папку Pi4J lib в classpath:
sudo java -classpath .:classes:/opt/pi4j/lib/'*' ...
Если вы хотите изучить примеры, вы можете скомпилировать все примеры со следующими командами:
cd /opt/pi4j/examples ./build
