Narrow Band FM (Frequency Modulation) implementation.
Firstly, the SSB patch content is not part of this library. These patches were published by Mr. Vadim Afonkin on his Dropbox repository. The author of this Si4735 Arduino Library does not encourage anyone to use the SSB patches content for commercial purposes. In other words, while this library supports SSB patches, the patches themselves should not be considered a part of this library. More...

Functions
void	SI4735::patchPowerUpNBFM ()
	This method can be used to prepare the device to apply NBFM patch.

void	SI4735::loadPatchNBFM (const uint8_t *patch_content, const uint16_t patch_content_size)
	Loads a given NBFM patch content.

void	SI4735::setNBFM ()
	Set the radio to FM function.

void	SI4735::setNBFM (uint16_t fromFreq, uint16_t toFreq, uint16_t initialFreq, uint16_t step)

void	SI4735::setFrequencyNBFM (uint16_t freq)
	Set the frequency to the corrent function of the Si4735 on NBFM mode.

Detailed Description

Narrow Band FM (Frequency Modulation) implementation.
Firstly, the SSB patch content is not part of this library. These patches were published by Mr. Vadim Afonkin on his Dropbox repository. The author of this Si4735 Arduino Library does not encourage anyone to use the SSB patches content for commercial purposes. In other words, while this library supports SSB patches, the patches themselves should not be considered a part of this library.

This implementation was not tested.

No NBFM patch was found to test this implementartion.

This implementation is applicable to Si47035-D60 and SI4732-A10 when powering up the part in FM mode with the NBFM patch

What does NBFM patch means? In this context, a patch is a piece of software used to change the behavior of the SI4735-D60/SI4732-A10 device. There is little information available about patching the SI4735-D60/SI4732-A10.

In this context, a patch is a piece of software used to change the behavior of the SI4735 device. There is little information available about patching the SI4735. The following information is the understanding of the author of this project and is not necessarily correct.

A patch is executed internally (run by internal MCU) of the device. Usually, patches are used to fix bugs or add new features over what the firmware installed in the internal ROM of the device offers. Patches for the SI4735 are distributed in binary form and are transferred to the internal RAM of the device by the host MCU (in this case, Arduino boards).

Since the RAM is volatile memory, the patch stored on the device gets lost when you turn off the system. Consequently, the content of the patch has to be transferred to the device every time the device is powered up.

I would like to thank Mr Vadim Afonkin for making available the SSBRX patches for SI4735-D60/SI4732-A10 on his Dropbox repository. On this repository you have two files, amrx_6_0_1_ssbrx_patch_full_0x9D29.csg and amrx_6_0_1_ssbrx_patch_init_0xA902.csg. It is important to know that the patch content of the original files is constant hexadecimal representation used by the language C/C++. Actally, the original files are in ASCII format (not in binary format). If you are not using C/C++ or if you want to load the files directly to the SI4735, you must convert the values to numeric value of the hexadecimal constants. For example: 0x15 = 21 (00010101); 0x16 = 22 (00010110); 0x01 = 1 (00000001); 0xFF = 255 (11111111);

ATTENTION: The author of this project cannot guarantee that procedures shown here will work in your development environment. Proceed at your own risk. This library works with the I²C communication protocol to send an SSB extension PATCH to SI4735-D60 and SI4732-A10 devices. Once again, the author disclaims any and all liability for any damage or effects this procedure may have on your devices. Proceed at your own risk.

See also: AN332 REV 0.8 UNIVERSAL PROGRAMMING GUIDE; pages 3 and 5

Function Documentation

◆ patchPowerUpNBFM()

void SI4735::patchPowerUpNBFM ( )

This method can be used to prepare the device to apply NBFM patch.

Call queryLibraryId before call this method. Powerup the device by issuing the POWER_UP command with FUNC = 0 (FM Receiver).

See also: setMaxDelaySetFrequency(); MAX_DELAY_AFTER_POWERUP; Si47XX PROGRAMMING GUIDE; AN332 (REV 1.0); pages 64 and 215-220 and; AN332 REV 0.8 UNIVERSAL PROGRAMMING GUIDE AMENDMENT FOR SI4735-D60 SSB AND NBFM PATCHES; page 32.

References SI4735::waitToSend().

Referenced by SI4735::loadPatchNBFM().

◆ loadPatchNBFM()

void SI4735::loadPatchNBFM	(	const uint8_t *	patch_content,
		const uint16_t	patch_content_size
	)

Loads a given NBFM patch content.

Configures the Si4735-D60/SI4732-A10 device to work with NBFM.

Parameters

patch_content	point to patch content array
patch_content_size	size of patch content

References SI4735::patchPowerUpNBFM(), and SI4735::queryLibraryId().

◆ setNBFM() [1/2]

void SI4735::setNBFM ( )

Set the radio to FM function.

Todo:: Adjust the power up parameters

Set the radio to NBFM function.

See also: AN332 REV 0.8 UNIVERSAL PROGRAMMING GUIDE; pages 32 and 14; setAM(), setSSB(), setFM(); setFrequencyStep(); void SI4735::setFrequency(uint16_t freq)

References SI4735::radioPowerUp().

Referenced by SI4735::setNBFM().

◆ setNBFM() [2/2]

void SI4735::setNBFM	(	uint16_t	fromFreq,
		uint16_t	toFreq,
		uint16_t	initialFreq,
		uint16_t	step
	)

Tunes the SSB (LSB or USB) receiver to a frequency between 64 and 108 MHz.

See also: AN332 REV 0.8 UNIVERSAL PROGRAMMING GUIDE;; setAM(), setFM(), setSSB(); setFrequencyStep(); void SI4735::setFrequency(uint16_t freq)

Parameters

fromFreq	minimum frequency for the band
toFreq	maximum frequency for the band
initialFreq	initial frequency
step	step used to go to the next channel

References SI4735::setNBFM().

◆ setFrequencyNBFM()

void SI4735::setFrequencyNBFM ( uint16_t freq )

Set the frequency to the corrent function of the Si4735 on NBFM mode.

You have to call setup or setPowerUp before call setFrequency.

See also: maxDelaySetFrequency(); MAX_DELAY_AFTER_SET_FREQUENCY; Si47XX PROGRAMMING GUIDE; AN332 (REV 1.0); pages 70, 135; AN332 REV 0.8 UNIVERSAL PROGRAMMING GUIDE; page 39

Parameters

uint16_t freq is the frequency to change. For example, FM => 10390 = 103.9 MHz; AM => 810 = 810 kHz.

References SI4735::waitToSend().

Functions

Detailed Description

Function Documentation

◆ patchPowerUpNBFM()

◆ loadPatchNBFM()

◆ setNBFM() [1/2]

◆ setNBFM() [2/2]

◆ setFrequencyNBFM()