diff --git a/Home.md b/Home.md index e4426a7..b38476b 100644 --- a/Home.md +++ b/Home.md @@ -1,14 +1,16 @@ + + **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) - - [手動](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) +# その他 + - [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) diff --git a/U‐Boot>ビルド>buildbrain.md b/U‐Boot>ビルド.md similarity index 100% rename from U‐Boot>ビルド>buildbrain.md rename to U‐Boot>ビルド.md diff --git a/U‐Boot>ビルド>手動.md b/U‐Boot>ビルド>手動.md deleted file mode 100644 index c890591..0000000 --- a/U‐Boot>ビルド>手動.md +++ /dev/null @@ -1 +0,0 @@ -Under Construction \ No newline at end of file diff --git a/_Sidebar.md b/_Sidebar.md index 557bf52..54abe31 100644 --- a/_Sidebar.md +++ b/_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) - - [手動](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) +# その他 + - [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) diff --git a/gen.py b/gen.py index 47c9fff..3c3a439 100644 --- a/gen.py +++ b/gen.py @@ -35,6 +35,7 @@ def main(): with open('Home.md', 'w') as f: f.write('\n\n') + f.write('\n\n') f.write('**Brain Hackers Wiki へようこそ!**\n\n') recurse(f, fn_tree, idfn) diff --git a/images/etcher1.png b/images/etcher1.png new file mode 100644 index 0000000..aa159c7 Binary files /dev/null and b/images/etcher1.png differ diff --git a/images/etcher2.png b/images/etcher2.png new file mode 100644 index 0000000..5e23c3c Binary files /dev/null and b/images/etcher2.png differ diff --git a/images/etcher3.png b/images/etcher3.png new file mode 100644 index 0000000..4178e55 Binary files /dev/null and b/images/etcher3.png differ diff --git a/images/etcher4.png b/images/etcher4.png new file mode 100644 index 0000000..b596866 Binary files /dev/null and b/images/etcher4.png differ diff --git a/images/etcher5.png b/images/etcher5.png new file mode 100644 index 0000000..fc0ade6 Binary files /dev/null and b/images/etcher5.png differ diff --git a/images/etcher6.png b/images/etcher6.png new file mode 100644 index 0000000..4b5eac7 Binary files /dev/null and b/images/etcher6.png differ diff --git a/images/etcher7.png b/images/etcher7.png new file mode 100644 index 0000000..3c82585 Binary files /dev/null and b/images/etcher7.png differ diff --git a/images/etcher8.png b/images/etcher8.png new file mode 100644 index 0000000..56e3019 Binary files /dev/null and b/images/etcher8.png differ diff --git a/images/happy.png b/images/happy.png new file mode 100644 index 0000000..573e209 Binary files /dev/null and b/images/happy.png differ diff --git a/images/top.jpg b/images/top.jpg new file mode 100644 index 0000000..289138a Binary files /dev/null and b/images/top.jpg differ diff --git a/Wikiの編集方法.md b/その他>Wikiの編集方法.md similarity index 100% rename from Wikiの編集方法.md rename to その他>Wikiの編集方法.md diff --git a/とりあえず試す.md b/とりあえず試す.md new file mode 100644 index 0000000..705b985 --- /dev/null +++ b/とりあえず試す.md @@ -0,0 +1,130 @@ + + +### 目次 + +- [対応している機種](#%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) + + + + + +このページでは、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 ファイルを選択します + + - 展開する必要はありません + + + + + + + 3. "Select target" をクリックし、書き込み先を選択します + + - 選択を間違えるとデータを失うことになるので、正しい SD カードを選択しているか慎重に確認してください + - 4GB 以上の SD カードであればなんでも使用可能ですが、SD カードの性能がシステムの使用感に直結するため、極力高速な SD カードを使用することをおすすめします + - 画像では 8GB の SD カードを選択しています + + + + + + 4. "Flash!" をクリックして書き込みます + + - 改めて正しい SD カードが選択されているか確認した上で書き込んでください + - 書き込みには管理者権限が必要なため、管理者パスワードを入力します + + + + + + + + 5. 完成! + + + + +## 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 が起動します。 +