# meta-tanowrt

**Repository Path**: dingl/meta-tanowrt

## Basic Information

- **Project Name**: meta-tanowrt
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2021-03-11
- **Last Updated**: 2021-03-11

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README


<img src="./meta-tanowrt/docs/tano-logo.svg" width="200">

# TanoWrt Linux Distribution

This repository contains OpenEmbedded layers of TanoWrt Linux distribution by Tano Systems.

## 1 Prerequisites

The recommended Linux distribution is Ubuntu 18.04 or Ubuntu 20.04.

### 1.1 Install Required Packages

Install the required packages by executing the following commands depending on your distribution:
- Ubuntu or Debian

    ```shell
    sudo apt-get install gawk wget git-core diffstat unzip texinfo gcc-multilib \
         build-essential chrpath socat cpio python python3 python3-pip python3-pexpect \
         xz-utils debianutils iputils-ping
    ```

- Fedora

    ```shell
    sudo dnf install gawk make wget tar bzip2 gzip python3 unzip perl patch \
         diffutils diffstat git cpp gcc gcc-c++ glibc-devel texinfo chrpath \
         ccache perl-Data-Dumper perl-Text-ParseWords perl-Thread-Queue perl-bignum \
         socat python3-pexpect findutils which file cpio python python3-pip xz
    ```

- openSUSE

    ```shell
    sudo zypper install python gcc gcc-c++ git chrpath make wget python-xml \
         diffstat makeinfo python-curses patch socat python3 python3-curses tar \
         python3-pip python3-pexpect xz which
    ```

- CentOS

    ```shell
    sudo yum install -y epel-release
    sudo yum makecache
    sudo yum install gawk make wget tar bzip2 gzip python unzip perl patch \
         diffutils diffstat git cpp gcc gcc-c++ glibc-devel texinfo chrpath socat \
         perl-Data-Dumper perl-Text-ParseWords perl-Thread-Queue python34-pip xz \
         which SDL-devel xterm
    ```

### 1.2 Configure Default System Shell

*Only for Ubuntu*

You need to configure the default system shell command interpreter for shell scripts to bash. You can do it with the command:

```shell
sudo dpkg-reconfigure dash
```

Select `No` when it asks you to install dash as `/bin/sh`.

### 1.3 Install Repo Tool

```shell
mkdir -p ~/bin
PATH=~/bin:$PATH
curl https://storage.googleapis.com/git-repo-downloads/repo > ~/bin/repo
chmod a+x ~/bin/repo
```

More detailed information about installing repo tool can be founded [here](https://gerrit.googlesource.com/git-repo).

## 2 Supported Hardware

TanoWrt Linux distribution core layer, located in `meta-tanowrt` subdirectory of this repository, supports only machines designed to run in QEMU.

Support for real hardware is provided by additional hardware support layers (HSL) located in the `meta-tanowrt-hsl-*` subdirectories of this repository.

Detailed instructions on how to use each layer to build the TanoWrt Distribution images can be found in the documentation of the appropriate layers:

| Layer                      | Hardware                                          |
| -------------------------- | ------------------------------------------------- |
| [meta-tanowrt]             | QEMU for x86 (32-bit and 64-bit), ARMv5 and ARMv8 |
| [meta-tanowrt-hsl-nxp]     | NXP (Freescale) boards                            |
| [meta-tanowrt-hsl-rpi]     | Raspberry Pi boards                               |
| [meta-tanowrt-hsl-swi]     | Sierra Wireless LTE modules                       |
| [meta-tanowrt-hsl-ti]      | Texas Instruments SoC based devices               |

[meta-tanowrt]: meta-tanowrt/README.md
[meta-tanowrt-hsl-nxp]: meta-tanowrt-hsl-nxp/README.md
[meta-tanowrt-hsl-rpi]: meta-tanowrt-hsl-rpi/README.md
[meta-tanowrt-hsl-swi]: meta-tanowrt-hsl-swi/README.md
[meta-tanowrt-hsl-ti]: meta-tanowrt-hsl-ti/README.md

## 3 Access

The following credentials are used by default to access the operating system (terminal) and the LuCI web-configuration interface:
* User name: `root`
* Password: `root`

## 4 Limitations

Works with OE Release 3.1 (Dunfell).

## 5 License

All metadata is MIT licensed unless otherwise stated. Source code included in tree for individual recipes is under the LICENSE stated in each recipe (.bb file) unless otherwise stated.

## 6 Maintainers

Anton Kikin <a.kikin@tano-systems.com>