[Installation] Pine A64 article and openhabian content (#325)
* Add first pine content Signed-off-by: Thomas Dietrich <Thomas.Dietrich@tu-ilmenau.de> * Fix review comments Signed-off-by: Thomas Dietrich <Thomas.Dietrich@tu-ilmenau.de> * Revert username:password till a decision is made Signed-off-by: Thomas Dietrich <Thomas.Dietrich@tu-ilmenau.de> * Update openhabian.md Signed-off-by: Thomas Dietrich <thomas.dietrich@tu-ilmenau.de> (github: ThomDietrich) * Update openhabian.md Signed-off-by: Thomas Dietrich <thomas.dietrich@tu-ilmenau.de> (github: ThomDietrich) * Update openhabian.md * Update user-menu.html * Update index.md Signed-off-by: Thomas Dietrich <thomas.dietrich@tu-ilmenau.de> (github: ThomDietrich)pull/331/head
Thomas Dietrich
GitHub
parent
7ce136b11a
commit
6bf2a4287e
|
|
@ -24,6 +24,7 @@
|
|||
<li><a href="{{docu}}/installation/docker.html">Docker</a></li>
|
||||
<hr />
|
||||
<li><a href="{{docu}}/installation/rasppi.html">Raspberry Pi</a></li>
|
||||
<li><a href="{{docu}}/installation/pine.html">Pine A64</a></li>
|
||||
<li><a href="{{docu}}/installation/synology.html">Synology DiskStation</a></li>
|
||||
<li><a href="{{docu}}/installation/qnap.html">QNAP NAS</a></li>
|
||||
<hr />
|
||||
|
|
|
|||
Binary file not shown.
|
After Width: | Height: | Size: 256 KiB |
Binary file not shown.
|
After Width: | Height: | Size: 264 KiB |
|
|
@ -31,9 +31,10 @@ Experiences with different devices and environments can be found in the [communi
|
|||
|
||||
The [Raspberry Pi](rasppi.html) as a minimal sufficient device is quite popular, especially as we offer a quick setup with [openHABian](openhabian.html).
|
||||
A popular alternative is [our solution for the Synology DiskStation](synology.html), which many users already own in their homes.
|
||||
|
||||
The previously mentioned [openHABian](openhabian.html) can also be used to kickstart your openHAB 2 experience on existing debian/ubuntu based Linux systems.
|
||||
|
||||
Please check the menu to the left for for all available options.
|
||||
|
||||
## Prerequisites
|
||||
|
||||
Make sure that you have an up to date Java platform installed on your host system.
|
||||
|
|
|
|||
|
|
@ -41,7 +41,7 @@ The following features are provided by openHABian:
|
|||
* openHABian configuration tool including an updater
|
||||
* [Raspberry Pi specific](rasppi.html): Extend to the whole SD card, 16MB GPU memory split
|
||||
|
||||
openHABian provides the configuration tool `openhabian-config` with the following optional settings and components:
|
||||
openHABian provides the configuration tool [`openhabian-config`](#first-steps) with the following optional settings and components:
|
||||
|
||||
|
||||
|
||||
|
|
@ -73,41 +73,71 @@ Learn more about the Raspberry Pi as your platform for openHAB and about the req
|
|||
|
||||
**Setup:**
|
||||
|
||||
* [Download the latest SD card image here](https://github.com/ThomDietrich/openhabian/releases)
|
||||
* Write the image to your SD card ([instructions](https://www.raspberrypi.org/documentation/installation/installing-images/README.md))
|
||||
* Connect Ethernet, SD card and power to your Raspberry Pi
|
||||
* Wait up to **45 minutes** (setup depends on your downlink as almost everything is downloaded live)
|
||||
* [Download the latest "openHABianPi" SD card image file](https://github.com/openhab/openhabian/releases)
|
||||
* Write the image to your SD card (e.g. with [Etcher](https://etcher.io))
|
||||
* Insert the SD card into the Raspberry Pi, connect Ethernet and power
|
||||
* Wait approximately **45 minutes** for openHABian to do its magic
|
||||
* Enjoy! 🎉
|
||||
|
||||
* The device will be available under it's IP or via the local DNS name `openhabianpi`
|
||||
* [Connect to the openHAB 2 portal](http://docs.openhab.org/configuration/packages.html) (available after a few more minutes): [http://openhabianpi:8080](http://openhabianpi:8080)
|
||||
* The device will be available under its IP or via the local DNS name `openhabianpi`
|
||||
* [Connect to the openHAB 2 dashboard](http://docs.openhab.org/configuration/packages.html) (available after a few more minutes): [http://openhabianpi:8080](http://openhabianpi:8080)
|
||||
* [Connect to the Samba network shares](http://docs.openhab.org/installation/linux.html#mounting-locally) with `openhab:habopen`
|
||||
* If you encounter a connection problem: [See here](#faq-successful)
|
||||
* If you encounter any setup problem, [please continue here](#faq-successful)
|
||||
|
||||
You can stop reading now.
|
||||
openHABian has installed and configured your openHAB system and you can start to use it right away.
|
||||
If you want to get in touch with the system or install one of the previously mentioned optional components, you can come back here later.
|
||||
If you want to get in touch with the system or want to install one of the previously mentioned optional features, you can come back here later.
|
||||
|
||||
Ready for more?
|
||||
[Connect to your Raspberry Pi SSH console](https://www.raspberrypi.org/documentation/remote-access/ssh/windows.md) using the username and password `pi:raspberry`.
|
||||
[Connect to your Raspberry Pi SSH console](https://www.raspberrypi.org/documentation/remote-access/ssh/windows.md) using the username and password `openhabian:openhabian`.
|
||||
You will see the following welcome screen:
|
||||
|
||||
|
||||
|
||||
➜ Continue at the ["First Steps"](#first-steps) chapter below!
|
||||
|
||||
### Pine64
|
||||
### Pine A64
|
||||
|
||||
***... Coming Soon! ...***
|
||||
We provide a ready to use system image for the Pine A64.
|
||||
The image is based on the official [Ubuntu Base Image by longsleep](http://wiki.pine64.org/index.php/Pine_A64_Software_Release), which comes as a compressed 4GB file.
|
||||
After boot-up the latest version of openHAB 2 and the featured settings and tools are installed.
|
||||
All packages are downloaded in their newest version and configured to work without further modifications.
|
||||
|
||||
Learn more about the Pine A64 as your platform for openHAB and about the requirements in our [Pine A64 article](pine.html).
|
||||
|
||||
**Setup:**
|
||||
|
||||
* [Download the latest "openHABianPine64" SD card image file](https://github.com/openhab/openhabian/releases) (Note: the file is *xz* compressed)
|
||||
* Write the image file to your SD card (e.g. with [Etcher](https://etcher.io))
|
||||
* Insert the SD card into the Pine A64, connect Ethernet and power ([See here for more details](http://wiki.pine64.org/index.php/Main_Page#Step_by_Step_Instructions))
|
||||
* Wait approximately **15 minutes** for openHABian to do its magic
|
||||
* Enjoy! 🎉
|
||||
|
||||
* The device will be available under its IP or via the local DNS name `openhabianpine64`
|
||||
* [Connect to the openHAB 2 dashboard](http://docs.openhab.org/configuration/packages.html) (available after a few more minutes): [http://openhabianpine64:8080](http://openhabianpine64:8080)
|
||||
* [Connect to the Samba network shares](http://docs.openhab.org/installation/linux.html#mounting-locally) with `openhab:habopen`
|
||||
* If you encounter any setup problem, [please continue here](#faq-successful)
|
||||
|
||||
You can stop reading now.
|
||||
openHABian has installed and configured your openHAB system and you can start to use it right away.
|
||||
If you want to get in touch with the system or want to install one of the previously mentioned optional features, you can come back here later.
|
||||
|
||||
Ready for more?
|
||||
Connect to your Pine A64 SSH console using the username and password `openhabian:openhabian`.
|
||||
You will see the following welcome screen:
|
||||
|
||||
|
||||
|
||||
➜ Continue at the ["First Steps"](#first-steps) section below!
|
||||
|
||||
### Manual Setup
|
||||
|
||||
openHABian also supports general Debian/Ubuntu based systems on different platforms.
|
||||
Successful installations have been reported for the following platforms and environments:
|
||||
|
||||
> **Attention:**
|
||||
> openHABian usage on a custom existing system is supported but not yet widely tested.
|
||||
> Please be cautious and have a close look at the console output for errors.
|
||||
> Please report every error you see at the [openHABian Issue Tracker](https://github.com/openhab/openhabian/issues).
|
||||
* **Raspberry Pi Zero:** The RPi0 doesn't have an ethernet port thus is not compatible with the netinstaller method of the openHABianPi image.
|
||||
Community member [*jtmoderate876* went the extra mile](https://community.openhab.org/t/oh-on-the-raspberry-pi-zero/10997/15).
|
||||
After installing Raspbian, executing openHABian as described below was all that's needed. He's quite happy with the results.
|
||||
|
||||
Starting with a fresh installation of your operating system, install git, then clone the openHABian poject and finally execute the openHABian configuration tool.
|
||||
|
||||
|
|
@ -126,6 +156,12 @@ sudo openhabian-config
|
|||
|
||||
You'll see the openHABian configuration menu and can now run all desired actions, e.g. install the newest Oracle Java 8 revision or openHAB 2.
|
||||
|
||||
> Attention:
|
||||
> openHABian usage on a custom system is supported but not yet widely tested.
|
||||
> Please be cautious and have a close look at the console output for errors.
|
||||
> Report every error you see to the [openHABian Issue Tracker](https://github.com/openhab/openhabian/issues).
|
||||
|
||||
|
||||
## First Steps
|
||||
|
||||
The following instructions are oriented at the Raspberry Pi openHABian setup but are transferable to all openHABian environments.
|
||||
|
|
@ -139,12 +175,12 @@ It is not only a menu with a set of options, it's also used in a special unatten
|
|||
|
||||
Execute the "Update" function before anything else. The menu and the menu options will evolve over time and you should ensure to be up to date.
|
||||
|
||||
All other menu entries should be self-explaining and a more details will be shown after selecting an option.
|
||||
All other menu entries should be self-explaining and more details are shown after selecting an option.
|
||||
|
||||
ℹ - The actions behind menu entry 1-5 are already taken care of on a Raspberry Pi openHABian image installation.
|
||||
|
||||
⌨ - A quick note on menu navgation.
|
||||
Use the cursor keys to navigate, <Enter> to execute, <Space> to select and <Tab> to jump to the actions on the bottom of the screen.
|
||||
Use the cursor keys to navigate, <Enter> to execute, <Space> to select and <Tab> to jump to the actions on the bottom of the screen. Press <Esc> twice to exit the configuration tool.
|
||||
|
||||
### Linux Hints
|
||||
|
||||
|
|
@ -159,7 +195,47 @@ A lot of helpful articles can be found on the internet, for example:
|
|||
|
||||
Regardless of if you want to copy some files or are on the search for a solution to a problem, sooner or later you'll have to know some Linux.
|
||||
Take a few minutes to study the above Tutorials and get to know the most basic commands and tools to be able to navigate on your Linux system, edit configurations, check the system state or look at log files.
|
||||
It's really not complicated and something that doesn't hurt on noes resumé.
|
||||
It's not complicated and something that doesn't hurt on ones résumé.
|
||||
|
||||
{: #further-config}
|
||||
### Further Configuration Steps
|
||||
|
||||
openHABian is supposed to provide a ready-to-use openHAB base system. There are however a few things we can not decide for you.
|
||||
|
||||
* **Timezone:** The default timezone openHABian is shipped with is "Europe/Berlin". You should change it to your location.
|
||||
* **Language:** The `locale` setting of the openHABian base system is set to "en_US.UTF-8". While this setting will not do any harm, you might prefer e.g. console errors in german or spanish. Change the locale settings acordingly. Be aware, that error solving might be easier when using the english error messages as search phrases.
|
||||
* **Passwords:** Relying on default passwords is a security concern you should care about!
|
||||
|
||||
{: #timezone-locale}
|
||||
### Timezone and Locale
|
||||
|
||||
To change the timezone for your openHABian system execute the follwing commands:
|
||||
|
||||
```shell
|
||||
# List available timezones
|
||||
timedatectl list-timezones
|
||||
|
||||
# Set system timezone
|
||||
sudo timedatectl set-timezone Europe/Berlin
|
||||
|
||||
# Check the result
|
||||
timedatectl
|
||||
```
|
||||
|
||||
Changing the locale of your system is done by the below commands.
|
||||
The first command configures the available languges, the second will define the default.
|
||||
You should leave Englisch as an available language, as not all packages provide error messages in e.g. German.
|
||||
|
||||
```shell
|
||||
# List available locales
|
||||
cat /usr/share/i18n/SUPPORTED
|
||||
|
||||
# Generate locales, set default
|
||||
/usr/sbin/locale-gen en_US.UTF-8 de_DE.UTF-8
|
||||
/usr/sbin/update-locale LANG=en_US.UTF-8
|
||||
```
|
||||
|
||||
You will need to restart your system for the locale setting to take effect.
|
||||
|
||||
{: #passwords}
|
||||
### Changing your Passwords
|
||||
|
|
@ -217,7 +293,7 @@ openHABian installs the latest stable build of openHAB 2.
|
|||
If you want to switch over to the testing/beta or the snapshot release branch, please do so manually on the SSH/Linux console.
|
||||
Switching from stable to newer development releases might introduce changes and incompatiblities, so please be sure to make a full openHAB backup first!
|
||||
|
||||
Check the Linux installation article for all needed details: [Linux: Changing Versions](http://docs.openhab.org/installation/linux.html#changing-versions)
|
||||
Check the Linux installation article for all needed details: [Linux: Changing Versions](http://docs.openhab.org/installation/linux.html#changing-versions)
|
||||
|
||||
{: #faq-other-platforms}
|
||||
#### Can I use openHABian on ...?
|
||||
|
|
|
|||
|
|
@ -5,6 +5,19 @@ title: PINE A64
|
|||
|
||||
{% include base.html %}
|
||||
|
||||
# Installation on a PINE A64
|
||||
# Pine A64
|
||||
|
||||
{% include contribution-wanted.html %}
|
||||
The [PINE A64](https://www.pine64.org/?page_id=1194) is a young but promising single-board computers (SBC) on the market.
|
||||
The project started off as a [Kickstarter campaign](https://www.kickstarter.com/projects/pine64/pine-a64-first-15-64-bit-single-board-super-comput) back in December 2015.
|
||||
Single Board Computer powered by Quad-Core ARM Cortex A53 64-Bit Processor.
|
||||
|
||||
|
||||
|
||||
Please visit the [official homepage](https://www.pine64.org) and [wiki](http://wiki.pine64.org/index.php/Main_Page) for more information and details.
|
||||
|
||||
## Recommended Setup
|
||||
|
||||
We are proud to provide a system image for the Pine A64, including the latest version of openHAB 2 and many recommended settings and useful software additions.
|
||||
The image is based on the official [Ubuntu Base Image by longsleep](http://wiki.pine64.org/index.php/Pine_A64_Software_Release) and the openHABian project.
|
||||
|
||||
Check out more details about [openHABian, the hassle-free openHAB setup](openhabian.html).
|
||||
|
|
|
|||
|
|
@ -10,12 +10,11 @@ title: Raspberry Pi
|
|||
Because of it's **low price**, it's **small form factor** and the **low energy consumption**, the [Raspberry Pi](https://www.raspberrypi.org) is a quite popular platform for openHAB.
|
||||
It is favored amongst existing users and a recommended choice for newcomers.
|
||||
|
||||
|
||||
|
||||
|
||||
If you want to learn more about the possibilities of the Raspberry Pi and Linux in general, many tutorials can be found on the internet.
|
||||
These including the official [raspberrypi.org help articles](https://www.raspberrypi.org/help) or the in-detail articles at [eLinux.org](http://elinux.org/RPi_Tutorials).
|
||||
|
||||
|
||||
Recommendations for a ["headless"](https://en.wikipedia.org/wiki/Headless_computer) hardware setup:
|
||||
|
||||
* [Raspberry Pi 2 or newer](https://en.wikipedia.org/wiki/Raspberry_Pi#Specifications), compare your existing device [here](https://en.wikipedia.org/wiki/Raspberry_Pi#Connectors) if you are unsure.
|
||||
|
|
@ -29,8 +28,7 @@ Recommendations for a ["headless"](https://en.wikipedia.org/wiki/Headless_comput
|
|||
We are proud to provide a **preconfigured image** for the Raspberry Pi, with the latest build of openHAB 2 and many useful software components (like Samba, Grafana or Mosquitto) as optional setup steps.
|
||||
**openHABian** is based on Raspbian and under constant improvement.
|
||||
|
||||
Check out more details about [openHABian, the hassle-free RPi image](openhabian.html).
|
||||
|
||||
Check out more details about [openHABian, the hassle-free openHAB setup](openhabian.html).
|
||||
|
||||
## Manual Setup
|
||||
|
||||
|
|
|
|||
Loading…
Reference in New Issue