对Tools文件夹下的几个工具做一个简单的介绍:
这些工具大多数都要在PC上的命令行下使用,所以在windows XP或Win 7下,使用快捷键WIN+R后输入cmd,在进入到这些小程序所在的路径下,这样使用这些程序转换或生成的文件也在该程序所在的目录下。
另外,大多数的源程序都提供C或C++源码,并已经编译生成,放在bin文件夹下,没有编译的可自行使用相关工具编译即可。
1) Ethernet Flash Downloader
作用:
这个程序主要是用来通过使用以太网连接的bootloader给开发板下载应用程序,在功能上同LMFlashProgramer有相同的部分。
主要用法举例:
eflash -i=192.168.0.100 -–m= 00.1a.b6.00.64.00 hello.bin
通过以太网给mac地址是00.1a.b6.00.64.00的并指定其升级过程中的IP地址是192.168.0.100的开发板下载程序hello.bin
2) Finder
作用:
这个程序会显示连接在本地网络上的开发板的IP地址、MAC地址、客户端地址和其主中应用的简单描述,这只有在开发板上移植了lwIP协议栈并包含lacator程序模块的时候才会发挥作用。当一些开发板上没有显示屏的时候,要知道其中通过DHCP或者AUTOIP自动分配的IP地址,用这个小程序来获取是很有用的。
用法:
双击打开或者在命令行下运行即可。
3) Web Filesystem Generator
作用:
为lwIP web服务器生成网页数据。这个程序可以把一个文件夹中包含htm、ssi、shtml、ico、gif等网页数据文件转换成一个C语言的头文件。再把这个生成的头文件包含到工程中之后,经过编译可以把网页数据下载到开发板中,然后通过以太网连接就可以访问这个web服务器中的网页。
主要用法举例:
1. 把设计的网页文件都放到一个文件夹中,比如给该文件夹命名为fs
2. 把makefsfile复制到与该文件夹所在的同一个目录
3. 打开命令行,进入到makefsfile所在的路径
4. 输入命令:makefsfile –i fs –o lm-fsdata.h –h –r
-h表示生成不含http头部的网页数据。
-r 表示直接覆盖原来生成的网页数据,而不必询问。
4) Serial Flash Downloader
作用:
这个程序主要是用来通过使用串口连接的bootloader或者是Stellaris Serial Flash Loader给开发板下载程序,同样和Stellaris Flash Programer的串口下载有功能相同的地方。
主要用法举例:
例如通过串口1,关闭自动波特率,下载二进制文件boot_demo1.bin
sflash boot_demo1.bin -p 0x2800 -r 0x2800 -c 1 -d
5) USB DFU Programmer
作用:
这个程序主要是用来通过使用USB连接的USB Device Firmware Upgrade bootloader给开发板下载程序。另外,这个程序也可用来从flash中读回已经存在的应用程序或者一个子扇区,并把它存为二进制文件或者一个可被下载的DFU镜像文件。
此工具的源文件在tools/dfuprog目录下,该工具的二进制文件还可以在http://www.luminarymicro.com/products/software_updates.html上下载。
主要用法举例:
1.把二进制文件program.bin写到地址为0x1800的flash中去:
Dfuprog –f program.bin –a 0x1800
2.把一个DFU格式的文件program.dfu通过连接的第二个USB DFU 设备下载到DFU文件制定的flash地址中去:
Dfuprog –I 1 –f program.dfu
3.把当前存在的应用程序镜像读出来并保存到一个duf格式的文件中去:
Dfuprog –u –f appimage.dfu
6) USB DFU Wrapper
作用:
这个程序的主要作用是通过USB 设备固件升级协议准备一个二进制文件下载到Flash中的指定位置,一个Stellaris指定的前缀和一个DFU标准后缀将被添加到该二进制文件中。
主要用法举例:
下面是生成一个DFU包,指定镜像下载地址为0x1800
Dufwrap –i program.bin –o program.dfu –a 0x1800
7) Free Type Rasterizer
作用:
这个程序的主要作用是把一种字体转换为图形库可识别的格式。包括TrueType®,OpenType®,PostScript®Type1,andWindows® FNT fonts等在内的能被此工具识别的都可以用来转换。一个完整的支持表单可以参考http://www.freetype.org。
主要用法举例:
下面的例子从test.ttf产生一个24-point的字体文件test
Ftrasterize –f test –s 24 test.tff
8) USB DFU Library
LMDFU是一个为Stellaris USB bootloader提供的USB设备固件升级功能的上层接口的windows下的动态链接库。该库被dufprog和LMFlash通过USB从基于Stellaris的板上下载或上传应用程序镜像。
9) GIMP Script For Texas Instruments Stellaris Button
这是一个GMIP的script-fu插件,生成的按钮图像可以被按钮控件使用。该工具生成的图像必须保存为PPM文件以便使用pnmtoc工具转换成一个c数组。
10) USB Dynamic Link Library
LMUSBDLL是一个简单的windows动态链接库,为通过USB连接的Stellaris 例程提供底层的包读取和包写入功能。这个DLL是在Microsoft WinUSB接口的基础上编写的并且确保windows 侧边栏的应用程序都不包含WinUSB头文件。
此DLL的源代码在tools/lmdfu文件夹下。
11) String Table Generator
作用:
把一个逗号分离的文件(.csv)转换成Stellaris 图形库可使用的字符串表。源文件.csv是一种简单的支持多语言的字符串的格式,一个.c和.h文件将被生成并可以和图形库一起被编译到程序中去实现相应功能,为了节省存储空间,字符串是被压缩过。
主要用法举例:
下面将在str.c中创建一个基于str.csv字符表,并把原型存在在str.h中:
Mkstringtable str.csv str
在生成的str.c文件中,在g_pucTablestr中将有有个字符串表。
12) NetPNM Converter
作用:
把一个NetPBM图像文件转换为Stellaris 图像库可识别的格式。源文件必须是一个最原始的PPM格式(也就是带有 P6 标签)的文件。
主要用法举例:
下面将把一个压缩的图片foo.ppm转换到foo.c中:
Pnmtoc –c foo.ppm>foo.c
13) USB Bulk Data Transfer Example
usb_bulk_example是一个与StellarisWare里的usb_dev_bulk相连的windows命令行应用程序,这个程序寻找在USB总线上的Stellaris设备,如果找到提示用户键入字符串并被发送到Stellaris板上的应用程序,这个应用程序将转化键入的字符串并返回现实数据到USB主机。
源代码在tools/usb_bulk_example中。 |