Утилита RasPY
Добро пожаловать в документацию RasPY Utility
RasPY Utility — это комплексное приложение для управления и мониторинга контактов GPIO Raspberry Pi через интуитивно понятный графический интерфейс или REST API.
Содержание
Введение
Разработка
Дополнительные материалы
Сообщество
Ключевые возможности
✅ Современный графический интерфейс
- Темная/светлая тема
- Поддержка нескольких языков
- Визуализация состояния контактов в реальном времени
- Интеграция с системным треем
🔌 Полная поддержка GPIO
- Управление цифровыми входами/выходами
- Встроенный симулятор для разработки
- Автоматическое определение оборудования
- Поддержка удаленного GPIO
🌐 Веб-интерфейс
- Встроенный веб-сервер
- Адаптивный дизайн для мобильных устройств и компьютеров
- Обновления в реальном времени
- Интегрированная документация по API
Быстрый старт
- Установка - как установить и настроить RasPY Utility
- Руководство - руководство по использованию приложения
- API - документация по API для разработчиков
- Разработка - руководство по разработке и внесению вклада
Руководство пользователя
Графический интерфейс
Графический интерфейс RasPY Utility разработан для интуитивно понятного и простого использования.
Главное меню
- Файл: основные элементы управления приложением
- GPIO: управление контактами и симулятором
- Вид: настройка интерфейса
- Справка: документация и информация
Управление GPIO
- Откройте окно управления GPIO из меню
- Выберите контакт для управления
- Используйте кнопки для переключения состояний
- Наблюдайте за статусом в реальном времени
Симулятор GPIO
Симулятор позволяет тестировать код без физического оборудования:
- Запустите симулятор из меню GPIO
- Используйте интерфейс для моделирования ввода/вывода
- Изменения отображаются в реальном времени
Логирование и отладка
Приложение сохраняет важные события в файл logs/app.log
. Используйте встроенный просмотрщик логов для:
- Фильтрации сообщений по уровню (INFO, WARNING, ERROR)
- Поиска конкретных сообщений
- Экспорта логов для анализа
Горячие клавиши
- Ctrl+Q: Выход из приложения
- F1: Показать справку
- Ctrl+L: Открыть просмотрщик логов
- F5: Обновить интерфейс
Справочник API
Обзор
REST API RasPY Utility позволяет управлять контактами GPIO через HTTP-запросы.
Все ответы возвращаются в формате JSON.
Доступные эндпоинты
GET /api/gpio
Возвращает статус всех настроенных контактов GPIO.
Пример ответа:
{
"17": {"state": 0, "mode": "out", "description": "Красный светодиод"},
"18": {"state": 1, "mode": "in", "description": "Кнопка"}
}
GET /api/gpio/<int:pin>
Возвращает статус указанного контакта.
Параметры:
Коды статуса:
- 200: Успешное выполнение
- 404: Контакт не найден
Пример ответа:
{
"state": 0,
"mode": "out",
"description": "Красный светодиод"
}
POST /api/gpio/<int:pin>/on
Включает указанный контакт.
Параметры:
Коды статуса:
- 200: Успешное выполнение
- 400: Недопустимый или недоступный для записи контакт
POST /api/gpio/<int:pin>/off
Выключает указанный контакт.
Параметры:
Коды статуса:
- 200: Успешное выполнение
- 400: Недопустимый или недоступный для записи контакт
Примеры использования
Управление GPIO с помощью Python
import requests
BASE_URL = "http://localhost:5000/api/gpio"
# Получить статус всех контактов
response = requests.get(f"{BASE_URL}")
print("Текущий статус:", response.json())
# Включить контакт 17
response = requests.post(f"{BASE_URL}/17/on")
print("Ответ при включении:", response.status_code)
Полезные ресурсы