nRF52832のADC

# nRF52832のADC

サンプルのsaadcプロジェクトを追ってみたので、調べたことを書き残します。
SDK14.20をみたが、前後のバージョンでも変わりないんじゃないかな(調べていません)。
＃誤りがあったら教えてほしいです。

main関数で、ADCの初期化、イベント(ADサンプリング)の設定、イベントの有効化をしている。
ADサンプリングが完了すれば、コールバック関数が呼ばれる仕組みとなっている。

```c:main.cのmain関数
#define SAMPLES_IN_BUFFER 5
volatile uint8_t state = 1;

static const nrf_drv_timer_t m_timer = NRF_DRV_TIMER_INSTANCE(0);
static nrf_saadc_value_t     m_buffer_pool[2][SAMPLES_IN_BUFFER];
static nrf_ppi_channel_t     m_ppi_channel;
static uint32_t              m_adc_evt_counter;

//省略(関数はこの後個別に抜き出し)

int main(void)
{
    uint32_t err_code = NRF_LOG_INIT(NULL);
    APP_ERROR_CHECK(err_code);

    NRF_LOG_DEFAULT_BACKENDS_INIT();

    err_code = nrf_drv_power_init(NULL);
    APP_ERROR_CHECK(err_code);

    ret_code_t ret_code = nrf_pwr_mgmt_init();
    APP_ERROR_CHECK(ret_code);

    NRF_LOG_INFO("SAADC HAL simple example.");
    saadc_init(); //ADCの初期化
    saadc_sampling_event_init(); //ADサンプリングイベントの初期化
    saadc_sampling_event_enable(); //イベントの有効化(開始)

    while (1)
    {
        nrf_pwr_mgmt_run();
        NRF_LOG_FLUSH();
    }
}
```

saadc_init関数では、ADC初期設定、変換結果の格納先バッファ初期化をしている。

チャネル設定の構造体変数channel_configについて、
NRF_DRV_SAADC_DEFAULT_CHANNEL_CONFIG_SEマクロで、
AD入力チャネルを定数NRF_SAADC_INPUT_AIN0とするほか、
・リファレンス電圧0.6V
・ゲイン1/6
に設定される。用途に応じて、付近で再変更すればいい。

また、サンプルプロジェクトでは、一部の設定がsdk_config.hで行われる。
・分解能(8bit/10bit/12bit/14bit)
・オーバーサンプリング
・ローパワーモード
・割込み優先度

追ってみると、nrf_drv_saadc_init関数で設定される仕組みになっている。
この関数の第一引数は、上記設定の構造体になっている。
ここをNULLとすると、関数内部でsdk_config.hの内容が用いられる。

SDKのADCモジュールは、ダブルバッファ構成になっており、
最初にnrf_drv_saadc_buffer_convert関数を2度呼ぶことで、
ダブルバッファ用のメモリを設定する仕組みになっている。


```c:
void saadc_init(void)
{
    ret_code_t err_code;
    nrf_saadc_channel_config_t channel_config =
        NRF_DRV_SAADC_DEFAULT_CHANNEL_CONFIG_SE(NRF_SAADC_INPUT_AIN0);

    err_code = nrf_drv_saadc_init(NULL, saadc_callback);
    APP_ERROR_CHECK(err_code);

    err_code = nrf_drv_saadc_channel_init(0, &channel_config);
    APP_ERROR_CHECK(err_code);

    err_code = nrf_drv_saadc_buffer_convert(m_buffer_pool[0], SAMPLES_IN_BUFFER);
    APP_ERROR_CHECK(err_code);

    err_code = nrf_drv_saadc_buffer_convert(m_buffer_pool[1], SAMPLES_IN_BUFFER);
    APP_ERROR_CHECK(err_code);

}
```

saadc_sampling_event_init関数では、AD変換のタイミング(周期)を設定している。
この関数の前半では、AD変換開始のためのTIMERを設定・有効にする。
サンプルプロジェクトでは、400ms毎にTIMERが発火する。

この関数の後半では、EventにTaskを割り当てている。

PPI(Programmable peripheral interconnect)は、nRF52の各機能を繋ぐような感じ
PPIはnRF52でとても重要な機能だと思う。

```c:
void saadc_sampling_event_init(void)
{
    ret_code_t err_code;

    err_code = nrf_drv_ppi_init();
    APP_ERROR_CHECK(err_code);

    nrf_drv_timer_config_t timer_cfg = NRF_DRV_TIMER_DEFAULT_CONFIG;
    timer_cfg.bit_width = NRF_TIMER_BIT_WIDTH_32;
    err_code = nrf_drv_timer_init(&m_timer, &timer_cfg, timer_handler);
    APP_ERROR_CHECK(err_code);

    /* setup m_timer for compare event every 400ms */
    uint32_t ticks = nrf_drv_timer_ms_to_ticks(&m_timer, 400);
    nrf_drv_timer_extended_compare(&m_timer,
                                   NRF_TIMER_CC_CHANNEL0,
                                   ticks,
                                   NRF_TIMER_SHORT_COMPARE0_CLEAR_MASK,
                                   false);
    nrf_drv_timer_enable(&m_timer);

    uint32_t timer_compare_event_addr = nrf_drv_timer_compare_event_address_get(&m_timer,
                                                                                NRF_TIMER_CC_CHANNEL0);
    uint32_t saadc_sample_task_addr   = nrf_drv_saadc_sample_task_get();

    /* setup ppi channel so that timer compare event is triggering sample task in SAADC */
    err_code = nrf_drv_ppi_channel_alloc(&m_ppi_channel);
    APP_ERROR_CHECK(err_code);

    err_code = nrf_drv_ppi_channel_assign(m_ppi_channel,
                                          timer_compare_event_addr,
                                          saadc_sample_task_addr);
    APP_ERROR_CHECK(err_code);
}
```

saadc_sampling_event_enable関数では、PPIの有効化をしている。
これにより、TaskとEventが繋がり、Eventの発生に呼応してTaskが動作するようになる。

```c:
void saadc_sampling_event_enable(void)
{
    ret_code_t err_code = nrf_drv_ppi_channel_enable(m_ppi_channel);

    APP_ERROR_CHECK(err_code);
}
```

Taskの動作完了により、saadc_callback関数が呼ばれるようになる。
nrf_drv_saadc_buffer_convert関数で、ダブルバッファのうち変換の完了しているものをAD変換結果の格納先に再設定する。

```c:
void saadc_callback(nrf_drv_saadc_evt_t const * p_event)
{
    if (p_event->type == NRF_DRV_SAADC_EVT_DONE)
    {
        ret_code_t err_code;

        err_code = nrf_drv_saadc_buffer_convert(p_event->data.done.p_buffer, SAMPLES_IN_BUFFER);
        APP_ERROR_CHECK(err_code);

        int i;
        NRF_LOG_INFO("ADC event number: %d", (int)m_adc_evt_counter);

        for (i = 0; i < SAMPLES_IN_BUFFER; i++)
        {
            NRF_LOG_INFO("%d", p_event->data.done.p_buffer[i]);
        }
        m_adc_evt_counter++;
    }
}
```

* 参考リンク

[Nordic Info Center](http://infocenter.nordicsemi.com/index.jsp?topic=%2Fcom.nordic.infocenter.sdk5.v15.2.0%2Fhardware_driver_saadc.html)