zms_priv.h

Go to the documentation of this file.

/* Copyright (c) 2018 Laczen
 * Copyright (c) 2024 BayLibre SAS
 *
 * SPDX-License-Identifier: Apache-2.0
 *
 * ZMS: Zephyr Memory Storage
 */
 
#ifndef __ZMS_PRIV_H_
#define __ZMS_PRIV_H_
 
/*
 * MASKS AND SHIFT FOR ADDRESSES.
 * An address in zms is an uint64_t where:
 * - high 4 bytes represent the sector number
 * - low 4 bytes represent the offset in a sector
 */
#define ADDR_SECT_MASK   GENMASK64(63, 32)
#define ADDR_SECT_SHIFT  32
#define ADDR_OFFS_MASK   GENMASK64(31, 0)
#define SECTOR_NUM(x)    FIELD_GET(ADDR_SECT_MASK, x)
#define SECTOR_OFFSET(x) FIELD_GET(ADDR_OFFS_MASK, x)
 
#if defined(CONFIG_ZMS_CUSTOMIZE_BLOCK_SIZE)
#define ZMS_BLOCK_SIZE CONFIG_ZMS_CUSTOM_BLOCK_SIZE
#else
#define ZMS_BLOCK_SIZE 32
#endif
 
#define ZMS_LOOKUP_CACHE_NO_ADDR GENMASK64(63, 0)
#define ZMS_HEAD_ID              GENMASK(31, 0)
 
#define ZMS_VERSION_MASK        GENMASK(7, 0)
#define ZMS_GET_VERSION(x)      FIELD_GET(ZMS_VERSION_MASK, x)
#define ZMS_DEFAULT_VERSION     1
#define ZMS_MAGIC_NUMBER        0x42 /* murmur3a hash of "ZMS" (MSB) */
#define ZMS_MAGIC_NUMBER_MASK   GENMASK(15, 8)
#define ZMS_GET_MAGIC_NUMBER(x) FIELD_GET(ZMS_MAGIC_NUMBER_MASK, x)
#define ZMS_MIN_ATE_NUM         5
 
#define ZMS_INVALID_SECTOR_NUM -1
#define ZMS_DATA_IN_ATE_SIZE   8
 
struct zms_ate {
        uint8_t crc8;
        uint8_t cycle_cnt;
        uint16_t len;
        uint32_t id;
        union {
                uint8_t data[8];
                struct {
                        uint32_t offset;
                        union {
                                uint32_t data_crc;
                                uint32_t metadata;
                        };
                };
        };
} __packed;
struct zms_ate {…};
 
#endif /* __ZMS_PRIV_H_ */