东京奥运会可以说是奥运会历史上最特殊的一届，推迟一年、没有观众、环保奥运等。


为了能实时关注奖牌榜，有开发者周末在家使用STM32+ESP8266做了一个东京奥运会奖牌榜桌面小摆件，最终效果如下：

▲ 桌面效果1

▲ 桌面效果2

▲ 桌面效果3

原理是通过STM32驱动ESP8266连接网络，然后GET接口，读取到接口返回的JSON数据，然后进行JSON解析，LCD显示，使用不同的接口就是不同的功能。


以上两个API接口返回的数据都非常简短，只有几百字节，而奖牌榜接口返回的数据有20KB之多，使用STM32不能一次处理这么多的数据量，本文采用了一种简单的方法来进行数据截取，从而减少数据量。


都有哪些内容？


API接口获取
JSON数据预处理
JSON数据解析
显示效果
开源地址

API接口获取

在进行开发之前，首先要找到一个API接口，请求方式最好是GET，返回数据格式JSON格式的。先上网搜一下，发现已经有很多网友实现奖牌榜数据获取的功能，使用的大多是：Python、Java、PHP，使用的语言无所谓，重要的是API接口是否是我们想要的，最终找到了两个API接口。
第一个接口是央视网官方的东京奥运专题页面：

▲ 图：2020.cctv.com

网址如下：
http://2020.cctv.com/medal_list/index.shtml
F12打开开发者模式，可以找到页面请求的API地址：

▲ cntv_api

这个接口返回的数据量有11KB，格式化后有24KB，JSON数据格式（部分）：

▲ cntv_json

可以看到数据比较齐全，包括排名，金、银、铜、合计奖牌总数，国家ID，国家名称为UTF-16BE编码方式，而开发板上的字库为GBK编码，这一点不好处理。看看还有没有其他的接口。
第二个接口是我的小米手机负一屏界面呈现的奥运奖牌榜，类似于这种：

▲  手机界面

可以跳转到浏览器打开：
http://act.e.mi.com/olympic/index.html
F12打开开发者模式，可以找到请求的API地址：

▲ mi_api

这个接口返回的数据有21KB，格式化后有33KB，JSON数据格式（部分）：

▲ mi_json

这个接口返回数据比较丰富，同样数据量相比于央视网的要大一些，除了奖牌数量排名等信息，还包括每个国家的国旗图片地址，更新时间等。国家名称为UTF-8编码，要在我们的开发板上进行使用需要进行UTF8-GBK的转换。
综上，我们就获取到了两个API接口的信息：
奥运奖牌榜央视API接口：

1. TYPE: "TCP"
   
2. PORT: "80"
   
3. IP  : "111.206.176.78"
   
4. API : "http://api.cntv.cn/olympic/getOlyMedals?serviceId=pcocean&itemcode=GEN-------------------------------"

复制代码

奥运奖牌榜小米手机API接口

1. TYPE: "TCP"
   
2. PORT: "80"
   
3. IP  : "111.206.101.253"
   
4. API : "http://act.e.mi.com/olympic/medal_rank"

复制代码

为了方便在开发板上直接显示国家名称，我们采用小米手机的API接口。

JSON 数据预处理

通过分析API接口返回的数据，共包括前90名的奖牌数据，数据长度为21KB：

▲ mi_json

但是我们只需要前10名的数据即可。串口接口缓存长度设置为2500个字节，即返回的21KB字节数据，只接收前2500个字节，然后处理成JSON标准格式就可以了。
处理方法为，倒序查找最后一个}号的位置，将{之后的数据丢弃掉，然后添加上]}，这样就将截取的2500字节数据修改为了标准JSON格式数据：

▲ mi_json_deal

JSON数据解析

从上图也可以看出，JSON格式比较简单，使用cJSON可以很方便的进行解析。


定义一个结构体：

1. typedef struct medal{
   
2.     char rank[5];
   
3.     char countryname[50];
   
4.     char count[5];
   
5.     char gold[5];
   
6.     char silver[5];
   
7.     char bronze[5];
   
8.     char update_time[50];
   
9.     char countryid[10];
   
10. }medalObj;

复制代码

解析函数，只读取前7名的奖牌数据：

1. uint8_t parse_mi_data(void)
   
2. {
   
3.     cJSON *root, *data_obj, *list_obj;
   
4.     char *str;
   
5.     char dest[USART2_MAX_RECV_LEN];
   
6.     char *loc;
   
7.     char gbk[50];
   
8.     char utf8[50];
   
9. 
   
10.     medalObj *pobj;
    
11.     medalObj obj;
    
12.     int idx;
    
13. 
    
14.     pobj = &obj;
    
15. 
    
16.     str = (char *)USART2_RX_BUF;
    
17.     memset(dest, '\0', USART2_MAX_RECV_LEN);
    
18.     loc = strrchr(str, '}');
    
19.     strncpy(dest, str, loc-str+1);
    
20.     strcat(dest, "]}");
    
21.     printf("json data size: %d bytes\r\n", strlen(dest));
    
22. 
    
23.     root = cJSON_Parse((const char*)dest);
    
24. 
    
25.     if(root != 0)
    
26.     {
    
27.         printf("JSON format ok, start parse!!!\r\n");
    
28.         data_obj = cJSON_GetObjectItem(root, "data");
    
29.         if(data_obj->type == cJSON_Array)
    
30.         {
    
31.             int size = cJSON_GetArraySize(data_obj);
    
32.             for(idx = 0; idx < size; idx++)
    
33.             {
    
34.                 if(size >= 7 && idx <= 7)
    
35.                 {
    
36.                     list_obj = cJSON_GetArrayItem(data_obj, idx);
    
37. 
    
38.                     strcpy(obj.bronze, cJSON_GetObjectItem(list_obj, "medal_bronze_count")->valuestring);
    
39.                     strcpy(obj.rank, cJSON_GetObjectItem(list_obj, "rank")->valuestring);
    
40.                     strcpy(obj.count, cJSON_GetObjectItem(list_obj, "medal_sum_count")->valuestring);
    
41.                     strcpy(obj.silver, cJSON_GetObjectItem(list_obj, "medal_silver_count")->valuestring);
    
42.                     //utf8->gbk
    
43.                     memset(utf8, '\0', sizeof(utf8));
    
44.                     memset(gbk, '\0', sizeof(gbk));
    
45.                     strcpy(utf8, cJSON_GetObjectItem(list_obj, "country_name")->valuestring);
    
46.                     SwitchToGbk(utf8, gbk);
    
47. 
    
48.                     strcpy(obj.countryname, gbk);
    
49. 
    
50.                     strcpy(obj.gold, cJSON_GetObjectItem(list_obj, "medal_gold_count")->valuestring);
    
51.                     strcpy(obj.update_time, cJSON_GetObjectItem(list_obj, "update_time")->valuestring);
    
52.                     printf("%s: %s %10s %s:%s-%s-%s\r\n",
    
53.                            pobj->rank, pobj->update_time, pobj->countryname,
    
54.                            pobj->count, pobj->gold, pobj->silver, pobj->bronze);
    
55.                         gui_show_data(48+idx*20, pobj);
    
56.                 }
    
57.             }
    
58.             Show_Str_Mid(200, 225, (u8 *)pobj->update_time, 12, 120);
    
59.         }
    
60.     }   
    
61.     else
    
62.     {
    
63.         printf("JSON format error:%s\r\n", cJSON_GetErrorPtr()); //输出json格式错误信息
    
64.     }
    
65. 
    
66.     USART2_RX_STA = 0;
    
67.     memset(USART2_RX_BUF, 0, sizeof(USART2_RX_BUF));
    
68. 
    
69.     cJSON_Delete(root);
    
70. 
    
71.     return 0;
    
72. }

复制代码

如果出现解析失败的情况，可能需要调整启动文件中的堆栈大小：

1. //startup_stm32f10x_hd.s
   
2. 
   
3. Stack_Size      EQU     0x00000C00
   
4. 
   
5. Heap_Size       EQU     0x00000200
   

复制代码

最终效果

▲ BMP显示效果

▲ 桌面效果4

▲ 桌面效果5

和手机端数据完全一致：

▲ 手机界面

开源地址

我的开发板已经预先写入了中文字库，没有字库的开发板可能不适用。
全部代码已经开源在Gitee码云：
https://gitee.com/whik/stm32_olympic_medals

总结

北京时间2021年8月8日晚，17天的2020东京奥运会落下帷幕。本届奥运会闭幕式理念为“Worlds we share”（我们共享的世界），蕴含“铭记与不同性格、不同文化背景的人们共享的感动，携手共创未来”之意，同时也包含了人类共同抵抗新冠疫情的团结之意，虽然东京奥运会已和观众说再见，但即将到来的2022北京冬奥会将持续点燃广大体育迷的热情。


文章出处：张巧龙