/* * This file is part of the Trezor project, https://trezor.io/ * * Copyright (c) SatoshiLabs * * This program is free software: you can redistribute it and/or modify * it under the terms of the GNU General Public License as published by * the Free Software Foundation, either version 3 of the License, or * (at your option) any later version. * * This program is distributed in the hope that it will be useful, * but WITHOUT ANY WARRANTY; without even the implied warranty of * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the * GNU General Public License for more details. * * You should have received a copy of the GNU General Public License * along with this program. If not, see <http://www.gnu.org/licenses/>. */ #ifndef __NORCOW_H__ #define __NORCOW_H__ #include <stdint.h> #include "secbool.h" /* * Storage parameters */ #include "norcow_config.h" /* * Initialize storage */ void norcow_init(uint32_t *norcow_version); /* * Wipe the storage */ void norcow_wipe(void); /* * Looks for the given key, returns status of the operation */ secbool norcow_get(uint16_t key, const void **val, uint16_t *len); /* * Reads the next entry in the storage starting at offset. Returns secfalse if * there is none. */ secbool norcow_get_next(uint32_t *offset, uint16_t *key, const void **val, uint16_t *len); /* * Sets the given key, returns status of the operation. If NULL is passed * as val, then norcow_set allocates a new key of size len. The value should * then be written using norcow_update_bytes(). */ secbool norcow_set(uint16_t key, const void *val, uint16_t len); secbool norcow_set_ex(uint16_t key, const void *val, uint16_t len, secbool *found); /* * Deletes the given key, returns status of the operation. */ secbool norcow_delete(uint16_t key); /* * Update a word in flash in the given key at the given offset. * Note that you can only change bits from 1 to 0. */ secbool norcow_update_word(uint16_t key, uint16_t offset, uint32_t value); /* * Update the value of the given key starting at the given offset. * Note that you can only change bits from 1 to 0. */ secbool norcow_update_bytes(const uint16_t key, const uint16_t offset, const uint8_t *data, const uint16_t len); /* * Complete storage version upgrade */ secbool norcow_upgrade_finish(void); #endif