waveform3  2.0.0.0
Main Page

Waveform 3 click

Waveform 3 Click is a compact add-on board that represents a high-performance signal generator. This board features the AD9837, a low-power programmable waveform generator capable of producing sine, triangular, and square wave outputs from Analog Devices.

click Product page


Click library

  • Author : Stefan Nikolic
  • Date : jan 2021.
  • Type : SPI type

Software Support

We provide a library for the Waveform3 Click as well as a demo application (example), developed using MikroElektronika compilers. The demo can run on all the main MikroElektronika development boards.

Package can be downloaded/installed directly from NECTO Studio Package Manager(recommended way), downloaded from our LibStock™ or found on mikroE github account.

Library Description

This library contains API for Waveform3 Click driver.

Standard key functions :

Example key functions :

  • waveform3_set_mode This function sets output mode, freq and phase channels of AD9837 waveform generator.
    void waveform3_set_mode ( waveform3_t *ctx, uint8_t mode, uint8_t freq_reg, uint8_t phase_reg );
  • waveform3_set_freq This function sets desired frequency ( in Hz ) on desired freq channel.
    uint32_t waveform3_set_freq ( waveform3_t *ctx, uint32_t frequency, uint8_t freq_reg );
  • waveform3_set_phase This function sets desired phase shift ( in degrees ) on desired phase channel.
    uint16_t waveform3_set_phase ( waveform3_t *ctx, float phase, uint8_t phase_reg );

Example Description

This demo app shows the basic capabilities of Waveform 3

click board. First, the sinusoidal wave is incremented to targeted frequency for visually pleasing introduction after which it changes between 4 modes of output.

The demo application is composed of two sections :

Application Init

Application initializes the UART LOG and SPI drivers,

resets the device and sets frequency and phase shift to default values. In the end, the mode is set with the preferred freq and phase channel.

void application_init ( void ) {
log_cfg_t log_cfg;
waveform3_cfg_t waveform3_cfg;
LOG_MAP_USB_UART( log_cfg );
log_init( &logger, &log_cfg );
log_info( &logger, " Application Init " );
// Click initialization.
waveform3_cfg_setup( &waveform3_cfg );
WAVEFORM3_MAP_MIKROBUS( waveform3_cfg, MIKROBUS_1 );
err_t init_flag = waveform3_init( &waveform3, &waveform3_cfg );
if ( init_flag == SPI_MASTER_ERROR ) {
log_error( &logger, " Application Init Error. " );
log_info( &logger, " Please, run program again... " );
for ( ; ; );
}
waveform3_default_cfg( &waveform3 );
Delay_ms( 500 );
log_info( &logger, " Application Task " );
}

Application Task

Task commences with the start frequency rising up to

the targeted one. When it reaches desired frequency, the mode changes every 5 seconds which includes: sinusoidal, triangular, DAC divided by 2 and DAC outputs respectively.

void application_task ( void ) {
uint8_t cfg_mode_switch;
if ( start_frequency < target_frequency ) {
if ( start_frequency / rising_factor < 100 ) {
start_frequency += rising_factor;
waveform3_set_freq( &waveform3, start_frequency, WAVEFORM3_CFG_FREQ_REG0 );
Delay_ms( 5 );
} else {
rising_factor += 10;
}
} else {
for ( cfg_mode_switch = 0 ; cfg_mode_switch < 4 ; cfg_mode_switch++ ) {
Delay_ms( 5000 );
}
}
}

Note

Waveform 3 click might not provide a high enough peak to peak signal on higher frequencies.

The user can freely implement custom buffer for the output stage.

The full application code, and ready to use projects can be installed directly from NECTO Studio Package Manager(recommended way), downloaded from our LibStock™ or found on mikroE github account.

Other mikroE Libraries used in the example:

  • MikroSDK.Board
  • MikroSDK.Log
  • Click.Waveform3

Additional notes and informations

Depending on the development board you are using, you may need USB UART click, USB UART 2 Click or RS232 Click to connect to your PC, for development systems with no UART to USB interface available on the board. The terminal available in all Mikroelektronika compilers, or any other terminal application of your choice, can be used to read the message.


WAVEFORM3_MAP_MIKROBUS
#define WAVEFORM3_MAP_MIKROBUS(cfg, mikrobus)
MikroBUS pin mapping.
Definition: waveform3.h:266
WAVEFORM3_CFG_FREQ_REG0
#define WAVEFORM3_CFG_FREQ_REG0
Waveform 3 FREQ0 channel select.
Definition: waveform3.h:182
waveform3_set_mode
void waveform3_set_mode(waveform3_t *ctx, uint8_t mode, uint8_t freq_reg, uint8_t phase_reg)
Waveform 3 set mode function.
waveform3_t
Waveform 3 Click context object.
Definition: waveform3.h:279
waveform3_cfg_t
Waveform 3 Click configuration object.
Definition: waveform3.h:293
waveform3_init
err_t waveform3_init(waveform3_t *ctx, waveform3_cfg_t *cfg)
Waveform 3 initialization function.
WAVEFORM3_CFG_PHASE_REG0
#define WAVEFORM3_CFG_PHASE_REG0
Waveform 3 PHASE0 channel select.
Definition: waveform3.h:206
application_task
void application_task(void)
Definition: main.c:81
WAVEFORM3_CFG_MODE_SINUSOIDAL
#define WAVEFORM3_CFG_MODE_SINUSOIDAL
Waveform 3 sinusoidal output mode.
Definition: waveform3.h:145
waveform3_set_freq
uint32_t waveform3_set_freq(waveform3_t *ctx, uint32_t frequency, uint8_t freq_reg)
Waveform 3 set frequency function.
application_init
void application_init(void)
Definition: main.c:46
waveform3_set_phase
uint16_t waveform3_set_phase(waveform3_t *ctx, float phase, uint8_t phase_reg)
Waveform 3 set phase function.
waveform3_default_cfg
void waveform3_default_cfg(waveform3_t *ctx)
Waveform 3 default configuration function.
waveform3_cfg_setup
void waveform3_cfg_setup(waveform3_cfg_t *cfg)
Waveform 3 configuration object setup function.