Skip to main content

dzcb

DMR Zone Channel Builder

  • Fetch - fetch input files from local directories or urls
  • Assemble - combine information from multiple sources
  • Filter - rename, exclude, reorder zones, and talkgroups
  • Format - output to common export formats

See Releases for Default Codeplugs

Github Actions

For more information on generating customized codeplugs in the cloud without installing any software, see WALKTHROUGH.

The walkthrough uses mycodeplug/example-codeplug [input files]

Output Formats

Farnsworth JSON

For import into editcp, with theoretical support for:

  • TYT
    • MD-380, MD-390
    • MD-UV380 (tested), MD-UV390
    • MD-2017,
  • Alinco DJ-MD40,
  • Retevis RT3, RT3-G, RT3S, and RT82 radios

Use --farnsworth-template-json to specify an exported codeplug to use as the template for settings and radio capabilities.

dzcb includes basic template files for MD380/390 and MD-UV380/390.

Anytone CPS

For import into the official Anytone CPS (windows-only).

dzcb generates Channels.CSV, Talkgroups.CSV, ScanList.CSV, and Zone.CSV

Versions Supported

(links fetched 2021/01/24)

GB3GF OpenGD77 CSV

For import into GB3GF CSV tool. Currently only supporting OpenGD77 target. Tool is "windows-only" but runs decently under wine.

A subdirectory gb3gf_opengd77 is created under the output directory containing the 4 CSV files used by the program:

  • Channels.csv
  • Contacts.csv
  • TG_Lists.csv
  • Zones.csv

Note: these files are actually semicolon separated.

Input Format

K7ABD style

A directory of inter-related CSV files describing the common settings needed to program all radios. This is a common format used by K7ABD's original anytone-config-builder and N7EKB's cps-import-builder.

An arbitrary number of files and folders will be combined. At this time duplicate zone names in different files may be problematic. Keep zone names unique. Particularly be wary of trucated names.

  • Analog__ZoneName.csv
    • Zone, Channel Name, Bandwidth, Power, RX Freq, TX Freq, CTCSS Decode, CTCSS Encode, TX Prohibit
  • Talkgroups__ZoneName.csv
    • No Header Row tuples of: talkgroup_name,talkgroup_number
  • Digital-Other__ZoneName.csv -- only really useful for digital simplex channels or private call
    • Zone, Channel Name, Power, RX Freq, TX Freq, Color Code, Talk Group, TimeSlot, Call Type, TX Permit
  • Digital-Repeaters__ZoneName.csv -- each line is a digital channel with static talkgroup timeslot assignments
    • Zone Name, Comment, Power, RX Freq, TX Freq, Color Code, talkgroup1, talkgroup2, talkgroup3, ...
    • Typically the Zone Name field is semicolon separated: "Longer Name;LNM"
    • The value for the talkgroup column should be "-", "1", or "2"
    • The talkgroup names must exist in the talkgroups file.
    • Some codeplug targets will create a zone for each frequency with channels for each static talkgroup.

Data Sources

PNWdigital.net

Before using this network, please read the quick start

When building a codeplug with the --pnwdigital switch, data is downloaded from PNWDigital.net/files/acb. The files are updated regularly from the cBridge, so there could be test data or repeaters that are not yet active.

The data is cached by dzcb.pnwdigital

SeattleDMR

Before using these repeaters, please read the website

When building a codeplug with the --seattledmr switch, data is downloaded from seattledmr.org/ConfigBuilder/Digital-Repeaters-Seattle-addon.csv and cleaned up a bit in dzcb.seattledmr

Repeaterbook Proximity

Repeaterbook account is required to access this endpoint

Download live analog repeaterbook data within distance of point of interest.

--repeaterbook-proximity-csv references a csv file with the fields:

  • Zone Name,Lat,Lon,Distance,Unit(m),Band(14 - 2m, 4 - 70cm)

This corresponds directly to the repeaterbook csv download "prox" http endpoint, which requires authentication. See dzcb.repeaterbook.

When using this option, be sure to set REPEATERBOOK_USER and REPEATERBOOK_PASSWD in the environment.

Example Format

Longview WA VHF 35mi,46.13819885,-122.93800354,35,m,14,
Longview WA UHF 35mi,46.13819885,-122.93800354,35,m,4,

(it's easy to search on repeaterbook and copy the info from the URL!)

Local

Information on these Western Washington standalone DMR repeaters was retrieved from Repeaterbook and respective websites in 2020 October.

Simplex, GMRS, etc

Some common Digital and Analog simplex frequencies, and GMRS/FRS and MURS channels are included if --default-k7abd is specified.

Bonus: Trim the Contact List

Download the usersDB.bin with Farnsworth editcp.

python -m dzcb.contact_trim \
    < "~/.cache/codeplug/Codeplug Editor/usersDB.bin" \
    > "~/.cache/codeplug/Codeplug Editor/usersDB-trimmed.bin"

Development Usage

Installation

pip install -e ./dzcb

Basic Usage

Download live pnwdigital and seattledmr networks and generate a codeplug in /tmp/my-codeplug with local simplex zones included.

python -m dzcb \
    --pnwdigital \
    --seattledmr \
    --default-k7abd /tmp/my-codeplug

See above and --help for more usage details.

Metadata

Release files for dzcb 0.1.3

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for dzcb 0.1.3
File Size Uploaded Provenance Actions
dzcb-0.1.3.tar.gz 2.2 MB Without provenance Details for dzcb-0.1.3.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for dzcb 0.1.3
File Interpreter ABI Platform Actions
dzcb-0.1.3-py2.py3-none-any.whl Python 3, Python 2 none any Details for dzcb-0.1.3-py2.py3-none-any.whl

Total release size: 2.2 MB

Release files / dzcb-0.1.3.tar.gz

Download URL dzcb-0.1.3.tar.gz
Size 2.2 MB
Tags Source
SHA-256 checksum
How to use checksums
e36dad96edb6b6d5e8840fd9141c55bf9229df56d7252ca23b88ffa26c937c30
BLAKE2b-256 checksum
How to use checksums
867fa502f9845cd54fcc14b2eadd83df12d9a7a5801b2a0c4608053eec51d0f8
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/3.3.0 pkginfo/1.7.0 requests/2.25.1 setuptools/49.2.1 requests-toolbelt/0.9.1 tqdm/4.56.0 CPython/3.8.6

Release files / dzcb-0.1.3-py2.py3-none-any.whl

Download URL dzcb-0.1.3-py2.py3-none-any.whl
Size 36.7 kB
Tags Python 2 Python 3
SHA-256 checksum
How to use checksums
76c8e45b15d318ff49d33ce912094d70bd7e8affe13764fc52284aca827e74d2
BLAKE2b-256 checksum
How to use checksums
394f83b34b8057d27b824461a1801852ffac09456417fc4750aef8c94885636f
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/3.3.0 pkginfo/1.7.0 requests/2.25.1 setuptools/49.2.1 requests-toolbelt/0.9.1 tqdm/4.56.0 CPython/3.8.6

Security for dzcb 0.1.3

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Release history Release notifications | RSS feed

This release

0.1.3 This release

2 release files No provenance

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page