akc6955.h

   1 /*
   2  * OpenI2CRADIO
   3  * RADIO CHIP AKC6955 Handler(Header)
   4  * Copyright (C) 2013-06-10 K.Ohta <whatisthis.sowhat ai gmail.com>
   5  * License: GPL2+LE
   6  *
   7  *  This program is free software; you can redistribute it and/or modify
   8  *  it under the terms of the GNU General Public License as published by
   9  *  the Free Software Foundation; either version 2,
  10  *  or (at your option) any later version.
  11  *  This library / program is distributed in the hope that it will be useful,
  12  *  but WITHOUT ANY WARRANTY; without even the implied warranty of
  13  *  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
  14  *  See the GNU General Public License for more details.
  15  *
  16  *  You should have received a copy of the GNU General Public License
  17  *  along with this library; see the file COPYING. If not, write to the
  18  *  Free Software Foundation, 51 Franklin Street, Fifth Floor, Boston,
  19  *  MA 02110-1301, USA.
  20  *
  21  *  As a special exception, if you link this(includeed from sdcc) library
  22  *  with other files, some of which are compiled with SDCC,
  23  *  to produce an executable, this library does not by itself cause
  24  *  the resulting executable to be covered by the GNU General Public License.
  25  *  This exception does not however invalidate any other reasons why
  26  *  the executable file might be covered by the GNU General Public License.
  27  */
  28
  29 #ifndef AKC6955_H
  30 #define AKC6955_H
  31
  32 #ifdef  __cplusplus
  33 extern "C" {
  34 #endif
  35
  36 #define AKC6955_ADDRESS 0x20
  37
  38 /*
  39  * Register definisions.
  40  */
  41 #define AKC6955_POWER  0
  42 #define AKC6955_BAND   1
  43 #define AKC6955_CH_HI  2
  44 #define AKC6955_CH_LO  3
  45 #define AKC6955_UCH_ST 4
  46 #define AKC6955_UCH_EN 5
  47 #define AKC6955_VOLUME 6
  48 #define AKC6955_STEREO 7
  49 #define AKC6955_THRESH 8
  50 #define AKC6955_ENABLE 9
  51 // 10 = RESERVE
  52 #define AKC6955_SPACE  11
  53 // 12 = RESERVE
  54 #define AKC6955_PRE 13
  55 // 14-19 = RESERVE
  56
  57 // Read only registers
  58 #define AKC6955_RCH_HI   20
  59 #define AKC6955_RCH_LO   21
  60 #define AKC6955_CNR_AM   22
  61 #define AKC6955_CNR_FM   23
  62 #define AKC6955_PGALEVEL 24
  63 #define AKC6955_VBAT     25
  64 #define AKC6955_FDNUM    26
  65 #define AKC6955_RSSI     27
  66
  67 /*
  68  * BAND DEFINES
  69  */
  70
  71     enum {
  72         AKC6955_BAND_LW = 0, // 150~285KHz, 3KHz order
  73         AKC6955_BAND_MW1,    // 520~1710KHz, 5KHz order
  74         AKC6955_BAND_MW2,    // 522~1620KHz, 9KHz order
  75         AKC6955_BAND_MW3,    // 520~1710KHz, 10KHz order
  76
  77         AKC6955_BAND_SW1,    // 4700~10000KHz, 5KHz order
  78         AKC6955_BAND_SW2,    // 3200~4100KHz, 5KHz order
  79         AKC6955_BAND_SW3,    // 4700~5600KHz, 5KHz order
  80         AKC6955_BAND_SW4,    // 5700~6400KHz, 5KHz order
  81
  82         AKC6955_BAND_SW5,    // 6800~7600KHz, 5KHz order
  83         AKC6955_BAND_SW6,    // 9200~10000KHz, 5KHz order
  84         AKC6955_BAND_SW7,    // 11400~12200KHz, 5KHz order
  85         AKC6955_BAND_SW8,    // 13500~14300KHz, 5KHz order
  86
  87         AKC6955_BAND_SW9,    // 15000~15900KHz, 5KHz order
  88         AKC6955_BAND_SW10,   // 17400~17900KHz, 5KHz order
  89         AKC6955_BAND_SW11,   // 18900~19700KHz, 5KHz order
  90         AKC6955_BAND_SW12,   // 21400~21900KHz, 5KHz order
  91
  92         AKC6955_BAND_SW13,   // 11400~17900KHz, 5KHz order
  93         AKC6955_BAND_AMUSER, // User Setting
  94         AKC6955_BAND_MW4,    // 520~1730KHz, 5KHz order
  95         AKC6955_BAND_AMEND
  96     };
  97
  98
  99     enum {
 100         AKC6955_BAND_FM1 = 0, // 87.0~108.0MHz
 101         AKC6955_BAND_FM2,     // 76.0~108.0MHz
 102         AKC6955_BAND_FM3,     // 70.0~93.0MHz
 103         AKC6955_BAND_FM4,     // 76.0~90.0MHz
 104         AKC6955_BAND_FM5,     // 64.0~88.0MHz
 105         AKC6955_BAND_TV1,     // 56.25~91.75MHz
 106         AKC6955_BAND_TV2,     // 174.75~222.25MHz
 107         AKC6955_BAND_FMUSER,  // User Setting
 108         AKC6955_BAND_FMEND
 109     };
 110 /*
 111  * Band defines
 112  */
 113     typedef struct {
 114     unsigned int start;
 115     unsigned int end;
 116 } banddesc;
 117 extern const banddesc ambands[AKC6955_BAND_AMEND];
 118 extern const banddesc fmbands[AKC6955_BAND_FMEND];
 119 /*
 120  * Resister definitions
 121  */
 122     typedef union{
 123         unsigned char byte;
 124         struct {
 125             unsigned power_on :1;
 126             unsigned fm_en :1;
 127             unsigned tune :1;
 128             unsigned seek :1;
 129             unsigned seekdir :1;
 130             unsigned mute :1;
 131             unsigned reserve :2;
 132         };
 133      } AKC6955_Reg0;
 134
 135 // MCU Clock = 8MHz
 136 #ifdef __SDCC
 137      // Wait 62.5ms
 138 #define _AKC6955_WAIT_62_5MS()     delay1ktcy(500)
 139 // Wait 12.5ms
 140 #define _AKC6955_WAIT_12_5MS()     delay1ktcy(100)
 141 // Wait 125.0ms
 142 #define _AKC6955_WAIT_125_0MS()     delay10ktcy(100)
 143 // Wait 50us
 144 #define _AKC6955_WAIT_12_5uS()     delay10tcy(40)
 145 #else
 146 #define _AKC6955_WAIT_62_5MS()     __delay_ms(63)
 147 // Wait 12.5ms
 148 #define _AKC6955_WAIT_12_5MS()     __delay_ms(13)
 149 // Wait 125.0ms
 150 #define _AKC6955_WAIT_125_0MS()    idle_time_ms(125)
 151 // Wait 50us
 152 #define _AKC6955_WAIT_12_5uS()     __delay_us(13)
 153 #endif
 154
 155 extern void akc6955_writecmd(unsigned char reg, unsigned char data);
 156 extern unsigned char akc6955_readcmd(unsigned char reg);
 157 extern void akc6955_chg_fm(unsigned char fm);
 158 extern unsigned char akc6955_get_fm(void);
 159
 160 extern void akc6955_set_amband(unsigned char band);
 161 extern void akc6955_set_fmband(unsigned char band);
 162
 163
 164 extern unsigned char akc6955_get_amband(void);
 165 extern unsigned char akc6955_get_fmband(void);
 166 extern void akc6955_set_power(unsigned char on);
 167 extern void akc6955_do_tune(void);
 168 extern unsigned char akc6955_tune(void);
 169
 170 extern void akc6955_mode3k(unsigned char flag);
 171 extern void akc6955_set_tune(unsigned char mode_3k, unsigned int ch);
 172 extern void akc6955_do_scan(unsigned char up);
 173 extern void akc6955_abort_scan(void);
 174 extern unsigned char akc6955_chk_donescan(void);
 175
 176 extern unsigned int akc6955_get_freq(void);
 177 extern void akc6955_set_freq(unsigned int freq);
 178 extern unsigned char akc6955_get_cnr(void);
 179 extern void akc6955_set_userband(unsigned char start, unsigned char stop, unsigned int ch, unsigned char mode3k);
 180
 181 extern int akc6955_read_level(void);
 182 extern void akc6955_up_freq(unsigned int step);
 183 extern void akc6955_down_freq(unsigned int step);
 184 extern int akc6955_get_diff(void);
 185
 186 extern void akc6955_setvolume(unsigned char level);
 187 extern void akc6955_setvolumemode(unsigned char flag);
 188 extern unsigned char akc6955_getvolumemode(void);
 189 extern unsigned char akc6955_getvolume(void);
 190 extern unsigned char akc6955_get_prevolume(void);
 191 extern void akc6955_set_prevolume(unsigned char level);
 192
 193 extern void akc6955_setphase(unsigned char flag);
 194 extern void akc6955_setline(unsigned char flag);
 195 extern void akc6955_set_stereomode(unsigned char mode);
 196 extern unsigned char akc6955_get_stereo(void);
 197 extern void akc6955_set_scanrate_fm(unsigned char rate);
 198 extern unsigned int akc6955_get_battery(void);
 199 extern void akc6955_set_lowboost(unsigned char flag);
 200
 201 #define akc6955_set_fmbandwidth(bw) { \
 202     unsigned char c = akc6955_readcmd(AKC6955_STEREO); \
 203     c = (c & 0xfc) | (bw & 0x03); \
 204     akc6955_writecmd(AKC6955_STEREO, c); \
 205 } \
 206
 207 #define akc6955_get_fmbandwidth(c) { \
 208     c = akc6955_readcmd(AKC6955_STEREO) & 0x03; \
 209 } \
 210
 211
 212
 213 #ifdef  __cplusplus
 214 }
 215 #endif
 216
 217 #endif  /* AKC6955_H */
 218