230 lines
6.0 KiB
C
230 lines
6.0 KiB
C
/*
|
|
* Auxiliary functions.
|
|
*
|
|
* Copyright (C) 2018 Serge Vakulenko, KK6ABQ
|
|
*
|
|
* Redistribution and use in source and binary forms, with or without
|
|
* modification, are permitted provided that the following conditions are met:
|
|
*
|
|
* 1. Redistributions of source code must retain the above copyright notice,
|
|
* this list of conditions and the following disclaimer.
|
|
* 2. Redistributions in binary form must reproduce the above copyright
|
|
* notice, this list of conditions and the following disclaimer in the
|
|
* documentation and/or other materials provided with the distribution.
|
|
* 3. The name of the author may not be used to endorse or promote products
|
|
* derived from this software without specific prior written permission.
|
|
*
|
|
* THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR IMPLIED
|
|
* WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF
|
|
* MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO
|
|
* EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
|
|
* SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO,
|
|
* PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS;
|
|
* OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY,
|
|
* WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR
|
|
* OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF
|
|
* ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
|
|
*/
|
|
|
|
//
|
|
// Program version.
|
|
//
|
|
extern const char version[];
|
|
extern const char *copyright;
|
|
|
|
//
|
|
// Trace data i/o via the serial port.
|
|
//
|
|
int trace_flag;
|
|
|
|
//
|
|
// Print data in hex format.
|
|
//
|
|
void print_hex(const unsigned char *data, int len);
|
|
void print_hex_addr_data(unsigned addr, const unsigned char *data, int len);
|
|
|
|
//
|
|
// Strip trailing spaces and newline.
|
|
// Shorten the string in place to a specified limit.
|
|
//
|
|
char *trim_spaces(char *line, int limit);
|
|
|
|
//
|
|
// Strip optional quotes around the string.
|
|
//
|
|
char *trim_quotes(char *line);
|
|
|
|
//
|
|
// Initialize CSV parser.
|
|
// Check header for correctness.
|
|
// Return -1 on error.
|
|
//
|
|
int csv_init(FILE *csv);
|
|
|
|
//
|
|
// Parse one line of CSV file.
|
|
// Return 1 on success, 0 on EOF.
|
|
//
|
|
int csv_read(FILE *csv, char **radioid, char **callsign, char **name,
|
|
char **city, char **state, char **country, char **remarks);
|
|
|
|
//
|
|
// DFU functions.
|
|
//
|
|
const char *dfu_init(unsigned vid, unsigned pid);
|
|
void dfu_close(void);
|
|
void dfu_erase(unsigned start, unsigned finish);
|
|
void dfu_read_block(int bno, unsigned char *data, int nbytes);
|
|
void dfu_write_block(int bno, unsigned char *data, int nbytes);
|
|
void dfu_reboot(void);
|
|
|
|
//
|
|
// HID functions.
|
|
//
|
|
int hid_init(int vid, int pid);
|
|
const char *hid_identify(void);
|
|
void hid_close(void);
|
|
void hid_send_recv(const unsigned char *data, unsigned nbytes, unsigned char *rdata, unsigned rlength);
|
|
void hid_read_block(int bno, unsigned char *data, int nbytes);
|
|
void hid_read_finish(void);
|
|
void hid_write_block(int bno, unsigned char *data, int nbytes);
|
|
void hid_write_finish(void);
|
|
|
|
//
|
|
// Serial functions.
|
|
//
|
|
int serial_init(int vid, int pid);
|
|
const char *serial_identify(void);
|
|
void serial_close(void);
|
|
void serial_read_region(int addr, unsigned char *data, int nbytes);
|
|
void serial_write_region(int addr, unsigned char *data, int nbytes);
|
|
|
|
//
|
|
// Delay in milliseconds.
|
|
//
|
|
void mdelay(unsigned msec);
|
|
|
|
//
|
|
// Check for a regular file.
|
|
//
|
|
int is_file(char *filename);
|
|
|
|
//
|
|
// Convert frequency in MHz from floating point to
|
|
// a binary coded decimal format (8 digits).
|
|
//
|
|
unsigned mhz_to_abcdefgh(double mhz);
|
|
unsigned mhz_to_ghefcdab(double mhz);
|
|
|
|
//
|
|
// Get a binary value of the parameter: On/Off,
|
|
// Ignore case.
|
|
//
|
|
int on_off(char *param, char *value);
|
|
|
|
//
|
|
// Get integer value, or "Off" as 0,
|
|
// Ignore case.
|
|
//
|
|
int atoi_off(const char *value);
|
|
|
|
//
|
|
// Copy a text string to memory image.
|
|
// Clear unused space to zero.
|
|
//
|
|
void copy_str(unsigned char *dest, const char *src, int nbytes);
|
|
|
|
//
|
|
// Find a string in a table of size nelem, ignoring case.
|
|
// Return -1 when not found.
|
|
//
|
|
int string_in_table(const char *value, const char *tab[], int nelem);
|
|
|
|
//
|
|
// Print description of the parameter.
|
|
//
|
|
void print_options(FILE *out, const char **tab, int num, const char *info);
|
|
|
|
//
|
|
// Print list of all squelch tones.
|
|
//
|
|
void print_squelch_tones(FILE *out, int normal_only);
|
|
|
|
//
|
|
// Write Unicode symbol to a file in UTF-8 encoding.
|
|
//
|
|
void putc_utf8(unsigned short ch, FILE *out);
|
|
|
|
//
|
|
// Print utf16 text as utf8.
|
|
//
|
|
void print_unicode(FILE *out, const unsigned short *text, unsigned nchars, int fill_flag);
|
|
void print_ascii(FILE *out, const unsigned char *text, unsigned nchars, int fill_flag);
|
|
|
|
//
|
|
// Fetch Unicode symbol from UTF-8 string.
|
|
// Advance string pointer.
|
|
//
|
|
int utf8_to_unicode(const char **p);
|
|
|
|
//
|
|
// Decode UTF-8 string into UCS-2 string, at most nsym characters.
|
|
//
|
|
void utf8_decode(unsigned short *dst, const char *src, unsigned nsym);
|
|
|
|
//
|
|
// Copy ASCII string, at most nsym characters.
|
|
// Replace underscore by space.
|
|
//
|
|
void ascii_decode(unsigned char *dst, const char *src, unsigned nsym, unsigned fill);
|
|
void ascii_decode_uppercase(unsigned char *dst, const char *src, unsigned nsym, unsigned fill);
|
|
|
|
//
|
|
// Get local time in format: YYYYMMDDhhmmss
|
|
//
|
|
void get_timestamp(char p[16]);
|
|
|
|
//
|
|
// Convert tone string to BCD format.
|
|
// Return -1 on error.
|
|
// Four possible formats:
|
|
// nnn.n - CTCSS frequency
|
|
// DnnnN - DCS normal
|
|
// DnnnI - DCS inverted
|
|
// '-' - Disabled
|
|
//
|
|
int encode_tone(char *str);
|
|
|
|
//
|
|
// Print frequency (BCD value).
|
|
//
|
|
void print_freq(FILE *out, unsigned data);
|
|
|
|
//
|
|
// Convert a 4-byte frequency value from binary coded decimal
|
|
// to integer format (in Hertz).
|
|
//
|
|
int freq_to_hz(unsigned bcd);
|
|
|
|
//
|
|
// Print frequency as MHz.
|
|
//
|
|
void print_mhz(FILE *out, unsigned hz);
|
|
|
|
//
|
|
// Print the transmit offset or frequency.
|
|
//
|
|
void print_offset(FILE *out, unsigned rx_bcd, unsigned tx_bcd);
|
|
|
|
//
|
|
// Compare channel index for qsort().
|
|
//
|
|
int compare_index(const void *pa, const void *pb);
|
|
int compare_index_ffff(const void *pa, const void *pb);
|
|
int compare_index_ffffffff(const void *pa, const void *pb);
|
|
|
|
//
|
|
// Print CTSS or DCS tone.
|
|
//
|
|
void print_tone(FILE *out, unsigned data);
|