烧录游戏的文档加入Mac系统下的操作步骤

This commit is contained in:
LiHuashen
2019-03-20 17:59:58 +08:00
parent 8f27636d10
commit d03ef780a8
7 changed files with 67 additions and 14 deletions
Binary file not shown.

After

Width:  |  Height:  |  Size: 23 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 180 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 193 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 47 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 15 KiB

After

Width:  |  Height:  |  Size: 11 KiB

@@ -12,23 +12,50 @@
## Download firmware
Download the gameboy simulator firmware named `firmware.zip` from [Github](https://github.com/m5stack/M5Stack-nesemu). And unpack `firmware.zip`.
Download the gameboy simulator firmware named `firmware.zip` from [Github](https://github.com/m5stack/M5Stack-nesemu). And unzip `firmware.zip`.
<img src="assets/img/getting_started_pics/faces/download_from_github.png">
<img src="assets/img/getting_started_pics/faces/faces_quick_start_05.png">
### Windows OS
<img src="assets/img/getting_started_pics/faces/unpack_firmware.png">
### Mac OS
<img src="assets/img/getting_started_pics/faces/faces_quick_start_06.png">
## Burn Game file
Open Flash Download Tools[点击下载](https://www.espressif.com/sites/default/files/tools/flash_download_tools_v3.6.4.rar) apply by Espressif, choose `ESP32 DownloadTool` option, choose 4 files, and execute **step 2-4** ( *choose firmware file, your serial port, erase and program flash* )
### Windows OS
Open Flash Download Tools[点击下载](https://www.espressif.com/sites/default/files/tools/flash_download_tools_v3.6.4.rar) apply by Espressif, choose `ESP32 DownloadTool` option, choose 4 files, and execute those operations as the following pictures shown. ( *choose firmware file, your serial port, erase and program flash* )
<img src="assets/img/getting_started_pics/faces/chose_files.png">
<img src="assets/img/getting_started_pics/faces/download_it.png">
### Mac OS
#### (1) install esptool
Open `terminal`, execute this command `pip install esptool`
<img src="assets/img/getting_started_pics/faces/faces_quick_start_08.png">
#### (2) burn the game firmware
Open `terminal`, go to the path where `firmware.zip` is located
Execute the following commands in the `terminal`
```sh
unzip firmware.zip
cd firmware
esptool.py erase_flash
sh flash.sh
```
<img src="assets/img/getting_started_pics/faces/faces_quick_start_07.png">
## Reset you device
@@ -1,6 +1,6 @@
# 烧录GameBoy游戏 {docsify-ignore-all}
# 烧录 NES 游戏 {docsify-ignore-all}
*这篇文档将引导你如何烧录游戏模拟器,并烧录想用的经典游戏,这样你就可以使用FACES Kit来玩GameBoy游戏。*
*这篇文档将引导你如何烧录游戏模拟器,并烧录想用的经典游戏,这样你就可以使用 FACES Kit 来玩 GameBoy 游戏。*
## 目录
@@ -8,34 +8,60 @@
2. [烧录固件和游戏文件](#烧录固件和游戏文件)
3. [重启FACES](#重启FACES)
3. [重启 FACES](#重启-FACES)
## 下载固件
下载Gameboy模拟器,固件名为`firmware.zip`,下载地址:[Github](https://github.com/m5stack/M5Stack-nesemu) 然后解压`firmware.zip`(*包括启动文件bootloader.bin,分区表文件, 模拟器文件, 游戏文件SuperMario*)。
下载 Gameboy 模拟器,固件名为 `firmware.zip`,下载地址:[Github](https://github.com/m5stack/M5Stack-nesemu) 然后解压 `firmware.zip` (*包括启动文件bootloader.bin,分区表文件, 模拟器文件, 游戏文件SuperMario*)。
<img src="assets/img/getting_started_pics/faces/faces_quick_start_05.png">
<img src="assets/img/getting_started_pics/faces/download_from_github.png">
### Windows OS
<img src="assets/img/getting_started_pics/faces/unpack_firmware.png">
### Mac OS
<img src="assets/img/getting_started_pics/faces/faces_quick_start_06.png">
## 烧录固件和游戏文件
打开乐鑫提供的烧录工具[Flash Download Tools](https://www.espressif.com/sites/default/files/tools/flash_download_tools_v3.6.4.rar),选择 `ESP32 DownloadTool` 选项,选择`firmware.zip`解压后的四个文件,并执行如下图的**步骤2-4**( *选择正确的串口号,擦除flash和烧录固件* )
### Windows OS
打开乐鑫提供的烧录工具 [Flash Download Tools](https://www.espressif.com/sites/default/files/tools/flash_download_tools_v3.6.4.rar),选择 `ESP32 DownloadTool` 选项,选择`firmware.zip`解压后的四个文件,并执行如下图的**步骤 2-4** ( *选择正确的串口号,擦除 flash 和烧录固件* )
<img src="assets/img/getting_started_pics/faces/chose_files.png">
<img src="assets/img/getting_started_pics/faces/download_it.png">
### Mac OS
## 重启FACES
#### (1) 安装 esptool
重启FACES之后,这时候就可以玩游戏啦。
打开终端,执行 `pip install esptool`
<img src="assets/img/getting_started_pics/faces/faces_quick_start_08.png">
#### (2) 烧录固件
在终端,进入 `firmware.zip` 所在的路径下,执行以下命令
```sh
unzip firmware.zip
cd firmware
esptool.py erase_flash
sh flash.sh
```
<img src="assets/img/getting_started_pics/faces/faces_quick_start_07.png">
## 重启 FACES
重启 FACES 之后,这时候就可以玩游戏啦。
<img src="assets/img/product_pics/core/faces_kit/gameboy_01.png">
?> Tip *如果你想换另一个游戏,只需替换**游戏文件**,再用以上工具烧录即可。注意是要使用NES格式的游戏文件。**
?> *如果你想换另一个游戏,只需替换**游戏文件**,再用以上工具烧录即可。注意是要使用 NES 格式的游戏文件。**