USB设备开发学习(四)

从本篇开始就要研究USB设备开发硬件部分的知识,本系列硬件部分文章的学习案例来源于《圈圈教你玩USB》。

准备工作

要做硬件开发,第一步肯定都是硬件设计,做硬件设计就包含了设计电路图,布线,出板子,焊接等步骤。

不过对于新手来说,不建议从第一步做起,建议直接买一个成品设备,然后把软件开发部分的知识搞懂后,再尝试自行进行硬件设计的工作。

因此,本篇文章将从单片机开发开始进行学习,后续文章会补上硬件设计的内容。在此前提下,第一步变为需要再淘宝/咸鱼之类的网站上购买相关开发版,可以搜索关键字:圈圈教你usb开发板,这里不提供购买链接,请自行解决开发板的问题,如果不想购买现成的开发板,并且对自己的动手能力有信心,可以参考本系列文章后续,硬件设计的文章。

本文案例中使用的设备如下图所示,包含运费花费了57¥(个人自行设计打板的总花费并不比购买成品低):

usb4_0

图1:USB开发51单片机

在购买了成品单片机后,还可以从商家那获取该单片机的原理图,如下图所示:

usb4_1

图2:USB开发51单片机原理图

还需要了解两个主要芯片的型号,以便于搜索芯片相关文档,其中51单片机芯片的型号为:STC89C52RC,USB芯片的型号为:PDIUSBD12,知道芯片型号后可以使用搜索引擎获取相关文档,后期开发的时候需要参考相关文档。

如果没做过单片机开发的,可以把单片机理解成一个集成了CPU,RAM,ROM的芯片,我们后面进行的开发工作就是用来控制单片机运行,编译出来的程序需要写入(常用说法是用下载)到单片机的ROM当中,不同的单片机下载的方式不一样。对于STC89C52RC单片机来说,可以直接通过TTL串口来进行下载程序到单片机中。

因此,还需要准备一个串口线,因为准备的开发板设计了RS-232串口母口,所以可以准备一个RS-232串口公口转USB线。或者直接用单片机的TTL串口,就需要准备一个TTL串口转USB的设备。

开发环境

大部分情况下,开发单片机用的都是Windows系统,所以绝大部分好用的工具都是Windows程序。但是,我还是喜欢在Mac系统下做开发工作,经过研究,搭建了Mac下的单片机开发环境。

首先安装VSCode,再安装PlatformIO IDE[1]插件,一个轻量的单片机开发环境就搭好了。

在本文的样例中,需要修改开发目录下的platformio.ini,按以下示例进行修改:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
; PlatformIO Project Configuration File
;
; Build options: build flags, source filter
; Upload options: custom upload port, speed and extra flags
; Library options: dependencies, extra library storages
; Advanced options: extra scripting
;
; Please visit documentation for the other options and examples
; https://docs.platformio.org/page/projectconf.html

[env:STC89C52RC]
platform = intel_mcs51
board = STC89C52RC
upload_port = /dev/tty.usbserial-0001 # ttl串口

按照上述过程进行环境搭建,不需要再额外的按照编译器,PlatformIO IDE会自带编译器,使用的编译工具叫sdcc。下载器(把编译好后的程序写入单片机的工具)使用的叫stcgal[2]PlatformIO IDE也可以一起安装好,但是有时候需要单独使用stcgal,如果在终端中直接使用PlatformIO IDE中安装的stcgal会比较麻烦,步骤如下:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
$ source ~/.platformio/penv/bin/activate
python3 ~/.platformio/packages/tool-stcgal/stcgal.py -h
usage: stcgal.py [-h] [-a] [-r RESETCMD] [-P {stc89,stc12a,stc12b,stc12,stc15a,stc15,stc8,usb15,auto}] [-p PORT]
[-b BAUD] [-l HANDSHAKE] [-o OPTION] [-t TRIM] [-D] [-V]
[code_image] [eeprom_image]

stcgal 1.6 - an STC MCU ISP flash tool
(C) 2014-2018 Grigori Goronzy and others
https://github.com/grigorig/stcgal

positional arguments:
code_image code segment file to flash (BIN/HEX)
eeprom_image eeprom segment file to flash (BIN/HEX)

options:
-h, --help show this help message and exit
-a, --autoreset cycle power automatically by asserting DTR
-r RESETCMD, --resetcmd RESETCMD
shell command for board power-cycling (instead of DTR assertion)
-P {stc89,stc12a,stc12b,stc12,stc15a,stc15,stc8,usb15,auto}, --protocol {stc89,stc12a,stc12b,stc12,stc15a,stc15,stc8,usb15,auto}
protocol version (default: auto)
-p PORT, --port PORT serial port device
-b BAUD, --baud BAUD transfer baud rate (default: 19200)
-l HANDSHAKE, --handshake HANDSHAKE
handshake baud rate (default: 2400)
-o OPTION, --option OPTION
set option (can be used multiple times, see documentation)
-t TRIM, --trim TRIM RC oscillator frequency in kHz (STC15+ series only)
-D, --debug enable debug output
-V, --version print version info and exit

所以建议自行使用pip install stcgal来安装该工具,这样就可以在终端中直接使用stcgal命令了。

测试串口

设备连接图如下所示:

usb4_2

图3:USB开发板和开发电脑的连接示意图

对照着原理图,假设TTL转USB设备为A,USB开发板为B,那么连接如下所示:

  • A的GND连B的任意一个GND。
  • A的5V连B的任意一个VCC。
  • A的TXD连B单片机的RXD。
  • A的RXD连B单片机的TXD。

B单片机的RXD和TXD口,可以参见原理图中J8和J3的10/11口。

如果一切正常,可以在/dev目录下发现/dev/tty.usbserial-0001文件,不过会由于使用的TTL转USB的设备不同,导致生成的文件不一样,但是文件都会处于/dev目录下,文件名一般有tty, usb等关键字。通过插拔操作,查看/dev目录下的文件变动,也是一个方法。

如果存在/dev/tty.usbserial-0001文件的情况下,运行以下命令,可以查看单片机是否能正常工作:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
$ stcgal -P stc89 -p /dev/tty.usbserial-0001
Waiting for MCU, please cycle power:
# 程序将会在输入上面的数据后卡住,这时候需要重新拔插VCC线,无所谓是在A设备上还是B设备上,经验来说,拔插B设备上的VCC线最方便。
# 如果一切正常,会得到以下输出
Target model:
Name: STC89C52RC/LE52R
Magic: F002
Code flash: 8.0 KB
EEPROM flash: 6.0 KB
Target frequency: 22.090 MHz
Target BSL version: 6.6C
Target options:
cpu_6t_enabled=False
bsl_pindetect_enabled=False
eeprom_erase_enabled=False
clock_gain=high
ale_enabled=True
xram_enabled=True
watchdog_por_enabled=False
Disconnected!

第一个单片机程序

一般情况下,我们学习编程语言写的都是Hello World,但是在单片机开发中,实现一个Hello World是比较困难的。首先你得需要一个屏幕,其次你得编写该屏幕的驱动,才能在屏幕上输出Hello World。再简单点,就是通过串口输出Hello World,但是也得编写一个串口驱动。

第一个程序就编写驱动是非常不友好的,对于我来说,编写第一个程序的目的是为了走通开发的主要流程,能正常编译,编译的程序能正常下载到单片机中,并且单片机能正常运行。所以我们可以降低一下要求,第一个程序,我们的目标是点亮一盏LED灯。

通过原理图可以看出,单片机的P20P27口连接到了LED1-LED8这8盏LED灯。这8盏LED灯的另一头连接到了1k欧姆的排阻(RP1)上,而排阻连接到了VCC电源上。所以当P20输出0的情况下,LED1电路就连通了,LED1灯就会发光。

现在,我们来编写第一个程序,让P20输出为0,代码如下所示:

1
2
3
4
5
6
7
8
// src/main.c
#include <8051.h>

void main()
{
P2_0 = 0;
while (1);
}

通过PlatformIO IDE创建的项目目录如下所示:

1
2
3
$ ls -a
. .gitignore .vscode lib src
.. .pio include platformio.ini test

由于VSCode装了PlatformIO IDE插件,所以在打开了PlatformIO IDE项目的情况下,编写好代码后,在左下角有一个☑️图标,点击就可以编译编写好的程序,也可以使用快捷键:shift + cmd + b

编译好后,可以点击build图标右边的➡️图标,表示下载编译好的程序到单片机中。在输出行看到Cycling power: done时,重新拔插VCC线,就可以下载程序到单片机中了。

如果一切正常,在下载结束后,就可以看到单片机中LED1灯常亮。

在第一个程序写完后,可以去看一下8051.h头文件的内容,里面对51单片的各个端口还有寄存器做了宏定义,这样让我们可以很方便的控制单片机的各个端口。比如P2_0就表示原理图中的P20端口,大小为1bit,P2表示的是单片机的P20P27端口,大小为1byte。

不同架构的单片机使用的头文件是不一样的,可以通过搜索引擎或者GPT根据芯片型号来得知该时候哪个头文件,搜索/询问的时候记得带上sdcc关键词。

第二个程序——定时器中断

第二个程序我们来了解一下单片机的定时器中断,不同单片机的定时器中断实现不一样,这个时候需要参考单片机的相关文档,请通过芯片型号+pdf关键字,自行使用搜索引擎获取芯片文档。

首先,需要编写一个定时器的初始化函数,代码如下所示:

1
2
3
4
5
6
7
8
9
10
//定时器0初始化
void Timer0Init()
{
TMOD &= 0xF0; //设置定时器模式
TMOD |= 0x01; //设置定时器模式
TL0 = 0x00; //设置定时初值
TH0 = 0x00; //设置定时初值
ET0 = 1; //使能定时器0中断
TR0 = 1; //启动定时器0
}

通过直接对寄存器赋值的方式来对单片机进行配置,各个寄存器表示的内容可以参考文档,比如TMOD寄存器的功能描述如下图所示:

usb4_3

图4:TMOD寄存器功能描述

TR0寄存器属于TCON寄存器的比特位,功能描述如下图所示:

usb4_4

图5:TCON寄存器功能描述

ET0寄存器属于IE中断寄存器的比特位,功能描述如下图所示:

usb4_5

图6:中断寄存器功能描述

通过上面三个寄存器的功能描述,可以看出Timer0Init函数的作用有以下几个:

  • 开启定时器0,设置模式1,为16位定时器。
  • 16位定时器使用的计数器为8bit的TL0和8bit的TH0,那么最大有65536次计数
  • TL0和TH0组合成了定时器的计数器T0,每个工作周期,T0 += 1,当T0溢出时,设置TF0寄存器为1,触发中断。

定时器有一个重要的参数,那就是时间,表示定时器多长时间一个循环。通过上面的总结,我们可以知道,TL0和TH0寄存器就是用来控制循环时间的寄存器。根据文档中一个计算示例,我们来算算该单片机的时间参数该如何设置,如下图所示:

usb4_6

图7:定时器时间计算案例

通过USB开发版的原理图,可以看出单片机的X1/X2端口外接了外部晶振,该晶振的频率为22.1184MHz,那么计算一下一个机器周期:12 / 22118400 ≈ 0.54μs

最大循环时间:65536 * 0.54 ≈ 35389.44μs ≈ 35ms

假设定义循环时间为20ms,那么可以求得T0的计数次数为:20 * 1000 / 0.54 = 36864

对计数次数取反,就是TL0/TH0寄存器的设置值:65536 - 36864 = 0x7000,那么需要设置:TL0 = 0x00, TH0 = 0x70

时间算出来了,那么就需要开始实现定时器的功能了,在本次的测试案例中,我们定义一个走马灯功能,我们有8个LED灯,灯从左向右循环亮起,间隔时间1s,实现代码如下所示:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
#define LEDs P2
volatile uint8 times = 0;
volatile uint8 TLED = 0b11111110;

//定时器0中断
void Timer0Isr() __interrupt 1
{
// 每20ms触发一次中断
TH0 = 0x70;
TL0 = 0x00;

// 使LED从左往右闪烁,间隔1s,1s / 20ms = 50次循环
if (times == 50) {
times = 0;
LEDs = TLED;
TLED = (TLED << 1) | (TLED >> 7);
// 不建议使用LEDs = (TLED << 1) | (TLED >> 7);因为如果LED坏了会影响LEDs的值
} else {
times++;
}
}

最后,再简单写一个main函数,就可以编译程序了,main函数如下所示:

1
2
3
4
5
6
7
8
9
10
void Timer0Isr(void) __interrupt 1; //在SDCC编译器中,如果不声明中断,中断不会生效

void main()
{
// 初始化定时器
Timer0Init();
// 开启中断,EA为IE中断寄存器的比特位,是所有中断的总开关
EA = 1;
while (1);
}

这样,一个走马灯的程序就开发完了,接着进行编译,下载到单片机中,就可以看到LED灯以1s的间隔,从左往右依次亮起。

第三个程序——TTL串口中断

STC89C52RC单片机自带TTL串口,可以通过该串口下载程序到单片机中,同样也可以使用串口与单片机通信。

首先来看一下串口的初始化函数,代码如下所示:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
#define Fclk 22118400UL
#define BitRate 9600UL

// 初始化UART配置
void InitUART()
{
EA = 0; // 暂时关闭中断
TMOD &= 0x0F; // 定时器1模式控制在高4位
TMOD |= 0x20; // 定时器1工作在模式2,自动重装模式
SCON = 0x50; // 串口工作在模式1
TH1 = 256 - Fclk/(BitRate*12*16); // 计算定时器重装值
TL1 = 256 - Fclk/(BitRate*12*16); //
PCON |= 0x80; // 串口波特率加倍
ES = 1; // 允许串口中断
TR1 = 1; // 启动定时器1
REN = 1; // 允许接收
EA = 1; // 开启中断
}

初始化的各个寄存器同样是通过看芯片文档可以理解各自的用途,如果文档里写的比较简单,可以单独搜索该寄存器,或者询问GPT,都是很容易理解作用的寄存器。

但是有几个注意事项:

  1. Fclk为晶振的频率,BitRate为设置的串口的波特率,在实际开发的过程中发现,可能是为了节省空间,SDCC在编译的过程中把整型都默认设置为short。对于频率和波特率,short型明显长度不够,所以需要在整型结尾加上UL表示unsigned long类型值。
  2. PCON |= 0x80实际表示的是SMOD = 1,由于在计算TH1值的时候使用了除法,那么就会出现除不尽的情况,而TH1为1字节的整型,所以在遇到该情况时,可以设置SMOD=1,就有可能可以除尽了。
  3. SMOD=1时,TH1的计算公式为:256 - Fclk/(BitRate*12*16),当SMOD=0时,TH1的计算公式为:256 - Fclk/(BitRate*32*16)

接下来就是编写串口的中断函数和串口的读写函数,代码如下所示:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
volatile char Sending = 0; // 发送标志

// UART 接收中断服务
void UARTIsr() __interrupt 4
{
if (RI) // 当RI = 1时,表示接受到数据,数据储存在SBUF中
{
// 清除中断请求
RI = 0;
SBUF = SBUF; // 用户输入回显
}
if (TI) // 当TI = 1时,表示开始写数据,数据储存在SBUF中
{
TI = 0;
Sending = 0;
}
}

// 发送一个字符
void UartSendChar(char c)
{
SBUF = c;
Sending = 1; //设置发送标志
while(Sending); //等待发送完成
}

// 发送一个字符串
void UartSendString(char *s)
{
while (*s)
{
UartSendChar(*s++);
}
}

接下来可以简单编写一个main函数,代码如下所示:

1
2
3
4
5
6
7
8
9
void UARTIsr() __interrupt 4;

void main()
{
// 初始化Uart函数
InitUART();
UartSendString("Hello World!\n");
while (1);
}

编译程序,下载到单片机中,这个时候就可以和USB开发版进行串口通信,波特率为9600,模式为8N1。每次reset单片机,都可以在串口中接收到Hello World!字符串,并且可以看到输入字符的回显,如下图所示:

usb4_7

图8:串口输出

第四个程序——检测PDIUSBD12芯片是否正常

学完了前面三个程序后,可以说对单片机开发是入门了,能进行以下几种基础操作:控制端口输出,编写中断函数,通过uart口输出调试信息。

接下来第四个程序,简单的来说,就是让单片机与其他外部芯片进行通信。这个时候我们需要参考原理图,查看PDIUSBD12芯片的哪些引脚和单片机相连,还需要参考D12芯片的参考文档来编写交互代码,简单的来说就两种函数:单片机传输数据到D12芯片的写函数,单片机获取D12芯片返回数据的读函数。

首先,参考D12文档和USB开发版原理图,我们来设置一些宏定义,代码如下所示:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
// A0值的宏定义
// A0引脚表示数据传输口传输的是数据还是命令,命令为1,数据为0。
#define PDIUSBD12_DATA_ADDR 0x00
#define PDIUSBD12_CMD_ADDR 0x01

// D12的D0-D7引脚为数据传输口,共8位1字节,连接到单片机的P00-P07
#define PDIUSBD12_DATA P0
// PDIUSBD12芯片与单片机其他连接引脚
#define PDIUSBD12_INT P3_2
#define PDIUSBD12_A0 P3_5
#define PDIUSBD12_WR P3_6
#define PDIUSBD12_RD P3_7

// 选择命令或数据地址
#define D12SetCommandAddr() PDIUSBD12_A0 = PDIUSBD12_CMD_ADDR
#define D12SetDataAddr() PDIUSBD12_A0 = PDIUSBD12_DATA_ADDR

// WR和RD控制
#define D12SetWr() PDIUSBD12_WR = 1
#define D12ClrWr() PDIUSBD12_WR = 0
#define D12SetRd() PDIUSBD12_RD = 1
#define D12ClrRd() PDIUSBD12_RD = 0

// 获取中断状态
#define D12GetInterrupt() PDIUSBD12_INT

// 读写数据
#define D12GetData() PDIUSBD12_DATA
#define D12SetData(x) PDIUSBD12_DATA = (x)

// 将数据口设置为输入状态,51单片机端口写1就是为输入状态
#define D12SetPortIn() PDIUSBD12_DATA = 0xFF
// 将数据口设置为输出状态,由于51单片机是准双向IO口,所以不用切换,为空宏
#define D12SetPortOut()

接着根据下面的并行接口时序图来编写读写函数,时序图如下所示:

usb4_8

图9:并行接口时序图

代码如下所示:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
// D12 写命令
void D12WriteCommand(uint8 command)
{
D12SetCommandAddr(); // 表明DATA中的数据为命令
D12ClrWr(); // WR_N置低
D12SetPortOut(); // 将数据口设置为输出状态
D12SetData(command); // 将命令写入数据口
D12SetWr(); // WR_N置高
D12SetPortIn(); // 将数据口设置为输入状态
}

// D12 写数据
void D12WriteData(uint8 command)
{
D12SetDataAddr(); // 表明DATA中的数据为数据
D12ClrWr(); // WR_N置低
D12SetPortOut(); // 将数据口设置为输出状态
D12SetData(command); // 将命令写入数据口
D12SetWr(); // WR_N置高
D12SetPortIn(); // 将数据口设置为输入状态
}

// D12 读单字节
uint8 D12ReadByte()
{
uint8 data;
D12SetDataAddr(); // 表明DATA中的数据为数据
D12ClrRd(); // RD_N置低
data = D12GetData(); // 读取数据
D12SetRd(); // RD_N置高
return data;
}

接着,通过文档资料发现存在一个ReadID = 0xFD命令,可以获取D12芯片的ID编码,以此来判断芯片是否能正常工作,ID值为固定的0x1012。根据该信息,编写以下代码:

1
2
3
4
5
6
7
8
9
10
11
12
// PDIUSBD12芯片读ID命令
#define D12_READ_ID 0xFD

// D12 执行ReadID命令
uint16 D12ReadID()
{
uint16 id;
D12WriteCommand(D12_READ_ID); // 执行ReadID命令
id = D12ReadByte(); // 读取ID低字节
id |= (D12ReadByte() << 8); // 读取ID高字节
return id;
}

获取到ID值后,打算通过串口把ID值输出,所以需要编写一个输出整型的函数,代码如下所示:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
__code uint8 HexTable[] = {'0', '1', '2', '3', '4', '5', '6', '7', '8', '9', 'A', 'B', 'C', 'D', 'E', 'F'};

// 将short转换为hex字符串
void UartSendShortToHex(uint16 x)
{
uint8 i;
uint8 output[7] = {0,};
output[0] = '0';
output[1] = 'x';
for (i = 5; i >= 2; i--)
{
output[i] = HexTable[x & 0x0F];
x >>= 4;
}
UartSendString(output);
}

最后,就是编写main函数,读取D12芯片的ID并且输出,代码如下所示:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
void main()
{
uint16 idv;

// 初始化Uart函数
InitUART();
UartSendString("Hello World!\r\n");
// 获取芯片ID
idv = D12ReadID();
// 输出芯片ID
UartSendString("Get PDIUSBD12 ID: ");
UartSendShortToHex(idv);
UartSendString("\r\n");
while (1);
}

编译以上代码,并且下载到单片机当中,得到结果如下图所示:

usb4_9

图10:示例四输出结果

得到以上结果,说明D12芯片一切正常,可以进行后续开发工作。后续的USB开发工作将在后续文章中继续讲解。

参考链接

  1. https://marketplace.visualstudio.com/items?itemName=platformio.platformio-ide
  2. https://github.com/grigorig/stcgal

USB设备开发学习(四)

https://nobb.site/2024/03/07/0x88/

Author

Hcamael

Posted on

2024-03-07

Updated on

2024-08-29

Licensed under