90 lines
3.1 KiB
C
90 lines
3.1 KiB
C
/**
|
|
* @file cdcchk.h
|
|
* @brief CODEC Hardware Check service.
|
|
*/
|
|
#pragma once
|
|
|
|
#include <3ds/types.h>
|
|
|
|
/// I2S line enumeration
|
|
typedef enum {
|
|
CODEC_I2S_LINE_1, ///< Primary I2S line, used by DSP/Mic (configurable)/GBA sound controller.
|
|
CODEC_I2S_LINE_2, ///< Secondary I2S line, used by CSND hardware.
|
|
} CodecI2sLine;
|
|
|
|
/// Initializes CDCCHK.
|
|
Result cdcChkInit(void);
|
|
|
|
/// Exits CDCCHK.
|
|
void cdcChkExit(void);
|
|
|
|
/**
|
|
* @brief Gets a pointer to the current cdc:CHK session handle.
|
|
* @return A pointer to the current cdc:CHK session handle.
|
|
*/
|
|
Handle *cdcChkGetSessionHandle(void);
|
|
|
|
/**
|
|
* @brief Reads multiple registers from the CODEC, using the old
|
|
* SPI hardware interface and a 4MHz baudrate.
|
|
* @param pageId CODEC Page ID.
|
|
* @param initialRegAddr Address of the CODEC register to start with.
|
|
* @param[out] outData Where to write the read data to.
|
|
* @param size Number of registers to read (bytes to read, max. 64).
|
|
*/
|
|
Result CDCCHK_ReadRegisters1(u8 pageId, u8 initialRegAddr, void *outData, size_t size);
|
|
|
|
/**
|
|
* @brief Reads multiple registers from the CODEC, using the new
|
|
* SPI hardware interface and a 16MHz baudrate.
|
|
* @param pageId CODEC Page ID.
|
|
* @param initialRegAddr Address of the CODEC register to start with.
|
|
* @param[out] outData Where to read the data to.
|
|
* @param size Number of registers to read (bytes to read, max. 64).
|
|
*/
|
|
Result CDCCHK_ReadRegisters2(u8 pageId, u8 initialRegAddr, void *outData, size_t size);
|
|
|
|
/**
|
|
* @brief Writes multiple registers to the CODEC, using the old
|
|
* SPI hardware interface and a 4MHz baudrate.
|
|
* @param pageId CODEC Page ID.
|
|
* @param initialRegAddr Address of the CODEC register to start with.
|
|
* @param data Where to read the data to write from.
|
|
* @param size Number of registers to write (bytes to read, max. 64).
|
|
*/
|
|
Result CDCCHK_WriteRegisters1(u8 pageId, u8 initialRegAddr, const void *data, size_t size);
|
|
|
|
/**
|
|
* @brief Writes multiple registers to the CODEC, using the new
|
|
* SPI hardware interface and a 16MHz baudrate.
|
|
* @param pageId CODEC Page ID.
|
|
* @param initialRegAddr Address of the CODEC register to start with.
|
|
* @param data Where to read the data to write from.
|
|
* @param size Number of registers to write (bytes to read, max. 64).
|
|
*/
|
|
Result CDCCHK_WriteRegisters2(u8 pageId, u8 initialRegAddr, const void *data, size_t size);
|
|
|
|
/**
|
|
* @brief Reads a single register from the NTR PMIC.
|
|
* @param[out] outData Where to read the data to (1 byte).
|
|
* @param regAddr Register address.
|
|
* @note The NTR PMIC is emulated by the CODEC hardware and sends
|
|
* IRQs to the MCU when relevant.
|
|
*/
|
|
Result CDCCHK_ReadNtrPmicRegister(u8 *outData, u8 regAddr);
|
|
|
|
/**
|
|
* @brief Writes a single register from the NTR PMIC.
|
|
* @param regAddr Register address.
|
|
* @param data Data to write (1 byte).
|
|
* @note The NTR PMIC is emulated by the CODEC hardware and sends
|
|
* IRQs to the MCU when relevant.
|
|
*/
|
|
Result CDCCHK_WriteNtrPmicRegister(u8 regAddr, u8 data);
|
|
|
|
/**
|
|
* @brief Sets the DAC volume level for the specified I2S line.
|
|
* @param i2sLine I2S line to set the volume for.
|
|
* @param volume Volume level (-128 to 0).
|
|
*/
|
|
Result CDCCHK_SetI2sVolume(CodecI2sLine i2sLine, s8 volume);
|