fram6 2.0.0.0
Main Page

FRAM 6 click

‍FRAM 6 Click is a compact add-on board that contains highly reliable ferroelectric random access memory. This board features the CY15B102Q, a 2Mbit nonvolatile memory employing an advanced ferroelectric process organized as 256K words of 8 bits each from Cypress Semiconductor, now part of Infineon.

click Product page


Click library

  • Author : Stefan Filipovic
  • Date : Aug 2021.
  • Type : SPI type

Software Support

We provide a library for the FRAM6 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 FRAM6 Click driver.

Standard key functions :

  • fram6_cfg_setup Config Object Initialization function.
    void fram6_cfg_setup(fram6_cfg_t *cfg)
    FRAM 6 configuration object setup function.
    FRAM 6 Click configuration object.
    Definition fram6.h:175
  • fram6_init Initialization function.
    err_t fram6_init ( fram6_t *ctx, fram6_cfg_t *cfg );
    err_t fram6_init(fram6_t *ctx, fram6_cfg_t *cfg)
    FRAM 6 initialization function.
    FRAM 6 Click context object.
    Definition fram6.h:158
  • fram6_default_cfg Click Default Configuration function.
    err_t fram6_default_cfg ( fram6_t *ctx );
    err_t fram6_default_cfg(fram6_t *ctx)
    FRAM 6 default configuration function.

Example key functions :

  • fram6_memory_write This function writes a desired number of data bytes starting from the selected memory address.
    err_t fram6_memory_write ( fram6_t *ctx, uint32_t address, uint8_t *data_in, uint16_t len );
    err_t fram6_memory_write(fram6_t *ctx, uint32_t address, uint8_t *data_in, uint16_t len)
    FRAM 6 memory write function.
  • fram6_memory_read This function reads a desired number of data bytes starting from the selected memory address.
    err_t fram6_memory_read ( fram6_t *ctx, uint32_t address, uint8_t *data_out, uint16_t len );
    err_t fram6_memory_read(fram6_t *ctx, uint32_t address, uint8_t *data_out, uint16_t len)
    FRAM 6 memory read function.
  • fram6_set_block_protection This function sets the block protection bits of the Status register.
    err_t fram6_set_block_protection ( fram6_t *ctx, uint8_t block_protect );
    err_t fram6_set_block_protection(fram6_t *ctx, uint8_t block_protect)
    FRAM 6 set block protection function.

Example Description

‍This example demonstrates the use of FRAM 6 click board.

The demo application is composed of two sections :

Application Init

‍Initializes the driver and performs the click default configuration.

void application_init ( void )
{
log_cfg_t log_cfg;
fram6_cfg_t fram6_cfg;
LOG_MAP_USB_UART( log_cfg );
log_init( &logger, &log_cfg );
log_info( &logger, " Application Init " );
// Click initialization.
fram6_cfg_setup( &fram6_cfg );
FRAM6_MAP_MIKROBUS( fram6_cfg, MIKROBUS_1 );
if ( SPI_MASTER_ERROR == fram6_init( &fram6, &fram6_cfg ) )
{
log_error( &logger, " Application Init Error. " );
log_info( &logger, " Please, run program again... " );
for ( ; ; );
}
if ( FRAM6_ERROR == fram6_default_cfg ( &fram6 ) )
{
log_error( &logger, " Default Config Error. " );
log_info( &logger, " Please, run program again... " );
for ( ; ; );
}
log_info( &logger, " Application Task " );
}
@ FRAM6_ERROR
Definition fram6.h:200
#define FRAM6_MAP_MIKROBUS(cfg, mikrobus)
MikroBUS pin mapping.
Definition fram6.h:142
void application_init(void)
Definition main.c:30

Application Task

‍Writes a desired number of bytes to the memory and then verifies that it's written correctly by reading from the same memory location and displaying the memory content on the USB UART.

void application_task ( void )
{
uint8_t data_buf[ 128 ] = { 0 };
{
log_printf ( &logger, "Data written to address 0x%.5lx: \t%s\r\n", ( uint32_t ) STARTING_ADDRESS,
( char * ) DEMO_TEXT_MESSAGE );
}
data_buf, strlen ( DEMO_TEXT_MESSAGE ) ) )
{
log_printf ( &logger, "Data read from address 0x%.5lx: \t%s\r\n\n", ( uint32_t ) STARTING_ADDRESS,
data_buf );
Delay_ms ( 1000 );
Delay_ms ( 1000 );
Delay_ms ( 1000 );
}
}
@ FRAM6_OK
Definition fram6.h:199
#define DEMO_TEXT_MESSAGE
Definition main.c:24
void application_task(void)
Definition main.c:70
#define STARTING_ADDRESS
Definition main.c:25

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.FRAM6

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.