Файлы страниц

Исходные файлы страниц хранятся в папке arduino_serial_commander. Это именно исходные файлы, которые не участвуют в работе системы, они нужны для того, чтобы вы могли внести в них изменения и затем отправить на сервер (на его microSD карту). Отправлять файлы можно либо с помощью утилиты Arduino Serial Commander, либо обычным способом — просто записав файлы на карту памяти (и затем вставив её в сервер AMS).

Наименование файлов

Наименование файлов подчиняется правилу 8.3, то есть имя файла должно содержать не более восьми символов, а расширение — не более трёх. Допустимы буквы английского алфавита, цифры и знаки «-» и «_». Это ограничения библиотеки работы с SD картами памяти.

Файлы страниц делятся на несколько типов: HTM, CSS, JS, PDE.

HTM

Это основные файлы веб-страниц, содержащие разметку на языке HTML. Эти файлы, в свою очередь, делятся на два типа: основные, содержащие контент и вспомогательные, содержащие структурные блоки веб-страниц, такие, как хедер, меню, футер и т. п. Для того, чтобы вспомогательные файлы можно было отличить от основных, их названия начинаются с символа подчёркивания.

Основные HTM файлы

  • index.htm — главный файл, загружаемый по умолчанию
  • index-p1.htm — главный файл партнёрского сайта 1
  • index-p2.htm — главный файл партнёрского сайта 2
  • index-p3.htm — главный файл партнёрского сайта 3
  • index-p4.htm — главный файл партнёрского сайта 4
  • sample1.htm — пример индикаторов
  • sample2.htm — пример Ajax
  • control.htm — управление светом
  • noo.htm — управление оборудованием nooLite
  • solder.htm — паяльная станция
  • network.htm — сетевые настройки
  • electro.htm — работа с Power Monitor
  • ports.htm — информация о состоянии портов
  • sdcard.htm — информация о microSD карте памяти
  • sensors.htm — информация о сенсорах
  • subsys.htm — информация о подсистемах
  • supply.htm — информация об электропитании
  • system.htm — информация о системе
  • settings.htm — установки
  • themes.htm — выбор темы (сайта) AMS
  • full.htm — полноэкранный осциллограф
  • full2.htm — полноэкранный ваттметр
  • full-am1.htm — брендированный ваттметр
  • help.htm — помощь
  • about.htm — о системе Arduino Mega Server
  • refer.htm — справочник
  • tech.htm — описание технологии
  • coop.htm — предложение о сотрудничестве
  • under.htm — «страница в разработке»
  • 404.htm — «страница не найдена»

CSS

Интерфейс Arduino Mega Server сделан с применением стандартных веб-технологий и внешний вид страниц задаётся с помощью CSS файлов стандартным способом, т. е. в веб-страницах находятся ссылки на соответствующие CSS файлы. Каждой теме оформления (сайту внутри системы AMS) соответствует свой CSS файл.

  • style.css — CSS файл темы по умолчанию («Гик моде»)
  • style_hm.css — CSS файл темы «Домашняя»
  • style_md.css — CSS файл темы «Модерн»
  • style_hk.css — CSS файл тёмной темы «Хакер дизайн»
  • style_p1.css — CSS файл партнёрского сайта 1
  • style_p2.css — CSS файл партнёрского сайта 2
  • style_p3.css — CSS файл партнёрского сайта 3
  • style_p4.css — CSS файл партнёрского сайта 4

JS

Файлы JavaScript обеспечивают всю динамическую и интерактивную функциональность веб-страниц. Эти файлы тоже подключаются к веб-страницам стандартным способом, при помощи соответствующих ссылок.

Общий принцип формирования JavaScript файлов такой: каждая динамическая и интерактивная веб-страница имеет свой JavaScript файл-спутник с таким же названием, например, страница settings.htm имеет спутник settings.js, в котором находится функционал этой страницы.

Это нестрогое правило — страница может не иметь JavaScript файла или иметь несколько подключённых файлов, но к большинству страниц подключается один JS файл (кроме общего scripts.js).

scripts.js

Это системный JavaScript файл в котором содержится большинство функций, необходимых для роботы интерфейса Arduino Mega Server, поэтому он подключается ко всем веб-страницам. Этот файл содержит функции обслуживания dash-панели, графическую библиотеку AMS и прочие важные компоненты системы.

Узнать подробнее

PDE

Файлы с расширение PDE содержат скрипты на языке Processing, которые используются для визуального представления информации, например, в dash-панели.

Внимание! Не путайте файлы PDE, относящиеся к утилите Arduino Serial Commander и файлы PDE скриптов на языке Processing, оба эти типа файлов имеют одно и то же расширение. Список файлов, относящихся к Arduino Serial Commander вы можете найти в документации к этой утилите.

Использование скриптов на языке Processing требует загрузки соответствующей библиотеки, а это, в свою очередь, замедляет загрузку веб-страниц, поэтому в текущей версии системы PDE скрипты не используются, но вы можете их задействовать, если они вам нужны. Посмотреть пример работы с этими скриптами вы можете в архивной 0.11 версии системы.


Обратите внимание. Система Arduino Mega Server непрерывно развивается и в код проекта постоянно вносятся изменения и улучшения, поэтому, описание и документация может не соответствовать вашей конкретной версии системы. Последняя правка этой страницы относится к 0.14 версии системы.