Portapack应用开发教程 （十六） Debug程序 D si5351芯片和iic实现

前面一篇文章把portapack板子上的两颗iic的声卡芯片讲完了，接下来我想不要直接去看hackrf板子上的spi总线的芯片，而是讲另一个芯片si5351。

这颗si5351芯片是时钟芯片（由800MHz分频提供40MHz 50MHz 及采样时钟），它是iic接口，但是它是在hackrf板子上的。相当于是portapack板子上的iic声卡芯片与hackrf板子上的spi芯片之间的过渡。

代码位置在/firmware/application/hw/si5351.cpp和si5351.hpp

先观察si5351.hpp

#include "i2c_pp.hpp"

class Si5351 {

	constexpr Si5351(I2C& bus, I2C::address_t address) :
		_clock_control({
			ClockControl::power_off(), ClockControl::power_off(),
			ClockControl::power_off(), ClockControl::power_off(),
			ClockControl::power_off(), ClockControl::power_off(),
			ClockControl::power_off(), ClockControl::power_off()
		}),
		_bus(bus),
		_address(address),
		_output_enable(0x00)
	{
	}

}

上面是我摘录的类声明和构建函数，从参数里的I2C和I2C::address_t可以看出，显然这个芯片还是在用iic接口，这和声卡芯片是一样的，只是address值不同。 

这个address与声卡芯片类似是在firmware/application/portapack.cpp里指定的并做了初始化的。

si5351::Si5351 clock_generator {
	i2c0, hackrf::one::si5351_i2c_address
};

具体值又从hackrf_hal.hpp里获取得到，是0x60。

constexpr uint8_t si5351_i2c_address = 0x60;

si5351.cpp里的reset函数有点像声卡芯片的init函数，在做各种配置。但是有些是调用write函数有些是write_register函数，没法完全看清楚。

而且cpp文件里没有write的函数的实现，只有read_register函数：

Si5351::regvalue_t Si5351::read_register(const uint8_t reg) {
	const std::array<uint8_t, 1> tx { reg };
	std::array<uint8_t, 1> rx { 0x00 };
	_bus.transmit(_address, tx.data(), tx.size());
	_bus.receive(_address, rx.data(), rx.size());
	return rx[0];
}

可以看到这个芯片的读寄存器函数的实现和ak声卡芯片是一样的。所以写入函数区别应该也不会太大。

然后看看si5351.hpp文件，它里面有4个跟write有关的函数。

	template<size_t N>
	void write(const std::array<uint8_t, N>& values) {
		_bus.transmit(_address, values.data(), values.size());
	}

	void write_register(const uint8_t reg, const regvalue_t value) {
		write(std::array<uint8_t, 2>{
			reg, value
		});
	}

	void write(const size_t ms_number, const MultisynthFractional& config) {
		write(config.reg(ms_number));
	}

	template<size_t N>
	void write_registers(const uint8_t reg, const std::array<uint8_t, N>& values) {
		std::array<uint8_t, N + 1> data;
		data[0] = reg;
		std::copy(values.cbegin(), values.cend(), data.begin() + 1);
		write(data);
	}

 

si5351.cpp的reset里所调用的write和write_register函数是第一行第二行的两个函数。

write_register也在调用第一行的write，相当于把要写入的寄存器地址和值一起打包进了一个array里，然后write函数直接把这个array经由bus.transmit函数发送出去。

write_registers函数也是类似的，它的区别只是对于一个寄存器地址，要写入一连串的值。实现方法是array里的第0个元素存入地址，后续元素都是那一连串的值，然后打包给write函数，再从bus.transmit发出去。

至于第三行的write函数，还没看明白，也没见哪里在用。

我找过了跟MultisynthFractional有关的cpp文件里的set_ms_frequency函数，最下方的write传入的参数是MultisynthFractional.reg，根据hpp文件里的定义，其类型也是std::array<uint8_t, 9>

所以调用的还是第一行的write函数，而不是第三行的write。

接下来看看这个芯片所调用的iic具体是怎样实现的。

在/firmware/common/下，打开i2c_pp.cpp和i2c_pp.hpp，可以看到主要实现代码在cpp里实现的

bool I2C::transfer(
	const address_t slave_address,
	const uint8_t* const data_tx, const size_t count_tx,
	uint8_t* const data_rx, const size_t count_rx,
	systime_t timeout
) {
	i2cAcquireBus(_driver);
	const msg_t status = i2cMasterTransmitTimeout(
		_driver, slave_address, data_tx, count_tx, data_rx, count_rx, timeout
	);
	i2cReleaseBus(_driver);
	return (status == RDY_OK);
}

bool I2C::receive(
	const address_t slave_address,
	uint8_t* const data, const size_t count,
	systime_t timeout
) {
	i2cAcquireBus(_driver);
	const msg_t status = i2cMasterReceiveTimeout(
		_driver, slave_address, data, count, timeout
	);
	i2cReleaseBus(_driver);
	return (status == RDY_OK);
}

bool I2C::transmit(
	const address_t slave_address,
	const uint8_t* const data, const size_t count,
	systime_t timeout
) {
	return transfer(slave_address, data, count, NULL, 0, timeout);
}

这是芯片驱动所要调用的receive和transmit函数的具体实现，都是在调用i2cAcquireBus i2cReleaseBus i2cMasterReceiveTimeout i2cMasterTransmitTimeout