rockbox/firmware/export/rds.h
Michael Sevakis fc9695eb47 Improve radio RDS driver and framework
* Remove unused bits like the radio event and simplify basic
radio interface. It can be more self-contained with rds.h only
required by radio and tuner code.

* Add post-processing to text a-la Silicon Labs AN243. The chip's
error correction can only do so much; additional checks are highly
recommended. Simply testing for two identical messages in a row
is extremely effective and I've never seen corrupted text since
doing that, even with mediocre reception.

Groups segments must arrive in order, not randomly; logic change
only accepts them in order, starting at 0.

Time readout was made a bit better but really we'd need to use
verbose mode and ensure that no errors were seen during receiving
of time and more checks would be need to have a stable PI. The
text is the important bit anyway.

* Time out of stale text.

* Text is no longer updated until a complete group has been
received, as is specified in the standard. Perhaps go back to
scrolling text lines in the radio screen?

* Add proper character conversion to UTF-8. Only the default G0
table for the moment. The other two could be added in.

* Add variants "RDS_CFG_PROCESS" and "RDS_CFG_PUSH" to allow
the option for processed RDS data to be pushed to the driver and
still do proper post-processing (only text conversion for now for
the latter).

Change-Id: I4d83f8b2e89a209a5096d15ec266477318c66925
2017-02-11 22:19:32 -05:00

62 lines
2 KiB
C

/***************************************************************************
* __________ __ ___.
* Open \______ \ ____ ____ | | _\_ |__ _______ ___
* Source | _// _ \_/ ___\| |/ /| __ \ / _ \ \/ /
* Jukebox | | ( <_> ) \___| < | \_\ ( <_> > < <
* Firmware |____|_ /\____/ \___ >__|_ \|___ /\____/__/\_ \
* \/ \/ \/ \/ \/
* $Id$
*
* Copyright (c) 2011 by Bertrik Sikken
*
* 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 software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
* KIND, either express or implied.
*
****************************************************************************/
#ifndef RDS_H
#define RDS_H
#include <stdint.h>
#include <stdbool.h>
#include "time.h"
void rds_init(void);
void rds_reset(void);
void rds_sync(void);
#if (CONFIG_RDS & RDS_CFG_PROCESS)
/* RDS raw data processing */
void rds_process(const uint16_t data[4]);
#endif /* (CONFIG_RDS & RDS_CFG_PROCESS) */
enum rds_info_id
{
RDS_INFO_NULL = 0,
RDS_INFO_CODEABLE, /* code table, right now only G0 */
RDS_INFO_PI, /* programme identifier */
RDS_INFO_PS, /* programme service name */
RDS_INFO_RT, /* radio text */
RDS_INFO_CT, /* clock time */
};
enum rds_code_table
{
RDS_CT_G0, /* default code table G0 */
RDS_CT_G1, /* alternate code table G1 */
RDS_CT_G2, /* alternate code table G2 */
};
#if (CONFIG_RDS & RDS_CFG_PUSH)
/* pushes preprocesed RDS information */
void rds_push_info(enum rds_info_id info_id, uintptr_t data, size_t size);
#endif /* (CONFIG_RDS & RDS_CFG_PUSH) */
/* read fully-processed RDS data */
size_t rds_pull_info(enum rds_info_id info_id, uintptr_t data, size_t size);
#endif /* RDS_H */