[WIP] balenaFin Getting Started を訳してみた

2019-03-14 追記: 公式サイトのURLが変更になったのと1.1が出てドキュメントの内容自体ちょっと変わったのでこの訳はもうあてになりません。

https://www.balena.io/fin/docs/getting-started/

# What you will need - 必要なもの

> What you need to get started with the balenaFin.

あなたがbalenaFinを始めるために必要なもの。

> All the components required to get started with the balenaFin are available in our Developer Kit.

balenaFinを始めるために必要なすべてのコンポーネントは、当社の開発キットで提供されています。


## BalenaFin

> Any storage variant (8GB, 16GB, 32GB and 64GB) will work for this tutorial.

このチュートリアルでは、8GB、16GB、32GB、および64GBのどのストレージ容量でも利用できます。

> If you don’t have one available, you can order now from the balenaFin Store.

あなたが使用可能なものを持っていない場合は、balenaFin Storeから今すぐ注文することができます。

## Micro-USB to USB cable

> To flash your Fin with an OS, you will need to connect it to your computer with a USB to Micro-USB cable.

いづれのOSでFinをフラッシュするにも、USB-MicroUSBケーブルを使ってFinをコンピュータに接続する必要があります。

## Raspberry Pi Compute Module 3 Lite

> The balenaFin supports the Raspberry Pi Compute Module 3 Lite (CM3L).

balenaFinはRaspberry Pi Compute Module 3 Lite（CM3L）をサポートしています。

> “Lite” means that the module itself has the eMMC socket unpopulated and the traces are exposed via SODIMM-200.

「Lite」とは、モジュール自体にeMMCソケットが取り付けられておらず、配線がSODIMM-200を介して露出されていることを意味します。

> This is very important since the standard CM3 has a fixed 4GB eMMC.

標準のCM3は固定4GBのeMMCが搭載されているので、これは非常に重要です。

> Instead, with the CM3L, the balenaFin can expose variable storage sizes via its embedded eMMC wired to the CM3L via the SODIMM-200 pins.

CM3ではストレージサイズが固定されるのに対して、CM3LはSODIMM-200ピン経由で、balenaFinに搭載しているeMMCにアクセスすることで、さまざまなサイズのストレージを利用可能です。

# Preparing the balenaFin

> In order to flash an OS to the balenaFin, the Fin must be placed into a USB Mass Storage Mode to allow the eMMC storage to be written to. The following proceedure will place the Fin into this boot mode:

OSをbalenaFinにフラッシュするには、eMMCストレージへの書き込みを可能にするために、balenaFinをUSBマスストレージモードにする必要があります。 次の手順でbalenaFinをこの起動モードにします。

> - Before powering on the Fin, connect a USB to Micro-USB cable between your system and the Fin's USB_DBG port.

balenaFinの電源を入れる前に、システムとbalenaFinのUSB_DBGポートをUSB to Micro-USBケーブルで接続してください。

> - Now, connect power to the Fin, either using the Phoenix or Barrel connector (Do not connect power to both!). Ensure that your power supply is rated between 6-24V DC and at least 12.5W.

次に、PhoenixまたはBarrelコネクタを使用して、電源をFinに接続します（両方に電源を接続しないでください）。 電源の定格が6〜24VDCで、少なくとも12.5Wの容量があることを確認してください。

> - Next open an eMMC flashing tool such as etcher to instruct the Fin to boot into USB Mass Storage Mode. You may also use etcher to flash your OS of choice to the Fin.

次に、etcherなどのeMMC書き込みツールを起動して、USBマスストレージモードで起動するようにFinに指示します。また、etcherを使って好みのOSをFinにフラッシュすることもできます。

> - Your Fin should now be in USB Mass Storage Mode, with two red (5V and 3V3) and one green (ACT) LEDs illuminated on the LED STATUS panel.


> - The eMMC storage of the Fin is now mounted and can be flashed. If you are using etcher, you will see it listed as a Compute Module under the writable devices tab.


# Flashing an OS - OSの書き込み

> This tutorial will be focused on the standalone version of balenaOS 2.x. For more information on balenaOS see “Variants of balenaOS” in the documentation.

このチュートリアルでは、balenaOS 2.xのスタンドアロンバージョンに焦点を当てます。 balenaOSの詳細については、ドキュメンテーションの「balenaOSの種類」を参照してください。

> After successfully flashing the Fin, ensure to remove the cable from USB_DBG before power cycling the board. The Fin should now boot normally, booting into the newly flashed OS.

フィンのフラッシュが正常に完了したら、ボードの電源を入れ直す前に必ずUSB_DBGからケーブルを取り外してください。Finは正常に起動し、新しくフラッシュされたOSで起動するはずです。

> NOTE: Any other recent OS distribution (2018+) for the Raspberry Pi 3 Model B should be compatible with the Balena Fin, including Raspbian.

最近（2018年以降）のRaspberryPi3 Model B向けOS（もちろんRaspbianも）は、BalenaFinと互換性があるはずです。

> NOTE 2: In order to get you started quickly, we uploaded a pre-configured version of Raspbian here. Please not that this is a work in progress and updating the kernel is not supported at the moment.

すばやく始めるために、ここにRaspbianの設定済みバージョンをアップロードしました。 これは進行中の作業であり、カーネルの更新は現時点ではサポートされていません。

## Getting started with balenaOS

> The best way to get started is to connect the Fin to your wireless network and deploy a sample container.

> If you are not sure how to do that, head over to the balenaOS documentation on the balenaFin for a complete guide: https://balena.io/os/docs/fincm3/getting-started/

## Sample projects

> Now that you are familiar with loading application containers, let's try using the modules available on the Fin. We put together a repository to get you started with some examples.