Update contents

Home.md

@@ -1,14 +1,16 @@
 <!-- This file is generated by gen.py. DO NOT EDIT MANUALLY! -->
 
+<img src="images/top.jpg">
+
 **Brain Hackers Wiki へようこそ！**
 
- - [Wikiの編集方法](Wiki%E3%81%AE%E7%B7%A8%E9%9B%86%E6%96%B9%E6%B3%95)
+ - [とりあえず試す](%E3%81%A8%E3%82%8A%E3%81%82%E3%81%88%E3%81%9A%E8%A9%A6%E3%81%99)
 # Linux
  - [SDカードにコピー](Linux%EF%BC%9ESD%E3%82%AB%E3%83%BC%E3%83%89%E3%81%AB%E3%82%B3%E3%83%94%E3%83%BC)
  - [ビルド](Linux%EF%BC%9E%E3%83%93%E3%83%AB%E3%83%89)
 # U‐Boot
+ - [ビルド](U%E2%80%90Boot%EF%BC%9E%E3%83%93%E3%83%AB%E3%83%89)
  - [起動 (EBOOT)](U%E2%80%90Boot%EF%BC%9E%E8%B5%B7%E5%8B%95-%28EBOOT%29)
  - [起動 (USB Recovery)](U%E2%80%90Boot%EF%BC%9E%E8%B5%B7%E5%8B%95-%28USB-Recovery%29)
-### ビルド
+# その他
- - [buildbrain](U%E2%80%90Boot%EF%BC%9E%E3%83%93%E3%83%AB%E3%83%89%EF%BC%9Ebuildbrain)
+ - [Wikiの編集方法](%E3%81%9D%E3%81%AE%E4%BB%96%EF%BC%9EWiki%E3%81%AE%E7%B7%A8%E9%9B%86%E6%96%B9%E6%B3%95)
- - [手動](U%E2%80%90Boot%EF%BC%9E%E3%83%93%E3%83%AB%E3%83%89%EF%BC%9E%E6%89%8B%E5%8B%95)

U‐Boot＞ビルド＞手動.md

@@ -1 +0,0 @@
-Under Construction

_Sidebar.md

@@ -2,13 +2,13 @@
 
 [Home](Home)
 
- - [Wikiの編集方法](Wiki%E3%81%AE%E7%B7%A8%E9%9B%86%E6%96%B9%E6%B3%95)
+ - [とりあえず試す](%E3%81%A8%E3%82%8A%E3%81%82%E3%81%88%E3%81%9A%E8%A9%A6%E3%81%99)
 # Linux
  - [SDカードにコピー](Linux%EF%BC%9ESD%E3%82%AB%E3%83%BC%E3%83%89%E3%81%AB%E3%82%B3%E3%83%94%E3%83%BC)
  - [ビルド](Linux%EF%BC%9E%E3%83%93%E3%83%AB%E3%83%89)
 # U‐Boot
+ - [ビルド](U%E2%80%90Boot%EF%BC%9E%E3%83%93%E3%83%AB%E3%83%89)
  - [起動 (EBOOT)](U%E2%80%90Boot%EF%BC%9E%E8%B5%B7%E5%8B%95-%28EBOOT%29)
  - [起動 (USB Recovery)](U%E2%80%90Boot%EF%BC%9E%E8%B5%B7%E5%8B%95-%28USB-Recovery%29)
-### ビルド
+# その他
- - [buildbrain](U%E2%80%90Boot%EF%BC%9E%E3%83%93%E3%83%AB%E3%83%89%EF%BC%9Ebuildbrain)
+ - [Wikiの編集方法](%E3%81%9D%E3%81%AE%E4%BB%96%EF%BC%9EWiki%E3%81%AE%E7%B7%A8%E9%9B%86%E6%96%B9%E6%B3%95)
- - [手動](U%E2%80%90Boot%EF%BC%9E%E3%83%93%E3%83%AB%E3%83%89%EF%BC%9E%E6%89%8B%E5%8B%95)

gen.py

@@ -35,6 +35,7 @@ def main():
 
     with open('Home.md', 'w') as f:
         f.write('<!-- This file is generated by gen.py. DO NOT EDIT MANUALLY! -->\n\n')
+        f.write('<img src="images/top.jpg">\n\n')
         f.write('**Brain Hackers Wiki へようこそ！**\n\n')
         recurse(f, fn_tree, idfn)
 

とりあえず試す.md

@@ -0,0 +1,130 @@
+<!-- START doctoc generated TOC please keep comment here to allow auto update -->
+<!-- DON'T EDIT THIS SECTION, INSTEAD RE-RUN doctoc TO UPDATE -->
+### 目次
+
+- [対応している機種](#%E5%AF%BE%E5%BF%9C%E3%81%97%E3%81%A6%E3%81%84%E3%82%8B%E6%A9%9F%E7%A8%AE)
+- [SD カードのイメージをダウンロードする](#sd-%E3%82%AB%E3%83%BC%E3%83%89%E3%81%AE%E3%82%A4%E3%83%A1%E3%83%BC%E3%82%B8%E3%82%92%E3%83%80%E3%82%A6%E3%83%B3%E3%83%AD%E3%83%BC%E3%83%89%E3%81%99%E3%82%8B)
+- [SD カードに書き込む](#sd-%E3%82%AB%E3%83%BC%E3%83%89%E3%81%AB%E6%9B%B8%E3%81%8D%E8%BE%BC%E3%82%80)
+  - [balenaEtcher を使う場合](#balenaetcher-%E3%82%92%E4%BD%BF%E3%81%86%E5%A0%B4%E5%90%88)
+  - [dd を使う場合](#dd-%E3%82%92%E4%BD%BF%E3%81%86%E5%A0%B4%E5%90%88)
+    - [macOS の場合](#macos-%E3%81%AE%E5%A0%B4%E5%90%88)
+    - [Linux の場合](#linux-%E3%81%AE%E5%A0%B4%E5%90%88)
+- [実機で起動する](#%E5%AE%9F%E6%A9%9F%E3%81%A7%E8%B5%B7%E5%8B%95%E3%81%99%E3%82%8B)
+
+<!-- END doctoc generated TOC please keep comment here to allow auto update -->
+
+<img src="images/happy.png">
+
+このページでは、SHARP Brain で Linux を動かす試みから生まれた Linux ディストリビューション **Brainux** をとりあえず起動する方法をご紹介します。
+
+Linux ディストリビューションは、2つの大きな要素としてカーネルとそれ以外のソフトウェアの組み合わせでできています。Brain の場合はカーネルを起動するブートローダーも SD カード上に必要なため、正確にはカーネル・ソフトウェア・ブートローダーのセットが必要になります。
+
+リポジトリ [buildbrain](https://github.com/brain-hackers/buildbrain) では、Raspberry Pi と同様に SD カードに書き込むだけで起動可能にした SD イメージを公開しています。ちなみにカーネル・ソフトウェア・ブートローダーはどれも自力で準備することもできます。くわしくは本 Wiki の対応するページを参照してください。
+
+質問がある場合や開発に参加したい場合は、まず [Brain Hackers の Discord](https://github.com/brain-hackers/README) に参加して頂き、「雑談」チャンネルでお気軽にご質問ください。
+
+
+# 対応している機種
+
+2021年2月21日現在、対応している機種とハードウェアは以下の通りです。対応しているものには :white_check_mark: が付いています。省略のため、PW-SH1 や PW-SJ1 のような同世代の機種は特記すべき差がない限りは "Sx1" のように省略形で記載します。
+
+|機種  |Linux 起動        |キーボード        |注釈|
+|:-----|:----------------:|:----------------:|:---|
+|PW-Sx1 より前|||PW-GC610, PW-G5300 のような数字が3桁もしくは4桁の機種|
+|PW-Sx1|:white_check_mark:|:white_check_mark:||
+|PW-Sx2|:white_check_mark:|:white_check_mark:||
+|PW-Sx3|:white_check_mark:|                  ||
+|PW-Sx4|:white_check_mark:|                  ||
+|PW-Sx5|:white_check_mark:|                  ||
+|PW-Sx6|:white_check_mark:|                  ||
+|PW-Sx7|:white_check_mark:|                  |未リリース・Sx6 を流用可|
+|PW-x1 以降||||
+
+
+# SD カードのイメージをダウンロードする
+
+[brain-hackers/buildbrain のリリースページ](https://github.com/brain-hackers/buildbrain/releases)にアクセスし、最新リリースの配布物の中から `sdimage-*.zip` と名のついた ZIP ファイルをダウンロードします。`*` には最新リリースのバージョン名が入ります。
+
+
+# SD カードに書き込む
+
+書き込むソフトは Windows / macOS / Linux のどれをお使いの場合でも利用可能な balenaEtcher がおすすめです。[公式サイト](https://www.balena.io/etcher/)にアクセスしてダウンロードしてください。
+
+macOS もしくは Linux をお使いの場合は、ZIP を展開して取り出した .img ファイルを `dd` コマンドでそのまま書くことも可能です。
+
+
+## balenaEtcher を使う場合
+
+今回は macOS で balenaEtcher を使用した際の画像で説明します。どの OS でも同様にして書き込めます。
+
+ 1. balenaEtcher を起動します
+
+ 2. "Flash from file" をクリックし、ダウンロードした ZIP ファイルを選択します
+
+   - 展開する必要はありません
+
+   <img src="images/etcher1.png" width=500px>
+
+   <img src="images/etcher2.png" width=500px>
+
+
+ 3. "Select target" をクリックし、書き込み先を選択します
+
+   - 選択を間違えるとデータを失うことになるので、正しい SD カードを選択しているか慎重に確認してください
+   - 4GB 以上の SD カードであればなんでも使用可能ですが、SD カードの性能がシステムの使用感に直結するため、極力高速な SD カードを使用することをおすすめします
+   - 画像では 8GB の SD カードを選択しています
+
+   <img src="images/etcher3.png" width=500px>
+
+   <img src="images/etcher4.png" width=500px>
+
+ 4. "Flash!" をクリックして書き込みます
+
+   - 改めて正しい SD カードが選択されているか確認した上で書き込んでください
+   - 書き込みには管理者権限が必要なため、管理者パスワードを入力します
+
+   <img src="images/etcher5.png" width=500px>
+
+   <img src="images/etcher6.png" width=500px>
+
+   <img src="images/etcher7.png" width=500px>
+
+ 5. 完成！
+
+   <img src="images/etcher8.png" width=500px>
+
+
+## dd を使う場合
+
+macOS もしくは Linux をお使いの場合は、`dd` コマンドでも書き込むことができます。以下にコマンド例を示します。
+
+
+### macOS の場合
+
+ - macOS では `/dev/disk*` に書き込むと非常に遅いため、`/dev/rdisk*` を使用します
+ - どのディスクが SD カードかはディスクユーティリティを使用して確認します
+
+以下に実行例を示します。バージョン番号は適宜読み替えてください。
+
+```sh
+cd ~/Downloads
+unzip sdimage-2021-02-21-162410.zip
+sudo dd if=~/Downloads/sdimage-2021-02-21-162410.img of=/dev/rdisk4 bs=10M
+```
+
+
+### Linux の場合
+
+以下に実行例を示します。バージョン番号は適宜読み替えてください。
+
+```sh
+cd ~/Downloads
+unzip sdimage-2021-02-21-162410.zip
+sudo dd if=~/Downloads/sdimage-2021-02-21-162410.img of=/dev/sdc bs=10M
+```
+
+
+# 実機で起動する
+
+書き込み終わった SD カードを Brain に挿入し、リセットボタンを押します。Brain のロゴが表示されたあと U-Boot が起動し、すぐ後に Linux が起動します。
+