src/platform/bouffalolab/common/BLConfig.h

/*
 *    Copyright (c) 2022 Project CHIP Authors
 *    All rights reserved.
 *
 *    Licensed under the Apache License, Version 2.0 (the "License");
 *    you may not use this file except in compliance with the License.
 *    You may obtain a copy of the License at
 *
 *        http://www.apache.org/licenses/LICENSE-2.0
 *
 *    Unless required by applicable law or agreed to in writing, software
 *    distributed under the License is distributed on an "AS IS" BASIS,
 *    WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 *    See the License for the specific language governing permissions and
 *    limitations under the License.
 */

#pragma once

namespace chip {
namespace DeviceLayer {
namespace Internal {

/**
 * Provides functions and definitions for accessing device configuration information on the Bouffalo Lab platform.
 *
 * This class is designed to be mixed-in to concrete implementation classes as a means to
 * provide access to configuration information to generic base classes.
 */
class BLConfig
{
public:
    using Key = const char *;

    /** Key definitions for well-known keys */
    /** Manufacturing config keys, which should be saved in a specified place */
    static constexpr char kConfigKey_SerialNum[]             = ("serial-num");
    static constexpr char kConfigKey_MfrDeviceId[]           = ("device-id");
    static constexpr char kConfigKey_MfrDeviceCert[]         = ("device-cert");
    static constexpr char kConfigKey_MfrDeviceICACerts[]     = ("device-ca-certs");
    static constexpr char kConfigKey_MfrDevicePrivateKey[]   = ("device-key");
    static constexpr char kConfigKey_ManufacturingDate[]     = ("mfg-date");
    static constexpr char kConfigKey_SetupPinCode[]          = ("pin-code");
    static constexpr char kConfigKey_SetupDiscriminator[]    = ("discriminator");
    static constexpr char kConfigKey_Spake2pIterationCount[] = ("iteration-count");
    static constexpr char kConfigKey_Spake2pSalt[]           = ("salt");
    static constexpr char kConfigKey_Spake2pVerifier[]       = ("verifier");
    static constexpr char kConfigKey_UniqueId[]              = ("unique-id");

    /** Config keys, which should be droped after a factory reset */
    static constexpr char kConfigKey_FabricId[]                    = ("fabric-id");
    static constexpr char kConfigKey_ServiceConfig[]               = ("service-config");
    static constexpr char kConfigKey_PairedAccountId[]             = ("account-id");
    static constexpr char kConfigKey_ServiceId[]                   = ("service-id");
    static constexpr char kConfigKey_FabricSecret[]                = ("fabric-secret");
    static constexpr char kConfigKey_HardwareVersion[]             = ("hardware-ver");
    static constexpr char kConfigKey_LastUsedEpochKeyId[]          = ("last-ek-id");
    static constexpr char kConfigKey_FailSafeArmed[]               = ("fail-safe-armed");
    static constexpr char kConfigKey_OperationalDeviceId[]         = ("op-device-id");
    static constexpr char kConfigKey_OperationalDeviceCert[]       = ("op-device-cert");
    static constexpr char kConfigKey_OperationalDeviceICACerts[]   = ("op-device-ca-certs");
    static constexpr char kConfigKey_OperationalDevicePrivateKey[] = ("op-device-key");
    static constexpr char kConfigKey_RegulatoryLocation[]          = ("regulatory-location");
    static constexpr char kConfigKey_CountryCode[]                 = ("country-code");
    static constexpr char kConfigKey_ActiveLocale[]                = ("active-locale");
    static constexpr char kConfigKey_Breadcrumb[]                  = ("breadcrumb");
    static constexpr char kConfigKey_GroupKeyIndex[]               = ("group-key-index");
    static constexpr char kConfigKey_LifeTimeCounter[]             = ("life-time-counter");

    static constexpr char kConfigKey_WiFiSSID[]     = ("bl-wifi-ssid");
    static constexpr char kConfigKey_WiFiPassword[] = ("bl-wifi-pass");

    /** Counter Keys, diagnostic information  */
    static constexpr char kCounterKey_RebootCount[]           = ("reboot-count");
    static constexpr char kCounterKey_TotalOperationalHours[] = ("total-hours");
    static constexpr char kCounterKey_UpTime[]                = ("up-time");

    static constexpr char kBLKey_factoryResetFlag[] = ("__factory_reset_pending");

    static void Init(void);

    // Config value accessors.
    static CHIP_ERROR ReadConfigValue(const char * key, uint8_t * val, size_t size, size_t & readsize);
    static CHIP_ERROR ReadConfigValue(const char * key, bool & val);
    static CHIP_ERROR ReadConfigValue(const char * key, uint32_t & val);
    static CHIP_ERROR ReadConfigValue(const char * key, uint64_t & val);
    static CHIP_ERROR ReadConfigValueStr(const char * key, char * buf, size_t bufSize, size_t & outLen);
    static CHIP_ERROR ReadConfigValueBin(const char * key, uint8_t * buf, size_t bufSize, size_t & outLen);

    static CHIP_ERROR WriteConfigValue(const char * key, uint8_t * val, size_t size);
    static CHIP_ERROR WriteConfigValue(const char * key, bool val);
    static CHIP_ERROR WriteConfigValue(const char * key, uint32_t val);
    static CHIP_ERROR WriteConfigValue(const char * key, uint64_t val);
    static CHIP_ERROR WriteConfigValueStr(const char * key, const char * str);
    static CHIP_ERROR WriteConfigValueStr(const char * key, const char * str, size_t strLen);
    static CHIP_ERROR WriteConfigValueBin(const char * key, const uint8_t * data, size_t dataLen);

    static CHIP_ERROR ClearConfigValue(const char * key);
    static bool ConfigValueExists(const char * key);
    static CHIP_ERROR FactoryResetConfig(void);

    static void RunConfigUnitTest(void);

    // internal to the platform for KeyValueStoreManagerImpl.cpp
    static CHIP_ERROR ReadKVS(const char * key, void * value, size_t value_size, size_t * read_bytes_size, size_t offset_bytes);
    static CHIP_ERROR WriteKVS(const char * key, const void * value, size_t value_size);
    static CHIP_ERROR ClearKVS(const char * key);
};

} // namespace Internal
} // namespace DeviceLayer
} // namespace chip