CHIRP

# Copyright 2016:

# * 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

LOG = logging.getLogger(__name__)

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, \

    RadioSettings, InvalidValueError

from textwrap import dedent

MEM_FORMAT = """

#seekto 0x0000;

struct {

  lbcd rxfreq[4];

  lbcd txfreq[4];

  ul16 rxtone;

  ul16 txtone;

  u8 unknown0:4,

     scode:4;

  u8 unknown1:2,

     spmute:1,

     unknown2:3,

     optsig:2;

  u8 unknown3:3,

     scramble:1,

     unknown4:3,

     power:1;

  u8 unknown5:1,

     wide:1,

     unknown6:2,

     bcl:1,

     add:1,

     pttid:2;

} memory[200];

#seekto 0x0E00;

struct {

  u8 tdr;

  u8 unknown1;

  u8 sql;

  u8 unknown2[2];

  u8 tot;

  u8 apo;           // BTech radios use this as the Auto Power Off time

                    // other radios use this as pre-Time Out Alert

  u8 unknown3;

  u8 abr;

  u8 beep;

  u8 unknown4[4];

  u8 dtmfst;

  u8 unknown5[2];

  u8 prisc;

  u8 prich;

  u8 screv;

  u8 unknown6[2];

  u8 pttid;

  u8 pttlt;

  u8 unknown7;

  u8 emctp;

  u8 emcch;

  u8 ringt;

  u8 unknown8;

  u8 camdf;

  u8 cbmdf;

  u8 sync;          // BTech radios use this as the display sync setting

                    // other radios use this as the auto keypad lock setting

  u8 ponmsg;

  u8 wtled;

  u8 rxled;

  u8 txled;

  u8 unknown9[5];

  u8 anil;

  u8 reps;

  u8 repm;

  u8 tdrab;

  u8 ste;

  u8 rpste;

  u8 rptdl;

  u8 mgain;

  u8 dtmfg;

} settings;

#seekto 0x0E80;

struct {

  u8 unknown1;

  u8 vfomr;

  u8 keylock;

  u8 unknown2;

  u8 unknown3:4,

     vfomren:1,

     unknown4:1,

     reseten:1,

     menuen:1;

  u8 unknown5[11];

  u8 dispab;

  u8 mrcha;

  u8 mrchb;

  u8 menu;

} settings2;

#seekto 0x0EC0;

struct {

  char line1[6];

  char line2[6];

} poweron_msg;

struct settings_vfo {

  u8 freq[8];

  u8 unknown1;

  u8 offset[4];

  u8 unknown2[3];

  ul16 rxtone;

  ul16 txtone;

  u8 scode;

  u8 spmute;

  u8 optsig;

  u8 scramble;

  u8 wide;

  u8 power;

  u8 shiftd;

  u8 step;

  u8 unknown3[4];

};

#seekto 0x0F00;

struct {

  struct settings_vfo a;

  struct settings_vfo b;

} vfo;

#seekto 0x1000;

struct {

  char name[6];

  u8 unknown1[10];

} names[200];

#seekto 0x3C90;

struct {

  u8 vhf_low[3];

  u8 vhf_high[3];

  u8 uhf_low[3];

  u8 uhf_high[3];

} ranges;

// the UV-2501+220 & KT8900R has different zones for storing ranges

#seekto 0x3CD0;

struct {

  u8 vhf_low[3];

  u8 vhf_high[3];

  u8 unknown1[4];

  u8 unknown2[6];

  u8 vhf2_low[3];

  u8 vhf2_high[3];

  u8 unknown3[4];

  u8 unknown4[6];

  u8 uhf_low[3];

  u8 uhf_high[3];

} ranges220;

#seekto 0x3F70;

struct {

  char fp[6];

} fingerprint;

"""

# 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])

NAME_LENGTH = 6

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"]

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

LIST_AB = ["A", "B"]

LIST_VFOMR = ["Frequency", "Channel"]

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

LIST_TXP = ["High", "Low"]

LIST_WIDE = ["Wide", "Narrow"]

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

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

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

# Practice has show that about 0.7 sec will be enough to cover all radios.

STIMEOUT = 0.7

# 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

# Power Levels

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

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

UV5001_POWER_LEVELS = [chirp_common.PowerLevel("High", watts=50),

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

# this must be defined globaly

POWER_LEVELS = None

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

VALID_CHARS = chirp_common.CHARSET_ALPHANUMERIC + \

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

##### 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"

# extra block read for the 2501+220 pre-production units

# the same for all of this radios so far

UV2501_220pp_id = "      280528"

# 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"

# 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"

# this radio has an extra ID

KT8900_id = "      303688"

# KT8900R

KT8900R_fp = "M3G1F4"

# Second Generation

KT8900R_fp1 = "M3G214"

# another model

KT8900R_fp2 = "M3C234"

# another model G4?

KT8900R_fp3 = "M39164"

# this radio has an extra ID

KT8900R_id = "280528"

# LUITON LT-588UV

LT588UV_fp = "V2G1F4"

#### 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"

NEEDS_DELAY = False

RETRY_DELAYED = False

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))

            global NEEDS_DELAY

            NEEDS_DELAY = True

            LOG.debug("Delaying future writes")

    except:

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

    return data

def _send(radio, data):

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

    try:

        for byte in data:

            radio.pipe.write(byte)

            # linux is to fast in the serial, causing the radio send a \x05

            # byte and stop responding, we need to slow it down a bit.

            # Thanks to Michael Wagner for this fix.

            # we have not noticed any problem in MAC (YET)

            #if sys.platform.startswith ('linux'):

            #LOG.debug(NEEDS_DELAY)

            if NEEDS_DELAY:

                # 10 msec is proved to be safe.

                sleep(0.005)

                LOG.debug("delayed")

        # 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.error("Invalid header for block 0x%04x" % addr)

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

        #retry once

        global RETRY_DELAYED

        if RETRY_DELAYED:

            LOG.debug("This was already a retry")

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

        else:

            LOG.warn("Failure occured. Trying once again with delay")

            RETRY_DELAYED = True

            global NEEDS_DELAY

            NEEDS_DELAY = True

            return False

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

    # return the data

    return block[5:]

def _start_clone_mode(radio, status):

    """Put the radio in clone mode and get the ident string, 3 tries"""

    # cleaning the serial buffer

    _clean_buffer(radio)

    # prep the data to show in the UI

    status.cur = 0

    status.msg = "Identifying the radio..."

    status.max = 3

    radio.status_fn(status)

    try:

        for a in range(0, status.max):

            # Update the UI

            status.cur = a + 1

            radio.status_fn(status)

            # send the magic word

            _send(radio, radio._magic)

            # Now you get a x06 of ACK if all goes well

            ack = radio.pipe.read(1)

            if ack == "\x06":

                # DEBUG

                LOG.info("Magic ACK received")

                status.cur = status.max

                radio.status_fn(status)

                return True

        return False

    except errors.RadioError:

        raise

    except Exception, e:

        raise errors.RadioError("Error sending Magic to radio:\n%s" % e)

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"

    # open the radio into program mode

    if _start_clone_mode(radio, status) is False:

        msg = "Radio did not enter clone mode"

        # warning about old versions of QYT KT8900

        if radio.MODEL == "KT8900":

            msg += ". You may want to try it as a WACCOM MINI-8900, there is a"

            msg += " known variant of this radios that is a clone of it."

        raise errors.RadioError(msg)

    # Ok, get the ident string

    ident = _rawrecv(radio, 49)

    # basic check for the ident

    if len(ident) != 49:

        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.")

    # some radios needs a extra read and check for a code on it, this ones

    # has the check value in the _id2 var, others simply False

    if radio._id2 is not False:

        # lower the timeout here as this radios are reseting due to timeout

        radio.pipe.timeout = 0.05

        # query & receive the extra ID

        _send(radio, _make_frame("S", 0x3DF0, 16))

        id2 = _rawrecv(radio, 21)

        # WARNING !!!!!!

        # different radios send a response with a different amount of data

        # it seems that it's padded with \xff, \x20 and some times with \x00

        # we just care about the first 16, our magic string is in there

        if len(id2) < 16:

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

        # ok, the correct string must be in the received data

        if radio._id2 not in id2:

            LOG.debug("Full *BAD* extra ID on the %s is: \n%s" %

                      (radio.MODEL, util.hexprint(id2)))

            raise errors.RadioError("The extra ID is wrong, 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")

            # restore the default serial timeout

            radio.pipe.timeout = STIMEOUT

    # 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)

    # the models that doesn't have the extra ID have to make a dummy read here

    if radio._id2 is False:

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

        discard = _rawrecv(radio, BLOCK_SIZE + 5)

        if debug is True:

            LOG.info("Dummy first block read done, got this:\n\n %s",

                     util.hexprint(discard))

    # 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)

    # cleaning the serial buffer

    _clean_buffer(radio)

    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)

        if d == False:

            LOG.info("Previous _recv failed. Cleaning buffer and trying again.")

            _clean_buffer(radio)

            d = _recv(radio, addr)

            global RETRY_DELAYED

            RETRY_DELAYED = False

        # 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 = 0x3100

    # 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 radios that doesn't have the extra ID 'may' do a dummy write, I found

    # that leveraging the bad ACK and NOT doing the dummy write is ok, as the

    # dummy write is accepted (it actually writes to the mem!) by the radio.

    # cleaning the serial buffer

    _clean_buffer(radio)

    # 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 and radio._id2 is not False:

            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 not ack 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 False

class BTech(chirp_common.CloneModeRadio, chirp_common.ExperimentalRadio):

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

    VENDOR = "BTECH"

    MODEL = ""

    IDENT = ""

    _vhf_range = (130000000, 180000000)

    _220_range = (210000000, 231000000)

    _uhf_range = (400000000, 521000000)

    _upper = 199

    _magic = MSTRING

    _fileid = None

    _id2 = False

    btech3 = 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 = 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.memory_bounds = (0, self._upper)

        # power levels

        if self.MODEL == "UV-5001":

            POWER_LEVELS = UV5001_POWER_LEVELS  # Higher power (50W)

        else:

            POWER_LEVELS = NORMAL_POWER_LEVELS  # Lower power (25W)

        rf.valid_power_levels = POWER_LEVELS

        # bands

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

        # 2501+220 & KT8900R

        if self.MODEL in ["UV-2501+220", "KT8900R"]:

            rf.valid_bands.append(self._220_range)

        return rf

    def sync_in(self):

        """Download from radio"""

        try:

            data = _download(self)

            LOG.info("Download succeeded for the first attempt!")

        except errors.RadioError:

            LOG.error("First download-attempt failed. Retrying whole procedure delayed")

            global NEEDS_DELAY

            NEEDS_DELAY = True

            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 set_options(self):

        """This is to read the options from the image and set it in the

        environment, for now just the limits of the freqs in the VHF/UHF

        ranges"""

        # setting the correct ranges for each radio type

        if self.MODEL in ["UV-2501+220", "KT8900R"]:

            # the model 2501+220 has a segment in 220

            # and a different position in the memmap

            # also the QYT KT8900R

            ranges = self._memobj.ranges220

        else:

            ranges = self._memobj.ranges

        # the normal dual bands

        vhf = _decode_ranges(ranges.vhf_low, ranges.vhf_high)

        uhf = _decode_ranges(ranges.uhf_low, ranges.uhf_high)

        # DEBUG

        LOG.info("Radio ranges: VHF %d to %d" % vhf)

        LOG.info("Radio ranges: UHF %d to %d" % uhf)

        # 220Mhz radios case

        if self.MODEL in ["UV-2501+220", "KT8900R"]:

            vhf2 = _decode_ranges(ranges.vhf2_low, ranges.vhf2_high)

            LOG.info("Radio ranges: VHF(220) %d to %d" % vhf2)

            self._220_range = vhf2

        # set the class with the real data

        self._vhf_range = vhf

        self._uhf_range = uhf

    def process_mmap(self):

        """Process the mem map into the mem object"""

        # Get it

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

        # load specific parameters from the radio image

        self.set_options()

    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):