codec2_talkie/README.md

53 wiersze
3.2 KiB
Markdown

2022-06-19 11:55:05 +00:00
![CI](https://github.com/sh123/codec2_talkie/workflows/CI/badge.svg)
![APK](https://img.shields.io/endpoint?url=https://apt.izzysoft.de/fdroid/api/v1/shield/com.radio.codec2talkie)
2020-12-10 11:44:49 +00:00
2021-01-27 13:28:39 +00:00
# Introduction
2022-08-15 14:20:38 +00:00
**Turn your Android phone into real Amateur Radio HF/VHF/UHF APRS enabled Codec2 DV (digital voice) and/or FreeDV handheld transceiver.**
2022-08-15 14:20:00 +00:00
**Requires additional hardware (e.g. AFSK/LoRa), software (e.g. Direwolf) radio modem or analog transceiver with USB audio + VOX/USB CAT PTT control, such as MCHF or ICOM**
2021-10-11 14:25:01 +00:00
2021-10-24 13:53:50 +00:00
For more information visit project [Wiki](https://github.com/sh123/codec2_talkie/wiki)
2021-01-27 15:53:51 +00:00
![alt text](images/diagram.png)
2020-12-06 10:21:21 +00:00
![alt text](images/screenshot.png)
2021-01-25 12:08:13 +00:00
![alt text](images/screenshot_settings.png)
2020-12-06 10:13:29 +00:00
2022-08-15 14:49:21 +00:00
# Short Description
What you can do with this app:
2022-08-15 14:56:03 +00:00
- Use it with your KISS Bluetooth/BLE/USB/TCPIP hardware modem, such as LoRa/FSK/AFSK/etc, control its parameters by using "set hardware" KISS command
2022-08-15 14:49:21 +00:00
- Use it with KISS software modem using TCPIP, such as Direwolf
2022-08-15 14:56:03 +00:00
- Use it with your HF/VHF/UHF transceiver as a sound modem
2022-08-15 14:59:12 +00:00
- Use your phone as a software sound modem by using external USB OTG audio adapter (voice + data) or built-in phone speaker and mic (only data)
2022-08-15 15:19:39 +00:00
- Use your phone for FreeDV protocol voice communication together with HF transceiver, which supports USB OTG audio
- Control your external transceiver PTT by using USB serial CAT (or VOX if CAT PTT is not supported)
2022-08-16 08:25:04 +00:00
- Send and receive APRS position reports over FSK 300 (HF, TX only), AFSK1200 (VHF), FreeDV OFDM (HF)
2022-08-15 14:49:21 +00:00
- Send and receive APRS messages
- Send and receive raw Codec2 speech frames over KISS or inside APRS/AX.25 UI frames
2022-08-16 08:25:04 +00:00
- Use application as APRS digirepeater
2022-08-21 14:07:56 +00:00
- Use application as APRS-IS RX/TX iGate
2021-01-27 12:05:52 +00:00
2020-12-06 09:56:08 +00:00
# Requirements
2021-07-29 16:34:38 +00:00
- Android 7.0 (API 24) or higher
2021-01-27 12:25:13 +00:00
- Application could also be used with your Android network radio, such as Inrico TM-7, apk just needs to be installed over USB, see [Discussion](https://github.com/sh123/codec2_talkie/issues/4)
2021-10-14 11:58:56 +00:00
- Android 5.0, 5.1, 6.0 (API 21, 22, 23)
2021-10-14 11:59:35 +00:00
- Separate apk package is released with "legacy" suffix from legacy branch
2022-06-21 19:21:43 +00:00
- Modem, radio module or transceiver which supports [KISS protocol](https://en.wikipedia.org/wiki/KISS_(TNC)) or can process KISS or raw Codec2 audio frames over serial Bluetooth, BLE, USB or TCP/IP
2022-08-11 22:08:51 +00:00
- Analog transceiver with built-in or external USB audio adapter and VOX or USB CAT PTT control (such as MCHF or iCom IC-7x00 series)
2021-10-28 12:33:12 +00:00
# Dependencies
- Source code is integrated into this project for easier building and customization:
- Codec2 codec: https://github.com/drowe67/codec2
- Android Codec2 wrapper code: https://github.com/UstadMobile/Codec2-Android
- Fetched with gradle as dependency:
- Android USB serial: https://github.com/mik3y/usb-serial-for-android
# Other similar or related projects
- ESP32 LoRa APRS modem (used with this application for testing): https://github.com/sh123/esp32_loraprs
- Version adopted for M17 protocol usage: https://github.com/mobilinkd/m17-kiss-ht
- iOS Codec2 wrapper: https://github.com/Beartooth/codec2-ios
- Minimal Arduino LoRa KISS modem: https://github.com/sh123/lora_arduino_kiss_modem
- Minimal Arduino NRF24 KISS modem: https://github.com/sh123/nrf24l01_arduino_kiss_modem
- Other interesting projects:
2021-10-29 06:33:04 +00:00
- LoRa mesh text GPS communicator: https://github.com/meshtastic/Meshtastic-device