JAPRS

Help для jAPRS

jAPRS aka APRS I-net Position Sender - java (J2ME) APRS-клиент для мобильных телефонов.

Автор программы: Алексей (UA3MQJ), г.Рыбинск, Ярославская обл.

Введение

В теме про альтернативные способы определения координат рассматривались варианты определения координат подвижной APRS станции без GPS-приёмника. Один из таких вариантов - определение координат по милевым столбам. Общий смысл в том, что берётся определенная точка в пространстве, ей даётся определенное имя и определяются точные координаты. Так определяются несколько точек, например, по пути предстоящего маршрута. Теперь, достигнув определенной точки маршрута, можно точно знать свои координаты.

О программе

jAPRS предназначена для отправки на сервер сети APRS-IS APRS сообщения о нахождении себя в определенном месте. Программа реализована на платформе J2ME, т. е. - это JAVA-приложение для сотового телефона. Точки в пространстве хранятся в отдельных текстовых файлах. Имя файла - это имя точки. Содержимое файла - координаты точки и комментарий. Файлы располагаются на флеш-карте телефона и для удобства могут быть разложены по разным папкам, например - по маршрутам движения автобусов, на которых вы можете передвигаться.

Например: файл 01-Автовокзал.txt может содержать в себе следующие данные: 58.02.08N 038.51.32E Autowokzal {jAPRS}

Пример файла с координатами:

файл 01-CentralPlace.txt содержит текст:

58.02.08N 038.51.32E Central Place {jAPRS}

Пример файла с объектами:

файл localobjects.txt содержит текст:

;Objects
UA3MAD /r 58.01.83N 038.51.23E Echo Repeater 430
UA3MAO /r 58.01.83N 038.51.24E Repeater 430

Возможности программы

Программа позволяет:

• Отправлять маяк вручную
• Автоматически отправлять последний переданный маяк по таймеру регулярно через заданное время
• Отправлять APRS сообщения
• Отправлять объекты
• Выбирать тип соединения с APRS сервером: постоянное или временное (устанавливается на момент отправки данных)
• Принимать APRS сообщения (при постоянном соединении)

История версий

• Первая версия программы была выпущена 26.03.2011
• Версия от 02.07.2012 - добавлена возможность отправки объектов.

Download

Standart Edition

Текущую версию программы (APRSInetSenderST (Standart) - cтандартная версия, для телефонов с клавиатурой без поддержки Location API) всегда можно скачать по ссылкам:

• https://raw.githubusercontent.com/UA3MQJ/japrs/master/APRSInetSenderST/APRSInetSender.jad
• https://raw.githubusercontent.com/UA3MQJ/japrs/master/APRSInetSenderST/APRSInetSender.jar

Список моделей телефонов, на которых проведено тестирование работы:

• Fly e135 - сенсорный телефон, работа с кнопочными меню прямо через сенсорный экран
• Samsung Champ c3300 - сенсорный телефон, работа только через виртуальную экранную клавиатуру (не удобно)
• Alcatel one touch 800
• SonyEricsson K530i (SonyEricsson, K510, 550, 530, 750, 800, 810)
• Nokia ASHA 206

Статус проекта

Проект находится в стадии разработки. Новые версии и доработки ведутся по мере возможностей и предложений со стороны пользователей. Ведётся проработка возможностей:

• определения координат по CELL_ID - испробованы варианты, на доступных для тестирования телефонах эта опция не работает, дальнейшие эксперименты приостановлены до появления реального телефона с поддержкой возможности CELL_ID
• определение координат через GPS на базе Location API для J2ME(JSR179) - возможность определения координат проверена на эмуляторе, но не все телефоны без поддержки GPS смогут запустить эту версию. Возможность работы с GPS отключена в стандартной версии для поддержания совместимости. Для работы с GPS нужно разрабатывать отдельную версию.
• работы по улучшению интерфейса на кнопочном и сенсорном телефоне
• работы со звуком

Стандартная версия программы (ST) разработана для телефонов с клавиатурой с использованием стандартных меню, поэтому должна работать практически на всех телефонах с поддержкой флеш-карт. Также она может работать на сенсорных телефонах с помощью виртуальной клавиатуры, которая обычно есть в таких телефонах (но это не так удобно). Среда разработки - свободная NetBeans IDE 6.9.1 и SUN Wireless Toolkit 2.5.2, которые могут быть свободно скачаны с сайтов разработчиков. Сам проект jAPRS является открытым.

Текущее состояние исходных кодов можно найти на GIT https://github.com/UA3MQJ/japrs

Для разработчиков

Список программного обеспечения, которое необходимо для разработки данного проекта

Установка GIT

Исходные коды данного проекта лежат в общем доступе (на чтение) на сервере контроля версий GIT. Под OS Windows я рекомендую использовать программу Tortoise GIT После того, как программа установлена, а win перезапущена, в контекстном меню при нажатии правой кнопки мыши появятся пункты Tortoise GIT. Создайте рабочий каталог, в котором будет стоять проект. Например c:\projects Зайдите в эту папку и нажмите GIT Clone для выгрузки исходных текстов. Укажите путь https://github.com/UA3MQJ/japrs.git и нажмите OK. Текущие исходные коды выгрузятся на диск в указанную папку.

Установка J2SE

Установить полную яву от сюда http://www.oracle.com/technetwork/java/index.html http://www.oracle.com/technetwork/java/javase/downloads/jdk7-downloads-1880260.html

Установка JAVA NetBeans

Скачать среду разработки по адресу http://netbeans.org/downloads/index.html Версия ALL для поддержки разработки J2ME. Начиная с версии NetBeans 7.2 проект не открывается, не компилируется, визуальный редактор не работает. Версия NetBeans IDE 6.9.1 + WTK 2.5.2_01b работает нормально.

Установка J2ME Эмулятора WTK

Для поддержки локального хранилища(RMS) при отладке на ПК, нужно установить другой эмулятор - WTK. Скачать эмулятор http://www.oracle.com/technetwork/java/javasebusiness/downloads/java-archive-downloads-javame-419430.html#sun_java_wireless_toolkit-2.5.2_01b-oth-JPR

Настройка NetBeans под WTK

Открыть проект. Tools->Java Platforms нажимаем кнопочку AddPlatform выбираем тип Java ME MIDP Platform Emulator и программа находит c:\WTK2.5.2_01 и ставим его. Там же Tools&Extensions жмем кнопочку Preferences в ней Security ставим JTWI и trusted и на закладке Storage ставить heap по 2000. В проекте выбираем отлаживаться именно им: Run - Set Project Configuration на закладочке Platform выбираем SUN Java(TM) Wireless toolkit 2.5. После этого дела можно поискать базы с rms где-то тут: C:\Users\user\j2mewtk\2.5.2\appdb\DefaultColorPhone там же находится и файловая система телефона, куда можно помещать файлы с координатами

См. также

• QAPRS

Ссылки

• http://code.google.com/p/japrs/
• http://forum.qrz.ru/thread30823.html - обсуждение программы