Skip to content

Commit

Permalink
RS-G2L100: added new board documentation (#960)
Browse files Browse the repository at this point in the history
* RS-G2L100: added new board documentation

- added build guides
- added downloads
--

Signed-off-by: xing.guangyang <[email protected]>

* Update README.md

---------

Signed-off-by: xing.guangyang <[email protected]>
  • Loading branch information
xingGTC authored Mar 7, 2023
1 parent 0bfc0d1 commit 44618a0
Show file tree
Hide file tree
Showing 29 changed files with 1,627 additions and 0 deletions.
29 changes: 29 additions & 0 deletions consumer/rs-g2l100/README.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,29 @@
---
title: Using the RS-G2L100
permalink: /documentation/consumer/rs-g2l100/
---
# Using the RS-G2L100

A comprehensive guide to using the GS-G2L100 Consumer Edition development board. This guide is written by the [96Boards](https://www.96boards.org) team at [Linaro](http://www.linaro.org) with community contributions and links to third-party content.

## Software

- [Downloads](downloads/README.md)
- Already familiar with your 96Boards? Skip the board bring up sections and go straight to your download!
- [Installation](installation/README.md)
- Choose and install an operating system on your RS-G2L100
- [Build from Source](build/README.md)
- Instructions for building and flashing the components of your favorite operating systems

## Documentation

- [Getting Started](getting-started/README.md)
- Learn about your RS-G2L100 board, how to prepare and set up for basic use
- [Useful Guides](guides/README.md)
- These guides will help to get you started with a variety of available on-boards software
- [Hardware Documentation](hardware-docs/README.md)
- Explore what makes your RS-G2L100 unique, technical specifications, schematics, hardware notes and more...
- [Support](support/README.md)
- From bug reports and current issues, to forum access and other useful resources, we want to help you find answers

***
17 changes: 17 additions & 0 deletions consumer/rs-g2l100/additional-docs/README.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,17 @@
---
title: Additional Docs for rs-g2l100
permalink: /documentation/consumer/rs-g2l100/additional-docs/
---
# Board Images

Each 96Boards development board must provide six images, 3 x High Definition and 3 x Standard Definition. These images should be sized and named accordingly. These images should be uploaded to this folder and made available to community for viewing and/or download.

#### 1500x974 - 300dpi
- BoardName_Front_HD
- BoardName_Back_HD
- BoardName_Angle_HD

#### 770x500 - 72dpi
- BoardName_Front_SD
- BoardName_Back_SD
- BoardName_Angle_SD
13 changes: 13 additions & 0 deletions consumer/rs-g2l100/additional-docs/images/images-board/README.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,13 @@
# Board Images

Each 96Boards development board must provide six images, 3 x High Definition and 3 x Standard Definition. These images should be sized and named accordingly. These images should be uploaded to this folder and made available to community for viewing and/or download.

#### 1500x974 - 300dpi
- BoardName_Front_HD
- BoardName_Back_HD
- BoardName_Angle_HD

#### 770x500 - 72dpi
- BoardName_Front_SD
- BoardName_Back_SD
- BoardName_Angle_SD
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Original file line number Diff line number Diff line change
@@ -0,0 +1 @@
Upload all raw images used in the UserManual.md document to this folder.
Original file line number Diff line number Diff line change
@@ -0,0 +1 @@

12 changes: 12 additions & 0 deletions consumer/rs-g2l100/build/README.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,12 @@
---
title: Build Source for RS-G2L100
permalink: /documentation/consumer/rs-g2l100/build/
---
# Build from Source

Page under construction...

## Contents
- Yocto Build Guide - [View](/hardware-docs/files/RS-G2L100-software-userguide.pdf)
- [OpenEmbedded](oe.md)
- [Linux Kernel](kernel.md)
6 changes: 6 additions & 0 deletions consumer/rs-g2l100/build/aosp.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,6 @@
<!---
---
title: Build AOSP Source for boardname
permalink: /documentation/consumer/boardname/build/
---
-->
6 changes: 6 additions & 0 deletions consumer/rs-g2l100/build/debian.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,6 @@
<!---
---
title: Build Debian Source for boardname
permalink: /documentation/consumer/boardname/build/
---
-->
6 changes: 6 additions & 0 deletions consumer/rs-g2l100/build/kernel.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,6 @@
<!---
---
title: Build Kernel Source for boardname
permalink: /documentation/consumer/boardname/build/
---
-->
6 changes: 6 additions & 0 deletions consumer/rs-g2l100/build/oe.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,6 @@
<!---
---
title: Build OpenEmbedded Source for boardname
permalink: /documentation/consumer/boardname/build/
---
-->
26 changes: 26 additions & 0 deletions consumer/rs-g2l100/downloads/README.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,26 @@
---
title: Downloads for RS-G2L100
permalink: /documentation/consumer/rs-g2l100/downloads/
---

## Downloads

The Board RS-G2L100 comes pre-installed with Linux (Yocto).
<!---
If you would like to switch the Operating System, update the existing software images on your board, or unbrick your board, this page provides links to the latest software downloads.
-->
***

### Linaro supported operating systems

- [Yocto](https://mega.nz/file/CMwCkRoK#Ylf3IwSvw3KNjDOKR7en-ZMISkghy4wfRHxKOmYJBCg)
<!---
***
### Third Party Operating Systems
Other operating systems supported on RS-G2L100, offered by partners.
- [Android](aosp.md)
-->
***
42 changes: 42 additions & 0 deletions consumer/rs-g2l100/downloads/aosp.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,42 @@
<!---
---
title: AOSP Downloads for boardname
permalink: /documentation/consumer/boardname/downloads/aosp.md.html
---
-->

# Android Open Source Project (AOSP)

**AOSP** is a mobile/tablet platform environment developer preview. This environment is primarily used to test applications/software developed remotely on a host computer using an assortment of IDE’s(integrated development environments) and SDK’s(software development kits).

***

## SD Card image

Currenty not available...

***

## Fastboot files

| Bootloader | |
|:------------------|:-----------------------|
| Comp 1 | [Download]() |
| Comp 2 | [Download]() |
| Comp 3 | [Download]() |
| Comp 4 | [Download]() |
| Comp 5 | [Download]() |

| Latest build files | [Build Folder]() |
|:------------------------|:-----------------------|
| recovery.img | [Download]() |
| tinysys-scp.bin | [Download]() |
| lk.bin | [Download]() |
| boot.img | [Download]() |
| logo.bin | [Download]() |
| trustzone.bin | [Download]() |
| system.img | [Download]() |
| cache.img | [Download]() |
| userdata.img | [Download]() |

Continue to [Installation page](../installation/README.md)
42 changes: 42 additions & 0 deletions consumer/rs-g2l100/downloads/debian.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,42 @@
<!---
---
title: Debian Downloads for boardname
permalink: /documentation/consumer/boardname/downloads/debian.md.html
---
-->

# Debian

**Debian Linux** is a desktop/window or console (command line) based development environment comprised of some basic programs and utilities. Development can happen directly on the board, and within the OS. While applications and programs can be built directly on the board, they can also be built remotely and cross-compiled for the particular system.

***

## SD Card image

| SD Card Image | [Desktop]() or [Developer]() |
|:------------------|:------------------------------------|
|Release Notes: |[Link]() |

Continue to [Installation page](../installation/README.md)

***

## Fastboot files

| Bootloader | |
|:-------------|:-----------------------|
| Comp 1 | [Download]() |
| Comp 2 | [Download]() |
| Comp 3 | [Download]() |
| Comp 4 | [Download]() |
| Comp 5 | [Download]() |

| Boot image | [Download]() |
|:------------------|:-----------------------|
|Release Notes: |[Link]() |

| Rootfs image | [Desktop]() |
|:------------------|:----------------------------------|
|Release Notes: |[Link]() |

Continue to [Installation page](../installation/README.md)
114 changes: 114 additions & 0 deletions consumer/rs-g2l100/getting-started/README.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,114 @@
---
title: Basic Kit for RS-G2L100
permalink: /documentation/consumer/rs-g2l100/getting-started/
---

# Getting Started

Learn about your RS-G2L100 board as well as how to prepare and set up for basic use

## Setup - What you will need

**Need**
- [RS-G2L100]
- Board based on the Renesas RZ-G2L Processor
- Power adapter](PowerAdapter.md)
- 96Boards specifications requires a 8V-18V with 2000mA Power adapter
- USB Keyboard and Mouse
- With two USB-A connectors, all 96Boards can be equiped with a full sized keyboard and mouse
- Monitor and HDMI Cable
- All 96Boards are equiped with a full sized HDMI connector, HDMI capable monitor is recommended
- SW1
- SW1 on the RS-G2L100 comes with three pin-jumpers

**Optional**
- MicroSD card with adapter
- For quick and easy switching between operating systems and extra storage
- Mezzanine Products
- These devices allow you to expand your experience with any 96Boards by adding peripherals and enhancing onboard components
- USB to MicroUSB cable
- This is needed for serial console interface
- USB to ethernet adapter and ethernet cable
- For connecting to a network without using WiFi

***

# Out of the Box

The following subsections should describe how to get started with the RS-G2L100 using the release build shipped with the boards. The RS-G2L100 board is ready to use “out of the box” with a preinstalled version of the Linux(Yocto) distribution.

<img src="../additional-docs/images/images-board/sd/rs-g2l100-front-sd.png" data-canonical-src="../additional-docs/images/images-board/sd/rs-g2l100-front-sd.png" width="250" height="250" />
<img src="../additional-docs/images/images-board/sd/rs-g2l100-back-sd.png" data-canonical-src="../additional-docs/images/images-board/sd/rs-g2l100-back-sd.png" width="250" height="250" />
<img src="../additional-docs/images/images-board/sd/rs-g2l100-angle-sd.png" data-canonical-src="../additional-docs/images/images-board/sd/rs-g2l100-angle-sd.png" width="250" height="250" />

## Features

< https://github.com/96boards/documentation/blob/master/ConsumerEdition/DragonBoard-410c/GettingStarted/README.md >

| Component | Description |
|:---------------------|:-------------------------------------------------------------------------------------------------|
| SoC | Renesas RZ/G2L |
| CPU | 1× or 2× Cortex®[email protected] L1,L3 Parity/ECC,1× Cortex®-M33@200MHz |
| GPU | Arm Mali-G31 GPU @500MHz |
| RAM | 16-bit ×1ch DDR4-1600/DDR3L-1333 w/ECC |
| PMU | |
| Storage | 8GB eMMC on board storage MicroSD card slot |
| Ethernet Port | 2ch |
| Wireless | WIFI Module 2.4G/5.0G (optional) |
| USB | 2 x USB2.0, 1 x USB(OTG) |
| Display | 1 x HDMI |
| Video | Support up to Full HD @30fps resolutions Encoding and Decoding: H.264 |
| Audio | |
| Camera | |
| Expansion Interface | |
| LED | |
| Button | |
| Power Source | |
| OS Support | |
| Size | |

**IMPORTANT NOTES**

< Insert RS-G2L100 Important notes - Example Below - This section should be monitored by board maintainers. This information should be periodically updated. Please treat this section as a "News" section. Important notes should consist of thing you think end user MUST KNOW to minimize unnecessary support questions surrounding the out of box experience with shipped stock image >

- HDMI EDID display data is used to determine the best display resolution. On monitors and TVs that support 1080p (or 1200p) this resolution will be selected. If 1080p is not supported the next available resolution reported by EDID will be used. This selected mode will work with **MOST but not all** monitors/TVs.
- There are limitations on the usage of the USB ports on the Board-X board.

***

## Starting the board for the first time

**The RS-G2L100 comes preloaded with Linux(Yocto) and can be up and running with a few simple steps:**

- Connect the RS-G2L100 to your display with the HDMI cable. It is important to do this first because the monitor will not detect the board if it is connected after starting. Ensure that the source for the display is switched to the HDMI port you are using
- Connect the USB keyboard and mouse. Do not connect the USB OTG port to your computer – this will prevent the keyboard and mouse from operating. The USB OTG port is the micro USB connector on the board

- Ensure SW1 Pins are linked as follows:

| 1 | 2 | 3 | Boot Configuration |
|:--------------|:--------:|:------:|:---------------------:|
| 0 | 0 | 1 | Boot from eMMC |
| 1 | 0 | 0 | Boot from Single/Quad |
| 1 | 0 | 1 | SCIF download |

- Boot Mode Selection Switch Below are the Boot mode switch selection settings to boot the board.

> Note: The above setup will cause RS-G2L100 Board to Auto Power up when it is plugged into power
- Connect the power supply to the RS-G2L100. The board will begin to boot Debian Linux immediately
***

## Updating to a new release or change your operating system

If you are already familiar with the Board-X board and would like to change out the stock operating system, please proceed to one of the following pages:

- [Downloads page](../downloads/README.md): This page lists all Linaro and 3rd party operating systems available for Board-X
- [Installation page](../installation/README.md): If you already have the images you need, this page has information on how to install the different operating systems onto your Board-X board
- [Board Recovery](../installation/BoardRecovery.md)
- If at any time your board is having unexplainable issues, it is suggested to attempt a board recovery. These instructions will guide you through a succesfull board recovery.
- [Troubleshooting](../support/README.md)
- From bug reports and current issues, to forum access and other useful resources, we want to help you find answers

Back to the [RS-G2L100 documentation home page](../README.md)

***
18 changes: 18 additions & 0 deletions consumer/rs-g2l100/guides/README.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,18 @@
<!---
---
title: Useful Guides for boardname
permalink: /documentation/consumer/boardname/guides/
---
-->

# Useful Guides

These guides will help to get you started with a variety of available on-boards software

## Debian

Coming Soon...

## Android

Coming Soon...
19 changes: 19 additions & 0 deletions consumer/rs-g2l100/hardware-docs/README.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,19 @@
---
title: Hardware Documentation for rs-g2l100
permalink: /documentation/consumer/boardname/hardware-docs/
---

# Hardware Documentation

Explore what makes your RS-G2L100 unique, technical specifications, schematics, hardware notes and more... This page allows you to see what is under the "RS-G2L100 hood" by offering static documentation published directly from the board vendors.

## User Guides
- Hardware User Manual ([View](/hardware-docs/files/RS-G2L100-hardware-userguide.pdf))
- Software User Manual ([View](/hardware-docs/files/RS-G2L100-software-userguide.pdf))
- Product Brief ([View](/hardware-docs/files/RS-G2L100_Specification.pdf))

## Hardware
<!---
- BOM ([View](/hardware-docs/files/RS-G2L100_Schematic.pdf) / [Download](https://github.com/xingGTC/rs-g2l100/blob/main/hardware-docs/files/RS-G2L100_Schematic.pdf))
-->
- Schematics ([View](/hardware-docs/files/RS-G2L100_Schematic.pdf))
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Loading

0 comments on commit 44618a0

Please sign in to comment.