Python库 | dzcb-0.3.4.tar.gz

# dzcb **D**MR **Z**one **C**hannel **B**uilder * 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 ## [Overview Video](https://youtu.be/RfokJM5rpsM) <img src="/doc/dzcb-overview.svg"> ## See [Releases](https://github.com/mycodeplug/dzcb/releases) for Default Codeplugs ## Github Actions For more information on generating customized codeplugs in the cloud without installing any software, see **[WALKTHROUGH](./doc/WALKTHROUGH.md)**. The walkthrough uses [mycodeplug/example-codeplug](https://github.com/mycodeplug/example-codeplug) [[input files](https://github.com/mycodeplug/example-codeplug/tree/main/input/default)] # Output Formats ## Farnsworth JSON For import into [editcp](https://www.farnsworth.org/dale/codeplug/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](./codeplug/default-tyt-md380) and [MD-UV380/390](./src/dzcb/data/farnsworth). Generated JSON files will be written to the `editcp` subdir of the output directory. ## [OpenRTX/dmrconfig](https://github.com/OpenRTX/dmrconfig) For import into [`dmrconfig`](https://github.com/OpenRTX/dmrconfig) 1.1 utility with theoretical support for: * Anytone AT-D868UV * Anytone AT-D878UV * BTECH DMR-6x2 * Baofeng DM-1801 * Radioddity GD-77 * TYT MD-380 * TYT MD-390 * Zastone D900 * Zastone DP880 * Radtel RT-27D * Baofeng RD-5R * TYT MD-UV380 * TYT MD-UV390 * TYT MD-2017 * TYT MD-9600 * Retevis RT84 Use `--dmrconfig-template` to specify an exported codeplug config to use as a template for radio type, messages, DMR ID, and startup text. The `dmrconfig` subdir of the output directory will contain a dmrconfig config per template specified. ## Anytone CPS For import into the official Anytone CPS (windows-only). `dzcb` generates Channels.CSV, Talkgroups.CSV, ScanList.CSV, and Zone.CSV in the `anytone` subdir of the output directory. ### Versions Supported * **AT-D578UV** [CPS 1.11](https://cdn.shopify.com/s/files/1/0833/9095/files/D578UV_V1.11_official_release_200918.zip) * [Bridgecom Support](https://bridgecomsystems.freshdesk.com/support/solutions/articles/63000106309-anytone-578-cps-and-firmware-downloads) * **AT-D868UV** [CPS 1.39](https://cdn.shopify.com/s/files/1/0833/9095/files/D868UV_2.39_official_200807.zip) * [Bridgecom Support](https://bridgecomsystems.freshdesk.com/support/solutions/articles/63000105671-anytone-868-cps-firmware-and-driver-versions) * **AT-D878UV** [CPS 1.21](https://cdn.shopify.com/s/files/1/0833/9095/files/D878UV_V1.21_official_release_200918.zip) * [Bridgecom Support](https://bridgecomsystems.freshdesk.com/support/solutions/articles/63000105978-anytone-878-878-plus-cps-firmware-and-driver-downloads) (links fetched 2021/01/24) ## GB3GF OpenGD77 CSV For import into [GB3GF CSV tool](http://www.gb3gf.co.uk/downloads.html). Currently only supporting OpenGD77 target. Tool is "windows-only" but runs decently under wine. If `--gb3gf` is specified, the `gb3gf/opengd77` subdir of the output directory will contain 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](https://www.k7abd.net/anytone-config-builder/) and N7EKB's [cps-import-builder](https://github.com/n7ekb/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 * To specify a **Private** call, suffix the talkgroup number with a "P" * `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](http://PNWDigital.net) **Before using this network, please read the [quick start](http://www.pnwdigital.net/quick-start.html)** When building a codeplug with the `--pnwdigital` switch, data is downloaded from [PNWDigital.net/files/acb](http://www.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`](./src/dzcb/pnwdigital.py) ### [SeattleDMR](https://seattledmr.org/) **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](https://seattledmr.org/ConfigBuilder/Digital-Repeaters-Seattle-addon.csv) and cleaned up a bit in [`dzcb.seattledmr`](./src/dzcb/seattledmr.py) ### Repeaterbook Proximity Download live analog Repeaterbook data within distance of point of interest. `--repeaterbook-proximity-csv` references a csv file with the fields: * Zone Name,Lat,Long,Distance,Unit,Band(2m;1.25m;70cm),Use,Operational Status,etc See example: [`src/dzcb/data/repeaterbook_proximity_zones.csv`](/src/dzcb/data/repeaterbook_proximity_zones.csv) The fields after Band are optional and correspond directly to the field names and values in the [Repeaterbook API](https://www.repeaterbook.com/wiki/doku.php?id=api) (see examples). `--repeaterbook-state` is a space-separated list of US states or Canadian provinces that should be included in the proximity search. Including more states will increase the time required to generate the codeplug. Repeaterbook API data is downloaded and cached in a user and platform-specific cache directory. Data will be refreshed if it is older than 12 hours. When downloading from Repeaterbook, a delay of 30 seconds is introduced between requests to reduce load on the repeaterbook servers. Please respect their servers and submit changes requests to repeaterbook directly. See [`dzcb.repeaterbook`](./src/dzcb/repeaterbook.py). #### Example Format ``` Zone Name,Lat,Long,Distance,Unit,Band(2m;1.25m;70cm),Use,Operational Status Longview WA 35mi,46.13819885,-122.93800354,35,miles,2m;70cm,OPEN,On-air Longview WA VHF 35mi,46.13819885,-122.93800354,35,miles,2m,open,On-air Longview WA UHF 35mi,46.13819885,-122.93800354,35,miles,70cm,OPEN,On-Air ``` (it's easy to search on repeaterbook and copy the info from the URL!) ### Simplex, GMRS, etc Some common [Digital](./src/dzcb/data/k7abd/Digital-Others__Simplex.csv) and [Analog](./src/dzcb/data/k7abd/Analog__Simplex.csv) simplex frequencies, and [GMRS/FRS and MURS channels](./src/dzcb/data/k7abd/Analog__Unlicensed.csv) are included if `--default-k7abd` is specified. # Customization The channels, zones, and contacts present and the ordering