Пользовательские элементы управления Redbear BLE Nano V2 с PfodApp - кодирование не требуется: 6 шагов

2024 Автор: John Day | [email protected]. Последнее изменение: 2024-01-30 11:51

Автор: drmpfpfodApps и pfodDevicesFollow Еще автор:

Обновление: 15 сентября 2017 г. - Это руководство было обновлено для использования последней версии RedBear BLE Nano, V2. Предыдущая версия этого руководства, предназначенная для RedBear BLE Nano V1.5, доступна здесь.

Обновление от 15 ноября - 2017 г. Некоторые платы / стеки программного обеспечения BLE поставляют один и тот же cmd дважды в быстрой последовательности. Обновите до pfodApp V3.322 + и pfodParser V3.17 +, чтобы решить эту проблему. pfodApp V3.322 + добавляет порядковый номер cmd, а pfodParser V3.17 + отфильтровывает повторяющиеся cmd

Ни один из этих экранов не запрограммирован жестко в pfodApp (приложение для Android). Все вышеперечисленные экраны полностью контролируются кодом RedBear BLE Nano V2

В этом руководстве рассматриваются настраиваемые элементы управления для модуля RedBear BLE Nano V2. Он состоит из двух частей:

Первая часть представляет собой «начальный» набросок, который при загрузке в RedBear BLE Nano V2 будет отображать интерактивную графику в pfodApp, которая позволит вам считывать аналоговые и цифровые входы. Измените цифровые контакты на выходы / ШИМ и установите значения выхода / ШИМ.

Вторая часть использует бесплатный pfodDesigner для создания настраиваемых многоуровневых меню, графиков и регистрации данных, которые могут отображаться в pfodApp. PfodDesigner генерирует весь код Android, необходимый для RedBear BLE Nano V2. Универсальный pfodApp обрабатывает отображение и взаимодействие пользователя на вашем мобильном телефоне Android. Пользовательский дисплей полностью контролируется кодом Android, который вы загружаете в свой Nano. Никакого программирования под Android не требуется.

Шаг 1. Начальный набросок RedBear BLE Nano V2

На анимированном GIF-изображении выше показано действие начального скетча RedBear BLE Nano V1.5.

Для запуска этого скетча вам потребуется: -

1. RedBearLab BLE Nano V2 Kit - модуль BLE Nano и модуль программирования https://redbearlab.com/buy/ ~ 30 долларов США
2. Удлинительный кабель USB (необязательно, но полезен) - https://www.sparkfun.com/products/13309 ~ 2 доллара США
3. pfodApp - приложение для Android https://redbearlab.com/buy/ ~ 10 долларов США
4. Arduino IDE V1.8.4 -
5. и вспомогательные библиотеки (см. примечание ниже об обновлении библиотеки BLEPeripheral с V0.4.0 до V0.5.0)

Шаг 2: Установка начального эскиза

1. Установите Arduino IDE V1.8.4 с

2. Следуйте руководству по установке Arduino https://github.com/redbear/nRF5x/blob/master/nRF5… Добавьте https://redbear.github.io/arduino/package_redbear… URL-адреса диспетчера дополнительных плат Arduino (в разделе Файл-> Настройки), а затем с помощью Arduino Board Manager установите платы RedBear nRF52832 V0.0.2 (отфильтруйте поиск по RedBear)

3. Установите библиотеку BLEPeripheral. Откройте диспетчер библиотек в среде Arduino IDE и введите BLEPeripheral в строке поиска. Выберите BLEPeripheral от Sandeep Mistry V0.5.0 и установите его.

   Примечание: BLEPeripheral V0.5.0 не выпущен по состоянию на 14 сентября 2017 года, поэтому установите V0.4.0, а затем перезапишите файлы nRF51822.h и nRF51822.cpp обновленными файлами в этом zip-файле, nRF51822.zip. Копия этого файла V0.4.0 arduino-BLEPeripheral-master.zip находится здесь.

4. Загрузите вручную и библиотеки pfodParser.zip и pfodDwgControls.zip отсюда, а затем используйте пункт меню Arduino IDE Sketch → Import Library → Add Library для их установки.
5. Разархивируйте этот скетч RedbearBLENanoV2Starter.zip и поддерживающие его классы в папку Aduino Sketchbook (показано в File → Preferences).
6. Откройте IDE Arduino, выберите плату BLE Nano (моя плата была V1.5), откройте скетч RedbearBLENanoV2Starter.ino, скомпилируйте и загрузите в модуль BLE Nano V2. Чтобы запрограммировать его, вам нужно добавить экран USB, показанный выше (под основной платой). Хотя экран USB предназначен для непосредственного подключения к вашему USB-порту, я обнаружил, что это очень неудобно на моем ноутбуке, поэтому я добавил удлинительный кабель USB. BLE Nano V2 теперь содержит весь код, необходимый для рисования интерактивной графики и обработки вводимых пользователем данных.
7. Установите pfodApp на свой Android Mobile. Вам понадобится мобильный телефон с ОС Android V4.4 или выше и тот, который поддерживает Bluetooth Low Energy. Затем создайте соединение BLE с вашим BLE Nano, как описано в pfodAppForAndroidGettingStarted.pdf. Наконец, подключитесь, и pfodApp загрузит изображение, показанное выше. После загрузки графики pfodApp кэширует ее, поэтому в следующий раз BLE Nano V2 нужно будет только отправить обновления.

В загруженном вами эскизе используются примитивы рисования pfodApp для рисования контура платы и кнопок, а также для определения зон касания и действий пользователя. В учебнике Custom Arduino Controls for Android рассказывается, как кодировать свои собственные элементы управления, а в учебнике Arduino101 Starter, управляемом Android / pfodApp, описывается, как работают Zoom и Pan.

В следующем разделе описывается, как использовать бесплатный WISIWYG pfodDesigner для создания многоуровневых меню для управления выходами, чтения, построения и регистрации аналоговых входов и генерации всего кода, необходимого для вашего RedBear BLE Nano.

Шаг 3. Создание пользовательских меню Android для RedBear BLE Nano и генерация кода

Бесплатное приложение pfodDesignerV2 для Android позволяет создавать пользовательские меню, а затем генерирует весь код для вашего конкретного модуля BLE. Затем pfodApp используется для отображения вашего пользовательского меню на вашем мобильном телефоне Android и позволяет вам управлять своим модулем.

Кодирование Android или Arduino не требуется

Бесплатный pfodDesignerV2 используется для создания меню в стиле WISIWYG и показывает вам точный предварительный просмотр того, как меню будет выглядеть на вашем мобильном телефоне. PfodDesignerV2 позволяет вам создавать меню и подменю с кнопками и ползунками, необязательно подключенными к контактам ввода-вывода, и генерировать для вас код эскиза (см. Учебные пособия по pfodDesigner), но pfodDesignerV2 не охватывает все функции, которые поддерживает pfodApp. См. PfodSpecification.pdf для получения полного списка, включая регистрацию и построение данных, экраны с множественным и одиночным выбором, ползунки, ввод текста и т. Д.

Создайте пользовательское меню для включения и выключения светодиода RedBear BLE Nano V2

В учебнике «Дизайн пользовательского меню» для включения и выключения светодиода Arduino есть пошаговые инструкции по созданию этого меню с помощью pfodDesignerV2. Если вам не нравятся цвета размеров шрифта или текста, вы можете легко отредактировать их в pfodDesignerV2 на все, что захотите, и увидеть WYSIWYG (что вы видите, то и получаете) отображение разработанного меню.

Для RedBear BLE Nano V2 нужно сделать только одно изменение - установить его в качестве цели для генератора кода для нового меню перед добавлением пункта меню управления светодиодами.

Шаг 4. Выбор RedBear BLE Nano V2 в качестве цели для генерации кода

Сначала вам нужно выбрать RedBear BLE Nano в качестве цели для генерации кода. Когда вы запускаете новое меню или редактируете существующее меню, верхняя кнопка показывает целевую доску. По умолчанию - Последовательный.

Нажмите кнопку «Цель», чтобы открыть список «Цель».

Нажмите кнопку Bluetooth Low Energy, прокрутите вниз, найдите параметр RedBearLab BLE Nano V2 и щелкните по нему.

Затем используйте кнопку возврата мобильного телефона, чтобы выйти из экрана выбора цели и вернуться к экрану меню редактирования.

Шаг 5: замена индикаторов включения / выключения - в BLE Nano V2 нет необходимости

Предыдущая версия RedBear BLE Nano V1.5 имела еще одно отличие. Светодиод горит НИЗКОМ. То есть, когда на выходе D13 низкий уровень, светодиод горит.

На Nano V2 светодиод активен ВЫСОКИЙ, поэтому здесь нечего делать.

На этом необходимые изменения завершены. Теперь вы можете продолжить работу с меню Design a Custom, чтобы включить и выключить руководство Arduino Led, чтобы сгенерировать код, перенести его на свой компьютер, скомпилировать и загрузить на RedBear BLE Nano V2. Копия скетча сгенерированного кода находится здесь (BLENanoV2LedController.ino)

Затем подключитесь через pfodApp со своего мобильного телефона, чтобы отобразить меню, которое вы только что создали, и управляйте светодиодом, щелкнув в любом месте кнопки или сдвинув ползунок.

Шаг 6: расширенное меню управления BLE Nano

Используя Led Controller в качестве основы, вы можете добавить дополнительные пункты меню для чтения или управления другими цифровыми выводами, а также для чтения, построения и регистрации аналоговых входов A4 и A5. Ознакомьтесь с различными руководствами pfodDesigner по использованию различных пунктов меню. В руководстве «Как отображать данные Arduino на Android для начинающих» рассматривается создание графиков.

Сгенерированный скетч находится здесь (BLE_NanoV2Controller.ino)

Помимо построения аналоговых значений, показания также записываются в формате CSV в файл на вашем мобильном телефоне для дальнейшего использования.

Образцы экранов

PfodDesignerV2 поддерживает только часть экранов, которые поддерживает pfodApp. Полный список см. В pfodSpecification.pdf. Эскиз SampleRedBearBLENanoV2Screens.ino включает дополнительные экраны, поддерживаемые pfodApp, но не включенные в pfodDesigner. Большинство экранов не имеют форматирования, чтобы сообщения оставались ясными и простыми. Селектор цвета под слайдерами является исключением. Вы можете добавить свои собственные цвета и стили шрифтов, используя pfodDesignerV2 в качестве руководства. Также см. Другие примеры в приложении pfodDemo для Android.

Для скетча SampleRedBearBLENanoV2Screens.ino сначала необходимо установить библиотеки pfodParser.zip и pfodDwgControls.zip.

Заключение

В этом руководстве показано, как легко взаимодействовать с досками RedBearLab BLE Nano и управлять ими. Программирование для Android не требуется. Всем этим занимается pfodApp. Кодирование Arduino не требуется. (Бесплатная) pfodDesignerV2 генерирует полные эскизы для этого и множества других модулей, включая ESP8266 и WiFi, Bluetooth и SMS-экраны. Поскольку не существует стандарта для универсального подключения UART к устройству BLE, pfodApp предварительно настроил ряд параметров подключения общих плат BLE, чтобы вы могли использовать один и тот же pfodApp для всех из них.