🌱 JXCT 7-в-1 Датчик Почвы

🌱 JXCT 7-в-1 Датчик Почвы

Профессиональная IoT система мониторинга почвы с веб-интерфейсом

📊 7 параметров 🔬 Научная компенсация 🌐 Веб-интерфейс 🔧 ESP32 + PlatformIO

---

📋 Содержание

• 🚀 Быстрый старт
• 📚 Полная документация
• 🌟 Основные возможности
• 🔬 Научные принципы
• 🌐 Веб-интерфейс
• 📊 Текущий статус
• 🔗 Полезные ссылки

---

🚀 Быстрый старт

⚡ Установка за 5 минут

1. Клонируйте репозиторий:
   git clone https://github.com/Gfermoto/soil-sensor-7in1.git
2. Откройте в PlatformIO:
   cd soil-sensor-7in1 && pio run
3. Загрузите на ESP32:
   pio run –target upload
4. Подключитесь к WiFi:
   Сеть: JXCT_Setup → http://192.168.4.1

📋 Требования к оборудованию

• ESP32 (рекомендуется ESP32-WROOM-32)
• JXCT 7-в-1 датчик почвы
• USB кабель для программирования
• PlatformIO IDE или Arduino IDE

---

📚 Полная документация

🔧 Техническая документация

📖 Руководства пользователя

• 📋 Руководство пользователя - Полное руководство по использованию
• 🔧 Техническая документация - Архитектура и API
• 📊 API документация - REST API и интеграции

🌱 Агрономические рекомендации

• 🌿 Агрономические рекомендации - Рекомендации по культурам
• 🔬 Руководство по компенсации - Научные модели и калибровка

💻 Разработка и код

📚 Документация кода

• 📖 Doxygen документация - Полная документация C++ кода
• 🏗️ Классы и интерфейсы - Архитектура классов
• 📁 Исходные файлы - Структура проекта

🔧 Разработка

• 🏗️ Архитектура системы - Общая архитектура
• 📋 План рефакторинга - Дорожная карта развития
• 📊 Технический долг - Отчет о качестве кода

📋 Примеры и конфигурация

📄 Примеры файлов

• 📊 Пример калибровки - CSV файл калибровочной таблицы
• ⚙️ Тестовая конфигурация - Безопасные настройки для тестов

🤝 Участие в разработке

• 📝 Руководство по участию - Как внести свой вклад

---

🌟 Основные возможности

🌡️ 7 параметров в одном датчике

• Температура: 0-50°C, ±0.5°C
• Влажность: 0-100%, ±3%
• EC: 0-5000 µS/cm, ±5%
• pH: 3-9 pH, ±0.3 pH
• Азот (N): 0-2000 мг/кг, ±10%
• Фосфор (P): 0-1000 мг/кг, ±10%
• Калий (K): 0-2000 мг/кг, ±10%

🔬 Научная компенсация

• Модель Арчи (1942): Компенсация EC
• Уравнение Нернста: Температурная поправка pH
• FAO 56 + Eur. J. Soil Sci.: NPK компенсация
• CSV калибровка: Лабораторная поверка

🌐 Веб-интерфейс

• Адаптивный дизайн: Для всех устройств
• Цветовая индикация: Статус измерений
• OTA обновления: По воздуху
• Экспорт CSV: Данные для анализа

🔧 Технические особенности

• ESP32: Мощный микроконтроллер
• Modbus RTU: Надежная связь
• MQTT: IoT интеграция
• ThingSpeak: Облачное хранение

---

🔬 Научные принципы

📊 Двухэтапная система компенсации

Наша система использует научно обоснованные методы для обеспечения точности измерений:

1️⃣ CSV калибровочная таблица (лабораторная поверка)

# Пример калибровочной таблицы
# Формат: сырое_значение,коэффициент_коррекции
 
# Электропроводность (µS/cm)
0,1.000
500,0.98
1000,0.95
1500,0.93
2000,0.91
 
# pH
3.0,1.000
4.0,1.000
5.0,1.000
6.0,1.000
7.0,1.000
8.0,1.000
9.0,1.000

2️⃣ Математическая компенсация (научные модели)

• EC: Модель Арчи с коэффициентами по типам почв
• pH: Уравнение Нернста для температурной поправки
• NPK: FAO 56 + Eur. J. Soil Sci. для влажностной компенсации

🧪 Научные источники

• Archie G.E. (1942): Electrical resistivity log as an aid in determining some reservoir characteristics
• FAO Irrigation Paper 56: Allen R.G. et al. (1998) - Crop evapotranspiration
• European Journal of Soil Science 73 (2022): Temperature effects on nutrient availability
• USDA Agricultural Handbook 18: Diagnosis and improvement of saline and alkali soils

---

🌐 Веб-интерфейс

📱 Основные страницы

• 📊 /readings - Текущие показания с объяснениями компенсации
• ⚙️ /intervals - Настройка интервалов измерений
• 📁 /config_manager - Управление конфигурацией
• 🚀 /updates - Обновление прошивки по воздуху
• 🔧 /service - Сервисные функции и диагностика

🎨 Особенности интерфейса

• Цветовая индикация: Статус измерений и калибровки
• Стрелки изменений: Отслеживание динамики параметров
• Сезонные корректировки: Автоматические поправки
• Научные источники: Ссылки на исследования

---

📊 Текущий статус

Версия: 3.4.9

Платформа: ESP32 + PlatformIO

Статус: ✅ Стабильный

Лицензия: MIT

✅ Последние улучшения

• 🔧 Исправлена логика применения калибровочной таблицы
• 🔬 Двухэтапная компенсация: CSV + математическая
• 🌿 Объединены агрономические рекомендации
• 📚 Полная консистентность документации - все документы имеют единообразную структуру
• 🚫 Отменена рискованная миграция статических страниц

📖 Консистентность документации

✅ Все документы теперь имеют:

• Блоки содержания в начале каждого документа
• Единообразные блоки ссылок в конце
• Консистентные заголовки и форматирование
• Профессиональную структуру навигации

---

🔗 Полезные ссылки

📦 GitHub Repository 🚀 Latest Release 🐛 Issues 💬 Telegram Support

---

© 2025 JXCT Development Team

Made with ❤️ for the agricultural community