==================================
⭐建立一个lvgl项目
==================================
要在我们的项目中使用 lvgl ，我们起码需要获取到官方的这两个库：

- lvgl(lvgl)核心图形库的官方 GitHub 仓库地址：https://github.com/lvgl/lvgl。
- lvgl(lv_drivers)输入输出设备驱动官方 GitHub 仓库地址：https://github.com/lvgl/lv_drivers

我们可以克隆或下载这两个库的最新版本，将它们复制到我们的项目中，然后进行适配。

- 目录 lvgl 就是 lvgl 的官方图形库
- 目录 lv_drivers 是 lvgl 输入输出设备驱动官方示例配置
- 目录 `lv_examples`_ 是 lvgl 的官方demo(可选，但不要直接使用到实际项目中)

.. figure:: http://photos.100ask.net/lvgl/02_poring/02_project/01_lvgl_library.png

.. _lv_examples: https://github.com/lvgl/lv_examples


配置文件
##################################
上面的三个库中有一个类似名为 **lv_conf_template.h** 的配置头文件(template就是模板的意思)。通过它可以设置库的基本行为，裁剪不需要模块和功能，在编译时调整内存缓冲区的大小等等。

1. 将 **lvgl/lv_conf_template.h** 复制到 lvgl 同级目录下，并将其重命名为 ``lv_conf.h`` 。打开文件并将开头的 ``#if 0`` 更改为 ``#if 1`` 以使能其内容。
#. 将 **lv_drivers/lv_drv_conf_template.h** 复制到 lv_drivers 同级目录下，并将其重命名为 ``lv_drv_conf.h`` 。打开文件并将开头的 ``#if 0`` 更改为 ``#if 1`` 以使能其内容。
#. (可选)将 **lv_examples/lv_ex_conf_template.h** 复制到 lv_examples 同级目录下，并将其重命名为 ``lv_ex_conf.h`` 。打开文件并将开头的 ``#if 0`` 更改为 ``#if 1`` 以使能其内容。


.. figure:: http://photos.100ask.net/lvgl/02_poring/02_project/02_lvgl_conf.png

	准备lvgl配置文件


.. figure:: http://photos.100ask.net/lvgl/02_poring/02_project/03_change_conf_file.png

	使能配置文件


:: 

   lv_conf.h 也可以复制到其他位置，但是应该在编译器选项中添加 ``LV_CONF_INCLUDE_SIMPLE`` 定义 (例如，对于 gcc 编译器为 ``-DLV_CONF_INCLUDE_SIMPLE`` ) 并手动设置包含路径。



在配置文件中，注释说明了各个选项的含义。我们在移植时至少要检查以下三个配置选项，其他配置根据具体的需要进行修改：

-  ``LV_HOR_RES_MAX`` 显示器的水平分辨率。 
-  ``LV_VER_RES_MAX`` 显示器的垂直分辨率。 
-  ``LV_COLOR_DEPTH`` 颜色深度，其可以是：

  - 8  - RG332
  - 16 - RGB565
  - 32 - (RGB888和ARGB8888)



初始化lvgl
##################################
准备好这三个库：lvgl、lv_drivers、lv_examples 后，我们就要开始使用lvgl带给我们的功能了。使用 lvgl 图形库之前，我们还必须初始化 lvlg 以及相关其他组件。初始化的顺序为：

1. 调用 lv_init() 初始化 lvgl 库;
#. 初始化驱动程序；
#. 在 LVGL 中注册显示和输入设备驱动程序；
#. 在中断中每隔 ``x毫秒`` 调用 ``lv_tick_inc(x)`` 用以告知 lvgl 经过的时间；
#. 每隔 ``x毫秒`` 定期调用 ``lv_task_handler()`` 用以处理与 lvgl 相关的任务。


Windows初始化示例(Cdoe::Blocks)
==================================
如果你是基于 windows上的IDE模拟器(推荐) 进行学习，请先 `点击这里下载配置好的项目工程`_ 及 ``windows上的IDE模拟器(Cdoe::Blocks)`` 用于后面的学习。


.. code-block:: c
    :linenos:
	
	#if WIN32
	int APIENTRY WinMain(HINSTANCE hInstance, HINSTANCE hPrevInstance, LPSTR szCmdLine, int nCmdShow)
	#else
	int main(int argc, char** argv)
	{
		/*Initialize LittlevGL*/
		lv_init();

		/*Initialize the HAL for LittlevGL*/
		hal_init();

		/*Check the themes too*/
		lv_disp_set_default(lv_windows_disp);

		/*Run your APP here */


	#if WIN32
		while(!lv_win_exit_flag) {
	#else
		while(1) {
	#endif // WIN32
			/* Periodically call the lv_task handler.
			 * It could be done in a timer interrupt or an OS task too.*/
			lv_task_handler();
			usleep(5*1000);       /*Just to let the system breath*/
			lv_tick_inc(5*1000)
		}
		return 0;
	}



Linux初始化示例
==================================
如果你是基于 Linux开发板 进行学习，请先 `点击这里下载配置好的项目工程`_ 用于后面的学习。


.. code-block:: c
    :linenos:
	
	int main(void)
	{
		/* LittlevGL init */
		lv_init();
		
		/* Linux frame buffer device init */
		fbdev_init();

		/* A small buffer for LittlevGL to draw the screen's content */
		static lv_color_t buf[DISP_BUF_SIZE];

		/* Initialize a descriptor for the buffer */
		static lv_disp_buf_t disp_buf;
		lv_disp_buf_init(&disp_buf, buf, NULL, DISP_BUF_SIZE);

		/* Initialize and register a display driver */
		lv_disp_drv_t disp_drv;
		lv_disp_drv_init(&disp_drv);
		disp_drv.buffer = &disp_buf;
		disp_drv.flush_cb = fbdev_flush;
		lv_disp_drv_register(&disp_drv);
		
		//hal_init
		lv_disp_set_default lv_windows_disp


		/* Linux input device init */
		evdev_init();
		
		/* Initialize and register a display input driver */
		lv_indev_drv_t indev_drv;
		lv_indev_drv_init(&indev_drv);      /*Basic initialization*/

		indev_drv.type = LV_INDEV_TYPE_POINTER;
		indev_drv.read_cb = evdev_read;   //lv_gesture_dir_t lv_indev_get_gesture_dir(const lv_indev_t * indev)
		lv_indev_t * my_indev = lv_indev_drv_register(&indev_drv); 
		
		

		/*Run your APP here */

		
		/*Handle LitlevGL tasks (tickless mode)*/
		while(1) {
			lv_task_handler();
			usleep(5000);
			lv_tick_inc(5*1000);
		}

		return 0;
	}



STM32F103初始化示例
==================================
如果你是基于 STM32F103 进行学习，请先 `点击这里下载配置好的项目工程`_ 用于后面的学习。

TODO





.. _点击这里下载配置好的项目工程: http://download.100ask.org/gui/lvgl/100ask_lvgl.html