head.jpg
Mpfshell 使用手冊
由于本章涉及的內(nèi)容不適合圖示說明秘蛔，所以均已表格或文字說明到千。
在 python3.5 以上使用命令 pip install mpfshell-lite 即可安裝，接著輸入 mpfshell-lite 即可打開運(yùn)行底瓣。
mpfshell_install.png
0. 了解不同的支持版本
| 系統(tǒng)類型 | 系統(tǒng)版本 | 運(yùn)行情況 | 注意事項(xiàng) |
|---|---|---|---|
| Windows | WIN7 - WIN10 | 正常 | 原生 CMD 不支持 TAB |
| Linux | Lubuntu - Ubuntu | 正常 | 原生 Shell 支持 TAB |
| Mac | Darwin | 正常 | 與 Unix 均一致 |
1. 了解重要的功能操作
| 操作方法 | 不同系統(tǒng)工具支持情況 | 運(yùn)行效果 | 注意事項(xiàng) |
|---|---|---|---|
| 輸入一些內(nèi)容后通過 TAB 鍵補(bǔ)全 | 僅 shell笨触、repl孝情、powershell 支持。 | 如果想要打 import 只需要 輸入 i 后在按下 TAB 鍵就可以自動補(bǔ)全了著恩，比如 linux 下院尔，輸入 ttyUSB0，只需要 i + TAB 鍵就可以了喉誊。 | 前提是邀摆，該命令被系統(tǒng)提前輸入過，否則它沒辦法補(bǔ)全伍茄，它只能補(bǔ)全歷史輸入的信息栋盹。 |
| 左鍵復(fù)制選取，右鍵粘貼選取 | 僅 Windows的系統(tǒng)支持敷矫。 | 開啟 CMD控制臺 程序的屬性里的 快速編輯 功能例获，可以讓程序支持鼠標(biāo) 點(diǎn)擊暫停程序后點(diǎn)左鍵拖動復(fù)制文本內(nèi)容汉额。 | 如果選取的是多行代碼或命令，不代表可以直接使用榨汤，所以一般都是選取一行的蠕搜。 |
| 上下左右按鍵及退格 | 均支持 | 上下按鍵可以切換讀取歷史輸入過的命令，左右方向鍵以及程序退格操作可以對自己輸入過的內(nèi)容進(jìn)行修改件余。 | 僅針對windows做了修復(fù)讥脐。 |
2. 了解所有功能的命令
| 命令類型 | 使用方法 | 運(yùn)行結(jié)果 | 注意事項(xiàng) |
|---|---|---|---|
| open(o) | 打開當(dāng)前設(shè)備。格式有：有線串口 open com3啼器，無線有 ws:192.168.10.114,1234
|
連接成功后返回 Connected to esp32
|
控制板子前旬渠，需要先打開連接。括號為簡寫端壳。 |
| close | 關(guān)閉當(dāng)前設(shè)備告丢。 | ||
| quit | 輸入 | 退出程序 | |
| EOF | 輸入 | 退出程序 | 無 |
| cat | 輸入 文件名，例如 cat boot.py
|
將板子的指定文件打印出來快速查看损谦。 | 無 |
| put | 把當(dāng)前目錄下的文件推送到板子岖免，例如put boot.py
|
無 | 失敗會返回錯(cuò)誤信息 |
| get | 獲取板子當(dāng)前目錄下的文件，例如get boot.py
|
在程序運(yùn)行的目錄下多了一個(gè) boot.py 文件 | |
| mput | 與 put 相對照捡，以板子為主颅湘，對程序的目錄操作。 | ||
| mget | 與 get 相對栗精，以板子為主闯参，對程序的目錄操作。 | ||
| repl(e) | 進(jìn)入 python 的 repl 控制接口 | 可以直接執(zhí)行python代碼悲立。 | |
| exec (e) | 輸入 Python 代碼鹿寨，例如exec print('hello')
|
返回print('hello')的運(yùn)行結(jié)果 hello | 只能執(zhí)行一行 python 代碼。括號為簡寫薪夕。 |
| execfile(ef) | 執(zhí)行板子中存在的python文件脚草，例如execfile main.py
|
執(zhí)行 main.py 的效果 | 括號為簡寫。 |
| lexecfile(ef) | 執(zhí)行程序下存在的python文件原献，例如lexecfile main.py
|
執(zhí)行 main.py 的效果 | 括號為簡寫馏慨，與 runfile 不同的是會進(jìn)入repl模式，所以支持input操作姑隅。 |
| runfile(rf) | 結(jié)合了 put 和 execfile 命令 | 括號為簡寫写隶。 | |
| cd | 輸入 指定板子里的目錄，例如 cd /
|
修改程序訪問板子的所處目錄 | 以 / 開頭的linux路徑粤策，盡量不要改變路徑樟澜，除非你十分清楚自己在做什么。 |
| md | 輸入 目錄名稱 | 在板子上新建一個(gè)目錄 | 無 |
| lcd | 輸入 指定現(xiàn)在程序里的目錄，例如 cd /
|
修改程序訪問板子的所處目錄 | 以 / 開頭的linux路徑秩贰，盡量不要改變路徑霹俺，除非你十分清楚自己在做什么。 |
| pwd | 輸入pwd
|
返回當(dāng)前板子所處的目錄 | 無 |
| lpwd | 輸入 lpwd
|
返回當(dāng)前程序所處的目錄 | 無 |
| mpyc | 輸入 當(dāng)前目錄下的 python 文件毒费，例如 mpyc main.py
|
把 python 代碼 pyc 化靜態(tài)編譯代碼處理丙唧，生成 main.pyc | |
| mrm | 輸入程序當(dāng)前的 rm 目錄或文件名
|
移除該目錄或文件名 | |
| rm | 輸入板子當(dāng)前的 rm 目錄或文件名
|
移除該目錄或文件名 | |
| ls | 輸入ls /
|
查看 板子 當(dāng)前目錄下的所有文件 | |
| lls | 輸入 lls /
|
查看 程序 當(dāng)前目錄下的所有文件 | |
| view | 輸入 view
|
查看 本機(jī) 可能的串口，和當(dāng)前的 open 配置 | |
| help | 查看命令的幫助觅玻，詳細(xì)看本節(jié)結(jié)尾想际。 |
在程序中，你也可以通過 help + 命令 的方式獲取對應(yīng)的命令說明或參數(shù)等細(xì)節(jié)溪厘。
例如：help cd胡本， 返回的是 cd <TARGET DIR> ? Change current remote directory to given target.。
可以得知 它是用來改變 目標(biāo)板子里的當(dāng)前文件目錄起點(diǎn)畸悬，相當(dāng)于設(shè)置板子的文件夾默認(rèn)路徑在什么位置侧甫。
提示：連接板子的時(shí)候，要特別注意死循環(huán)蹋宦，如果在連接過程中板子存在沒有任何延時(shí)的死循環(huán)披粟，則會影響軟件連接板子的成功率，尤其是沒有延時(shí)的 mian.py 死循環(huán)冷冗，這會導(dǎo)致上電后將無法連接無線模式守屉，這點(diǎn)需要注意，不過蒿辙，有線串口的連接不成功則會進(jìn)行板子的復(fù)位拇泛。
