CHIRP

# Copyright 2016-2022:

# * Pavel Milanes CO7WT, <pavelmc@gmail.com>

# * Jim Unroe KC9HI, <rock.unroe@gmail.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 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 time

import struct

import logging

from time import sleep

from chirp import chirp_common, directory, memmap

from chirp import bitwise, errors, util

from chirp.settings import RadioSettingGroup, RadioSetting, \

    RadioSettingValueBoolean, RadioSettingValueList, \

    RadioSettingValueString, RadioSettingValueInteger, \

    RadioSettingValueFloat, RadioSettings, InvalidValueError

from textwrap import dedent

LOG = logging.getLogger(__name__)

# A note about the memmory in these radios

#

# The real memory of these radios extends to 0x4000

# On read the factory software only uses up to 0x3200

# On write it just uploads the contents up to 0x3100

#

# The mem beyond 0x3200 holds the ID data

MEM_SIZE = 0x4000

BLOCK_SIZE = 0x40

TX_BLOCK_SIZE = 0x10

ACK_CMD = "\x06"

MODES = ["FM", "NFM"]

SKIP_VALUES = ["S", ""]

TONES = chirp_common.TONES

DTCS = sorted(chirp_common.DTCS_CODES + [645])

# lists related to "extra" settings

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

PTTIDCODE_LIST = ["%s" % x for x in range(1, 16)]

OPTSIG_LIST = ["OFF", "DTMF", "2TONE", "5TONE"]

SPMUTE_LIST = ["Tone/DTCS", "Tone/DTCS and Optsig", "Tone/DTCS or Optsig"]

# lists

LIST_AB = ["A", "B"]

LIST_ABCD = LIST_AB + ["C", "D"]

LIST_ANIL = ["3", "4", "5"]

LIST_APO = ["Off"] + ["%s minutes" % x for x in range(30, 330, 30)]

LIST_COLOR4 = ["Off", "Blue", "Orange", "Purple"]

LIST_COLOR8 = ["White", "Red", "Blue", "Green", "Yellow", "Indego",

               "Purple", "Gray"]

LIST_COLOR9 = ["Black"] + LIST_COLOR8

LIST_DTMFST = ["OFF", "Keyboard", "ANI", "Keyboad + ANI"]

LIST_EMCTP = ["TX alarm sound", "TX ANI", "Both"]

LIST_EMCTPX = ["Off"] + LIST_EMCTP

LIST_LANGUA = ["English", "Chinese"]

LIST_MDF = ["Frequency", "Channel", "Name"]

LIST_OFF1TO9 = ["Off"] + ["%s seconds" % x for x in range(1, 10)]

LIST_OFF1TO10 = ["Off"] + ["%s seconds" % x for x in range(1, 11)]

LIST_OFF1TO50 = ["Off"] + ["%s seconds" % x for x in range(1, 51)]

LIST_PONMSG = ["Full", "Message", "Battery voltage"]

LIST_REPM = ["Off", "Carrier", "CTCSS or DCS", "Tone", "DTMF"]

LIST_REPS = ["1000 Hz", "1450 Hz", "1750 Hz", "2100Hz"]

LIST_RPTDL = ["Off"] + ["%s ms" % x for x in range(1, 11)]

LIST_SCMODE = ["Off", "PTT-SC", "MEM-SC", "PON-SC"]

LIST_SHIFT = ["Off", "+", "-"]

LIST_SKIPTX = ["Off", "Skip 1", "Skip 2"]

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

LIST_STEP = [str(x) for x in STEPS]

LIST_SYNC = ["Off", "AB", "CD", "AB+CD"]

# the first 12 TMR choices common to all color display mobile radios

LIST_TMR12 = ["OFF", "M+A", "M+B", "M+C", "M+D", "M+A+B", "M+A+C", "M+A+D",

              "M+B+C", "M+B+D", "M+C+D", "M+A+B+C"]

# the 16 choice list for color display mobile radios that correctly implement

# the full 16 TMR choices

LIST_TMR16 = LIST_TMR12 + ["M+A+B+D", "M+A+C+D", "M+B+C+D", "A+B+C+D"]

# the 15 choice list for color mobile radios that are missing the M+A+B+D

# choice in the TMR menu

LIST_TMR15 = LIST_TMR12 + ["M+A+C+D", "M+B+C+D", "A+B+C+D"]

LIST_TMRTX = ["Track", "Fixed"]

LIST_TOT = ["%s sec" % x for x in range(15, 615, 15)]

LIST_TXDISP = ["Power", "Mic Volume"]

LIST_TXP = ["High", "Low"]

LIST_TXP3 = ["High", "Mid", "Low"]

LIST_SCREV = ["TO (timeout)", "CO (carrier operated)", "SE (search)"]

LIST_VFOMR = ["Frequency", "Channel"]

LIST_VOICE = ["Off"] + LIST_LANGUA

LIST_VOX = ["Off"] + ["%s" % x for x in range(1, 11)]

LIST_VOXT = ["%s seconds" % x for x in range(0, 21)]

LIST_WIDE = ["Wide", "Narrow"]

# lists related to DTMF, 2TONE and 5TONE settings

LIST_5TONE_STANDARDS = ["CCIR1", "CCIR2", "PCCIR", "ZVEI1", "ZVEI2", "ZVEI3",

                        "PZVEI", "DZVEI", "PDZVEI", "EEA", "EIA", "EURO",

                        "CCITT", "NATEL", "MODAT", "none"]

LIST_5TONE_STANDARDS_without_none = ["CCIR1", "CCIR2", "PCCIR", "ZVEI1",

                                     "ZVEI2", "ZVEI3",

                                     "PZVEI", "DZVEI", "PDZVEI", "EEA", "EIA",

                                     "EURO", "CCITT", "NATEL", "MODAT"]

LIST_5TONE_STANDARD_PERIODS = ["20", "30", "40", "50", "60", "70", "80", "90",

                               "100", "110", "120", "130", "140", "150", "160",

                               "170", "180", "190", "200"]

LIST_5TONE_DIGITS = ["0", "1", "2", "3", "4", "5", "6", "7", "8", "9", "A",

                     "B", "C", "D", "E", "F"]

LIST_5TONE_DELAY = ["%s ms" % x for x in range(0, 1010, 10)]

LIST_5TONE_RESET = ["%s ms" % x for x in range(100, 8100, 100)]

LIST_5TONE_RESET_COLOR = ["%s ms" % x for x in range(100, 20100, 100)]

LIST_DTMF_SPEED = ["%s ms" % x for x in range(50, 2010, 10)]

LIST_DTMF_DIGITS = ["0", "1", "2", "3", "4", "5", "6", "7", "8", "9", "A", "B",

                    "C", "D", "#", "*"]

LIST_DTMF_VALUES = [0x0A, 0x01, 0x02, 0x03, 0x04, 0x05, 0x06, 0x07, 0x08, 0x09,

                    0x0D, 0x0E, 0x0F, 0x00, 0x0C, 0x0B]

LIST_DTMF_SPECIAL_DIGITS = ["*", "#", "A", "B", "C", "D"]

LIST_DTMF_SPECIAL_VALUES = [0x0B, 0x0C, 0x0D, 0x0E, 0x0F, 0x00]

LIST_DTMF_DELAY = ["%s ms" % x for x in range(100, 4100, 100)]

CHARSET_DTMF_DIGITS = "0123456789AaBbCcDd#*"

LIST_2TONE_DEC = ["A-B", "A-C", "A-D",

                  "B-A", "B-C", "B-D",

                  "C-A", "C-B", "C-D",

                  "D-A", "D-B", "D-C"]

LIST_2TONE_RESPONSE = ["None", "Alert", "Transpond", "Alert+Transpond"]

# This is a general serial timeout for all serial read functions.

STIMEOUT = 0.25

# this var controls the verbosity in the debug and by default it's low (False)

# make it True and you will to get a very verbose debug.log

debug = True  ##False

# valid chars on the LCD, Note that " " (space) is stored as "\xFF"

VALID_CHARS = chirp_common.CHARSET_ALPHANUMERIC + \

    "`{|}!\"#$%&'()*+,-./:;<=>?@[]^_"

GMRS_FREQS1 = [462.5625, 462.5875, 462.6125, 462.6375, 462.6625,

               462.6875, 462.7125]

GMRS_FREQS2 = [467.5625, 467.5875, 467.6125, 467.6375, 467.6625,

               467.6875, 467.7125]

GMRS_FREQS3 = [462.5500, 462.5750, 462.6000, 462.6250, 462.6500,

               462.6750, 462.7000, 462.7250]

GMRS_FREQS = GMRS_FREQS1 + GMRS_FREQS2 + GMRS_FREQS3 * 2

# #### ID strings #####################################################

# BTECH UV2501 pre-production units

UV2501pp_fp = "M2C294"

# BTECH UV2501 pre-production units 2 + and 1st Gen radios

UV2501pp2_fp = "M29204"

# B-TECH UV-2501 second generation (2G) radios

UV2501G2_fp = "BTG214"

# B-TECH UV-2501 third generation (3G) radios

UV2501G3_fp = "BTG324"

# B-TECH UV-2501+220 pre-production units

UV2501_220pp_fp = "M3C281"

# B-TECH UV-2501+220

UV2501_220_fp = "M3G201"

# new variant, let's call it Generation 2

UV2501_220G2_fp = "BTG211"

# B-TECH UV-2501+220 third generation (3G)

UV2501_220G3_fp = "BTG311"

# B-TECH UV-5001 pre-production units + 1st Gen radios

UV5001pp_fp = "V19204"

# B-TECH UV-5001 alpha units

UV5001alpha_fp = "V28204"

# B-TECH UV-5001 second generation (2G) radios

UV5001G2_fp = "BTG214"

# B-TECH UV-5001 second generation (2G2)

UV5001G22_fp = "V2G204"

# B-TECH UV-5001 third generation (3G)

UV5001G3_fp = "BTG304"

# B-TECH UV-25X2

UV25X2_fp = "UC2012"

# B-TECH UV-25X4

UV25X4_fp = "UC4014"

# B-TECH UV-50X2

UV50X2_fp = "UC2M12"

# B-TECH GMRS-50X1

GMRS50X1_fp = "NC1802"

GMRS50X1_fp1 = "NC1932"

# special var to know when we found a BTECH Gen 3

BTECH3 = [UV2501G3_fp, UV2501_220G3_fp, UV5001G3_fp]

# WACCOM Mini-8900

MINI8900_fp = "M28854"

# QYT KT-UV980

KTUV980_fp = "H28854"

# QYT KT8900

KT8900_fp = "M29154"

# New generations KT8900

KT8900_fp1 = "M2C234"

KT8900_fp2 = "M2G1F4"

KT8900_fp3 = "M2G2F4"

KT8900_fp4 = "M2G304"

KT8900_fp5 = "M2G314"

KT8900_fp6 = "M2G424"

KT8900_fp7 = "M27184"

# KT8900R

KT8900R_fp = "M3G1F4"

# Second Generation

KT8900R_fp1 = "M3G214"

# another model

KT8900R_fp2 = "M3C234"

# another model G4?

KT8900R_fp3 = "M39164"

# another model

KT8900R_fp4 = "M3G314"

# AC3MB: another id

KT8900R_fp5 = "M3B064"

# KT7900D (quad band)

KT7900D_fp = "VC4004"

KT7900D_fp1 = "VC4284"

KT7900D_fp2 = "VC4264"

KT7900D_fp3 = "VC4114"

KT7900D_fp4 = "VC4104"

KT7900D_fp5 = "VC4254"

KT7900D_fp6 = "VC5264"

KT7900D_fp7 = "VC9204"

# QB25 (quad band) - a clone of KT7900D

QB25_fp = "QB-25"

# KT8900D (dual band)

KT8900D_fp = "VC2002"

KT8900D_fp1 = "VC8632"

KT8900D_fp2 = "VC3402"

KT8900D_fp3 = "VC7062"

# LUITON LT-588UV

LT588UV_fp = "V2G1F4"

# Added by rstrickoff gen 2 id

LT588UV_fp1 = "V2G214"

# QYT KT-8R (quad band ht)

KT8R_fp = "MCB264"

KT8R_fp1 = "MCB284"

KT8R_fp2 = "MC5264"

# QYT KT5800 (dual band)

KT5800_fp = "VCB222"

# QYT KT980Plus (dual band)

KT980PLUS_fp = "VC2002"

KT980PLUS_fp1 = "VC6042"

# Radioddity DB25-G (gmrs)

DB25G_fp = "VC6182"

DB25G_fp1 = "VC7062"

# ### MAGICS

# for the Waccom Mini-8900

MSTRING_MINI8900 = "\x55\xA5\xB5\x45\x55\x45\x4d\x02"

# for the B-TECH UV-2501+220 (including pre production ones)

MSTRING_220 = "\x55\x20\x15\x12\x12\x01\x4d\x02"

# for the QYT KT8900 & R

MSTRING_KT8900 = "\x55\x20\x15\x09\x16\x45\x4D\x02"

MSTRING_KT8900R = "\x55\x20\x15\x09\x25\x01\x4D\x02"

# magic string for all other models

MSTRING = "\x55\x20\x15\x09\x20\x45\x4d\x02"

# for the QYT KT7900D & KT8900D

MSTRING_KT8900D = "\x55\x20\x16\x08\x01\xFF\xDC\x02"

# for the BTECH UV-25X2 and UV-50X2

MSTRING_UV25X2 = "\x55\x20\x16\x12\x28\xFF\xDC\x02"

# for the BTECH UV-25X4

MSTRING_UV25X4 = "\x55\x20\x16\x11\x18\xFF\xDC\x02"

# for the BTECH GMRS-50X1

MSTRING_GMRS50X1 = "\x55\x20\x18\x10\x18\xFF\xDC\x02"

# for the QYT KT-8R

MSTRING_KT8R = "\x55\x20\x17\x07\x03\xFF\xDC\x02"

def _clean_buffer(radio):

    """Cleaning the read serial buffer, hard timeout to survive an infinite

    data stream"""

    # touching the serial timeout to optimize the flushing

    # restored at the end to the default value

    radio.pipe.timeout = 0.1

    dump = "1"

    datacount = 0

    try:

        while len(dump) > 0:

            dump = radio.pipe.read(100)

            datacount += len(dump)

            # hard limit to survive a infinite serial data stream

            # 5 times bigger than a normal rx block (69 bytes)

            if datacount > 345:

                seriale = "Please check your serial port selection."

                raise errors.RadioError(seriale)

        # restore the default serial timeout

        radio.pipe.timeout = STIMEOUT

    except Exception:

        raise errors.RadioError("Unknown error cleaning the serial buffer")

def _rawrecv(radio, amount):

    """Raw read from the radio device, less intensive way"""

    data = ""

    try:

        data = radio.pipe.read(amount)

        # DEBUG

        if debug is True:

            LOG.debug("<== (%d) bytes:\n\n%s" %

                      (len(data), util.hexprint(data)))

        # fail if no data is received

        if len(data) == 0:

            raise errors.RadioError("No data received from radio")

        # notice on the logs if short

        if len(data) < amount:

            LOG.warn("Short reading %d bytes from the %d requested." %

                     (len(data), amount))

    except:

        raise errors.RadioError("Error reading data from radio")

    return data

def _send(radio, data):

    """Send data to the radio device"""

    try:

        radio.pipe.write(data)

        # DEBUG

        if debug is True:

            LOG.debug("==> (%d) bytes:\n\n%s" %

                      (len(data), util.hexprint(data)))

    except:

        raise errors.RadioError("Error sending data to radio")

def _make_frame(cmd, addr, length, data=""):

    """Pack the info in the headder format"""

    frame = "\x06" + struct.pack(">BHB", ord(cmd), addr, length)

    # add the data if set

    if len(data) != 0:

        frame += data

    return frame

def _recv(radio, addr):

    """Get data from the radio all at once to lower syscalls load"""

    # Get the full 69 bytes at a time to reduce load

    # 1 byte ACK + 4 bytes header + 64 bytes of data (BLOCK_SIZE)

    # get the whole block

    block = _rawrecv(radio, BLOCK_SIZE + 5)

    # basic check

    if len(block) < (BLOCK_SIZE + 5):

        raise errors.RadioError("Short read of the block 0x%04x" % addr)

    # checking for the ack

    if block[0] != ACK_CMD:

        raise errors.RadioError("Bad ack from radio in block 0x%04x" % addr)

    # header validation

    c, a, l = struct.unpack(">BHB", block[1:5])

    if a != addr or l != BLOCK_SIZE or c != ord("X"):

        LOG.debug("Invalid header for block 0x%04x" % addr)

        LOG.debug("CMD: %s  ADDR: %04x  SIZE: %02x" % (c, a, l))

        raise errors.RadioError("Invalid header for block 0x%04x:" % addr)

    # return the data

    return block[5:]

def _do_ident(radio, status, upload=False):

    """Put the radio in PROGRAM mode & identify it"""

    #  set the serial discipline

    radio.pipe.baudrate = 9600

    radio.pipe.parity = "N"

    # lengthen the timeout here as these radios are reseting due to timeout

    radio.pipe.timeout = 0.75

    # send the magic word

    _send(radio, radio._magic)

    # Now you get a 50 byte reply if all goes well

    ident = _rawrecv(radio, 50)

    # checking for the ack

    if ident[0] != ACK_CMD:

        raise errors.RadioError("Bad ack from radio")

    # basic check for the ident block

    if len(ident) != 50:

        raise errors.RadioError("Radio send a short ident block.")

    # check if ident is OK

    itis = False

    for fp in radio._fileid:

        if fp in ident:

            # got it!

            itis = True

            # checking if we are dealing with a Gen 3 BTECH

            if radio.VENDOR == "BTECH" and fp in BTECH3:

                radio.btech3 = True

            break

    if itis is False:

        LOG.debug("Incorrect model ID, got this:\n\n" + util.hexprint(ident))

        raise errors.RadioError("Radio identification failed.")

    # pause here for the radio to catch up

    sleep(0.1)

    # the OEM software reads this additional block, so we will, too

    # Get the full 21 bytes at a time to reduce load

    # 1 byte ACK + 4 bytes header + 16 bytes of data (BLOCK_SIZE)

    frame = _make_frame("S", 0x3DF0, 16)

    _send(radio, frame)

    id2 = _rawrecv(radio, 21)

    # restore the default serial timeout

    radio.pipe.timeout = STIMEOUT

    # checking for the ack

    if id2[0] not in "\x06\x05":

        raise errors.RadioError("Bad ack from radio")

    # basic check for the additional block

    if len(id2) < 21:

        raise errors.RadioError("The extra ID is short, aborting.")

    # this radios need a extra request/answer here on the upload

    # the amount of data received depends of the radio type

    #

    # also the first block of TX must no have the ACK at the beginning

    # see _upload for this.

    if upload is True:

        # send an ACK

        _send(radio, ACK_CMD)

        # the amount of data depend on the radio, so far we have two radios

        # reading two bytes with an ACK at the end and just ONE with just

        # one byte (QYT KT8900)

        # the JT-6188 appears a clone of the last, but reads TWO bytes.

        #

        # we will read two bytes with a custom timeout to not penalize the

        # users for this.

        #

        # we just check for a response and last byte being a ACK, that is

        # the common stone for all radios (3 so far)

        ack = _rawrecv(radio, 2)

        # checking

        if len(ack) == 0 or ack[-1:] != ACK_CMD:

            raise errors.RadioError("Radio didn't ACK the upload")

    # DEBUG

    LOG.info("Positive ident, this is a %s %s" % (radio.VENDOR, radio.MODEL))

    return True

def _download(radio):

    """Get the memory map"""

    # UI progress

    status = chirp_common.Status()

    # put radio in program mode and identify it

    _do_ident(radio, status)

    # reset the progress bar in the UI

    status.max = MEM_SIZE / BLOCK_SIZE

    status.msg = "Cloning from radio..."

    status.cur = 0

    radio.status_fn(status)

    data = ""

    for addr in range(0, MEM_SIZE, BLOCK_SIZE):

        # sending the read request

        _send(radio, _make_frame("S", addr, BLOCK_SIZE))

        # read

        d = _recv(radio, addr)

        # aggregate the data

        data += d

        # UI Update

        status.cur = addr / BLOCK_SIZE

        status.msg = "Cloning from radio..."

        radio.status_fn(status)

    return data

def _upload(radio):

    """Upload procedure"""

    # The UPLOAD mem is restricted to lower than 0x3100,

    # so we will overide that here localy

    MEM_SIZE = radio.UPLOAD_MEM_SIZE

    # UI progress

    status = chirp_common.Status()

    # put radio in program mode and identify it

    _do_ident(radio, status, True)

    # get the data to upload to radio

    data = radio.get_mmap()

    # Reset the UI progress

    status.max = MEM_SIZE / TX_BLOCK_SIZE

    status.cur = 0

    status.msg = "Cloning to radio..."

    radio.status_fn(status)

    # the fun start here

    for addr in range(0, MEM_SIZE, TX_BLOCK_SIZE):

        # getting the block of data to send

        d = data[addr:addr + TX_BLOCK_SIZE]

        # build the frame to send

        frame = _make_frame("X", addr, TX_BLOCK_SIZE, d)

        # first block must not send the ACK at the beginning for the

        # ones that has the extra id, since this have to do a extra step

        if addr == 0:

            frame = frame[1:]

        # send the frame

        _send(radio, frame)

        # receiving the response

        ack = _rawrecv(radio, 1)

        # basic check

        if len(ack) != 1:

            raise errors.RadioError("No ACK when writing block 0x%04x" % addr)

        if ack not in "\x06\x05":

            raise errors.RadioError("Bad ACK writing block 0x%04x:" % addr)

        # UI Update

        status.cur = addr / TX_BLOCK_SIZE

        status.msg = "Cloning to radio..."

        radio.status_fn(status)

def model_match(cls, data):

    """Match the opened/downloaded image to the correct version"""

    rid = data[0x3f70:0x3f76]

    if rid in cls._fileid:

        return True

    return False

def _decode_ranges(low, high):

    """Unpack the data in the ranges zones in the memmap and return

    a tuple with the integer corresponding to the Mhz it means"""

    ilow = int(low[0]) * 100 + int(low[1]) * 10 + int(low[2])

    ihigh = int(high[0]) * 100 + int(high[1]) * 10 + int(high[2])

    ilow *= 1000000

    ihigh *= 1000000

    return (ilow, ihigh)

def _split(rf, f1, f2):

    """Returns False if the two freqs are in the same band (no split)

    or True otherwise"""

    # determine if the two freqs are in the same band

    for low, high in rf.valid_bands:

        if f1 >= low and f1 <= high and \

                f2 >= low and f2 <= high:

            # if the two freqs are on the same Band this is not a split

            return False

    # if you get here is because the freq pairs are split

    return True

class BTechMobileCommon(chirp_common.CloneModeRadio,

                        chirp_common.ExperimentalRadio):

    """BTECH's UV-5001 and alike radios"""

    VENDOR = "BTECH"

    MODEL = ""

    IDENT = ""

    BANDS = 2

    COLOR_LCD = False

    COLOR_LCD2 = False

    COLOR_LCD3 = False

    NAME_LENGTH = 6

    UPLOAD_MEM_SIZE = 0X3100

    _power_levels = [chirp_common.PowerLevel("High", watts=25),

                     chirp_common.PowerLevel("Low", watts=10)]

    _vhf_range = (130000000, 180000000)

    _220_range = (200000000, 271000000)

    _uhf_range = (400000000, 521000000)

    _350_range = (350000000, 391000000)

    _upper = 199

    _magic = MSTRING

    _fileid = None

    _id2 = False

    btech3 = False

    _gmrs = False

    @classmethod

    def get_prompts(cls):

        rp = chirp_common.RadioPrompts()

        rp.experimental = \

            ('This driver is experimental.\n'

             '\n'

             'Please keep a copy of your memories with the original software '

             'if you treasure them, this driver is new and may contain'

             ' bugs.\n'

             '\n'

             )

        rp.pre_download = _(dedent("""\

            Follow these instructions to download your info:

            1 - Turn off your radio

            2 - Connect your interface cable

            3 - Turn on your radio

            4 - Do the download of your radio data

            """))

        rp.pre_upload = _(dedent("""\

            Follow these instructions to upload your info:

            1 - Turn off your radio

            2 - Connect your interface cable

            3 - Turn on your radio

            4 - Do the upload of your radio data

            """))

        return rp

    def get_features(self):

        """Get the radio's features"""

        # we will use the following var as global

        global POWER_LEVELS

        rf = chirp_common.RadioFeatures()

        rf.has_settings = True

        rf.has_bank = False

        rf.has_tuning_step = False

        rf.can_odd_split = True

        rf.has_name = True

        rf.has_offset = True

        rf.has_mode = True

        rf.has_dtcs = True

        rf.has_rx_dtcs = True

        rf.has_dtcs_polarity = True

        rf.has_ctone = True

        rf.has_cross = True

        rf.valid_modes = MODES

        rf.valid_characters = VALID_CHARS

        rf.valid_name_length = self.NAME_LENGTH

        rf.valid_duplexes = ["", "-", "+", "split", "off"]

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

        rf.valid_cross_modes = [

            "Tone->Tone",

            "DTCS->",

            "->DTCS",

            "Tone->DTCS",

            "DTCS->Tone",

            "->Tone",

            "DTCS->DTCS"]

        rf.valid_skips = SKIP_VALUES

        rf.valid_dtcs_codes = DTCS

        rf.valid_tuning_steps = STEPS

        rf.memory_bounds = (0, self._upper)

        # power levels

        POWER_LEVELS = self._power_levels

        rf.valid_power_levels = POWER_LEVELS

        # normal dual bands

        rf.valid_bands = [self._vhf_range, self._uhf_range]

        # 220 band

        if self.BANDS == 3 or self.BANDS == 4:

            rf.valid_bands.append(self._220_range)

        # 350 band

        if self.BANDS == 4:

            rf.valid_bands.append(self._350_range)

        return rf

    def validate_memory(self, mem):

        msgs = chirp_common.CloneModeRadio.validate_memory(self, mem)

        _msg_duplex1 = 'Memory location only supports "Low"'

        _msg_duplex2 = 'Memory location only supports "off"'

        _msg_duplex3 = 'Memory location only supports "(None)", "+" or "off"'

        if self._gmrs:

            if mem.number < 1 or mem.number > 30:

                if float(mem.freq) / 1000000 in GMRS_FREQS1:

                    if mem.duplex not in ['', 'off']:

                        # warn user wrong Duplex

                        msgs.append(chirp_common.ValidationError(_msg_duplex2))

                    if mem.power != self._power_levels[2]:

                        # warn user wrong Duplex

                        msgs.append(chirp_common.ValidationError(_msg_duplex1))

                if float(mem.freq) / 1000000 in GMRS_FREQS2:

                    if mem.duplex not in ['off', ]:

                        # warn user wrong Duplex

                        msgs.append(chirp_common.ValidationError(_msg_duplex2))

                if float(mem.freq) / 1000000 in GMRS_FREQS3:

                    if mem.duplex not in ['', '+', 'off']:

                        # warn user wrong Duplex

                        msgs.append(chirp_common.ValidationError(_msg_duplex3))

        return msgs

    def sync_in(self):

        """Download from radio"""

        data = _download(self)

        self._mmap = memmap.MemoryMap(data)

        self.process_mmap()

    def sync_out(self):

        """Upload to radio"""

        try:

            _upload(self)

        except errors.RadioError:

            raise

        except Exception, e:

            raise errors.RadioError("Error: %s" % e)

    def get_raw_memory(self, number):

        return repr(self._memobj.memory[number])

    def _decode_tone(self, val):

        """Parse the tone data to decode from mem, it returns:

        Mode (''|DTCS|Tone), Value (None|###), Polarity (None,N,R)"""

        pol = None

        if val in [0, 65535]:

            return '', None, None

        elif val > 0x0258:

            a = val / 10.0

            return 'Tone', a, pol

        else:

            if val > 0x69:

                index = val - 0x6A

                pol = "R"

            else:

                index = val - 1

                pol = "N"

            tone = DTCS[index]

            return 'DTCS', tone, pol

    def _encode_tone(self, memval, mode, val, pol):

        """Parse the tone data to encode from UI to mem"""

        if mode == '' or mode is None:

            memval.set_raw("\x00\x00")

        elif mode == 'Tone':

            memval.set_value(val * 10)

        elif mode == 'DTCS':

            # detect the index in the DTCS list

            try:

                index = DTCS.index(val)

                if pol == "N":

                    index += 1

                else:

                    index += 0x6A

                memval.set_value(index)

            except:

                msg = "Digital Tone '%d' is not supported" % value

                LOG.error(msg)

                raise errors.RadioError(msg)

        else:

            msg = "Internal error: invalid mode '%s'" % mode

            LOG.error(msg)

            raise errors.InvalidDataError(msg)

    def get_memory(self, number):

        """Get the mem representation from the radio image"""

        _mem = self._memobj.memory[number]

        _names = self._memobj.names[number]

        # Create a high-level memory object to return to the UI

        mem = chirp_common.Memory()

        # Memory number

        mem.number = number

        if _mem.get_raw()[0] == "\xFF":

            mem.empty = True

            return mem

        # Freq and offset

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

        # tx freq can be blank

        if _mem.get_raw()[4] == "\xFF":

            # TX freq not set

            mem.offset = 0

            mem.duplex = "off"

        else:

            # TX freq set

            offset = (int(_mem.txfreq) * 10) - mem.freq

            if offset != 0:

                if _split(self.get_features(), mem.freq, int(

                          _mem.txfreq) * 10):

                    mem.duplex = "split"

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

                elif offset < 0:

                    mem.offset = abs(offset)

                    mem.duplex = "-"

                elif offset > 0:

                    mem.offset = offset

                    mem.duplex = "+"

            else:

                mem.offset = 0

        # name TAG of the channel

        mem.name = str(_names.name).rstrip("\xFF").replace("\xFF", " ")

        # power