Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Pine64 article and openhabian content #325

Merged
merged 8 commits into from
Feb 17, 2017
Merged
Show file tree
Hide file tree
Changes from 3 commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
Binary file added installation/images/pine64.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added installation/images/rpi2b.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
54 changes: 42 additions & 12 deletions installation/openhabian.md
Original file line number Diff line number Diff line change
Expand Up @@ -73,32 +73,62 @@ 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)
* [Download the latest "openHABianPi" SD card image file](https://github.com/ThomDietrich/openhabian/releases)
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Shouldn't the url be https://github.com/openhab/openhabian/releases ?

Copy link
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

oh, good catch! It's the old URL and I've just copy&pasted it now.

* 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)
* 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 `pi:raspberry`.
You will see the following welcome screen:

![openHABian login screen](images/openHABian-SSH-MotD.png)

➜ Continue at the ["First Steps"](#first-steps) chapter below!

### Pine64
### Pine A64

***... Coming Soon! ...***
We also 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/ThomDietrich/openhabian/releases) (Note: the file is *xz* compressed)
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Shouldn't the url be https://github.com/openhab/openhabian/releases ?

* Write the image file to your SD card (e.g. with [Etcher](https://etcher.io)), depending on your environment you might need to extract the compressed image file first (e.g. with [WinRAR](http://www.rarlab.com/download.htm) or [7zip](http://www.7-zip.org))
* 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 `ubuntu:ubuntu`.
You will see the following welcome screen:

![openHABian login screen](images/openHABian-SSH-MotD.png)

➜ Continue at the ["First Steps"](#first-steps) section below!

### Manual Setup

Expand Down Expand Up @@ -159,7 +189,7 @@ 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é.

{: #passwords}
### Changing your Passwords
Expand Down Expand Up @@ -217,7 +247,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 ...?
Expand Down
17 changes: 15 additions & 2 deletions installation/pine.md
Original file line number Diff line number Diff line change
Expand Up @@ -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.

![Pine A64](images/pine64.png)

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).
6 changes: 2 additions & 4 deletions installation/rasppi.md
Original file line number Diff line number Diff line change
Expand Up @@ -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.

![Raspberry Pi 2 Model B](https://www.raspberrypi.org/wp-content/uploads/2015/02/Pi_2_Model_B.png)
![Raspberry Pi 2 Model B](images/rpi2b.png)

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.
Expand All @@ -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

Expand Down