nrf_mbr.h

/*
 * Copyright (c) 2014 - 2017, Nordic Semiconductor ASA
 * All rights reserved.
 *
 * Redistribution and use in source and binary forms, with or without modification,
 * are permitted provided that the following conditions are met:
 *
 * 1. Redistributions of source code must retain the above copyright notice, this
 *    list of conditions and the following disclaimer.
 *
 * 2. Redistributions in binary form, except as embedded into a Nordic
 *    Semiconductor ASA integrated circuit in a product or a software update for
 *    such product, must reproduce the above copyright notice, this list of
 *    conditions and the following disclaimer in the documentation and/or other
 *    materials provided with the distribution.
 *
 * 3. Neither the name of Nordic Semiconductor ASA nor the names of its
 *    contributors may be used to endorse or promote products derived from this
 *    software without specific prior written permission.
 *
 * 4. This software, with or without modification, must only be used with a
 *    Nordic Semiconductor ASA integrated circuit.
 *
 * 5. Any software provided in binary form under this license must not be reverse
 *    engineered, decompiled, modified and/or disassembled.
 *
 * THIS SOFTWARE IS PROVIDED BY NORDIC SEMICONDUCTOR ASA "AS IS" AND ANY EXPRESS
 * OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
 * OF MERCHANTABILITY, NONINFRINGEMENT, AND FITNESS FOR A PARTICULAR PURPOSE ARE
 * DISCLAIMED. IN NO EVENT SHALL NORDIC SEMICONDUCTOR ASA OR CONTRIBUTORS BE
 * LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
 * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE
 * GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
 * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
 * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT
 * OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
 */

#ifndef NRF_MBR_H__
#define NRF_MBR_H__

#include "nrf_svc.h"
#include <stdint.h>

#ifdef __cplusplus
extern "C" {
#endif

#define MBR_SVC_BASE            (0x18)

#define MBR_PAGE_SIZE_IN_WORDS  (1024)

#define MBR_SIZE                (0x1000)

enum NRF_MBR_SVCS
{
  SD_MBR_COMMAND = MBR_SVC_BASE, 
};

enum NRF_MBR_COMMANDS
{
  SD_MBR_COMMAND_COPY_BL,                 
  SD_MBR_COMMAND_COPY_SD,                 
  SD_MBR_COMMAND_INIT_SD,                 
  SD_MBR_COMMAND_COMPARE,                 
  SD_MBR_COMMAND_VECTOR_TABLE_BASE_SET,   
  SD_MBR_COMMAND_RESERVED,
  SD_MBR_COMMAND_IRQ_FORWARD_ADDRESS_SET, 
};

typedef struct
{
  uint32_t *src;  
  uint32_t *dst;  
  uint32_t len;   
} sd_mbr_command_copy_sd_t;


typedef struct
{
  uint32_t *ptr1; 
  uint32_t *ptr2; 
  uint32_t len;   
} sd_mbr_command_compare_t;


typedef struct
{
  uint32_t *bl_src;  
  uint32_t bl_len;   
} sd_mbr_command_copy_bl_t;

typedef struct
{
  uint32_t address; 
} sd_mbr_command_vector_table_base_set_t;

typedef struct
{
  uint32_t address; 
} sd_mbr_command_irq_forward_address_set_t;

typedef struct
{
  uint32_t command;  
  union
  {
    sd_mbr_command_copy_sd_t copy_sd;  
    sd_mbr_command_compare_t compare;  
    sd_mbr_command_copy_bl_t copy_bl;  
    sd_mbr_command_vector_table_base_set_t base_set; 
    sd_mbr_command_irq_forward_address_set_t irq_forward_address_set; 
  } params;
} sd_mbr_command_t;

SVCALL(SD_MBR_COMMAND, uint32_t, sd_mbr_command(sd_mbr_command_t* param));

#ifdef __cplusplus
}
#endif
#endif // NRF_MBR_H__