wuhanstudio / Rt U8g2
Programming Languages
Projects that are alternatives of or similar to Rt U8g2
rt-u8g2
0、介绍
u8g2 原先是 Arduino 平台上的一个单色屏驱动，现在移植到了 rt-thread，可以满足各种各种各样的需求。
游戏开发 (examples/games/space_trash)
用户界面 (examples/page_buffer/icon_menu)
绘图 (examples/page_buffer/graphic_test)
1、U8G2 特点
1.1 支持屏幕多，移植方便
使用 u8g2 的好处在于它支持近 200 种单色屏，同样的代码可以直接运行在不同的屏幕上，比如前面的游戏可以在各种屏幕上运行：
经典 128x64
OLED SSD1306 I2C
在这里可以看到所有支持的屏幕：
https://github.com/olikraus/u8g2/wiki/gallery
1.2 支持字体多
中文
韩文
日文
梵文
1.3 绘图函数多
支持各种绘图函数，而且自带各种 icon
总结一下 u8g2 的特点：
- 支持近 200 种单色屏，移植方便
- 支持各种绘图函数、图像与非操作，自带用户按键检测
- 支持 unicode 和 utf8，自带 100 多种字体和 100 多个 icon
2、项目说明
2.1 目录结构
说明：目录结构
| 名称 | 说明 |
|---|---|
| docs | 文档目录 |
| examples | 例子目录 |
| src | 源代码目录 |
| port | 针对特定平台的移植代码目录 |
2.2 许可证
-
The U8g2lib code (http://code.google.com/p/u8g2/) is licensed under the terms of the new-bsd license (two-clause bsd license). See also:
http://www.opensource.org/licenses/bsd-license.php -
The repository and optionally the releases contain icons, which are derived from the WPZOOM Developer Icon Set. WPZOOM Developer Icon Set by WPZOOM is licensed under a Creative Commons Attribution-ShareAlike 3.0 Unported License.
http://www.wpzoom.com/wpzoom/new-freebie-wpzoom-developer-icon-set-154-free-icons/ -
Fonts are licensed under different conditions.for detailed information on the licensing conditions for each font.
https://github.com/olikraus/u8g2/wiki/fntgrp
Check full LICENCE here.
2.3 项目依赖
说明：如果使用 I2C 液晶屏需要开启 I2C，GPIO 模拟 I2C 。
- Using I2C device drivers
- Use GPIO to simulate I2C
说明：如果使用 SPI 液晶屏需要开启 SPI 。
- Using SPI Bus/Device device drivers
3、如何使用 U8G2
使用 u8g2 package 需要在 RT-Thread 的包管理器中选择它，具体路径如下：
RT-Thread online packages
peripheral libraries and drivers --->
[*] U8G2: a u8g2 package for rt-thread
[*] Use hardware spi
(spi1) spi bus name (NEW)
(spi10) spi device name (NEW)
[*] Use hardware i2c
(i2c2) i2c device name
U8G2 Examples --->
然后让 RT-Thread 的包管理器自动更新，或者使用 pkgs --update 命令更新包到 BSP 中。
一共有50个例程，可以在源码 docs 目录下看到预览图。默认的例程都是用的软件I2C，如果觉得速度比较慢可以使用硬件I2C。
4、注意事项
- 默测试认使用 STM32F103，如果要使用到其他平台，请参照 移植说明，不过只要用的 RT-Thread 应当不需要额外的移植。
- 请使用 stm32 目录下的 bsp
- 编译需要开启 -std=c99
- 如果编译发现 flash 不够大，可以打开优化选项 -O3 或者参照 这里 去掉多余的字库
- 完整的 API 手册可以访问这个 链接
- 其他 常见问题 FAQ
5、感谢
6、联系方式
- 维护：Wu Han
- 主页：http://wuhanstudio.cc
- 联系：https://github.com/wuhanstudio/rt-u8g2/issues