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

    RadioSettingValueFloat, 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 0x2400;

struct {

  u8 period; // one out of LIST_5TONE_STANDARD_PERIODS

  u8 group_tone;

  u8 repeat_tone;

  u8 unused[13];

} _5tone_std_settings[15];

#seekto 0x2500;

struct {

  u8 frame1[5];

  u8 frame2[5];

  u8 frame3[5];

  u8 standard;   // one out of LIST_5TONE_STANDARDS

} _5tone_codes[15];

#seekto 0x25F0;

struct {

  u8 _5tone_delay1; // * 10ms

  u8 _5tone_delay2; // * 10ms

  u8 _5tone_delay3; // * 10ms

  u8 _5tone_first_digit_ext_length;

  u8 unknown1;

  u8 unknown2;

  u8 unknown3;

  u8 unknown4;

  u8 decode_standard;

  u8 unknown5:5,

     _5tone_decode_call_frame3:1,

     _5tone_decode_call_frame2:1,

     _5tone_decode_call_frame1:1;

  u8 unknown6:5,

     _5tone_decode_disp_frame3:1,

     _5tone_decode_disp_frame2:1,

     _5tone_decode_disp_frame1:1;

  u8 decode_reset_time; // * 100 + 100ms

} _5tone_settings;

#seekto 0x2900;

struct {

  u8 code[16]; // 0=x0A, A=0x0D, B=0x0E, C=0x0F, D=0x00, #=0x0C *=0x0B

} dtmf_codes[15];

#seekto 0x29F0;

struct {

  u8 dtmfspeed_on;  //list with 50..2000ms in steps of 10

  u8 dtmfspeed_off; //list with 50..2000ms in steps of 10

  u8 unknown0[14];

  u8 inspection[16];

  u8 monitor[16];

  u8 alarmcode[16];

  u8 stun[16];

  u8 kill[16];

  u8 revive[16];

  u8 unknown1[16];

  u8 unknown2[16];

  u8 unknown3[16];

  u8 unknown4[16];

  u8 unknown5[16];

  u8 unknown6[16];

  u8 unknown7[16];

  u8 masterid[16];

  u8 viceid[16];

  u8 unused01:7,

     mastervice:1;

  u8 unused02:3,

     mrevive:1,

     mkill:1,

     mstun:1,

     mmonitor:1,

     minspection:1;

  u8 unused03:3,

     vrevive:1,

     vkill:1,

     vstun:1,

     vmonitor:1,

     vinspection:1;

  u8 unused04:6,

     txdisable:1,

     rxdisable:1;

  u8 groupcode;

  u8 spacecode;

  u8 delayproctime; // * 100 + 100ms

  u8 resettime;     // * 100 + 100ms

} dtmf_settings;

#seekto 0x2D00;

struct {

  struct {

    ul16 freq1;

    u8 unused01[6];

    ul16 freq2;

    u8 unused02[6];

  } _2tone_encode[15];

  u8 duration_1st_tone; // *10ms

  u8 duration_2nd_tone; // *10ms

  u8 duration_gap;      // *10ms

  u8 unused03[13];

  struct {

    struct {

      u8 dec;      // one out of LIST_2TONE_DEC

      u8 response; // one out of LIST_2TONE_RESPONSE

      u8 alert;    // 1-16

    } decs[4];

    u8 unused04[4];

  } _2tone_decode[15];

  u8 unused05[16];

  struct {

    ul16 freqA;

    ul16 freqB;

    ul16 freqC;

    ul16 freqD;

    // unknown what those values mean, but they are

    // derived from configured frequencies

    ul16 derived_from_freqA; // 2304000/freqA

    ul16 derived_from_freqB; // 2304000/freqB

    ul16 derived_from_freqC; // 2304000/freqC

    ul16 derived_from_freqD; // 2304000/freqD

  }freqs[15];

  u8 reset_time;  // * 100 + 100ms - 100-8000ms

} _2tone;

#seekto 0x3000;

struct {

  u8 freq[8];

  char broadcast_station_name[6];

  u8 unknown[2];

} fm_radio_preset[16];

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

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_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.

# 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 = False

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

KT8900_fp5 = "M2G314"

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

# another model

KT8900R_fp4 = "M3G314"

# this radio has an extra ID

KT8900R_id = "280528"

# LUITON LT-588UV

LT588UV_fp = "V2G1F4"

# Added by rstrickoff gen 2 id

LT588UV_fp1 = "V2G214"

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

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:

        for byte in data:

            radio.pipe.write(byte)

            # Some OS (mainly Linux ones) are too fast on the serial and

            # get the MCU inside the radio stuck in the early stages, this

            # hits some models more than others.

            #

            # To cope with that we introduce a delay on the writes.

            # Many option have been tested (delaying only after error occures, after short reads, only for linux, ...)

            # Finally, a static delay was chosen as simplest of all solutions (Michael Wagner, OE4AMW)

            # (for details, see issue 3993)

            sleep(0.002)

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

        # 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