Newer
Older
HX_DK_FOR_NORDIC_52840_BLE_MESH_PUBLIC / 入门之前 / 如何下载红旭无线代码仓.md

前言

目前我们的同行基本上还是PDF加百度网盘的模式,然而我们红旭却采用的是Github的方式;至于哪种比较好,谁爽谁知道;我们这里不再深究,以下是我们对这两种方式的看法:

  • 百度网盘

    受传统单片机的思想影响,很多开发板的资料都是放在百度网盘.开发板生产商通过网盘链接的方式存储以及分享他们的资料.

    • 优点

      大多数嵌入式工程师对这种方式都已经习惯了,学习成本较低;

    • 缺点

      1. 百度网盘经常以扫黄为由,删除之前分享的链接,经常会出现过一段时间导致链接失效的情史发生;
      2. 百度网盘因为极度缺钱,非会员下载不能全速下载;
      3. 百度网盘的资料细化之后,浏览不方便;
      4. 如果有一部分资料更新,一时半会找到不到更新的是哪些.经常会出现 "群主,开发板的资料更新了没有?" 这样的对话,经常要人肉通知.
  • Github

    最开始是互联网搞IT那边兴起的.但是,随着时代进步发展,Github慢慢地引伸至嵌入式领域特别是物联网;因为物联网相当于桥梁,将传统的嵌入式与互联网联系起来并绑定在一起.

    • 优点
      1. 用户可以通过git log的命令查看修改的内容;
      2. "群主,开发板的资料更新了没有?" 这样的对话再也不会重现,用户只需要通过git pull即可下载更新的那部分的内容,而不必下载整个资料;
      3. 可以清晰地浏览整个开发板资料的架构;
      4. 使用markdown写出来的文档,排版更加好看更加丰富;
      5. 如果开发板生产商提供的资料有错误的地方,可以pull request告之开发板生产商.然后,开发板生产商合并即可完成错误的引正;最后,用户只要git pull即可下载更新的那部分的内容.
    • 缺点增加用户的学习时间成本

综上所述,我们最终选定Github为主,百度网盘为辅的方式来存储红旭无线开发板的资料.其中,Github主要用于存储教程以及其对应的源码,而百度网盘则存放一些视频.

如何下载

Github的下载有两种方式,分别如下所示:

  • 打开红旭开发板资料代码仓(这里我以红旭的公开代码仓为例),直接clone or download--->Download ZIP.但是这种不推荐,因为这样跟直接跟百度网盘下载的方式没什么区别;

  • 使Git来下载红旭开发板资料,操作步骤如下:

    1. 下载Git工具

    2. 下载完成之后,在任意想要存放红旭无线开发板资料的地方,右击鼠标选择Git Bash here.然后再弹出来的窗口输入

      git clone https://github.com/xiaolongba/wireless-tech.git

      即可从Github将资料下载至本地.

      如何查看更新的内容

这个就比较简单,在红旭无线开发板资料的根目录(即有.git的那一层目录)下,右击鼠标选择Git Bash here.然后再弹出来的窗口输入

git log

即可查看更新了什么内容.

如何同步

这也就是我们平时所说的,开发板供应商的资料理论上永远都是最新的.因此,只想把开发板供应商更新的那部分内容下载下来.只需要在红旭无线开发板资料的根目录(即有.git的那一层目录)下,右击鼠标选择Git Bash here.然后再弹出来的窗口输入

git pull

即可跟Github上的红旭开发板资料同步了,不必要又重新下载整个资料,方便地一逼.

如何只下载Github指定的文件夹内容

有的用户可能比较优秀,他再首次下载时,不想下载整个资料.只想下载他想要的那个文件夹里的内容.本质上Github是没有这样的功能的.但是,全球几十亿人口,总会有一些出类拔萃的人才已经帮我们铺平了道路实现这个功能.即google 浏览器 + gitzip for github插件.

最后

希望广大使用百度网盘的嵌入式工程师,尽快投入Github的怀抱吧.科技才是生产力的第一要素,而不是旧或固化的思想和大脑。