Бюджетный LTE модуль Neoway N58. Начало работы с OpenCPU
16 Август, 2021
Neoway N58 - бюджетный модуль LTE Cat.1 с возможностью загрузки приложений.
LTE модуль Neoway N58 может работать с двумя разными прошивками:
1. Прошивка с АТ-командами. В этом случае модуль управляется при помощи расширенного набора АТ-команд, поступающих от внешнего устройства по последовательному интерфейсу (физическому или виртуальному UART). При этом нет возможности загрузить в модуль свое приложение.
2. Прошивка OpenCPU. Доступен только ограниченный набор АТ-команд. Можно загрузить в модуль свое приложение, доступны дополнительные интерфейсы. Внешнее устройство управления не требуется.
Нужную прошивку можно загрузить в модуль самостоятельно через USB. Для загрузки прошивки с АТ-командами необходимо использовать программу "Upgrade Download", а в случае прошивки и приложения OpenCPU - "Research Download".
В данной статье описывается начало работы с OpenCPU.
В этом случае разработчикам доступны следующие ресурсы LTE модуля Neoway N58:
- ARM Cortex-A5, 500 МГц;
- 128 кбайт ОЗУ (может быть увеличено до 1 МБ);
- общий объем Flash – 8 Мбайт, под приложение отводится 192 кбайта;
- Bluetooth, Wi-Fi Scan;
- приемник Глонасс/GPS/BDS (опционально),
- интерфейсы USB2.0, ADC, UART, SPI, I2C, GPIO, keypad, audio IN/OUT;
- API, базовый набор АТ-команд.
Для разработки приложений производитель предоставляет SDK.
В состав SDK входит тестовое приложение, которое можно использовать для быстрого ознакомления с основными возможностями N58. Для этого нужно загрузить в модуль сначала базовую прошивку OpenCPU, а затем – тестовое приложение.
Загружаем в модуль Neoway N58 базовую прошивку OpenCPU и тестовое приложение
1. Для прошивки ПО модуль N58 нужно перевести в режим загрузки ПО (download mode).
Для этого перед включением или перезагрузкой модуля нужно замкнуть между собой контакты 45 (VDD_1P8) и 48 (USB_BOOT). В случае отладочной платы эти контакты выведены на джампер, обозначенный надписью: "BOOT".
После перехода модуля в режим загрузки ПО в диспетчере устройств Windows должен появиться COM-порт: "SPRD U2S Diag".
USB-драйверы можно найти на странице с документацией модуля Neoway N58.
2. На ПК с ОС Windows запускаем приложение Research Download.
Запускаем файл ResearchDownload.exe и ждем появления окна программы - это может занять несколько десятков секунд!
3. Загружаем в модуль базовую прошивку OpenCPU (в моем случае - N58-R07-STD-OE_V20-03C.pac):
а) для выбора прошивки нажимаем кнопку "Load packet" в верхнем меню программы и выбираем файл базовой прошивки (например, N58-R07-STD-OE_V20-03C.pac);
б) номер порта можно проверить, нажав кнопку "Settings" (обычно выбирается автоматически);
в) запускаем процесс прошивки с помощью кнопки "Start downloading";
г) после успешной прошивки в столбике "Progress" появляется надпись: "Passed".
Затем нужно нажать кнопку "Stop downloading" и повторить те же самые шаги для тестового приложения.
4. Загружаем в модуль тестовое приложение hello_flash.pac:
а) для выбора прошивки нажимаем кнопку "Load packet" в верхнем меню программы и выбираем файл hello_flash.pac;
б) номер порта можно проверить, нажав кнопку "Settings" (обычно выбирается автоматически);
в) запускаем процесс прошивки с помощью кнопки "Start downloading";
г) после успешной прошивки в столбике "Progress" появляется надпись: "Passed".
После окончания прошивки модуль необходимо перезагрузить и убедиться в том, что он включился в обычном режиме.
При этом в диспетчере устройств Windows должны появиться несколько COM-портов. Один из них называется: "Neoway USB OPEN_CON" - это порт, на который выводятся текстовые сообщения из приложения.
Проверяем работу тестового приложения
Убедиться в том, что тестовое приложение загружено в модуль, можно при помощи команды "AT+NAPPCHECK?".
Эту команду нужно подавать через порт "Neoway USB AT", используя терминальную программу.
В ответ модуль должен передать версию приложения, например:
AT+NAPPCHECK?
+NAPPCHECK: "NWY_APP_V1.0.1", Dec 11
Работу тестового приложения можно проверить, подключив терминальную программу к порту "Neoway USB OPEN_CON".
При этом необходимо использовать такую терминальную программу, которая ввод данных завершает символами возврата каретки и перевода строки (\r\n).
Приложение, содержащееся в SDK производителя, представляет собой набор простых программ, предназначенных для тестирования отдельных функций модуля. Выбор той или иной программы осуществляется при помощи текстового меню, которое после включения модуля выводится на порт "Neoway USB OPEN_CON".
Для повторного вывода меню достаточно отправить из терминальной программы какую-либо букву или набор букв, заканчивающихся символами \r\n.
В ответ на приглашение: "Please input option:" вводим номер, соответствующий выбранной опции. Например, для выбора "51. get device ver test" вводим 51:
Вносим изменения в исходный код и компилируем новое приложение
Исходный код тестового приложения находится в файле hello_world.c, содержащемся в папке core_sdk. Модуль работает под управлением ОС FreeRTOS, входной точкой приложения является функция appimg_enter(). Под приложение отводится 192 кбайта Flash.
При отладке приложения можно использовать функцию nwy_ext_echo(), предназначенную для вывода текстовых сообщений на порт "Neoway USB OPEN_CON". Другой вариант – использование функции OSI_LOGI(), но в этом случае понадобится специальное ПО, называемое Coolwatcher.
Для компиляции приложения нужно запустить скрипт nwy_opencpu.bat из директории core_sdk и убедиться в том, что компиляция прошла без ошибок.
После успешной компиляции в директории core_sdk\out\appimage_release\hex должен появиться файл приложения - hello_flash.pac.
Этот файл нужно загрузить в модуль N58 при помощи программы "Research Download", как было описано ранее, и проверить его работу.
Ваши вопросы вы можете задать автору статьи Андрею Анисимову, email avan@efo.ru