mirror of
https://github.com/Telecominfraproject/OpenCellular.git
synced 2026-01-17 10:31:31 +00:00
5252c73936
Currently, field sizes are automatically set to the smallest size which can fit a given value. This patch makes cbi-util allow field sizes to be specified. Signed-off-by: Daisuke Nojiri <dnojiri@chromium.org> BUG=b:79514391 BRANCH=none TEST=Tested as follows: 1. Create CBI image: $ cbi-util create --file cbi.bin --board_version 0x202 \ --oem_id 0xabcd:2 --sku_id 0xff:4 --size 256 2. Verify the image: $ cbi-util show --file cbi.bin CBI image: /home/dnojiri/tmp/nami/tmp/cbi.new.bin TOTAL_SIZE: 22 Data Field: name: value (hex, tag, size) BOARD_VERSION: 514 (0x202, 0, 2) OEM_ID: 43981 (0xabcd, 1, 2) SKU_ID: 255 (0xff, 2, 4) 3. Verify the output matches with the previous output if field sizes are not specified. Change-Id: Ic7149274d6e4a118ea12bbf03199b548b7089a3e Reviewed-on: https://chromium-review.googlesource.com/1056201 Commit-Ready: Daisuke Nojiri <dnojiri@chromium.org> Tested-by: Daisuke Nojiri <dnojiri@chromium.org> Reviewed-by: Aaron Durbin <adurbin@chromium.org>
101 lines
2.8 KiB
C
101 lines
2.8 KiB
C
/* Copyright 2018 The Chromium OS Authors. All rights reserved.
|
|
* Use of this source code is governed by a BSD-style license that can be
|
|
* found in the LICENSE file.
|
|
*
|
|
* Cros Board Info
|
|
*/
|
|
#ifndef __CROS_EC_CROS_BOARD_INFO_H
|
|
#define __CROS_EC_CROS_BOARD_INFO_H
|
|
|
|
#include "common.h"
|
|
#include "ec_commands.h"
|
|
|
|
#define CBI_VERSION_MAJOR 0
|
|
#define CBI_VERSION_MINOR 0
|
|
#define CBI_EEPROM_SIZE 256
|
|
static const uint8_t cbi_magic[] = { 0x43, 0x42, 0x49 }; /* 'C' 'B' 'I' */
|
|
|
|
struct cbi_header {
|
|
uint8_t magic[3];
|
|
/* CRC of 'struct board_info' excluding magic and crc */
|
|
uint8_t crc;
|
|
/* Data format version. Parsers are expected to process data as long
|
|
* as major version is equal or younger. */
|
|
union {
|
|
struct {
|
|
uint8_t minor_version;
|
|
uint8_t major_version;
|
|
};
|
|
uint16_t version;
|
|
};
|
|
/* Total size of data. It can be larger than sizeof(struct board_info)
|
|
* if future versions add additional fields. */
|
|
uint16_t total_size;
|
|
/* List of data items (i.e. struct cbi_data[]) */
|
|
uint8_t data[];
|
|
} __attribute__((packed));
|
|
|
|
struct cbi_data {
|
|
uint8_t tag; /* enum cbi_data_tag */
|
|
uint8_t size; /* size of value[] */
|
|
uint8_t value[]; /* data value */
|
|
} __attribute__((packed));
|
|
|
|
/**
|
|
* Board info accessors
|
|
*
|
|
* @param version/sku_id/oem_id [OUT] Data read from EEPROM
|
|
* @return EC_SUCCESS on success or EC_ERROR_* otherwise.
|
|
*/
|
|
int cbi_get_board_version(uint32_t *version);
|
|
int cbi_get_sku_id(uint32_t *sku_id);
|
|
int cbi_get_oem_id(uint32_t *oem_id);
|
|
|
|
/**
|
|
* Primitive accessors
|
|
*
|
|
* @param tag Tag of the target data.
|
|
* @param buf Buffer where data is passed.
|
|
* @param size (IN) Size of <buf>. (OUT) Size of the data returned.
|
|
* @return EC_SUCCESS on success or EC_ERROR_* otherwise.
|
|
*/
|
|
int cbi_get_board_info(enum cbi_data_tag tag, uint8_t *buf, uint8_t *size);
|
|
int cbi_set_board_info(enum cbi_data_tag tag, const uint8_t *buf, uint8_t size);
|
|
|
|
/*
|
|
* Utility functions
|
|
*/
|
|
|
|
/**
|
|
* Calculate 8-bit CRC of CBI
|
|
*
|
|
* @param h Pointer to CBI header
|
|
* @return CRC value
|
|
*/
|
|
uint8_t cbi_crc8(const struct cbi_header *h);
|
|
|
|
/**
|
|
* Store data in memory in CBI data format
|
|
*
|
|
* @param p Pointer to the buffer where a new data item will be stored. It
|
|
* should be pointing to the data section of CBI.
|
|
* @param tag Tag of the data item
|
|
* @param buf Pointer to the buffer containing the data being copied.
|
|
* @param size Size of the data in bytes. Must be 0 < size < 256.
|
|
* @return Address of the byte following the stored data in the
|
|
* destination buffer
|
|
*/
|
|
uint8_t *cbi_set_data(uint8_t *p, enum cbi_data_tag tag,
|
|
const void *buf, int size);
|
|
|
|
/**
|
|
* Find a data field in CBI
|
|
*
|
|
* @param cbi Buffer containing CBI struct
|
|
* @param tag Tag of the data field to search
|
|
* @return Pointer to the data or NULL if not found.
|
|
*/
|
|
struct cbi_data *cbi_find_tag(const void *cbi, enum cbi_data_tag tag);
|
|
|
|
#endif /* __CROS_EC_CROS_BOARD_INFO_H */
|