Go to file
Shane Daley 3a97ad2d3c Update 'README.md'
Update Readme
2021-10-11 20:41:07 -04:00
.gitattributes Update to sync dev system 2020-03-14 10:56:16 -05:00
.gitignore non-programatic updates 2019-03-01 11:30:45 -06:00
HBlink.png Adding Official Logo Images 2020-03-06 07:31:12 -06:00
HBlink.svg Adding Official Logo Images 2020-03-06 07:31:12 -06:00
LICENSE.txt non-programatic updates 2019-03-01 11:30:45 -06:00
README.md Update 'README.md' 2021-10-11 20:41:07 -04:00
bridge.py forward CSBK to destination TG 2021-02-26 16:16:15 -08:00
bridge_all.py Changed initial state values for some reporting variables. Cosmetic, but avoids unecessary tracabacks. 2020-01-13 14:45:17 +00:00
config.py Cosmetics 2020-10-24 21:20:22 -04:00
const.py Add necessary pieces for Talker Alias DMRA 2020-10-15 16:23:55 -05:00
hblink-SAMPLE.cfg Re-add needed code removed when diffing to restore XLX 2020-10-24 21:14:06 -04:00
hblink.py Re-add needed code removed when diffing to restore XLX 2020-10-24 21:14:06 -04:00
log.py non-programatic updates 2019-03-01 11:30:45 -06:00
mk_voice.py non-programatic updates 2019-03-01 11:30:45 -06:00
play_ambe.py update copyrights 2019-03-05 19:01:07 -06:00
playback.py Cleaned up Processing and logging 2019-09-30 14:10:40 -05:00
reporting_const.py Mostly kinda works now 2019-01-04 15:32:13 -06:00
requirements.txt Add packet generation for XLX master module selection 2019-06-19 12:15:21 +00:00
rules_SAMPLE.py READY FOR TESTING 2020-03-15 21:23:03 -05:00
voice_lib.py Update to sync dev system 2020-03-14 10:56:16 -05:00

README.md

OBP-Master


FOR SUPPORT, DISCUSSION, GETTING INVOLVED

Please join the DVSwitch group at groups.io for online forum support, discussion, and to become part of the development team.

DVSwitch@groups.io

A voluntary registrty for HBlink systems with public access has been created at http://hblink-register.com.es Please consider listing your system if you allow open access.


PROJECT: Open Source HomeBrew Repeater Proctol Client/Master.

UPDATES:

PURPOSE: Thanks to the work of Jonathan Naylor, G4KLX; Hans Barthen, DL5DI; Torsten Shultze, DG1HT we have an open protocol for internetworking DMR repeaters. Unfortunately, there's no generic client and/or master stacks. This project is to build an open-source, python-based implementation. You are free to use this software however you want, however we ask that you provide attribution in some public venue (such as project, club, organization web site). This helps us see where the software is in use and track how it is used.

For those who will ask: This is a piece of software that implements an open-source, amateur radio networking protocol. It is not a network. It is not intended to be a network. It is not intended to replace or circumvent a network. People do those things, code doesn't.

PROPERTY:
This work represents the author's interpretation of the HomeBrew Repeater Protocol, based on the 2015-07-26 documents from DMRplus, "IPSC Protocol Specs for homebrew DMR repeater" as written by Jonathan Naylor, G4KLX; Hans Barthen, DL5DI; Torsten Shultze, DG1HT, also licenced under Creative Commons BY-NC-SA license.

WARRANTY None. The owners of this work make absolutely no warranty, express or implied. Use this software at your own risk.

PRE-REQUISITE KNOWLEDGE:
This document assumes the reader is familiar with Linux/UNIX, the Python programming language and DMR.

Using docker version

To work with provided docker setup you will need:

  • A private repository with your configuration files (all .cfg files in repo will be copyed to the application root directory on start up)
  • A service user able to read your private repository (or be brave and publish your configuration, or be really brave and give your username and password to the docker)
  • A server with docker installed
  • Follow this simple steps:

Build your own image from source


docker build . -t millaguie/hblink:3.0.0

Or user a prebuilt one in docker hub: millaguie/hblink:3.0.0

Wake up your container

touch /var/log/hblink.log
chown 65000  /var/log/hblink.log
 run -v /var/log/hblink.log:/var/log/hblink.log -e GIT_USER=$USER -e GIT_PASSWORD=$PASSWORD -e GIT_REPO=$URL_TO_REPO_WITHOUT_HTTPS://  -p 54000:54000  millaguie/hblink:3.0.0

MORE DOCUMENTATION TO COME

0x49 DE N0MJS

Copyright (C) 2016-2020 Cortney T. Buffington, N0MJS n0mjs@me.com

This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 3 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with this program; if not, write to the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA