怎么把源代碼弄到word文檔上，1313_pyserial的安裝以及文檔的生成

全部學習匯總： GreyZhang/g_serial: Some serial learning notes which may be usefull in embedded system debugging. (github.com)

串口應該算是一個很有歷史的技術了，在嵌入式的領域中應該有著極其廣泛的應用。由于我自己工作的特殊性，從事了汽車電子，前幾年的開發又是接觸的別人的相對成熟的軟硬件開發平臺，因此這方面在工作的過程中就基本上沒有用到。我真正覺得串口是一個好東西的時候其實是在我玩我的Arduino的時候，發現這種方式還是非常直接干脆的。

近段時間，串口在我做軟件調試的時候給了我很大的幫助。但是，我覺得這個還是欠缺了點什么，主要的欠缺點應該就是沒有Arduino那樣的便捷。或許，我應該找一個上位機的東西，把我的調試以及測試串成塊。這樣，找一個python腳本支持的串口收發方案就成了我的首選。我找到了： pyserial/pyserial: Python serial port access library (github.com)

怎么把源代碼弄到word文檔上？

首先就是安裝， pip install pyserial就可以了。這一個安裝相對來說簡單，在下載下來的repo壓縮包中還有一個文檔需要自己做生成。

文檔位于上面的目錄中，已經有寫好的Makefile可以直接進行make生成。不過，在生成的時候需要安裝一個文檔生成工具。工具就是基于python實現的Sphinx。我第一次嘗試安裝的時候，可能網絡質量很差，一直失敗。后來，啟用了我之前一直用的一個小腳本。

文檔如何生成目錄。

這是包管理的小腳本，具體的代碼可以參考文章最后。現在看上去，似乎網絡質量有了一定的改善。第一次安裝基本都有快要成功的感覺了。

文檔管理工具安裝成功之后，可以切換到documentation目錄下面，執行make html來生成html的文檔。如果在windows的環境下執行，得注意需要有bash命令環境支持。以下是一個執行的效果：

office2013安裝過程中出錯 無代碼、

如果要生成pdf，可以借助于latex。這樣，輸入make latex就可以生成。我的電腦WSL中配置了latex的環境，這里嘗試生成一下pdf文檔。還是在上面的目錄，輸入make latex。

文檔，執行結束，會有類似的提示。可能中間有一些警告，但是看到最后的生成成功，暫且不去管了。接下來，切換到latex配置文件的目錄下繼續生成pdf。

這樣，就生成了pdf文檔。

pyserial安裝、

以上，是生成的文檔的結果。

這一次的時間有點趕，時間不早了也該休息了。暫且做這個工具的安裝以及文檔生成的記錄，后面的調試再說。

附加信息以及代碼：

python包的強制安裝：

#!/usr/bin/python

import os

def SmartInstall(lib_name):

installed_flg = False

num = int(1)

while installed_flg == False:

print("the %dth time try to install %s" % (num, lib_name))

num = int(num + 1)

try:

exec('import ' + lib_name)

installed_flg = True

except:

os.system("pip install -U %s" % lib_name)

SmartInstall('sphinx')