update logicromsdk to v0.9.5

Signed-off-by: Ajay Bhargav <[email protected]>

Author: ajaybhargav

cores/logicrom/logicromsdk/include/fota.h

@@ -23,6 +23,16 @@ int fota_start(const char *in_url);
  */
 int fota_in_progress(void);
 
+/**
+ * @brief Register with Logicrom FOTA server for automatic firmware
+ * updates via Device management console.
+ *
+ * @param code		Firmware code to identify application
+ * @param ver		current firmware version
+ * @return			return 0 on success, negative value on failure
+ */
+int logicrom_fota_register(const char *code, const char *ver);
+
 #ifdef __cplusplus
 }
 #endif

cores/logicrom/logicromsdk/include/gpsdriver.h

@@ -105,7 +105,7 @@ struct gpsdriver_t {
 int gps_set_driver_casic(void);
 
 /**
- * @brief Set GPS driver to Quectel L89R2.0 GNSS/IRNSS Module
+ * @brief Set GPS driver to Quectel L89H R2.0 GNSS/IRNSS Module
  * 
  * @return 0 on success
  */

cores/logicrom/logicromsdk/include/gpslib.h

@@ -207,7 +207,7 @@ int gps_getstatus(void);
  * @return			On success, returns actual number of bytes written or -1 on failure
  * 					errno will be set on failure.
  */
-int gps_uart_write(unsigned char *buf, int len);
+int gps_uart_write(const void *buf, int len);
 
 /**
  * Convert GPS string date time to seconds since Epoch.

cores/logicrom/logicromsdk/include/hw/i2c.h

@@ -38,7 +38,7 @@ int i2c_hw_setspeed(int port, int speed_khz);
  * @param len			[in] Length of data to send (must be less than or equal to 8)
  * @return				Length of bytes written on success, negative value on error
  */
-int i2c_hw_write(int port, unsigned char address, const unsigned char *buffer, int len);
+int i2c_hw_write(int port, unsigned char address, const void *buffer, int len);
 
 /**
  * Master read data from I2C slave device
@@ -48,7 +48,7 @@ int i2c_hw_write(int port, unsigned char address, const unsigned char *buffer, i
  * @param len			[in] No. of bytes to read
  * @return				Length of data read from slave on success, negative value on error
  */
-int i2c_hw_read(int port, unsigned char address, unsigned char *buffer, int len);
+int i2c_hw_read(int port, unsigned char address, void *buffer, int len);
 
 /**
  * Write and Read operation with repeated start.
@@ -63,7 +63,7 @@ int i2c_hw_read(int port, unsigned char address, unsigned char *buffer, int len)
  * @param rdlen			[in] No. of bytes to read
  * @return				Length of data read from slave on success, negative value on error
  */
-int i2c_hw_writeread(int port, unsigned char address, const unsigned char *wrbuf, int wrlen, unsigned char *rdbuf, int rdlen);
+int i2c_hw_writeread(int port, unsigned char address, const void *wrbuf, int wrlen, void *rdbuf, int rdlen);
 
 /**
  * De-Init I2C bus and release GPIO

cores/logicrom/logicromsdk/include/hw/imu_sensor.h

@@ -45,9 +45,9 @@ extern "C" {
  * 
  */
 enum imusentype_e {
-	SEN_TYPE_ACCEL, /**< Accelerometer */
-	SEN_TYPE_GYRO,  /**< Gyroscope */
-	SEN_TYPE_MAG,   /**< Magnetometer */
+	SENSOR_TYPE_ACCEL, /**< Accelerometer */
+	SENSOR_TYPE_GYRO,  /**< Gyroscope */
+	SENSOR_TYPE_MAG,   /**< Magnetometer */
 };
 
 /**
@@ -81,8 +81,8 @@ typedef void (*imu_eventcb_f)(int event);
  * 
  * when configuration is not provided, below are the default threshold values\n
  * 
- * 		static_threshold = 0.01g
- * 		motion_detect_threshold = 0.02g
+ * 		static_threshold = 0.02g
+ * 		motion_detect_threshold = 0.05g
  * 		harsh_accel_threshold = 0.43g
  * 		harsh_break_threshold = 0.55g
  * 		harsh_turn_threshold = 0.47g
@@ -201,11 +201,11 @@ struct imu_sensor_t {
 /**
  * @brief Initialize IMU library
  * 
- * @param config IMU configuration structure (@ref imuconf_t), can be null for default configuration
- * @param callback Event callback function, can be null if callback not required
+ * @param config IMU configuration structure (@ref imuconf_t), can be NULL for default configuration
+ * @param callback Event callback function, can be set to NULL to disable events
  * @return return 0 on success, -1 on failure
  */
-int imu_init(struct imuconf_t *config, imu_eventcb_f callback);
+int imu_lib_init(struct imuconf_t *config, imu_eventcb_f callback);
 
 /**
  * @brief Add new sensor to sensor fusion library
@@ -215,6 +215,14 @@ int imu_init(struct imuconf_t *config, imu_eventcb_f callback);
  */
 int imu_add_sensor(const struct imu_sensor_t *sensor);
 
+/**
+ * @brief Init config structure with default values
+ * 
+ * @param config structure pointer to initialize
+ * @return return 0 on success, -1 on failure
+ */
+int imu_initconfig(struct imuconf_t *config);
+
 /**
  * @brief Change/set IMU configuration
  * 
@@ -223,6 +231,14 @@ int imu_add_sensor(const struct imu_sensor_t *sensor);
  */
 int imu_setconfig(struct imuconf_t *config);
 
+/**
+ * @brief Get current IMU configuration
+ * 
+ * @param config pointer to configuration structure to be filled
+ * @return return 0 on success, -1 on failure
+ */
+int imu_getconfig(struct imuconf_t *config);
+
 /**
  * @brief Change/Set event callback function
  * 
@@ -253,9 +269,7 @@ int imu_get_accel(float *ax, float *ay, float *az);
 int imu_get_linearaccel(float *ax, float *ay, float *az);
 
 /**
- * @brief Get acceleration magnitude without gravity component with direction
- * positivity value represents acceleration and negative value represent
- * deceleration.
+ * @brief Get acceleration magnitude without gravity component.
  * 
  * @param force Value of force magnitude in unit of g
  * @return return 0 on success, -1 on failure
@@ -297,6 +311,13 @@ int imu_is_ready(void);
  */
 int imu_is_motionactive(void);
 
+/**
+ * @brief Get Tilt status
+ * 
+ * @return returns 1 when motion active and 0 otherwise
+ */
+int imu_is_tiltactive(void);
+
 /**
  * @brief This function initiates sensor calibration
  * 
@@ -307,7 +328,7 @@ int imu_calibrate_sensor(int handle);
 
 /**
  * @brief This function sets zero position of sensor placement, used for detection
- * of tilt, motion etc. Once set zero position is stored inside flash memory.
+ * of tilt, motion etc. Once set, zero position is stored inside flash memory.
  * 
  * @return return 0 on success, -1 on failure
  */
@@ -335,6 +356,13 @@ int imu_calibrate_position(void);
  */
 void imu_set_debuglevel(int level);
 
+/**
+ * @brief Get current debug level
+ * 
+ * @return debug level
+ */
+int imu_get_debuglevel(void);
+
 /**
  * @brief Add GPS as sensor
  * If system uses GPS then imu library can use gps to validate some events
@@ -352,6 +380,24 @@ int imu_add_gpssensor(void);
  */
 int imu_gps_motionassist(int enable);
 
+/**
+ * @brief Enable library test mode
+ * 
+ * In test mode, GPS sensor (if enabled) will be disabled and
+ * events will be generated without any external dependency to
+ * test IMU library.
+ * 
+ * @param enable 1 to enable, 0 to disable
+ */
+void imu_set_testmode(int enable);
+
+/**
+ * @brief Get test mode status
+ * 
+ * @return returns 0 if disabled, 1 if enabled
+ */
+int imu_get_testmode(void);
+
 #ifdef __cplusplus
 }
 #endif

cores/logicrom/logicromsdk/include/hw/spi.h

@@ -95,7 +95,7 @@ int spi_hw_setcsmode(int port, int cs_pol);
  * @param length			[in] Length of data to read/write
  * @return					Length of data read/write on success, negative on error
  */
-int spi_hw_transfer(int port, const unsigned char *wrbuf, unsigned char *rdbuf, int length);
+int spi_hw_transfer(int port, const void *wrbuf, void *rdbuf, int length);
 
 /**
  * Release SPI hardware

cores/logicrom/logicromsdk/include/lib.h

@@ -28,7 +28,7 @@ enum loglevel_e {
 	/* Library Debug levels */
 	DBG_OFF = 0,                 /**< Default loglevel, equivalent to printf */
 	DBG_INFO,                    /**< Log level info */
-	DBG_NETWORK,                 /**< Network layer debug level */
+	DBG_VERBOSE,                 /**< Log level verbose for more information */
 
 	/* User application Debug levels must start at DBG_USER_START */
 	DBG_LIB_END = 24,
@@ -62,7 +62,7 @@ enum loglevel_e {
 #endif
 
 /**
- * Unsolicited response handler callback
+ * Unsolicited response code handler callback
  * @param urc_code			URC code @ref sysurc_e
  * @param urc_param			URC parameter
  */

cores/logicrom/logicromsdk/include/os_api.h

@@ -85,15 +85,16 @@ void sys_setsleep(int type);
 void os_task_sleep(unsigned int ms);
 
 /**
- * Get message from task external queue
+ * Get message from task message queue
  * @param msg		[in] Pointer to OS message structure @ref osmsg_t
  * @return			0 on success, negative value on error
  */
 int os_message_get(struct osmsg_t *msg);
 
 /**
- * Send message to a task external queue, Maximum number of messages are 30
+ * Send message to a task message queue, Maximum number of messages are 30
  * @note on GSM Platform, an assert is raised if more than 30 messages are sent to task queue.
+ *
  * @param dest_taskid	[in] Destination task id
  * @param message		[in] Message ID
  * @param param1		[in] Parameter 1

cores/logicrom/logicromsdk/include/proto/modbus.h

@@ -9,7 +9,10 @@
 #define INC_MODBUS_H_
 
 #include <stdint.h>
-#include <termios.h>
+
+#ifdef __cplusplus
+extern "C" {
+#endif
 
 /**
  * Modbus Error codes
@@ -117,10 +120,6 @@ struct modbus_t {
  */
 typedef void (*mb_dirctl)(int dir);
 
-#ifdef __cplusplus
-extern "C" {
-#endif
-
 /**
  * Initialize MODBUS
  * @param com		[in] UART device file (e.g. /dev/ttyS1)
@@ -132,14 +131,14 @@ int mb_init(const char *com, int mode, mb_dirctl func);
 
 /**
  * Configure MODBUS Parameters
- * @param baud		[in] Baudrate value as in termios.h e.g. B9600
+ * @param baud		[in] Baudrate value
  * @param com_para	[in] Communication parameter data bits, parity and stopbit in ascii format e.g. "8N1", "8E2"\n
  * 					Data bits: 8, 7, 6, 5 (not supported on all platforms)\n
  * 					Parity: N - None, E - Even, O - Odd Parity\n
  * 					Stop Bits: 1 or 2
  * @return			For return value see @ref mb_err_e
  */
-int mb_config(speed_t baud, const char *com_para);
+int mb_config(unsigned int baud, const char *com_para);
 
 /**
  * Perform a MODBUS request

cores/logicrom/logicromsdk/include/remotedbg.h

@@ -20,7 +20,7 @@ extern "C" {
  *
  * Once connected, remote server will be greeted with device parameter message in following format
  * $RDBG,[Module UID],[IMEI]#[CR][LF]
- * and login prompt will be shown for remote console
+ * and followed by a login prompt.
  */
 void remote_debug_enable(void);