Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/ok-dmr/hytera_homebrew_bridge
[BETA] protocol translator between Hytera repeaters 8.x and 9.x and MMDVM / Homebrew servers (hblink3, freedmr, ...)
https://github.com/ok-dmr/hytera_homebrew_bridge
ham-radio hytera kaitai kaitai-struct mmdvm radio-control
Last synced: 2 days ago
JSON representation
[BETA] protocol translator between Hytera repeaters 8.x and 9.x and MMDVM / Homebrew servers (hblink3, freedmr, ...)
- Host: GitHub
- URL: https://github.com/ok-dmr/hytera_homebrew_bridge
- Owner: OK-DMR
- License: agpl-3.0
- Created: 2020-03-22T19:53:10.000Z (over 4 years ago)
- Default Branch: master
- Last Pushed: 2024-04-15T07:42:07.000Z (7 months ago)
- Last Synced: 2024-05-02T00:10:43.978Z (7 months ago)
- Topics: ham-radio, hytera, kaitai, kaitai-struct, mmdvm, radio-control
- Language: Python
- Homepage:
- Size: 603 KB
- Stars: 26
- Watchers: 10
- Forks: 21
- Open Issues: 9
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Hytera Homebrew Bridge
**21.12.2020: We've entered alpha testing phase, see instructions below, on how to install and test**
----
This software will interconnect your Hytera repeater (tested RD625 and RD985) with MMDVM server (HBlink, DMRGateway, ...)
It does not require running under root/admin user, if you bind to ports over 1024
----
## Simple install:
```shell
# You need to have Python3 installed, at least version 3.7
$ python3 -m pip install pip wheel setuptools --upgrade
$ python3 -m pip install hytera-homebrew-bridge --upgrade
# download config file
$ curl "https://raw.githubusercontent.com/OK-DMR/Hytera_Homebrew_Bridge/master/settings.ini.minimal.default" -o settings.ini
# Now edit settings.ini
# Hytera: You must provide at least IPSC IP + ports (P2P, DMR and RDAC)
# MMDVM: You must provide at least local_ip, master_ip, port and password
# See "settings.ini.minimal.default" for required params / minimal configuration
$ hytera-homebrew-bridge.py settings.ini
```
----
## Install on Windows
To get software running on Windows, you need to install appropriate Python 3.7+ package (depending on your Windows version),
and you need to install dependencies (MSVC++ 14) required to build **bitarray** dependency
- Microsoft Visual C++ Build Tools v14.0
- Use [visualcppbuildtools_full.exe](https://go.microsoft.com/fwlink/?LinkId=691126) and install with default configuration
Then you should be able to use **Simple install**
```shell
# From standard Windows Command Line (cmd.exe)
$ python -m pip install pip wheel setuptools --upgrade
$ python -m pip install hytera-homebrew-bridge --upgrade
# Download settings from the project, settings.ini.minimal.default or settings.ini.default and modify it
$ hytera-homebrew-bridge.py
```
----
## Developer install:
Run the software without installing to Python packages, so you can edit code and run the edits
```shell
# Optionally uninstall the version installed in system
# python3
$ git clone https://github.com/OK-DMR/Hytera_Homebrew_Bridge.git
$ cd Hytera_Homebrew_Bridge
# You can use either settings.ini.default (all configuration params) or settings.ini.minimal.default (only required params)
$ cp settings.ini.default settings.ini
$ apt-get install libsnmp-dev snmp-mibs-downloader gcc python-dev
$ python3 -m pip install -r requirements.txt --user --upgrade
# Dependencies to run tests (pytest, pcapng parsing, ...)
$ python3 -m pip install -r requirements.development.txt --user --upgrade
$ python3 bin/hytera-homebrew-bridge.py settings.ini
```
----
## FAQ
- Q: Difference between SNMP family/community 'public' and 'hytera'?
- A: Some repeaters have non-changeable SNMP setting, and it appears it is usually either 'public' or 'hytera', if SNMP does not work for you, try changing the value to the other one
- Q: RDAC identification restarts unexpectedly or does not work at all, what can I try to fix it?
- A: Check the programming in CPS, there might be multiple incorrect settings
1. Open `Conventional > Channel > Digital Channel (or analog) > Digital IP Multi-Site Connect (4th from top in channel detail) must be set to "Slot 1 & Slot 2"`
2. Open `Conventional > General Settings > Access Manager` and in the section "Multisite Access Management" either disable the management or set correct list
- Q: SNMP does not work correctly, what can I try to fix it?
- A: Check if SNMP port is set to 161 in `Conventional > General Settings > Network` section `SNMP` at the bottom
- Q: I'm not getting the upstream connection and/or I'm seeing a lot of logs similar to "MMDVMProtocol - Sending Login Request"
- A: This is usually misconfiguration of Hytera repeater, if you do not see any logs with 'RDAC' or the long packet with 'REPEATER SNMP CONFIGURATION' info. In such cases you should check if the Hytera repeater is programmed correctly as slave and the IP/ports do match the HHB startup log saying 'Hytera Repeater is expected to connect at xxx.xxx.xxx.xxx'
----
Project is licensed under AGPLv3 and uses parts of other software, mentioned in NOTICE
----
This project is intended for educational/scientific purposes, and for HAM community to use non-commercialy.
Use at your own risk, and expect no warranties.