root/drivers/media/dvb-frontends/as102_fe.c

/* [<][>][^][v][top][bottom][index][help] */

DEFINITIONS

This source file includes following definitions.
  1. as102_fe_get_code_rate
  2. as102_fe_set_frontend
  3. as102_fe_get_frontend
  4. as102_fe_get_tune_settings
  5. as102_fe_read_status
  6. as102_fe_read_snr
  7. as102_fe_read_ber
  8. as102_fe_read_signal_strength
  9. as102_fe_read_ucblocks
  10. as102_fe_ts_bus_ctrl
  11. as102_fe_release
  12. as102_attach

   1 // SPDX-License-Identifier: GPL-2.0-or-later
   2 /*
   3  * Abilis Systems Single DVB-T Receiver
   4  * Copyright (C) 2008 Pierrick Hascoet <pierrick.hascoet@abilis.com>
   5  * Copyright (C) 2010 Devin Heitmueller <dheitmueller@kernellabs.com>
   6  */
   7 
   8 #include <media/dvb_frontend.h>
   9 
  10 #include "as102_fe.h"
  11 
  12 struct as102_state {
  13         struct dvb_frontend frontend;
  14         struct as10x_demod_stats demod_stats;
  15 
  16         const struct as102_fe_ops *ops;
  17         void *priv;
  18         uint8_t elna_cfg;
  19 
  20         /* signal strength */
  21         uint16_t signal_strength;
  22         /* bit error rate */
  23         uint32_t ber;
  24 };
  25 
  26 static uint8_t as102_fe_get_code_rate(enum fe_code_rate arg)
  27 {
  28         uint8_t c;
  29 
  30         switch (arg) {
  31         case FEC_1_2:
  32                 c = CODE_RATE_1_2;
  33                 break;
  34         case FEC_2_3:
  35                 c = CODE_RATE_2_3;
  36                 break;
  37         case FEC_3_4:
  38                 c = CODE_RATE_3_4;
  39                 break;
  40         case FEC_5_6:
  41                 c = CODE_RATE_5_6;
  42                 break;
  43         case FEC_7_8:
  44                 c = CODE_RATE_7_8;
  45                 break;
  46         default:
  47                 c = CODE_RATE_UNKNOWN;
  48                 break;
  49         }
  50 
  51         return c;
  52 }
  53 
  54 static int as102_fe_set_frontend(struct dvb_frontend *fe)
  55 {
  56         struct as102_state *state = fe->demodulator_priv;
  57         struct dtv_frontend_properties *c = &fe->dtv_property_cache;
  58         struct as10x_tune_args tune_args = { 0 };
  59 
  60         /* set frequency */
  61         tune_args.freq = c->frequency / 1000;
  62 
  63         /* fix interleaving_mode */
  64         tune_args.interleaving_mode = INTLV_NATIVE;
  65 
  66         switch (c->bandwidth_hz) {
  67         case 8000000:
  68                 tune_args.bandwidth = BW_8_MHZ;
  69                 break;
  70         case 7000000:
  71                 tune_args.bandwidth = BW_7_MHZ;
  72                 break;
  73         case 6000000:
  74                 tune_args.bandwidth = BW_6_MHZ;
  75                 break;
  76         default:
  77                 tune_args.bandwidth = BW_8_MHZ;
  78         }
  79 
  80         switch (c->guard_interval) {
  81         case GUARD_INTERVAL_1_32:
  82                 tune_args.guard_interval = GUARD_INT_1_32;
  83                 break;
  84         case GUARD_INTERVAL_1_16:
  85                 tune_args.guard_interval = GUARD_INT_1_16;
  86                 break;
  87         case GUARD_INTERVAL_1_8:
  88                 tune_args.guard_interval = GUARD_INT_1_8;
  89                 break;
  90         case GUARD_INTERVAL_1_4:
  91                 tune_args.guard_interval = GUARD_INT_1_4;
  92                 break;
  93         case GUARD_INTERVAL_AUTO:
  94         default:
  95                 tune_args.guard_interval = GUARD_UNKNOWN;
  96                 break;
  97         }
  98 
  99         switch (c->modulation) {
 100         case QPSK:
 101                 tune_args.modulation = CONST_QPSK;
 102                 break;
 103         case QAM_16:
 104                 tune_args.modulation = CONST_QAM16;
 105                 break;
 106         case QAM_64:
 107                 tune_args.modulation = CONST_QAM64;
 108                 break;
 109         default:
 110                 tune_args.modulation = CONST_UNKNOWN;
 111                 break;
 112         }
 113 
 114         switch (c->transmission_mode) {
 115         case TRANSMISSION_MODE_2K:
 116                 tune_args.transmission_mode = TRANS_MODE_2K;
 117                 break;
 118         case TRANSMISSION_MODE_8K:
 119                 tune_args.transmission_mode = TRANS_MODE_8K;
 120                 break;
 121         default:
 122                 tune_args.transmission_mode = TRANS_MODE_UNKNOWN;
 123         }
 124 
 125         switch (c->hierarchy) {
 126         case HIERARCHY_NONE:
 127                 tune_args.hierarchy = HIER_NONE;
 128                 break;
 129         case HIERARCHY_1:
 130                 tune_args.hierarchy = HIER_ALPHA_1;
 131                 break;
 132         case HIERARCHY_2:
 133                 tune_args.hierarchy = HIER_ALPHA_2;
 134                 break;
 135         case HIERARCHY_4:
 136                 tune_args.hierarchy = HIER_ALPHA_4;
 137                 break;
 138         case HIERARCHY_AUTO:
 139                 tune_args.hierarchy = HIER_UNKNOWN;
 140                 break;
 141         }
 142 
 143         pr_debug("as102: tuner parameters: freq: %d  bw: 0x%02x  gi: 0x%02x\n",
 144                         c->frequency,
 145                         tune_args.bandwidth,
 146                         tune_args.guard_interval);
 147 
 148         /*
 149          * Detect a hierarchy selection
 150          * if HP/LP are both set to FEC_NONE, HP will be selected.
 151          */
 152         if ((tune_args.hierarchy != HIER_NONE) &&
 153                        ((c->code_rate_LP == FEC_NONE) ||
 154                         (c->code_rate_HP == FEC_NONE))) {
 155 
 156                 if (c->code_rate_LP == FEC_NONE) {
 157                         tune_args.hier_select = HIER_HIGH_PRIORITY;
 158                         tune_args.code_rate =
 159                            as102_fe_get_code_rate(c->code_rate_HP);
 160                 }
 161 
 162                 if (c->code_rate_HP == FEC_NONE) {
 163                         tune_args.hier_select = HIER_LOW_PRIORITY;
 164                         tune_args.code_rate =
 165                            as102_fe_get_code_rate(c->code_rate_LP);
 166                 }
 167 
 168                 pr_debug("as102: \thierarchy: 0x%02x  selected: %s  code_rate_%s: 0x%02x\n",
 169                         tune_args.hierarchy,
 170                         tune_args.hier_select == HIER_HIGH_PRIORITY ?
 171                         "HP" : "LP",
 172                         tune_args.hier_select == HIER_HIGH_PRIORITY ?
 173                         "HP" : "LP",
 174                         tune_args.code_rate);
 175         } else {
 176                 tune_args.code_rate =
 177                         as102_fe_get_code_rate(c->code_rate_HP);
 178         }
 179 
 180         /* Set frontend arguments */
 181         return state->ops->set_tune(state->priv, &tune_args);
 182 }
 183 
 184 static int as102_fe_get_frontend(struct dvb_frontend *fe,
 185                                  struct dtv_frontend_properties *c)
 186 {
 187         struct as102_state *state = fe->demodulator_priv;
 188         int ret = 0;
 189         struct as10x_tps tps = { 0 };
 190 
 191         /* send abilis command: GET_TPS */
 192         ret = state->ops->get_tps(state->priv, &tps);
 193         if (ret < 0)
 194                 return ret;
 195 
 196         /* extract constellation */
 197         switch (tps.modulation) {
 198         case CONST_QPSK:
 199                 c->modulation = QPSK;
 200                 break;
 201         case CONST_QAM16:
 202                 c->modulation = QAM_16;
 203                 break;
 204         case CONST_QAM64:
 205                 c->modulation = QAM_64;
 206                 break;
 207         }
 208 
 209         /* extract hierarchy */
 210         switch (tps.hierarchy) {
 211         case HIER_NONE:
 212                 c->hierarchy = HIERARCHY_NONE;
 213                 break;
 214         case HIER_ALPHA_1:
 215                 c->hierarchy = HIERARCHY_1;
 216                 break;
 217         case HIER_ALPHA_2:
 218                 c->hierarchy = HIERARCHY_2;
 219                 break;
 220         case HIER_ALPHA_4:
 221                 c->hierarchy = HIERARCHY_4;
 222                 break;
 223         }
 224 
 225         /* extract code rate HP */
 226         switch (tps.code_rate_HP) {
 227         case CODE_RATE_1_2:
 228                 c->code_rate_HP = FEC_1_2;
 229                 break;
 230         case CODE_RATE_2_3:
 231                 c->code_rate_HP = FEC_2_3;
 232                 break;
 233         case CODE_RATE_3_4:
 234                 c->code_rate_HP = FEC_3_4;
 235                 break;
 236         case CODE_RATE_5_6:
 237                 c->code_rate_HP = FEC_5_6;
 238                 break;
 239         case CODE_RATE_7_8:
 240                 c->code_rate_HP = FEC_7_8;
 241                 break;
 242         }
 243 
 244         /* extract code rate LP */
 245         switch (tps.code_rate_LP) {
 246         case CODE_RATE_1_2:
 247                 c->code_rate_LP = FEC_1_2;
 248                 break;
 249         case CODE_RATE_2_3:
 250                 c->code_rate_LP = FEC_2_3;
 251                 break;
 252         case CODE_RATE_3_4:
 253                 c->code_rate_LP = FEC_3_4;
 254                 break;
 255         case CODE_RATE_5_6:
 256                 c->code_rate_LP = FEC_5_6;
 257                 break;
 258         case CODE_RATE_7_8:
 259                 c->code_rate_LP = FEC_7_8;
 260                 break;
 261         }
 262 
 263         /* extract guard interval */
 264         switch (tps.guard_interval) {
 265         case GUARD_INT_1_32:
 266                 c->guard_interval = GUARD_INTERVAL_1_32;
 267                 break;
 268         case GUARD_INT_1_16:
 269                 c->guard_interval = GUARD_INTERVAL_1_16;
 270                 break;
 271         case GUARD_INT_1_8:
 272                 c->guard_interval = GUARD_INTERVAL_1_8;
 273                 break;
 274         case GUARD_INT_1_4:
 275                 c->guard_interval = GUARD_INTERVAL_1_4;
 276                 break;
 277         }
 278 
 279         /* extract transmission mode */
 280         switch (tps.transmission_mode) {
 281         case TRANS_MODE_2K:
 282                 c->transmission_mode = TRANSMISSION_MODE_2K;
 283                 break;
 284         case TRANS_MODE_8K:
 285                 c->transmission_mode = TRANSMISSION_MODE_8K;
 286                 break;
 287         }
 288 
 289         return 0;
 290 }
 291 
 292 static int as102_fe_get_tune_settings(struct dvb_frontend *fe,
 293                         struct dvb_frontend_tune_settings *settings) {
 294 
 295         settings->min_delay_ms = 1000;
 296 
 297         return 0;
 298 }
 299 
 300 static int as102_fe_read_status(struct dvb_frontend *fe, enum fe_status *status)
 301 {
 302         int ret = 0;
 303         struct as102_state *state = fe->demodulator_priv;
 304         struct as10x_tune_status tstate = { 0 };
 305 
 306         /* send abilis command: GET_TUNE_STATUS */
 307         ret = state->ops->get_status(state->priv, &tstate);
 308         if (ret < 0)
 309                 return ret;
 310 
 311         state->signal_strength  = tstate.signal_strength;
 312         state->ber  = tstate.BER;
 313 
 314         switch (tstate.tune_state) {
 315         case TUNE_STATUS_SIGNAL_DVB_OK:
 316                 *status = FE_HAS_SIGNAL | FE_HAS_CARRIER;
 317                 break;
 318         case TUNE_STATUS_STREAM_DETECTED:
 319                 *status = FE_HAS_SIGNAL | FE_HAS_CARRIER | FE_HAS_SYNC |
 320                           FE_HAS_VITERBI;
 321                 break;
 322         case TUNE_STATUS_STREAM_TUNED:
 323                 *status = FE_HAS_SIGNAL | FE_HAS_CARRIER | FE_HAS_SYNC |
 324                           FE_HAS_LOCK | FE_HAS_VITERBI;
 325                 break;
 326         default:
 327                 *status = TUNE_STATUS_NOT_TUNED;
 328         }
 329 
 330         pr_debug("as102: tuner status: 0x%02x, strength %d, per: %d, ber: %d\n",
 331                  tstate.tune_state, tstate.signal_strength,
 332                  tstate.PER, tstate.BER);
 333 
 334         if (!(*status & FE_HAS_LOCK)) {
 335                 memset(&state->demod_stats, 0, sizeof(state->demod_stats));
 336                 return 0;
 337         }
 338 
 339         ret = state->ops->get_stats(state->priv, &state->demod_stats);
 340         if (ret < 0)
 341                 memset(&state->demod_stats, 0, sizeof(state->demod_stats));
 342 
 343         return ret;
 344 }
 345 
 346 /*
 347  * Note:
 348  * - in AS102 SNR=MER
 349  *   - the SNR will be returned in linear terms, i.e. not in dB
 350  *   - the accuracy equals ±2dB for a SNR range from 4dB to 30dB
 351  *   - the accuracy is >2dB for SNR values outside this range
 352  */
 353 static int as102_fe_read_snr(struct dvb_frontend *fe, u16 *snr)
 354 {
 355         struct as102_state *state = fe->demodulator_priv;
 356 
 357         *snr = state->demod_stats.mer;
 358 
 359         return 0;
 360 }
 361 
 362 static int as102_fe_read_ber(struct dvb_frontend *fe, u32 *ber)
 363 {
 364         struct as102_state *state = fe->demodulator_priv;
 365 
 366         *ber = state->ber;
 367 
 368         return 0;
 369 }
 370 
 371 static int as102_fe_read_signal_strength(struct dvb_frontend *fe,
 372                                          u16 *strength)
 373 {
 374         struct as102_state *state = fe->demodulator_priv;
 375 
 376         *strength = (((0xffff * 400) * state->signal_strength + 41000) * 2);
 377 
 378         return 0;
 379 }
 380 
 381 static int as102_fe_read_ucblocks(struct dvb_frontend *fe, u32 *ucblocks)
 382 {
 383         struct as102_state *state = fe->demodulator_priv;
 384 
 385         if (state->demod_stats.has_started)
 386                 *ucblocks = state->demod_stats.bad_frame_count;
 387         else
 388                 *ucblocks = 0;
 389 
 390         return 0;
 391 }
 392 
 393 static int as102_fe_ts_bus_ctrl(struct dvb_frontend *fe, int acquire)
 394 {
 395         struct as102_state *state = fe->demodulator_priv;
 396 
 397         return state->ops->stream_ctrl(state->priv, acquire,
 398                                       state->elna_cfg);
 399 }
 400 
 401 static void as102_fe_release(struct dvb_frontend *fe)
 402 {
 403         struct as102_state *state = fe->demodulator_priv;
 404 
 405         kfree(state);
 406 }
 407 
 408 
 409 static const struct dvb_frontend_ops as102_fe_ops = {
 410         .delsys = { SYS_DVBT },
 411         .info = {
 412                 .name                   = "Abilis AS102 DVB-T",
 413                 .frequency_min_hz       = 174 * MHz,
 414                 .frequency_max_hz       = 862 * MHz,
 415                 .frequency_stepsize_hz  = 166667,
 416                 .caps = FE_CAN_INVERSION_AUTO
 417                         | FE_CAN_FEC_1_2 | FE_CAN_FEC_2_3 | FE_CAN_FEC_3_4
 418                         | FE_CAN_FEC_5_6 | FE_CAN_FEC_7_8 | FE_CAN_FEC_AUTO
 419                         | FE_CAN_QAM_16 | FE_CAN_QAM_64 | FE_CAN_QPSK
 420                         | FE_CAN_QAM_AUTO
 421                         | FE_CAN_TRANSMISSION_MODE_AUTO
 422                         | FE_CAN_GUARD_INTERVAL_AUTO
 423                         | FE_CAN_HIERARCHY_AUTO
 424                         | FE_CAN_RECOVER
 425                         | FE_CAN_MUTE_TS
 426         },
 427 
 428         .set_frontend           = as102_fe_set_frontend,
 429         .get_frontend           = as102_fe_get_frontend,
 430         .get_tune_settings      = as102_fe_get_tune_settings,
 431 
 432         .read_status            = as102_fe_read_status,
 433         .read_snr               = as102_fe_read_snr,
 434         .read_ber               = as102_fe_read_ber,
 435         .read_signal_strength   = as102_fe_read_signal_strength,
 436         .read_ucblocks          = as102_fe_read_ucblocks,
 437         .ts_bus_ctrl            = as102_fe_ts_bus_ctrl,
 438         .release                = as102_fe_release,
 439 };
 440 
 441 struct dvb_frontend *as102_attach(const char *name,
 442                                   const struct as102_fe_ops *ops,
 443                                   void *priv,
 444                                   uint8_t elna_cfg)
 445 {
 446         struct as102_state *state;
 447         struct dvb_frontend *fe;
 448 
 449         state = kzalloc(sizeof(*state), GFP_KERNEL);
 450         if (!state)
 451                 return NULL;
 452 
 453         fe = &state->frontend;
 454         fe->demodulator_priv = state;
 455         state->ops = ops;
 456         state->priv = priv;
 457         state->elna_cfg = elna_cfg;
 458 
 459         /* init frontend callback ops */
 460         memcpy(&fe->ops, &as102_fe_ops, sizeof(struct dvb_frontend_ops));
 461         strscpy(fe->ops.info.name, name, sizeof(fe->ops.info.name));
 462 
 463         return fe;
 464 
 465 }
 466 EXPORT_SYMBOL_GPL(as102_attach);
 467 
 468 MODULE_DESCRIPTION("as102-fe");
 469 MODULE_LICENSE("GPL");
 470 MODULE_AUTHOR("Pierrick Hascoet <pierrick.hascoet@abilis.com>");

/* [<][>][^][v][top][bottom][index][help] */