X-Git-Url: https://gerrit.automotivelinux.org/gerrit/gitweb?a=blobdiff_plain;f=src%2Fhs-helper.cpp;h=a599fdd4f6625da757f94143d40e2f68e1d8ca62;hb=2aa2fc0f925fb529b0a4db038d91398bb627fd1a;hp=452ae24d4d41dcb3eed2de69f9ad46dfcaf2e7f6;hpb=bb38a76d1b00e93187967aa2880e79e671f02eba;p=apps%2Fagl-service-homescreen.git

diff --git a/src/hs-helper.cpp b/src/hs-helper.cpp
index 452ae24..a599fdd 100644
--- a/src/hs-helper.cpp
+++ b/src/hs-helper.cpp
@@ -26,7 +26,18 @@ const char* evlist[] = {
     "reserved"
   };
 
-
+/**
+ * get uint16 value from source
+ *
+ * #### Parameters
+ * - request : Describes the request by bindings from afb-daemon
+ * - source  : input source
+ * - out_id  : output uint16 value
+ *
+ * #### Return
+ * error code
+ *
+ */
 REQ_ERROR get_value_uint16(const struct afb_req request, const char *source, uint16_t *out_id)
 {
     char* endptr;
@@ -51,6 +62,18 @@ REQ_ERROR get_value_uint16(const struct afb_req request, const char *source, uin
     return REQ_OK;
 }
 
+/**
+ * get int16 value from source
+ *
+ * #### Parameters
+ * - request : Describes the request by bindings from afb-daemon
+ * - source  : input source
+ * - out_id  : output int16 value
+ *
+ * #### Return
+ * error code
+ *
+ */
 REQ_ERROR get_value_int16(const struct afb_req request, const char *source, int16_t *out_id)
 {
     char* endptr;
@@ -75,6 +98,18 @@ REQ_ERROR get_value_int16(const struct afb_req request, const char *source, int1
     return REQ_OK;
 }
 
+/**
+ * get int32 value from source
+ *
+ * #### Parameters
+ * - request : Describes the request by bindings from afb-daemon
+ * - source  : input source
+ * - out_id  : output int32 value
+ *
+ * #### Return
+ * error code
+ *
+ */
 REQ_ERROR get_value_int32(const struct afb_req request, const char *source, int32_t *out_id)
 {
     char* endptr;
@@ -99,6 +134,18 @@ REQ_ERROR get_value_int32(const struct afb_req request, const char *source, int3
     return REQ_OK;
 }
 
+/**
+ * add int object to json object
+ *
+ * #### Parameters
+ * - j_obj : the json object will join in int json object
+ * - count : input parameter number
+ * - ...   : parameter list
+ *
+ * #### Return
+ * None
+ *
+ */
 void hs_add_object_to_json_object(struct json_object* j_obj, int count,...)
 {
     va_list args;
@@ -113,6 +160,18 @@ void hs_add_object_to_json_object(struct json_object* j_obj, int count,...)
     va_end(args);
 }
 
+/**
+ * add string object to json object
+ *
+ * #### Parameters
+ * - j_obj : the json object will join in string json object
+ * - count : input parameter number
+ * - ...   : parameter list
+ *
+ * #### Return
+ * None
+ *
+ */
 void hs_add_object_to_json_object_str(struct json_object* j_obj, int count,...)
 {
     va_list args;
@@ -127,7 +186,19 @@ void hs_add_object_to_json_object_str(struct json_object* j_obj, int count,...)
     va_end(args);
 }
 
-
+/**
+ * add new json object to json object
+ *
+ * #### Parameters
+ * - j_obj : the json object will join in new json object
+ * - verb_name : new json object's verb value
+ * - count : input parameter number
+ * - ...   : parameter list
+ *
+ * #### Return
+ * None
+ *
+ */
 void hs_add_object_to_json_object_func(struct json_object* j_obj, const char* verb_name, int count, ...)
 {
     va_list args;
@@ -145,6 +216,16 @@ void hs_add_object_to_json_object_func(struct json_object* j_obj, const char* ve
     va_end(args);
 }
 
+/**
+ * search event position in event list
+ *
+ * #### Parameters
+ * - value : searched event name
+ *
+ * #### Return
+ * event's index in event list
+ *
+ */
 int hs_search_event_name_index(const char* value)
 {
     size_t buf_size = 50;