test test test
snake-test/mbed/hal/flash_data.h@0:e4c5e6ec922e, 2020-05-25 (annotated)
- Committer:
- mohamedmoawya
- Date:
- Mon May 25 19:06:11 2020 +0000
- Revision:
- 0:e4c5e6ec922e
snake game tteest
Who changed what in which revision?
User | Revision | Line number | New contents of line |
---|---|---|---|
mohamedmoawya | 0:e4c5e6ec922e | 1 | /* mbed Microcontroller Library |
mohamedmoawya | 0:e4c5e6ec922e | 2 | * Copyright (c) 2017 ARM Limited |
mohamedmoawya | 0:e4c5e6ec922e | 3 | * |
mohamedmoawya | 0:e4c5e6ec922e | 4 | * Licensed under the Apache License, Version 2.0 (the "License"); |
mohamedmoawya | 0:e4c5e6ec922e | 5 | * you may not use this file except in compliance with the License. |
mohamedmoawya | 0:e4c5e6ec922e | 6 | * You may obtain a copy of the License at |
mohamedmoawya | 0:e4c5e6ec922e | 7 | * |
mohamedmoawya | 0:e4c5e6ec922e | 8 | * http://www.apache.org/licenses/LICENSE-2.0 |
mohamedmoawya | 0:e4c5e6ec922e | 9 | * |
mohamedmoawya | 0:e4c5e6ec922e | 10 | * Unless required by applicable law or agreed to in writing, software |
mohamedmoawya | 0:e4c5e6ec922e | 11 | * distributed under the License is distributed on an "AS IS" BASIS, |
mohamedmoawya | 0:e4c5e6ec922e | 12 | * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. |
mohamedmoawya | 0:e4c5e6ec922e | 13 | * See the License for the specific language governing permissions and |
mohamedmoawya | 0:e4c5e6ec922e | 14 | * limitations under the License. |
mohamedmoawya | 0:e4c5e6ec922e | 15 | */ |
mohamedmoawya | 0:e4c5e6ec922e | 16 | #ifndef MBED_FLASH_DATA_H |
mohamedmoawya | 0:e4c5e6ec922e | 17 | #define MBED_FLASH_DATA_H |
mohamedmoawya | 0:e4c5e6ec922e | 18 | |
mohamedmoawya | 0:e4c5e6ec922e | 19 | #include <stdint.h> |
mohamedmoawya | 0:e4c5e6ec922e | 20 | |
mohamedmoawya | 0:e4c5e6ec922e | 21 | /** Target flash algorithm structure |
mohamedmoawya | 0:e4c5e6ec922e | 22 | */ |
mohamedmoawya | 0:e4c5e6ec922e | 23 | typedef struct { |
mohamedmoawya | 0:e4c5e6ec922e | 24 | const uint32_t init; /**< Init function address */ |
mohamedmoawya | 0:e4c5e6ec922e | 25 | const uint32_t uninit; /**< Uninit function address */ |
mohamedmoawya | 0:e4c5e6ec922e | 26 | const uint32_t erase_sector; /**< Erase sector function address */ |
mohamedmoawya | 0:e4c5e6ec922e | 27 | const uint32_t program_page; /**< Program page function address */ |
mohamedmoawya | 0:e4c5e6ec922e | 28 | const uint32_t static_base; /**< Static base address */ |
mohamedmoawya | 0:e4c5e6ec922e | 29 | uint32_t *algo_blob; /**< Pointer to flash algo binary blob */ |
mohamedmoawya | 0:e4c5e6ec922e | 30 | } flash_algo_t; |
mohamedmoawya | 0:e4c5e6ec922e | 31 | |
mohamedmoawya | 0:e4c5e6ec922e | 32 | /** Sector information structure |
mohamedmoawya | 0:e4c5e6ec922e | 33 | */ |
mohamedmoawya | 0:e4c5e6ec922e | 34 | typedef struct { |
mohamedmoawya | 0:e4c5e6ec922e | 35 | const uint32_t start; /**< Sector start address */ |
mohamedmoawya | 0:e4c5e6ec922e | 36 | const uint32_t size; /**< Sector size */ |
mohamedmoawya | 0:e4c5e6ec922e | 37 | } sector_info_t; |
mohamedmoawya | 0:e4c5e6ec922e | 38 | |
mohamedmoawya | 0:e4c5e6ec922e | 39 | /** Flash configuration structure |
mohamedmoawya | 0:e4c5e6ec922e | 40 | */ |
mohamedmoawya | 0:e4c5e6ec922e | 41 | typedef struct { |
mohamedmoawya | 0:e4c5e6ec922e | 42 | const uint32_t page_size; /**< The minimum program page size that can be written */ |
mohamedmoawya | 0:e4c5e6ec922e | 43 | const uint32_t flash_start; /**< Start address of the flash <0, flash_size) */ |
mohamedmoawya | 0:e4c5e6ec922e | 44 | const uint32_t flash_size; /**< Flash size. The size is accumulative sum of all sector sizes */ |
mohamedmoawya | 0:e4c5e6ec922e | 45 | const sector_info_t *sectors; /**< List of sectors - sector can vary in sizes */ |
mohamedmoawya | 0:e4c5e6ec922e | 46 | const uint32_t sector_info_count; /**< Number of sectors */ |
mohamedmoawya | 0:e4c5e6ec922e | 47 | } flash_target_config_t; |
mohamedmoawya | 0:e4c5e6ec922e | 48 | |
mohamedmoawya | 0:e4c5e6ec922e | 49 | /** Target flash configuration |
mohamedmoawya | 0:e4c5e6ec922e | 50 | * For targets not supporting TrustZone, its flash_set_target_config must define target_config. |
mohamedmoawya | 0:e4c5e6ec922e | 51 | * For targets supporting TrustZone, it has the following requirements: |
mohamedmoawya | 0:e4c5e6ec922e | 52 | * -# Flash IAP H/W can only configure to secure. It can access both secure/non-secure flash. |
mohamedmoawya | 0:e4c5e6ec922e | 53 | * -# Flash IAP port is for secure build only. It exports secure functions for non-secure build. |
mohamedmoawya | 0:e4c5e6ec922e | 54 | * -# In Flash IAP port, flash_set_target_config must define both target_config/target_config_ns for secure/non-secure flash respectively. |
mohamedmoawya | 0:e4c5e6ec922e | 55 | * -# Non-secure application can access its non-secure flash only through secure flash IAP functions. It cannot access secure flash. |
mohamedmoawya | 0:e4c5e6ec922e | 56 | */ |
mohamedmoawya | 0:e4c5e6ec922e | 57 | struct flash_s { |
mohamedmoawya | 0:e4c5e6ec922e | 58 | const flash_target_config_t *target_config; /**< Normal/secure flash configuration structure for targets not supporting/supporting TrustZone */ |
mohamedmoawya | 0:e4c5e6ec922e | 59 | #if defined(__CORTEX_M23) || defined(__CORTEX_M33) |
mohamedmoawya | 0:e4c5e6ec922e | 60 | const flash_target_config_t *target_config_ns; /**< Non-secure flash configuration structure for targets supporting TrustZone */ |
mohamedmoawya | 0:e4c5e6ec922e | 61 | #endif |
mohamedmoawya | 0:e4c5e6ec922e | 62 | const flash_algo_t *flash_algo; |
mohamedmoawya | 0:e4c5e6ec922e | 63 | }; |
mohamedmoawya | 0:e4c5e6ec922e | 64 | |
mohamedmoawya | 0:e4c5e6ec922e | 65 | /** Flash algo argument structure |
mohamedmoawya | 0:e4c5e6ec922e | 66 | * Contains all registers that should be preserved |
mohamedmoawya | 0:e4c5e6ec922e | 67 | */ |
mohamedmoawya | 0:e4c5e6ec922e | 68 | typedef struct { |
mohamedmoawya | 0:e4c5e6ec922e | 69 | uint32_t r0; |
mohamedmoawya | 0:e4c5e6ec922e | 70 | uint32_t r1; |
mohamedmoawya | 0:e4c5e6ec922e | 71 | uint32_t r2; |
mohamedmoawya | 0:e4c5e6ec922e | 72 | uint32_t r3; |
mohamedmoawya | 0:e4c5e6ec922e | 73 | uint32_t r9; |
mohamedmoawya | 0:e4c5e6ec922e | 74 | uint32_t pc; |
mohamedmoawya | 0:e4c5e6ec922e | 75 | } args_t; |
mohamedmoawya | 0:e4c5e6ec922e | 76 | |
mohamedmoawya | 0:e4c5e6ec922e | 77 | typedef int32_t (*flash_algo_jump_t)(args_t *); |
mohamedmoawya | 0:e4c5e6ec922e | 78 | |
mohamedmoawya | 0:e4c5e6ec922e | 79 | // prototypes for flash algo CMSIS API |
mohamedmoawya | 0:e4c5e6ec922e | 80 | |
mohamedmoawya | 0:e4c5e6ec922e | 81 | typedef int (*CMSIS_Algo_Function_Init)(unsigned long adr, unsigned long clk, unsigned long fnc); |
mohamedmoawya | 0:e4c5e6ec922e | 82 | typedef int (*CMSIS_Algo_Function_UnInit)(unsigned long fnc); |
mohamedmoawya | 0:e4c5e6ec922e | 83 | typedef int (*CMSIS_Algo_Function_EraseSector)(unsigned long adr); |
mohamedmoawya | 0:e4c5e6ec922e | 84 | typedef int (*CMSIS_Algo_Function_EraseChip)(void); |
mohamedmoawya | 0:e4c5e6ec922e | 85 | typedef int (*CMSIS_Algo_Function_ProgramPage)(unsigned long adr, unsigned long sz, unsigned char *buf); |
mohamedmoawya | 0:e4c5e6ec922e | 86 | typedef unsigned long (*CMSIS_Algo_Function_Verify)(unsigned long adr, unsigned long sz, unsigned char *buf); |
mohamedmoawya | 0:e4c5e6ec922e | 87 | |
mohamedmoawya | 0:e4c5e6ec922e | 88 | #ifdef __cplusplus |
mohamedmoawya | 0:e4c5e6ec922e | 89 | extern "C" { |
mohamedmoawya | 0:e4c5e6ec922e | 90 | #endif |
mohamedmoawya | 0:e4c5e6ec922e | 91 | |
mohamedmoawya | 0:e4c5e6ec922e | 92 | /* Set target configuration |
mohamedmoawya | 0:e4c5e6ec922e | 93 | */ |
mohamedmoawya | 0:e4c5e6ec922e | 94 | void flash_set_target_config(flash_t *obj); |
mohamedmoawya | 0:e4c5e6ec922e | 95 | |
mohamedmoawya | 0:e4c5e6ec922e | 96 | #ifdef __cplusplus |
mohamedmoawya | 0:e4c5e6ec922e | 97 | }; |
mohamedmoawya | 0:e4c5e6ec922e | 98 | #endif |
mohamedmoawya | 0:e4c5e6ec922e | 99 | |
mohamedmoawya | 0:e4c5e6ec922e | 100 | |
mohamedmoawya | 0:e4c5e6ec922e | 101 | #endif |