path: root/firmware/export/si4700.h
diff options
authorWolfram Sang <>2021-11-15 20:46:28 +0100
committerSolomon Peachy <>2021-11-18 16:44:21 -0500
commitde0346065b415e03efad5746ffdee99d607a0d3c (patch)
tree87397e0435d5e9dcf03af7ef81c80a777e2f6fd1 /firmware/export/si4700.h
parent701d4ba77e61984a71ddbf552193e5567be4e3af (diff)
Sansa Clip+: add RDS support
Based on a patch by Amaury Pouly which was based on a patch from Ryan Hitchman. I mainly moved the code for polling into the tuner driver so it can be reused by other targets. I added the CONFIG parameter for the polling frequency (in ticks) to save energy. Also, I did some minor cleanups. Change-Id: I95a62e7e1e42c62dbf47ecb27a3b312a42be62aa
Diffstat (limited to 'firmware/export/si4700.h')
1 files changed, 7 insertions, 1 deletions
diff --git a/firmware/export/si4700.h b/firmware/export/si4700.h
index bd75bf0817..033b435f2a 100644
--- a/firmware/export/si4700.h
+++ b/firmware/export/si4700.h
@@ -55,7 +55,13 @@ void si4700_rds_read_raw_async(unsigned char *buf, int count); /* implemented by
void si4700_rds_interrupt(void);
#endif /* (CONFIG_RDS & RDS_CFG_ISR) */
-/* Read raw RDS info for processing */
+/* Read raw RDS info for processing.
+ * - If RDS_CFG_ISR is set, the tuner driver will call si4700_rds_read_raw_async() which should
+ * perform an asynchronous read and call this function when the data has been read.
+ * - If RDS_CFG_POLL is set, this function will read status and RDS data and process it if a new
+ * packet is available.
+ * - Otherwise this function will read a RDS packet and process it under the assumption that it is
+ * new. */
void si4700_rds_process(void);
#endif /* HAVE_RDS_CAP */