Adds support for the ES8311 codec on the ESP32-S2-Kaluga-1 board. This commit also adds basic configurations for testing and updates the board documentation.
192 lines
6.2 KiB
C
192 lines
6.2 KiB
C
/****************************************************************************
|
|
* boards/xtensa/esp32s2/esp32s2-kaluga-1/src/esp32s2-kaluga-1.h
|
|
*
|
|
* Licensed to the Apache Software Foundation (ASF) under one or more
|
|
* contributor license agreements. See the NOTICE file distributed with
|
|
* this work for additional information regarding copyright ownership. The
|
|
* ASF licenses this file to you under the Apache License, Version 2.0 (the
|
|
* "License"); you may not use this file except in compliance with the
|
|
* License. You may obtain a copy of the License at
|
|
*
|
|
* http://www.apache.org/licenses/LICENSE-2.0
|
|
*
|
|
* Unless required by applicable law or agreed to in writing, software
|
|
* distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
|
|
* WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the
|
|
* License for the specific language governing permissions and limitations
|
|
* under the License.
|
|
*
|
|
****************************************************************************/
|
|
|
|
#ifndef __BOARDS_XTENSA_ESP32S2_ESP32S2_KALUGA_1_SRC_ESP32S2_KALUGA_1_H
|
|
#define __BOARDS_XTENSA_ESP32S2_ESP32S2_KALUGA_1_SRC_ESP32S2_KALUGA_1_H
|
|
|
|
/****************************************************************************
|
|
* Included Files
|
|
****************************************************************************/
|
|
|
|
#include <nuttx/config.h>
|
|
#include <nuttx/compiler.h>
|
|
|
|
#include <stdint.h>
|
|
|
|
/****************************************************************************
|
|
* Pre-processor Definitions
|
|
****************************************************************************/
|
|
|
|
/* ESP32S2-Kaluga-1 GPIOs ***************************************************/
|
|
|
|
/* Audio Amplifier */
|
|
|
|
#define SPEAKER_ENABLE_GPIO 10
|
|
|
|
/* Buttons */
|
|
|
|
#define BUTTON_BOOT 0
|
|
#define TP_PHOTO_CHANNEL 6
|
|
#define TP_PLAY_CHANNEL 2
|
|
#define TP_RECORD_CHANNEL 5
|
|
#define TP_NETWORK_CHANNEL 11
|
|
#define TP_VOLUP_CHANNEL 1
|
|
#define TP_VOLDN_CHANNEL 3
|
|
|
|
/* TIMERS */
|
|
|
|
#define TIMER0 0
|
|
#define TIMER1 1
|
|
#define TIMER2 2
|
|
#define TIMER3 3
|
|
|
|
/* ONESHOT */
|
|
|
|
#define ONESHOT_TIMER TIMER0
|
|
#define ONESHOT_RESOLUTION_US 1
|
|
|
|
/****************************************************************************
|
|
* Public Types
|
|
****************************************************************************/
|
|
|
|
/****************************************************************************
|
|
* Public Data
|
|
****************************************************************************/
|
|
|
|
#ifndef __ASSEMBLY__
|
|
|
|
/****************************************************************************
|
|
* Public Function Prototypes
|
|
****************************************************************************/
|
|
|
|
/****************************************************************************
|
|
* Name: esp32s2_bringup
|
|
*
|
|
* Description:
|
|
* Perform architecture-specific initialization
|
|
*
|
|
* CONFIG_BOARD_LATE_INITIALIZE=y :
|
|
* Called from board_late_initialize().
|
|
*
|
|
* CONFIG_BOARD_LATE_INITIALIZE=y && CONFIG_BOARDCTL=y :
|
|
* Called from the NSH library via board_app_initialize()
|
|
*
|
|
****************************************************************************/
|
|
|
|
int esp32s2_bringup(void);
|
|
|
|
/****************************************************************************
|
|
* Name: esp32s2_gpio_init
|
|
*
|
|
* Description:
|
|
* Configure the GPIO driver.
|
|
*
|
|
* Returned Value:
|
|
* Zero (OK) is returned on success; A negated errno value is returned
|
|
* to indicate the nature of any failure.
|
|
*
|
|
****************************************************************************/
|
|
|
|
#ifdef CONFIG_DEV_GPIO
|
|
int esp32s2_gpio_init(void);
|
|
#endif
|
|
|
|
/****************************************************************************
|
|
* Name: board_oneshot_init
|
|
*
|
|
* Description:
|
|
* Configure the oneshot timer driver.
|
|
*
|
|
* Input Parameters:
|
|
* timer - Timer instance to be used as oneshot timer.
|
|
* resolution - Oneshot timer resolution.
|
|
*
|
|
* Returned Value:
|
|
* Zero (OK) is returned on success; A negated errno value is returned
|
|
* to indicate the nature of any failure.
|
|
*
|
|
****************************************************************************/
|
|
|
|
#ifdef CONFIG_ONESHOT
|
|
int board_oneshot_init(int timer, uint16_t resolution);
|
|
#endif
|
|
|
|
/****************************************************************************
|
|
* Name: board_i2c_init
|
|
*
|
|
* Description:
|
|
* Configure the I2C driver.
|
|
*
|
|
* Returned Value:
|
|
* Zero (OK) is returned on success; A negated errno value is returned
|
|
* to indicate the nature of any failure.
|
|
*
|
|
****************************************************************************/
|
|
|
|
#ifdef CONFIG_I2C_DRIVER
|
|
int board_i2c_init(void);
|
|
#endif
|
|
|
|
/****************************************************************************
|
|
* Name: board_i2sdev_initialize
|
|
*
|
|
* Description:
|
|
* This function is called by platform-specific, setup logic to configure
|
|
* and register the generic I2S audio driver. This function will register
|
|
* the driver as /dev/audio/pcm[x] where x is determined by the I2S port
|
|
* number.
|
|
*
|
|
* Input Parameters:
|
|
* None.
|
|
*
|
|
* Returned Value:
|
|
* Zero is returned on success. Otherwise, a negated errno value is
|
|
* returned to indicate the nature of the failure.
|
|
*
|
|
****************************************************************************/
|
|
|
|
#if defined(CONFIG_ESP32S2_I2S) && !defined(CONFIG_AUDIO_ES8311)
|
|
int board_i2sdev_initialize(void);
|
|
#endif
|
|
|
|
/****************************************************************************
|
|
* Name: esp32s2_es8311_initialize
|
|
*
|
|
* Description:
|
|
* This function is called by platform-specific, setup logic to configure
|
|
* and register the ES8311 device. This function will register the driver
|
|
* as /dev/audio/pcm[x] where x is determined by the I2S port number.
|
|
*
|
|
* Input Parameters:
|
|
* i2c_port - The I2C port used for the device;
|
|
* i2c_addr - The I2C address used by the device;
|
|
* i2c_freq - The I2C frequency used for the device.
|
|
*
|
|
* Returned Value:
|
|
* Zero is returned on success. Otherwise, a negated errno value is
|
|
* returned to indicate the nature of the failure.
|
|
*
|
|
****************************************************************************/
|
|
|
|
int esp32s2_es8311_initialize(int i2c_port, uint8_t i2c_addr, int i2c_freq);
|
|
|
|
#endif /* __ASSEMBLY__ */
|
|
#endif /* __BOARDS_XTENSA_ESP32S2_ESP32S2_KALUGA_1_SRC_ESP32S2_KALUGA_1_H */
|