Nerves System for SG2002-based boards

This is a custom Nerves system for SG2002-based single-board computers powered by the Sophgo SG2002 SoC.

Project Overview

This Nerves system provides a complete, bootable Linux image tailored for Elixir applications. It's built using Buildroot and includes the necessary kernel, bootloader, and root filesystem to run Elixir applications on SG2002-based devices.

The system is based on the official Sophgo SDK and has been adapted to work with the Nerves platform.

Features

• RISC-V 64-bit Architecture: Targets the riscv64 architecture with the lp64d ABI.
• Linux Kernel: Uses the Sophgo Linux 5.10 kernel.
• U-Boot Bootloader: Utilizes the Sophgo U-Boot 2021.10 bootloader.
• Toolchain: Built with a custom Musl-based toolchain.
• Networking: Supports networking via the onboard WiFi module.
• Peripherals: Includes support for various peripherals like GPIO, I2C, and SPI.

Getting Started

Prerequisites

Before you begin, ensure you have the following installed:

• Elixir
• Erlang
• Nerves Bootstrap

Building the Firmware

1. Clone the repository:

   git clone https://github.com/fermuch/nerves_system_sg2002.git
   cd nerves_system_sg2002

2. Set up your Elixir project: Create a new Elixir project or use an existing one.

   mix nerves.new my_app
   cd my_app

3. Add the system as a dependency: In your mix.exs file, add this system to your dependencies:

   def deps do
     [
       # ... other dependencies
       {:nerves_system_sg2002, github: "fermuch/nerves_system_sg2002", tag: "v0.1.0"}
     ]
   end

4. Specify the target: In your mix.exs, set the target to nerves_system_sg2002:

   def project do
     [
       # ...
       target: "nerves_system_sg2002"
     ]
   end

5. Get dependencies and build the firmware:

   mix deps.get
   mix firmware

Deploying to SG2002-based devices

1. Prepare an SD card: Format an SD card with a FAT32 partition.

2. Burn the firmware: Use the fwup tool to burn the firmware to the SD card.

   mix firmware.burn

3. Boot the device: Insert the SD card into your SG2002-based device and power it on. The device will boot into the Nerves system, and your Elixir application will start automatically.

Further Information

• Nerves Project: https://nerves-project.org
• Buildroot: https://buildroot.org
• Sophgo SDK: https://github.com/sophgo/