kopia lustrzana https://github.com/M17-Project/M17_spec
94 wiersze
2.2 KiB
ReStructuredText
94 wiersze
2.2 KiB
ReStructuredText
Recommendation for the codeplug structure
|
|
*****************************************
|
|
|
|
Introduction
|
|
############
|
|
|
|
Codeplugs are ordinary text files with *.m17* extension. They provide an information on:
|
|
|
|
* channel banks
|
|
* channel frequencies
|
|
* destination IDs
|
|
* transmission mode
|
|
* payload type
|
|
* encryption mode
|
|
|
|
Codeplugs should be human-readable and easily editable with common text editors.
|
|
|
|
Codeplug file structure
|
|
#######################
|
|
|
|
We recommend using YAML for the codeplug files.
|
|
|
|
Keywords
|
|
--------
|
|
|
|
**codeplug:**
|
|
**author:**
|
|
String - Codeplug author, max 16 characters
|
|
**version:**
|
|
Date and time in YYYY-MM-DDTHH:MM:SS format
|
|
|
|
**bank:**
|
|
**name:**
|
|
String - Channel bank name, 16 characters maximum
|
|
|
|
**channel:**
|
|
**name:**
|
|
String - Channel name, 16 characters maximum
|
|
**descr:**
|
|
String - Channel Description, 16 characters maximum
|
|
**freq_rx:**
|
|
Integer - Channel RX Frequency in Hz
|
|
**freq_tx:**
|
|
Integer - Channel TX Frequency in Hz
|
|
**mode:**
|
|
Integer - Channel mode. Valid modes are: 0 - Analog, 1 - Digital Voice, 2 - Digital Data, 3 - Digital Voice and Data
|
|
**encr:**
|
|
Integer - Is encryption enabled? 0 for no encryption, 1 - AES256, 2 - scrambler etc. (refer to M17_spec for details)
|
|
**nonce:**
|
|
String - 14-byte hex value without leading 0x. nonce for ciphers or initial LFSR value for scrambler
|
|
**gps:**
|
|
Boolean - If true, and mode value enables digital data, gps data will be transferred along with payload
|
|
|
|
Example Codeplug
|
|
################
|
|
|
|
::
|
|
|
|
codeplug:
|
|
author: SP5WWP
|
|
version: 2020-28-09T13:20:49
|
|
- bank:
|
|
name: M17
|
|
- channel:
|
|
name: M17_DMO
|
|
descr:
|
|
freq_rx: 439575000
|
|
freq_tx: 439575000
|
|
mode: 2
|
|
encr: 0
|
|
nonce: 0
|
|
gps: false
|
|
- channel:
|
|
name: M17_DMO_2
|
|
descr:
|
|
freq_rx: 439975000
|
|
freq_tx: 439975000
|
|
mode: 2
|
|
encr: 0
|
|
nonce: 0
|
|
gps: false
|
|
- bank:
|
|
name: Repeaters
|
|
- channel:
|
|
name: SR5MS
|
|
descr:
|
|
freq_rx: 439425000
|
|
freq_tx: 431825000
|
|
mode: 2
|
|
encr: 0
|
|
nonce: 0
|
|
gps: false
|
|
#codeplug end
|