Android-Serialport

Porting Google's official serial port library android-serialport-api, only supports serial port name and baud rate. This item adds support check digit, data bit, stop bit, flow control configuration item.

Document

• 中文

Использование

1. Gradle dependency:

implementation 'tp.xmaihh:serialport:2.1'

2. Maven dependency:

<dependency>
  <groupId>tp.xmaihh</groupId>
  <artifactId>serialport</artifactId>
  <version>2.1</version>
  <type>pom</type>
</dependency>

Функции

1. Список последовательных портов

serialPortFinder.getAllDevicesPath();

2. Настройки свойств последовательного порта

serialHelper.setPort(String sPort);      // установить последовательный порт
serialHelper.setBaudRate(int iBaud);     // установить скорость передачи данных
serialHelper.setDataBits(int dataBits);  // установить бит данных
serialHelper.setParity(int parity);      // установить контрольный бит
serialHelper.setFlowCon(int flowcon);    // установить управление потоком

Настройки свойств последовательного порта должны быть установлены до выполнения функции open().

3. Открыть последовательный порт

serialHelper.open();

4. Закрыть последовательный порт

serialHelper.close();

5. Отправка

serialHelper.send(byte[] bOutArray); // отправить byte[]
serialHelper.sendHex(String sHex);  // отправить Hex
serialHelper.sendTxt(String sTxt);  // отправить ASCII

6. Получение

@Override
protected void onDataReceived(final ComBean comBean) {
       Toast.makeText(getBaseContext(), new String(comBean.bRec, "UTF-8"), Toast.LENGTH_SHORT).show();
}

7. Обработка «залипших» пакетов

Поддерживает обработку «залипших» пакетов, причина описана в Issue, предоставленный «залипший» пакет. Обработка

• Не обработано (по умолчанию).
• Обработка первого и последнего специальных символов.
• Обработка фиксированной длины.
• Динамическая обработка длины.

Поддерживает пользовательскую обработку липких пакетов.

Шаг 1 Первым шагом является реализация интерфейса AbsStickPackageHelper (https://github.com/xmaihh/Android-Serialport/blob/master/serialport/src/main/java/tp/xmaihh/serialport/stick/AbsStickPackageHelper.java).

/**
 * Принять сообщение, помощник обработки липкого пакета, вернуть окончательные данные через входной поток, необходимо вручную обработать липкий пакет, а возвращённый byte[] — это полные данные, которые мы ожидали.
 * Примечание: этот метод будет вызываться повторно до тех пор, пока не будет разрешён полный фрагмент данных. Этот метод является синхронным, старайтесь не выполнять длительные операции, иначе он заблокирует чтение данных.
 */
public interface AbsStickPackageHelper {
    byte[] execute(InputStream is);
}

Шаг 2 Настройте обработку липкого пакета.

serialHelper.setStickPackageHelper(AbsStickPackageHelper mStickPackageHelper);

Демо APK

Инструменты отладки на стороне ПК Инструмент для последовательной отладки для Win

Журнал изменений

[2.1]

Добавлено

• Добавлена поддержка настроек для получения данных обработки липких пакетов, поддержка настройки пользовательской обработки липких пакетов

[2.0]

Добавлено

• Добавлена поддержка установки контрольных цифр, битов данных, стоповых битов, элементов конфигурации управления потоком

[1.0]

Добавлено

• Базовая функция, последовательный порт устанавливает номер последовательного порта, скорость передачи данных, отправляет и получает данные

Часто задаваемые вопросы

• Эта библиотека не предоставляет права ROOT, пожалуйста, откройте последовательный порт «666» самостоятельно.

adb shell  chmod 666 /dev/ttyS1

Вклад

Пожалуйста, внесите свой вклад! Проблемы и запросы на вытягивание приветствуются.

Спасибо за вашу помощь в улучшении программного обеспечения, одно изменение за раз!