CHIRP

# Quansheng UV-K5 driver (c) 2023 Jacek Lipkowski <sq5bpf@lipkowski.org>

#

# based on template.py Copyright 2012 Dan Smith <dsmith@danplanet.com>

#

#

# This is a preliminary version of a driver for the UV-K5

# It is based on my reverse engineering effort described here:

# https://github.com/sq5bpf/uvk5-reverse-engineering

#

# Warning: this driver is experimental, it may brick your radio,

# eat your lunch and mess up your configuration. Before even attempting

# to use it save a memory image from the radio using k5prog:

# https://github.com/sq5bpf/k5prog

#

#

# 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 2 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, see <http://www.gnu.org/licenses/>.

import struct

import logging

import serial  

import logging

import os

from chirp import chirp_common, directory, bitwise, memmap, errors, util

from chirp.settings import RadioSetting, RadioSettingGroup, \

        RadioSettingValueBoolean, RadioSettingValueList, \

        RadioSettingValueInteger, RadioSettingValueString, \

        RadioSettingValueFloat, RadioSettingValueMap, RadioSettings

LOG = logging.getLogger(__name__)

# Show the obfuscated version of commands. Not needed normally, but 

# might be useful for someone who is debugging a similar radio

DEBUG_SHOW_OBFUSCATED_COMMANDS=False

# Show the memory being written/received. Not needed normally, because

# this is the same information as in the packet hexdumps, but

# might be useful for someone debugging some obscure memory issue

DEBUG_SHOW_MEMORY_ACTIONS=False

DRIVER_VERSION="Quansheng UV-K5 driver v20230523 (c) Jacek Lipkowski SQ5BPF"

PRINT_CONSOLE=False

MEM_FORMAT = """

#seekto 0x0000;

struct {

  ul32 freq;

  ul32 offset;

  u8 rxcode;

  u8 txcode;

  u8 code_flag;

  u8 flags1;

  u8 flags2;

  u8 dtmf_flags;

  u8 step;

  u8 scrambler;

} channel[214];

#seekto 0x640;

ul16 fmfreq[20];

#seekto 0xe70;

u8 call_channel;

u8 squelch;

u8 max_talk_time;

u8 noaa_autoscan;

u8 unknown1;

u8 unknown2;

u8 vox_level;

u8 mic_gain;

u8 unknown3;

u8 channel_display_mode;

u8 crossband;

u8 battery_save;

u8 dual_watch;

u8 tail_note_elimination;

u8 vfo_open;

#seekto 0xe90;

u8 beep_control;

#seekto 0xe95;

u8 scan_resume_mode;

u8 auto_keypad_lock;

u8 power_on_dispmode;

u8 password[4];

#seekto 0xea0;

u8 keypad_tone;

u8 language;

#seekto 0xea8;

u8 alarm_mode;

u8 reminding_of_end_talk;

u8 repeater_tail_elimination;

#seekto 0xeb0;

char logo_line1[16];

char logo_line2[16];

#seekto 0xf40;

u8 int_flock;

u8 int_350tx;

u8 int_unknown1;

u8 int_200tx;

u8 int_500tx;

u8 int_350en;

u8 int_screen;

#seekto 0xf50;

struct {

char name[16];

} channelname[200];

"""

#flags1

FLAGS1_OFFSET=0b1

FLAGS1_ISSCANLIST=0b100

FLAGS1_ISAM=0b10000

#flags2

FLAGS2_BCLO=0b10000

FLAGS2_POWER_MASK=0b1100

FLAGS2_POWER_HIGH=0b1000

FLAGS2_POWER_MEDIUM=0b0100

FLAGS2_POWER_LOW=0b0000

FLAGS2_BANDWIDTH=0b10

FLAGS2_REVERSE=0b1

#dtmf_flags

PTTID_LIST = ["off", "BOT", "EOT", "BOTH"]

FLAGS_DTMF_PTTID_MASK=0b110 # PTTID: 00 - disabled, 01 - BOT, 10 - EOT, 11 - BOTH

FLAGS_DTMF_PTTID_DISABLED=0b000

FLAGS_DTMF_PTTID_BOT=0b010

FLAGS_DTMF_PTTID_EOT=0b100

FLAGS_DTMF_PTTID_BOTH=0b110

FLAGS_DTMF_DECODE=0b1

#power

UVK5_POWER_LEVELS = [ chirp_common.PowerLevel("Low",  watts=1.50),

                     chirp_common.PowerLevel("Med",  watts=3.00),

                     chirp_common.PowerLevel("High", watts=5.00),

                     ]

#scrambler

SCRAMBLER_LIST = [ "off", "1", "2", "3", "4", "5", "6", "7", "8", "9", "10" ]

#channel display mode

CHANNELDISP_LIST = [ "Frequency", "Channel No", "Channel Name" ]

#battery save

BATSAVE_LIST = [ "OFF", "1:1", "1:2", "1:3", "1:4" ]

#Crossband receiving/transmitting

CROSSBAND_LIST = [ "Off", "Band A", "Band B" ]

DUALWATCH_LIST= CROSSBAND_LIST

#steps

STEPS = [ 2.5, 5.0, 6.25, 10.0, 12.5, 25.0 , 8.33 ]

#ctcss/dcs codes

TMODES = ["", "Tone", "DTCS", "DTCS"]

TONE_NONE=0

TONE_CTCSS=1

TONE_DCS=2

TONE_RDCS=3

#DTCS_CODES = sorted(chirp_common.DTCS_CODES)

CTCSS_TONES = [

        67.0, 69.3, 71.9, 74.4, 77.0, 79.7, 82.5, 85.4,

        88.5, 91.5, 94.8, 97.4, 100.0, 103.5, 107.2, 110.9,

        114.8, 118.8, 123.0, 127.3, 131.8, 136.5, 141.3, 146.2,

        151.4, 156.7, 159.8, 162.2, 165.5, 167.9, 171.3, 173.8,

        177.3, 179.9, 183.5, 186.2, 189.9, 192.8, 196.6, 199.5,

        203.5, 206.5, 210.7, 218.1, 225.7, 229.1, 233.6, 241.8,

        250.3, 254.1

        ]

# lifted from ft4.py

DTCS_CODES = [ 

              23,  25,  26,  31,  32,  36,  43,  47,  51,  53,  54,

              65,  71,  72,  73,  74,  114, 115, 116, 122, 125, 131,

              132, 134, 143, 145, 152, 155, 156, 162, 165, 172, 174,

              205, 212, 223, 225, 226, 243, 244, 245, 246, 251, 252,

              255, 261, 263, 265, 266, 271, 274, 306, 311, 315, 325,

              331, 332, 343, 346, 351, 356, 364, 365, 371, 411, 412,

              413, 423, 431, 432, 445, 446, 452, 454, 455, 462, 464,

              465, 466, 503, 506, 516, 523, 526, 532, 546, 565, 606,

              612, 624, 627, 631, 632, 654, 662, 664, 703, 712, 723,

              731, 732, 734, 743, 754

              ]

FLOCK_LIST=[ "Off", "FCC", "CE", "GB", "430", "438" ]

SCANRESUME_LIST = [ "TO: Resume after 5 seconds", "CO: Resume after signal dissapears", "SE: Stop scanning after receiving a signal" ]

WELCOME_LIST = [ "Full Screen", "Welcome Info", "Voltage" ]

KEYPADTONE_LIST = [ "Off", "Chinese", "English" ]

LANGUAGE_LIST = [ "Chinese", "English" ]

ALARMMODE_LIST = [ "SITE", "TONE" ]

REMENDOFTALK_LIST = [ "Off" , "ROGER", "MDC" ]

RTE_LIST = [ "Off" , "100ms", "200ms", "300ms", "400ms", "500ms", "600ms", "700ms", "800ms", "900ms" ]

MEM_SIZE=0x2000 #size of all memory

PROG_SIZE=0x1d00 #size of the memory that we will write

MEM_BLOCK=0x80 #largest block of memory that we can reliably write

# the communication is obfuscated using this fine mechanism

def xorarr(data: bytes):

    tbl=[ 22, 108, 20, 230, 46, 145, 13, 64, 33, 53, 213, 64, 19, 3, 233, 128]

    x=b""

    r=0

    for byte in data:

        x+=bytes([byte^tbl[r]])

        r=(r+1)%len(tbl)

    return x

# if this crc was used for communication to AND from the radio, then it

# would be a measure to increase reliability.

# but it's only used towards the radio, so it's for further obfuscation

def calculate_crc16_xmodem(data: bytes):

    poly=0x1021

    crc = 0x0

    for byte in data:

        crc = crc ^ (byte << 8)

        for i in range(8):

            crc = crc << 1

            if (crc & 0x10000):

                crc = (crc ^ poly ) & 0xFFFF

    return crc & 0xFFFF

def _send_command(serial,data: bytes):

    """Send a command to UV-K5 radio"""

    LOG.debug("Sending command (unobfuscated) len=0x%4.4x:\n%s" % (len(data),util.hexprint(data)))

    crc=calculate_crc16_xmodem(data)

    data2=data+bytes([crc&0xff,(crc>>8)&0xff])

    command=b"\xAB\xCD"+bytes([len(data)])+b"\x00"+xorarr(data2)+b"\xDC\xBA"

    if DEBUG_SHOW_OBFUSCATED_COMMANDS:

        LOG.debug("Sending command (obfuscated):\n%s" % util.hexprint(command))

    serial.write(command)

def _receive_reply(serial):

    headed: bytes

    cmd: bytes

    footer: bytes

    header=serial.read(4)

    if header[0]!=0xAB or header[1]!=0xCD or header[3]!=0x00:

        LOG.warning("Bad response header: %s len=%i",(util.hexprint(header),len(header)))

        raise errors.RadioError( "Bad response header")

        return False

    cmd=serial.read(int(header[2]))

    footer=serial.read(4)

    if footer[2]!=0xDC or footer[3]!=0xBA:

        LOG.debug("Reply before bad response footer (obfuscated) len=0x%4.4x:\n%s" % (len(cmd),util.hexprint(cmd)))

        LOG.warning("Bad response footer: %s len=%i",(util.hexprint(footer),len(footer)))

        raise errors.RadioError( "Bad response footer")

        return False

    if DEBUG_SHOW_OBFUSCATED_COMMANDS:

        LOG.debug("Received reply (obfuscated) len=0x%4.4x:\n%s" % (len(cmd),util.hexprint(cmd)))

    cmd2=xorarr(cmd)

    LOG.debug("Received reply (unobfuscated) len=0x%4.4x:\n%s" % (len(cmd2),util.hexprint(cmd2)))

    return cmd2

def _getstring(data: bytes, begin, maxlen):

    s=""

    c=0

    for i in data:

        c+=1

        if c<begin:

            continue

        if i<ord(' ') or i>ord('~'):

            break

        s+=chr(i)

    return s

def _sayhello(serial):

    hellopacket=b"\x14\x05\x04\x00\x6a\x39\x57\x64"

    tries=5

    while (True):

        LOG.debug("Sending hello packet")

        _send_command(serial,hellopacket)

        o=_receive_reply(serial)

        if (o):

            break

        tries-=1

        if tries==0:

            LOG.warning("Failed to initialise radio")

            raise errors.RadioError( "Failed to initialize radio")

            return False

    firmware=_getstring(o,5,16)

    LOG.info("Found firmware: %s" % firmware)

    return firmware

def _readmem(serial,offset,length):

    LOG.debug("Sending readmem offset=0x%4.4x len=0x%4.4x" % (offset,length))

    readmem=b"\x1b\x05\x08\x00"+bytes([offset&0xff,(offset>>8)&0xff,length,0])+b"\x6a\x39\x57\x64"

    _send_command(serial,readmem)

    o=_receive_reply(serial)

    if DEBUG_SHOW_MEMORY_ACTIONS:

        LOG.debug("readmem Received data len=0x%4.4x:\n%s" % (len(o),util.hexprint(o)))

    return o[8:]

def _writemem(serial,data,offset):

    LOG.debug("Sending writemem offset=0x%4.4x len=0x%4.4x" % (offset,len(data)))

    if DEBUG_SHOW_MEMORY_ACTIONS:

        LOG.debug("writemem sent data offset=0x%4.4x len=0x%4.4x:\n%s" % (offset,len(data),util.hexprint(data)))

    dlen=len(data)

    writemem=b"\x1d\x05"+bytes([dlen+8])+b"\x00"+bytes([offset&0xff,(offset>>8)&0xff,dlen,1])+b"\x6a\x39\x57\x64"+data

    _send_command(serial,writemem)

    o=_receive_reply(serial)

    LOG.debug("writemem Received data: %s len=%i" % (util.hexprint(o),len(o)))

    if o[0]==0x1e and o[4]==(offset&0xff) and o[5]==(offset>>8)&0xff:

        return True

    else:

        LOG.warning("Bad data from writemem")

        raise errors.RadioError( "Bad response to writemem")

    return False

def _resetradio(serial):

    resetpacket=b"\xdd\x05\x00\x00"

    _send_command(serial,resetpacket)

def do_download(radio):

    serial=radio.pipe

    serial.timeout=0.5

    status = chirp_common.Status()

    status.cur = 0

    status.max = MEM_SIZE

    status.msg = "Downloading from radio"

    radio.status_fn(status)

    eeprom=b""

    f=_sayhello(serial)

    if f:

        radio.FIRMWARE_VERSION=f

    else:

        return False

    addr=0

    while addr<MEM_SIZE:

        o=_readmem(serial,addr,MEM_BLOCK)

        status.cur=addr

        radio.status_fn(status)

        if o and len(o)==MEM_BLOCK:

            eeprom+=o

            addr+=MEM_BLOCK

        else:

            raise errors.RadioError( "Memory download incomplete")

    return memmap.MemoryMapBytes(eeprom)

def do_upload(radio):

    serial=radio.pipe

    serial.timeout=0.5

    status = chirp_common.Status()

    status.cur = 0

    status.max = PROG_SIZE

    status.msg = "Uploading to radio"

    radio.status_fn(status)

    f=_sayhello(serial)

    if f:

        radio.FIRMWARE_VERSION=f

    else:

        return False

    addr=0

    while addr<PROG_SIZE:

        o = radio.get_mmap()[addr:addr+MEM_BLOCK]

        _writemem(serial,o,addr)

        status.cur=addr

        radio.status_fn(status)

        if o:

            addr+=MEM_BLOCK

        else:

            raise errors.RadioError( "Memory upload incomplete")

    status.msg = "Uploaded OK"

    _resetradio(serial)

    return True

@directory.register

class TemplateRadio(chirp_common.CloneModeRadio):

    """Quansheng UV-K5"""

    VENDOR = "Quansheng"

    MODEL = "UV-K5"

    BAUD_RATE = 38400

    NEEDS_COMPAT_SERIAL = False

    FIRMWARE_VERSION=""

    # If the user knows what he's doing, then he can expose this

    # functionality that goes against the spirit of chirp

    if os.getenv("UVK5_DATA_IN_COMMENTS"):

        COMMENT_HACK=True

    else:

        COMMENT_HACK=False

    def get_prompts(x=None):

        rp = chirp_common.RadioPrompts()

        rp.experimental = \

            ('This is an experimental driver for the Quanscheng UV-K5. '

             'It may harm your radio, or worse. Use at your own risk.\n\n'

             'Before attempting to do any changes please download'

             'the memory image from the radio with chirp or k5prog '

             'and keep it. This can be later used to recover the '

             'original settings. \n\n'

             'FM radio, DTMF settings and scanlists are not yet implemented' )

        rp.pre_download = _(

            "1. Turn radio on.\n"

            "2. Connect cable to mic/spkr connector.\n"

            "3. Make sure connector is firmly connected.\n"

            "4. Click OK to download image from device.\n\n"

            "It will may not work if you turn o the radio "

            "with the cable already attached\n")

        rp.pre_upload = _(

            "1. Turn radio on.\n"

            "2. Connect cable to mic/spkr connector.\n"

            "3. Make sure connector is firmly connected.\n"

            "4. Click OK to upload the image to device.\n\n"

            "It will may not work if you turn o the radio "

            "with the cable already attached")

        return rp

    # Return information about this radio's features, including

    # how many memories it has, what bands it supports, etc

    def get_features(self):

        rf = chirp_common.RadioFeatures()

        rf.has_bank = False

        rf.valid_dtcs_codes = DTCS_CODES

        rf.has_rx_dtcs = True

        rf.has_ctone = True

        rf.has_settings = True

        if self.COMMENT_HACK:

            rf.has_comment = True

        else:

            rf.has_comment = False

        rf.valid_name_length = 16

        rf.valid_power_levels = UVK5_POWER_LEVELS

        #hack so we can input any frequency, the 0.1 and 0.01 steps don't work unfortunately

        rf.valid_tuning_steps = [ 0.01, 0.1, 1.0 ] + STEPS 

        rf.valid_tmodes = ["", "Tone", "TSQL", "DTCS", "Cross"]

        rf.valid_cross_modes = ["Tone->Tone", "Tone->DTCS", "DTCS->Tone",

                                "->Tone", "->DTCS", "DTCS->", "DTCS->DTCS"]

        rf.valid_characters = chirp_common.CHARSET_ASCII

        rf.valid_modes = ["FM", "NFM", "AM" ]

        rf.valid_tmodes = ["", "Tone", "TSQL", "DTCS", "TSQL-R", "Cross"]

        # This radio supports memories 1-200, 201-214 are the VFO memories

        rf.memory_bounds = (1, 214) 

        # For now everything that the BK4819 chip supports

        # in the future this driver should read the service settings

        # and modify the valid_bands accordingly

        rf.valid_bands = [(18000000,  620000000), 

                          (840000000, 1300000000)

                          ]

        return rf

    # Do a download of the radio from the serial port

    def sync_in(self):

        self._mmap = do_download(self)

        self.process_mmap()

    # Do an upload of the radio to the serial port

    def sync_out(self):

        do_upload(self)

    # Convert the raw byte array into a memory object structure

    def process_mmap(self):

        self._memobj = bitwise.parse(MEM_FORMAT, self._mmap)

    # Return a raw representation of the memory object, which

    # is very helpful for development

    def get_raw_memory(self, number):

        return repr(self._memobj.channel[number-1])

    def validate_memory(self, mem):

        msgs = super().validate_memory(mem)

        return msgs

    def _set_tone(self, mem, _mem):

        ((txmode, txtone, txpol),

         (rxmode, rxtone, rxpol)) = chirp_common.split_tone_encode(mem)

        if txmode == "Tone":

            txtoval = CTCSS_TONES.index(txtone)

            txmoval = 0b01

        elif txmode == "DTCS":

            txmoval = txpol == "R" and 0b11 or 0b10

            txtoval = DTCS_CODES.index(txtone)

        else:

            txmoval=0

            txtoval = 0

        if rxmode == "Tone":

            rxtoval = CTCSS_TONES.index(rxtone)

            rxmoval = 0b01

        elif rxmode == "DTCS":

            rxmoval = rxpol == "R" and 0b11 or 0b10

            rxtoval = DTCS_CODES.index(rxtone)

        else:

            rxmoval=0

            rxtoval = 0

        _mem.code_flag = ( _mem.code_flag & 0b11001100 ) | (txmoval << 4) | rxmoval

        _mem.rxcode=rxtoval

        _mem.txcode=txtoval

    def _get_tone(self, mem, _mem):

        rxtype=_mem.code_flag&0x03

        txtype=(_mem.code_flag>>4)&0x03

        rx_tmode = TMODES[rxtype]

        tx_tmode = TMODES[txtype]

        rx_tone = tx_tone = None

        if tx_tmode == "Tone":

            if _mem.txcode<len(CTCSS_TONES):

                tx_tone = CTCSS_TONES[_mem.txcode]

            else:

                tx_tone=0

                tx_tmode = ""

        elif tx_tmode == "DTCS":

            if _mem.txcode<len(DTCS_CODES):

                tx_tone = DTCS_CODES[_mem.txcode]

            else:

                tx_tone = 0

                tx_tmode = ""

        if rx_tmode == "Tone":

            if _mem.rxcode<len(CTCSS_TONES):

                rx_tone = CTCSS_TONES[_mem.rxcode]

            else:

                rx_tone=0

                rx_tmode = ""

        elif rx_tmode == "DTCS":

            if _mem.rxcode<len(DTCS_CODES):

                rx_tone = DTCS_CODES[_mem.rxcode]

            else:

                rx_tone = 0

                rx_tmode = ""

        tx_pol = txtype == 0x03 and "R" or "N"

        rx_pol = rxtype == 0x03 and "R" or "N"

        chirp_common.split_tone_decode(mem, (tx_tmode, tx_tone, tx_pol),

                                       (rx_tmode, rx_tone, rx_pol))

    # Extract a high-level memory object from the low-level memory map

    # This is called to populate a memory in the UI

    def get_memory(self, number2):

        number=number2-1 #in the radio memories start with 0

        mem = chirp_common.Memory()

        # cutting and pasting configs from different radios might try to set channel 0

        if number2==0:

            LOG.warning("Attempt to set channel 0")

            return mem

        _mem = self._memobj.channel[number]

        tmpcomment="" 

        mem.number = number2

        if number>199:

            mem.name="VFO_"+str(number-199)

        else:

            _mem2 = self._memobj.channelname[number]

            for char in _mem2.name:

                if str(char) == "\xFF" or str(char) == "\x00":

                    break

                mem.name += str(char)

            mem.name = mem.name.rstrip()

        # Convert your low-level frequency to Hertz

        mem.freq = int(_mem.freq)*10

        mem.offset = int(_mem.offset)*10

        if (mem.offset==0):

            mem.duplex = ''

        else:

            if (_mem.flags1&FLAGS1_OFFSET):

                mem.duplex = '-'

            else:

                mem.duplex = '+'

        # tone data 

        self._get_tone(mem, _mem)

        # mode

        if (_mem.flags1 & FLAGS1_ISAM )>0 :

            # Actually not sure if internally there aren't "Narrow AM" 

            # and "Wide AM" modes. To be investigated.

            mem.mode="AM"

        else:

            if (_mem.flags2 & FLAGS2_BANDWIDTH )>0:

                mem.mode="NFM"

            else:

                mem.mode="FM"

        # tuning step

        tstep=(_mem.step>>1)&0x7

        if tstep < len(STEPS):

            mem.tuning_step = STEPS[tstep]

        else:

            mem.tuning_step = 2.5

        # power

        if (_mem.flags2 & FLAGS2_POWER_MASK ) == FLAGS2_POWER_HIGH:

            mem.power=UVK5_POWER_LEVELS[2]

        elif (_mem.flags2 & FLAGS2_POWER_MASK ) == FLAGS2_POWER_MEDIUM:

            mem.power=UVK5_POWER_LEVELS[1]

        else:

            mem.power=UVK5_POWER_LEVELS[0]

        # We'll consider any blank (i.e. 0MHz frequency) to be empty

        if (_mem.freq == 0xffffffff) or (_mem.freq == 0):

            mem.empty = True

        else:

            mem.empty = False

        mem.extra = RadioSettingGroup("Extra", "extra")

        # BCLO

        is_bclo=bool(_mem.flags2&FLAGS2_BCLO>0);

        rs = RadioSetting("bclo", "BCLO", RadioSettingValueBoolean(is_bclo))

        mem.extra.append(rs)

        tmpcomment+="BCLO:"+(is_bclo and "ON" or "off")+" "

        # Frequency reverse - whatever that means, don't see it in the manual

        is_frev=bool(_mem.flags2&FLAGS2_REVERSE>0);

        rs = RadioSetting("frev", "FreqRev", RadioSettingValueBoolean(is_frev))

        mem.extra.append(rs)

        tmpcomment+="FreqReverse:"+(is_frev and "ON" or "off")+" "

        # PTTID

        pttid=(_mem.dtmf_flags&FLAGS_DTMF_PTTID_MASK)>>1

        rs = RadioSetting("pttid", "PTTID", RadioSettingValueList(PTTID_LIST,PTTID_LIST[pttid]))

        mem.extra.append(rs)

        tmpcomment+="PTTid:"+PTTID_LIST[pttid]+" "

        # DTMF DECODE

        is_dtmf=bool(_mem.dtmf_flags&FLAGS_DTMF_DECODE>0);

        rs = RadioSetting("dtmfdecode", "DTMF decode", RadioSettingValueBoolean(is_dtmf))

        mem.extra.append(rs)

        tmpcomment+="DTMFdecode:"+(is_dtmf and "ON" or "off")+" "

        # Scrambler

        if _mem.scrambler&0x0f<len(SCRAMBLER_LIST):

            enc=_mem.scrambler&0x0f

        else:

            enc=0

        rs = RadioSetting("scrambler", "Scrambler", RadioSettingValueList(SCRAMBLER_LIST,SCRAMBLER_LIST[enc]))

        mem.extra.append(rs)

        tmpcomment+="Scrambler:"+SCRAMBLER_LIST[enc]+" "

        # Ugly hack: the extra parameters will be shown in the comments field, 

        # because there is no other way to show them without the user 

        # right-clicking every channel

        # Unfortunately this makes that field effectively read-only, so

        # it is only for those that can find it in the sources

        if self.COMMENT_HACK:

            mem.comment=tmpcomment

        return mem

    def set_settings(self, settings):

        _mem = self._memobj

        for element in settings:

            if not isinstance(element, RadioSetting):

                self.set_settings(element)

                continue

            ### basic settings

            # call channel

            if element.get_name()=="call_channel":

                _mem.call_channel=int(element.value)-1

            #squelch

            if element.get_name()=="squelch":

                _mem.squelch=int(element.value)

            #TOT

            if element.get_name()=="tot":

                _mem.max_talk_time=int(element.value)

            #NOAA autoscan

            if element.get_name()=="noaa_autoscan":

                _mem.noaa_autoscan=element.value and 1 or 0

            #vox level

            if element.get_name()=="vox_level":

                _mem.vox_level=int(element.value)-1

            #mic gain

            if element.get_name()=="mic_gain":

                _mem.mic_gain=int(element.value)

            #Channel display mode

            if element.get_name()=="channel_display_mode":

                _mem.channel_display_mode=CHANNELDISP_LIST.index(str(element.value))

            #Crossband receiving/transmitting

            if element.get_name()=="crossband":

                _mem.crossband=CROSSBAND_LIST.index(str(element.value))

            #Battery Save

            if element.get_name()=="battery_save":

                _mem.battery_save=BATSAVE_LIST.index(str(element.value))

            #Dual Watch

            if element.get_name()=="dualwatch":

                _mem.dual_watch=DUALWATCH_LIST.index(str(element.value))

            #Tail tone elimination

            if element.get_name()=="tail_note_elimination":

                _mem.tail_note_elimination=element.value and 1 or 0

            #VFO Open

            if element.get_name()=="vfo_open":

                _mem.vfo_open=element.value and 1 or 0

            #Beep control

            if element.get_name()=="beep_control":

                _mem.beep_control=element.value and 1 or 0

            #Scan resume mode

            if element.get_name()=="scan_resume_mode":

                _mem.scan_resume_mode=SCANRESUME_LIST.index(str(element.value))

            #Auto keypad lock

            if element.get_name()=="auto_keypad_lock":

                _mem.auto_keypad_lock=element.value and 1 or 0

            #Power on display mode

            if element.get_name()=="welcome_mode":

                _mem.power_on_dispmode=WELCOME_LIST.index(str(element.value))

            #Keypad Tone

            if element.get_name()=="keypad_tone":

                _mem.keypad_tone=KEYPADTONE_LIST.index(str(element.value))

            #Language

            if element.get_name()=="language":

                _mem.language=LANGUAGE_LIST.index(str(element.value))

            #Alarm mode

            if element.get_name()=="alarm_mode":

                _mem.alarm_mode=ALARMMODE_LIST.index(str(element.value))

            #Reminding of end of talk

            if element.get_name()=="reminding_of_end_talk":

                _mem.reminding_of_end_talk=REMENDOFTALK_LIST.index(str(element.value))

            #Repeater tail tone elimination

            if element.get_name()=="repeater_tail_elimination":

                _mem.repeater_tail_elimination=RTE_LIST.index(str(element.value))

            #Logo string 1

            if element.get_name()=="logo1":

                b=str(element.value).rstrip("\x20\xff\x00")+"\x00"*12

                _mem.logo_line1=b[0:12]+"\xff\xff\xff\xff"

            #Logo string 2

            if element.get_name()=="logo2":

                b=str(element.value).rstrip("\x20\xff\x00")+"\x00"*12

                _mem.logo_line2=b[0:12]+"\xff\xff\xff\xff"