/* * Copyright (c) 2021 Huawei Device Co., Ltd. * 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. */ #ifndef BASE_STARTUP_INIT_PARAM_H #define BASE_STARTUP_INIT_PARAM_H #include #include #ifdef PARAM_SUPPORT_TRIGGER #include "cJSON.h" #endif #include "sys_param.h" #ifdef __cplusplus #if __cplusplus extern "C" { #endif #endif #define DEFAULT_PARAM_WAIT_TIMEOUT 30 // 30s #define DEFAULT_PARAM_SET_TIMEOUT 10 // 10s #ifndef PARAM_NAME_LEN_MAX #define PARAM_CONST_VALUE_LEN_MAX 4096 #define PARAM_VALUE_LEN_MAX 96 #define PARAM_NAME_LEN_MAX 96 #endif typedef uint32_t ParamHandle; typedef enum { PARAM_CODE_ERROR = -1, PARAM_CODE_SUCCESS = 0, PARAM_CODE_INVALID_PARAM = 100, PARAM_CODE_INVALID_NAME, PARAM_CODE_INVALID_VALUE, PARAM_CODE_REACHED_MAX, PARAM_CODE_NOT_SUPPORT, PARAM_CODE_TIMEOUT, PARAM_CODE_NOT_FOUND, PARAM_CODE_READ_ONLY, PARAM_CODE_FAIL_CONNECT, PARAM_CODE_NODE_EXIST, // 9 PARAM_CODE_INVALID_SOCKET, DAC_RESULT_INVALID_PARAM = 1000, DAC_RESULT_FORBIDED, PARAM_CODE_MAX } PARAM_CODE; typedef enum { EVENT_TRIGGER_PARAM, EVENT_TRIGGER_BOOT, EVENT_TRIGGER_PARAM_WAIT, EVENT_TRIGGER_PARAM_WATCH } EventType; #define LOAD_PARAM_NORMAL 0x00 #define LOAD_PARAM_ONLY_ADD 0x01 /** * Init 接口 * 初始化参数服务 * */ void InitParamService(void); void LoadSpecialParam(void); /** * Init 接口 * 启动参数服务,在main启动的最后调用,阻赛当前线程 * */ int StartParamService(void); /** * Init 接口 * 停止参数服务 * */ void StopParamService(void); /** * Init 接口 * 加载默认的参数值 * */ int LoadDefaultParams(const char *fileName, uint32_t mode); /** * Init 接口 * 加载持久化参数。 * */ int LoadPersistParams(void); /** * Init 接口 * 设置参数,主要用于其他进程使用,通过管道修改参数 * */ int SystemWriteParam(const char *name, const char *value); #ifdef PARAM_SUPPORT_TRIGGER /** * 对外接口 * 触发一个trigger操作。 * */ void PostTrigger(EventType type, const char *content, uint32_t contentLen); /** * 对外接口 * 解析trigger文件。 * */ int ParseTriggerConfig(const cJSON *fileRoot, int (*checkJobValid)(const char *jobName)); /** * 对外接口 * 按名字执行对应的trigger。 * */ void DoTriggerExec(const char *triggerName); void DoJobExecNow(const char *triggerName); /** * 对外接口 * 按名字添加一个job,用于group支持。 * */ int AddCompleteJob(const char *name, const char *condition, const char *cmdContent); void RegisterBootStateChange(void (*bootStateChange)(int start, const char *)); /** * 对外接口 * dump 参数和trigger信息 * */ void SystemDumpTriggers(int verbose, int (*dump)(const char *fmt, ...)); #endif /** * 对外接口 * 设置参数,主要用于其他进程使用,通过管道修改参数。 * */ int SystemSetParameter(const char *name, const char *value); /** * 对外接口 * 查询参数,主要用于其他进程使用,需要给定足够的内存保存参数。 * 如果 value == null,获取value的长度 * 否则value的大小认为是len * */ #define SystemGetParameter SystemReadParam /** * 对外接口 * 查询参数,主要用于其他进程使用,找到对应属性的handle。 * */ int SystemFindParameter(const char *name, ParamHandle *handle); /** * 对外接口 * 根据handle获取对应数据的修改标识。 * commitId 获取计数变化 * */ int SystemGetParameterCommitId(ParamHandle handle, uint32_t *commitId); /** * 外部接口 * 遍历参数。 * */ int SystemTraversalParameter(const char *prefix, void (*traversalParameter)(ParamHandle handle, void *cookie), void *cookie); /** * 外部接口 * 查询参数,主要用于其他进程使用,需要给定足够的内存保存参数。 * 如果 value == null,获取value的长度 * 否则value的大小认为是len * */ int SystemGetParameterName(ParamHandle handle, char *name, unsigned int len); /** * 外部接口 * 获取参数值。 * */ int SystemGetParameterValue(ParamHandle handle, char *value, unsigned int *len); /** * 外部接口 * 等待某个参数值被修改,阻塞直到参数值被修改或超时 * */ int SystemWaitParameter(const char *name, const char *value, int32_t timeout); typedef void (*ParameterChangePtr)(const char *key, const char *value, void *context); int SystemWatchParameter(const char *keyprefix, ParameterChangePtr change, void *context); int SystemCheckParamExist(const char *name); long long GetSystemCommitId(void); void SystemDumpParameters(int verbose, int (*dump)(const char *fmt, ...)); int WatchParamCheck(const char *keyprefix); #ifdef __cplusplus #if __cplusplus } #endif #endif #endif