淺羽今天想 Diss 一下 Friendly ARM 的 Wiki 頁

淺羽今天要 Diss 的就是 Friendly ARM 官方Wiki的 NanoPi NEO/zh 頁。這圖現在的版本已經截了一個長圖保存,防止改完之後有人說淺羽亂 Diss。網頁截圖可以從櫻川存儲取得

最近從 @imi415 那順了一個 NanoPi NEO 玩,根據習慣第一步先上串口調試。於是串口怎麼接呢?NanoPi NEO 的板子太小,UART 附近沒找到絲印,於是看一下官方 Wiki 吧。好的,官方 Wiki 給出了清楚明確的 Pinout:

這麼看應該是蠻清楚的一個結構 RX-TX-5V-GND,於是就插上了,結果當然是沒有反應。一開始的時候,還以爲是 TX-RX RX-TX 的問題,畢竟每次都有機率要試一試錯;然而不管怎麼嘗試,最後都沒有任何輸出,而且 CP2102 板子上的 TX 和 RX 燈號都是不亮的。畢竟板子是 @imi415 的,於是和他討論了一下:

好的,終於發現了絲印,那麼絲印寫的是什麼呢?

真是完美。按絲印的順序連線,還是不行;仔細檢查發現是 TX 沒插穩,重新連接後問題解決。

千辛萬苦終於能串口調試了…當然,不看絲印是淺羽的問題;但是作爲官方 Wiki 竟然能出錯,這更加不應該吧。


淺羽後來在歷史版本中,看到了一個 V1.2 的 UART Pinout 圖:

也就是說 v1.3 開始是改了 UART Pinout 的。可是 Wiki 在 UART 部分提了什麼呢?

很遺憾,儘管在其他 Pinout 上都提到了版本區別,但是 UART 部分的區別並沒有提及。再看看官方的 UART 示範插法:

注意線材的順序,完全是按照 v1.3 的新版本來的,同時也沒有提及 Pinout 區別的問題。整個 Wiki,已經可以用「極具誤導性」來形容了。

Comments

發佈留言

發佈留言必須填寫的電子郵件地址不會公開。 必填欄位標示為 *

This site uses Akismet to reduce spam. Learn how your comment data is processed.

To respond on your own website, enter the URL of your response which should contain a link to this post’s permalink URL. Your response will then appear (possibly after moderation) on this page. Want to update or remove your response? Update or delete your post and re-enter your post’s URL again. (Find out more about Webmentions.)