From 57aa85f688ec3a6fe6faf835456cb87259456fcd Mon Sep 17 00:00:00 2001
From: Aditya Prayoga <aditya@kobol.io>
Date: Thu, 5 Nov 2020 10:20:28 +0700
Subject: [PATCH] initial page

---
 docs/helios64/troubleshoot.md | 63 +++++++++++++++++++++++++++++++++++
 mkdocs.yml                    |  1 +
 2 files changed, 64 insertions(+)
 create mode 100644 docs/helios64/troubleshoot.md

diff --git a/docs/helios64/troubleshoot.md b/docs/helios64/troubleshoot.md
new file mode 100644
index 0000000..6bc74d8
--- /dev/null
+++ b/docs/helios64/troubleshoot.md
@@ -0,0 +1,63 @@
+
+## Problem: Could not connect to Helios64
+
+### Faulty Power Supply
+
+Verify whether [LED1](/helios64/led/) is turned on. If not tighten PSU cable.
+
+If problem still occurs, replace the PSU.
+
+### OS Failure
+
+Verify whether [System Activity LED](/helios64/front-panel/#helios64-enclosure) is blinking. If it is not, reset or power cycle.
+
+If problem still occurs, please capture the serial console output and report it to forum.
+
+### Kernel Panic
+
+If [System Error LED](/helios64/front-panel/#helios64-enclosure) blinking, there was kernel panic.
+
+If problem still occurs, please capture the serial console output and report it to forum.
+
+### Network down
+
+#### Solution 1
+
+Verify whether Ethernet LED turned on. If it is not, try to unplug and re-plug the network cable.
+
+#### Solution 2
+
+Try other Ethernet port.
+
+### Corrupted filesystem
+
+Boot from micro SD card and execute following command to repair system partition on eMMC
+
+```
+fsck -p /dev/mmcblk1p1
+```
+
+or
+
+```
+btrfs check --repair /dev/mmcblk1p1
+```
+
+if your system partition formatted with BTRFS.
+
+### Micro SD card slot broken
+
+Try to flash OS directly to eMMC using [maskrom mode](/helios64/maskrom/)
+
+---
+
+## Problem: Serial console does not appear
+
+### Driver not installed
+
+Make sure you have FTDI VCP driver installed. You can download the driver from [FTDI Website](https://www.ftdichip.com/Drivers/VCP.htm)
+
+### Jumper P13 closed
+
+Make sure jumper P13 is open otherwise it will disable the built-in USB to Serial converter. Refer to [USB Console/Recovery Mode (P13)](/helios64/jumper/#usb-consolerecovery-mode-p13)
+
diff --git a/mkdocs.yml b/mkdocs.yml
index 1e09172..f44d009 100644
--- a/mkdocs.yml
+++ b/mkdocs.yml
@@ -104,6 +104,7 @@ nav:
     - UEXT: 'helios64/uext.md'
     - USB: 'helios64/usb.md'
   - Documents: 'helios64/docs.md'
+  - Troubleshooting: 'helios64/troubleshoot.md'
 - Helios4:
   - Introduction: 'helios4/intro.md'
   - Kit Assembly: 'helios4/kit.md'