OpenHU Project Management

2016-06-24T12:28:59Z

AdminTeam:

'''[http://consoleos.com/ Console OS] > [[Main_Page|Wiki]] > [[OpenHU]] > OpenHU Builds'''

= Project Plan & Milestones =

''This is very, very early rough-draft porting from the final work Mike Reid contributed, and our conversations with him before his passing.''

* Early Phase 1 - Cleanup build process, create an easy step-by-step guide, and adjust makefiles to embrace a standalone compile process
* Early Phase 2 - Migrate from Ant & Eclipse to Gradle & Android Studio
* Bughunt - Add x86-clean (w/o Houdini) building, improve ADB reliability, and evaluate official Wi-Fi mode support
* Major Revision - Migrate NDK code over to JNI and ART for future Android OS version compatibility (likely required to run OpenHU server atop Android N final release, due to security changes to ADB server - unless Google adds an NDK ADB passthrough)

= Licensing =

As noted on the License file on GitHub, OpenHU is currently licensed under GPLv3 Affero. It was Mike Reid's original intention to not accept outside commits, and license the code using other licenses when companies, and use cases, arose that may not warrant GPLv3 Affero.

Obviously, Mike Reid's passing complicates this significantly.

At Console, we are working on contacting Mike Reid's next of kin, and getting permission to relicense the project under GPLv2 or GPLv3. Since Mike Reid's code represented 100% of our initial GitHub posting, we do not need to seek permission from others.

Also as noted in the License (and GitHub pages), we only will accept community code pushes if the developer is willing to license under GPLv2 and GPLv3, at our discretion. If you are not comfortable with this, do not submit a pull request to our GitHub.

If we are unable to obtain authorization from Mike Reid's next of kin (or authorized representative), we will continue development under GPL Affero exclusively. We realize some commercial developers are not comfortable with the Affero license, so this is a high priority for us.

= Long-term Wants/Needs/Requests =

''No plans to even evaluate for foreseeable future, just community brainstorming from the [http://forums.console.com.co/forums/openhu.73/ forums] and elsewhere. Any reasonably good idea shared with us, will go here.''

* Open-source Client? - Replacement for Android Auto client app
* Bluetooth PAN Connectivity - Instantly pair, connect, and use Bluetooth for video frame transfer
* Integrated OpenHU apps pushed to client - OBD2 diagnostics/status, Torque integration, connected services, etc

OpenHU

2016-06-24T12:23:37Z

AdminTeam: AOSP link

'''[http://consoleos.com/ Console OS] > [[Main_Page|Wiki]] > OpenHU'''

=About OpenHU=

OpenHU is an app that enables your Android tablet to function as an Android Auto receiver, in your car. It is an open-source app, originally created by Mike Reid. Since his passing, we've taken over development of the app, and are committed to continuing its development in open-source.

OpenHU is the formal project name, but is an abbreviation that stands for '''Open''' '''H'''ead '''U'''nit for Android Auto. Because Android Auto is a trademark of Google, we typically avoid direct references unless necessary to explain how the app works, or to the Android Auto protocol where fair use would naturally prevail.

Android Auto is a closed-source app, and unfortunately is not an open-source part of the [https://source.android.com/ Android Open Source Project]. ''We hope that changes in the future!'' However, Android Auto is built using open-source technologies and protocols, hence the community (pioneered by the late Mike Reid), was able to reverse engineer the Android Auto protocol, and create an open-source head unit application. The OpenHU Project is a continuation of that groundbreaking effort.

This project is in its very early stages. We need your help to keep it going, as we never planned on taking over development. Without the help of the Android developer community, we can't keep this going ourselves. To that end, we're realigning and rebooting our [[Console Developer Rewards]] initiative, to reward indie developers for their FOSS contributions to OpenHU.

For now, check out the pages below for details and information about OpenHU:

* [[OpenHU Builds]] - Compiled early builds for testing
* [[OpenHU Source Code]] - Getting the code, and build instructions
* [[OpenHU Project Management]] - Goals, objectives, and how to contribute and/or donate
* [[Console Developer Rewards]] - Our incentive plan, initially (re) launching with a focus on the OpenHU Project
* [http://forums.console.com.co/forums/openhu.73/ OpenHU Support Forum]

OpenHU

2016-06-24T12:22:21Z

AdminTeam: Expanded about page

'''[http://consoleos.com/ Console OS] > [[Main_Page|Wiki]] > OpenHU'''

=About OpenHU=

OpenHU is an app that enables your Android tablet to function as an Android Auto receiver, in your car. It is an open-source app, originally created by Mike Reid. Since his passing, we've taken over development of the app, and are committed to continuing its development in open-source.

OpenHU is the formal project name, but is an abbreviation that stands for '''Open''' '''H'''ead '''U'''nit for Android Auto. Because Android Auto is a trademark of Google, we typically avoid direct references unless necessary to explain how the app works, or to the Android Auto protocol where fair use would naturally prevail.

Android Auto is a closed-source app, and is not an open-source part of the Android Open Source Project. However, Android Auto is built using open-source technologies and protocols, hence the community (pioneered by the late Mike Reid), was able to reverse engineer the Android Auto protocol, and create an open-source head unit application. The OpenHU Project is a continuation of that groundbreaking effort.

This project is in its very early stages. We need your help to keep it going, as we never planned on taking over development. Without the help of the Android developer community, we can't keep this going ourselves. To that end, we're realigning and rebooting our [[Console Developer Rewards]] initiative, to reward indie developers for their FOSS contributions to OpenHU.

For now, check out the pages below for details and information about OpenHU:

* [[OpenHU Builds]] - Compiled early builds for testing
* [[OpenHU Source Code]] - Getting the code, and build instructions
* [[OpenHU Project Management]] - Goals, objectives, and how to contribute and/or donate
* [[Console Developer Rewards]] - Our incentive plan, initially (re) launching with a focus on the OpenHU Project
* [http://forums.console.com.co/forums/openhu.73/ OpenHU Support Forum]

Console Developer Rewards

2016-06-24T12:19:32Z

AdminTeam: Created page

OpenHU Project Management

2016-06-24T12:17:13Z

AdminTeam: Created page

Main Page

2016-06-24T11:57:33Z

AdminTeam:

<div class="col-md-12 cos-main txt">
<div class="col-md-2">
<div class="thumbnail bot">
[[File:Console-Inc-Consolebot-alpha-135x173.png|link=http://consoleos.com|center|middle]]
</div></div>
<div class="col-md-10">
=== Welcome to the Console, Inc Wiki ===

Welcome to the Wiki for Console, Inc! Located here is an information repository for all of our products, both production and experimental.

For additional support for all Console products, the [http://forums.console.com.co/ Console Forums] are open and staffed with Console teammates, as well as the entire community, to get your questions answered as fast as possible.

</div>
== OpenHU Project (New!) ==
The OpenHU Project is our new effort to continue the open-source Android Auto Head Unit application, originally developed by the late Mike Reid.

In a nutshell, the OpenHU app will allow you to take most modern Android tablets, and use them as an Android Auto receiver for your car. It is fully open-source, and we're taking over leadership of the project, in order to keep a great app going.

''This is a new expansion of the Wiki. Pardon the dust while we finish it!''

* [[OpenHU Builds]] - Compiled early builds for testing
* [[OpenHU Source Code]] - Getting the code, and build instructions
* [[OpenHU Project Management]] - Goals, objectives, and how to contribute and/or donate
* [[Console Developer Rewards]] - Our incentive plan, initially (re) launching with a focus on the OpenHU Project
* [http://forums.console.com.co/forums/openhu.73/ OpenHU Support Forum]

''Necessary Note: This is not a Google application. Google owns all related Android trademarks and intellectual property related to Android Auto.''

== Console OS™ (Experimental) ==

Console OS™ with Android is the first commercial distribution of the Android™ operating system, and is based on the [https://source.android.com/ Android Open Source Project]. Our goal is to make the most powerful, and easy-to-use Android experience possible for the laptop, desktop, PC Tablet, and 2-in-1.

Console OS is free software, both for [https://account.console.com.co/ public download], as well as in [https://github.com/iConsole source code form on GitHub]. We welcome you to check out the extensive resources below to learn more about Console OS with Android!

</div>
<div class="col-md-12 cos-main">
<div class="panel panel-info-white-border">
<div class="panel-heading">
<h2 class="panel-title">Introduction</h2>
</div>
<div class="panel-body">
*[[Getting Started with Console OS]] - Finding out if Console OS is right for you, and where we're headed...
*[[Obtaining Console OS]] - Learn who can get Console OS today and how to get it in the future
*[[FAQ]] - Frequently asked questions
*[[Source Code]]
</div>
</div>
</div>
<div class="col-md-12 cos-main">
<div class="panel panel-info-white-border">
<div class="panel-heading">
<h2 class="panel-title">Hardware</h2>
</div>
<div class="panel-body">
*[[Devices]] - Important Details about Console OS compatibility per-machine
*[[Custom PCs]] - Guidelines for building your own PC that runs Console OS
*[[Unsupported Systems]] - Console OS is currently built to target iconic and popular systems, but it may work for other PCs too
</div>
</div>
</div>
<div class="col-md-12 cos-main">
<div class="panel panel-info-white-border">
<div class="panel-heading">
<h2 class="panel-title">Console OS Lollipop</h2>
</div>
<div class="panel-body">
*[[Release Notes]] - Read me first, before installing
*Also visit the [[Devices]] page for device-specific details, required firmware updates, and other information
*[[Storage Requirements]]
</div>
</div>
</div>
<div class="col-md-12 cos-main">
<div class="panel panel-info-white-border">
<div class="panel-heading">
<h2 class="panel-title">Console OS Open Source Project</h2>
</div>
<div class="panel-body">
*[[Source Code|Source Code Home Page]] - Learn more about Console OS in Open Source, or check the links below:
*[[Build Instructions]] - How to configure a build environment, download the source code, and create your first build
*Contributing - How to commit code and help make Console OS even better
*Console Developer Rewards - Programs where we are incentivizing contribution
</div>
</div>
</div>
<div class="col-md-12 cos-main">
<div class="panel panel-info-white-border">
<div class="panel-heading">
<h2 class="panel-title">Archived</h2>
</div>
<div class="panel-body">
*[[Release Notes DR1 KitKat]]
</div>
</div>
</div>
<div class="col-md-12">
<div class="row">
<div class="col-md-4">
<div class="panel panel-info-white-border">
<div class="panel-heading">
<h3 class="panel-title">Community</h3>
</div>
<div class="panel-body pix">
<div class="thumbnail" style="margin-top: 15px;">[[File:Console-Inc-Console-os-android-for-pc-startup-1085x635.png |link=Community]]</div>
</div>
</div>
</div>
<div class="col-md-4">
<div class="panel panel-info-white-border">
<div class="panel-heading">
<h3 class="panel-title">Video Demos</h3>
</div>
<div class="panel-body pix">
<div class="thumbnail" style="margin-top: 15px;">[[File:Console-Inc-Console-os-android-pc-video-preview-1085x635.png |link=Video Demos]]</div>
</div>
</div>
</div>
<div class="col-md-4">
<div class="panel panel-info-white-border">
<div class="panel-heading">
<h3 class="panel-title">Resources</h3>
</div>
<div class="panel-body pix">
<div class="thumbnail" style="margin-top: 15px;">[[File:Console-Inc-Console-os-android-pc-links-1085x635.png |link=Resources]]</div>
</div>
</div>
</div>
</div>
</div>

<div class="col-md-12 cos-main txt bot">
<div class="col-md-10">
=== Console OS™ with Android™ ===
* Production-grade Android on the Desktop
* Industry-licensed, native Android that can really toggle with Windows on your PC
* Raising Android up to be your primary PC operating system
* Creating a touch-optional Android – and touch-friendly for massive multitouch displays
* Perfect for existing PC tablets and 2-in-1 devices
</div></div>

OpenHU Source Code

2016-06-24T11:57:08Z

AdminTeam: Forum link

'''[http://consoleos.com/ Console OS] > [[Main_Page|Wiki]] > [[OpenHU]] > OpenHU Builds'''

=Compiling OpenHU=

This is a very, very early draft. You will need to do considerable footwork to get the app to compile... we're working on making it easier.

=Requirements=

OpenHU is a direct continuation of Mike Reid's Android Auto Head Unit app. He built the app using ant from the command line. It was originally built prior to Android Studio.

It is a high priority for us to migrate to a Gradle-and-Studio build structure, embracing Android Studio. We have not even started on that effort.

If you're new to Android, and have built using Android Studio exclusively, that means you'll need to install some tools. Specifically, you'll need to install '''Oracle JDK 7''', '''Eclipse''', the '''Android API v21 (Lollipop) SDK''', the '''Android NDK''', and '''ant'''.

We have successfully built OpenHU, in its current form, on '''Linux''' and '''macOS / OS X'''. We have not built it successfully on Windows, but it may be straightforward to do so.

=Building=

Until we do a round of cleanup, you're best off matching the late Mike Reid's build environment. The configuration for this is inside the build_headunit script.

Theoretically, you should just be able to invoke ./build_headunit and have a successful build.

In practice, you will have to undergo several rebuilds until you can match Mike's environment. Over time, we hope to both make this easier, and provide a reproducible step-by-step.

=Google Play=

Please read the Google Play section at the bottom of [[OpenHU Builds]], for an explanation of why you shouldn't, as a developer, attempt to submit this app to Google Play.

=Discussion=

We've created an [http://forums.console.com.co/forums/openhu.73/ OpenHU project forum] where both users and developers can support one-another. We encourage you to post questions and answer other people's questions there.

OpenHU

2016-06-24T11:56:14Z

AdminTeam: Forum link

OpenHU Builds

2016-06-24T11:55:42Z

AdminTeam: Forum link

'''[http://consoleos.com/ Console OS] > [[Main_Page|Wiki]] > [[OpenHU]] > OpenHU Builds'''

== Downloading Builds of OpenHU ==

OpenHU is very much a work in progress. When we're ready, builds of OpenHU will be pubished here. Until then, you can [https://github.com/iConsole/OpenHU download the source code from GitHub] and [[OpenHU Source Code|build it yourself]]!

'''Important:''' Only you are responsible for how you drive, and for how use this app. This app may contain bugs and glitches. It is offered without warranty. Focus on driving at all times, and don't allow any infotainment device to distract you.

== Installing ==

First, you must enable unsigned sources, which is typically inside the Security tab of the Android Settings app. You may have already done this if you installed certain third-party apps like the Amazon Appstore.

If you are running Lollipop, KitKat, or Jelly Bean, you will need to activate USB Debugging. This should not be necessary on Marshmallow.

Once done, simple sideload the APK to your device and install it, as you would any other APK file obtained from the internet.

For best results, launch OpenHU once, then reboot the device. This loads the proper USB ID associations with the ADB system.

== Requirements & Important Notes ==

OpenHU requires an Android device running Android 4.1 "Jelly Bean" or later. Android 4.4 "KitKat" or higher is strongly recommended. We are only focused on developing for Android 5.1 "Lollipop" and Android 6.0 "Marshmallow", so we encourage you to at least use Android 5.0 tablets with OpenHU.

In terms of hardware, your device must support USB On The Go (OTG) mode, and your build of the Android operating system must support it as well.

Your device also needs to be able to decode H.264, which is an Android compatibility requirement - but some low-end uncertified devices lack.

Currently x86 device support requires Intel's ARM translator "Houdini" - which all production Intel-based Android devices have. Still, this is a high priority to resolve, as it will improve power consumption and performance on x86, and there are no major roadblocks to making the app cross-architecture. While Mike Reid had crafted a fix for this, he passed away before uploading these changes to GitHub.

Finally, the phone or device you wish to connect - must be running the Android Auto app, obtained from Google Play. Unlike the OpenHU app, which is not a Google-endorsed app, the Android Auto client app must be obtained from Google Play - and the phone in question must have Google Play Services installed. In the very, very long term, the OpenHU project may pivot to developing a client-side app, but this is not a priority right now.

=== Android N ===

Currently Android N (Developer Preview) devices cannot run OpenHU. Android N adds additional security layers to ADB networking that will require reworking the app, routing USB networking calls through JNI instead of NDK. This is something we hope to incentivize the developer community to help us do. It may also change as Android N is in an active state of development - so we aren't going to treat this as a priority, until Android N ships.

It's important to note that this does not apply to Android N phones that you wish to run Android Auto from, and connect to a tablet running OpenHU. From our testing, a phone running Android Auto and the Android N Developer Preview, has no issue communicating to a tablet running OpenHU and an earlier version of Android.

We also expect most Android tablet users to be slow to upgrade to Android N. From our experience, most people installing OpenHU are using an older tablet - and even most Android Auto car manufacturers are not even running Android 6.0 today. We've even encountered some first-party cars that are using Google's Android Auto head unit app, atop Android 2.3, Gingerbread (which we do '''not''' support).

== About Submitting / Getting OpenHU from Google Play ==

Google repeatedly removed Mike Reid's submissions of his predecessor app to the Google Play Store, routinely giving extremely vague reasons for removal. This despite Mike Reid's considerable efforts to engage the Google Play support team and issuing multiple fixes, aimed at their vague concerns - including removing all references to Android Auto from the app itself.

As such, we have no immediate plans to submit the app to the Google Play Store, and we discourage you to attempt doing so either.

It is a project goal to resolve any lingering concerns about the app with the Google Play team, but we ask that you aid this process by not flooding Google Play with your own APK builds of OpenHU. It may, in fact, endanger your developer credentials with Google Play to attempt submitting this app to the Google Play Store (''though we are not aware of any Play Store rule that it inherently violates'').

== Getting Support ==

We encourage you to post questions, and help others, in the [http://forums.console.com.co/forums/openhu.73/ OpenHU project forum], located on our own forum server.

OpenHU

2016-06-24T11:40:42Z

AdminTeam:

OpenHU

2016-06-24T11:40:12Z

AdminTeam: Created page with "=OpenHU= OpenHU is an app that enables your Android tablet to function as an Android Auto receiver, in your car. It is an open-source app, originally created by Mike Reid. Si..."

=OpenHU=

OpenHU is an app that enables your Android tablet to function as an Android Auto receiver, in your car. It is an open-source app, originally created by Mike Reid. Since his passing, we've taken over development of the app, and are committed to continuing its development in open-source.

This project is in its very early stages. We need your help to keep it going, as we never planned on taking over development. Without the help of the Android developer community, we can't keep this going ourselves. To that end, we're realigning and rebooting our [[Console Developer Rewards]] initiative, to reward indie developers for their FOSS contributions to OpenHU.

For now, check out the pages below for details and information about OpenHU:

* [[OpenHU Builds]] - Compiled early builds for testing
* [[OpenHU Source Code]] - Getting the code, and build instructions
* [[OpenHU Project Management]] - Goals, objectives, and how to contribute and/or donate
* [[Console Developer Rewards]] - Our incentive plan, initially (re) launching with a focus on the OpenHU Project

OpenHU Source Code

2016-06-24T11:36:38Z

AdminTeam: JDK requirement

OpenHU Source Code

2016-06-24T11:34:31Z

AdminTeam: Clarified SDK and Google Play

'''[http://consoleos.com/ Console OS] > [[Main_Page|Wiki]] > [[OpenHU]] > OpenHU Builds'''

=Compiling OpenHU=

This is a very, very early draft. You will need to do considerable footwork to get the app to compile... we're working on making it easier.

=Requirements=

OpenHU is a direct continuation of Mike Reid's Android Auto Head Unit app. He built the app using ant from the command line. It was originally built prior to Android Studio.

It is a high priority for us to migrate to a Gradle-and-Studio build structure, embracing Android Studio. We have not even started on that effort.

If you're new to Android, and have built using Android Studio exclusively, that means you'll need to install some tools. Specifically, you'll need to install '''Eclipse''', the '''Android API v21 (Lollipop) SDK''', the '''Android NDK''', and '''ant'''.

We have successfully built OpenHU, in its current form, on '''Linux''' and '''macOS / OS X'''. We have not built it successfully on Windows, but it may be straightforward to do so.

=Building=

Until we do a round of cleanup, you're best off matching the late Mike Reid's build environment. The configuration for this is inside the build_headunit script.

Theoretically, you should just be able to invoke ./build_headunit and have a successful build.

In practice, you will have to undergo several rebuilds until you can match Mike's environment. Over time, we hope to both make this easier, and provide a reproducible step-by-step.

=Google Play=

Please read the Google Play section at the bottom of [[OpenHU Builds]], for an explanation of why you shouldn't, as a developer, attempt to submit this app to Google Play.

Main Page

2016-06-24T11:26:59Z

AdminTeam: Nutshell

<div class="col-md-12 cos-main txt">
<div class="col-md-2">
<div class="thumbnail bot">
[[File:Console-Inc-Consolebot-alpha-135x173.png|link=http://consoleos.com|center|middle]]
</div></div>
<div class="col-md-10">
=== Welcome to the Console, Inc Wiki ===

Welcome to the Wiki for Console, Inc! Located here is an information repository for all of our products, both production and experimental.

For additional support for all Console products, the [http://forums.console.com.co/ Console Forums] are open and staffed with Console teammates, as well as the entire community, to get your questions answered as fast as possible.

</div>
== OpenHU Project (New!) ==
The OpenHU Project is our new effort to continue the open-source Android Auto Head Unit application, originally developed by the late Mike Reid.

In a nutshell, the OpenHU app will allow you to take most modern Android tablets, and use them as an Android Auto receiver for your car. It is fully open-source, and we're taking over leadership of the project, in order to keep a great app going.

''This is a new expansion of the Wiki. Pardon the dust while we finish it!''

* [[OpenHU Builds]] - Compiled early builds for testing
* [[OpenHU Source Code]] - Getting the code, and build instructions
* [[OpenHU Project Management]] - Goals, objectives, and how to contribute and/or donate
* [[Console Developer Rewards]] - Our incentive plan, initially (re) launching with a focus on the OpenHU Project

''Necessary Note: This is not a Google application. Google owns all related Android trademarks and intellectual property related to Android Auto.''

== Console OS™ (Experimental) ==

Console OS™ with Android is the first commercial distribution of the Android™ operating system, and is based on the [https://source.android.com/ Android Open Source Project]. Our goal is to make the most powerful, and easy-to-use Android experience possible for the laptop, desktop, PC Tablet, and 2-in-1.

Console OS is free software, both for [https://account.console.com.co/ public download], as well as in [https://github.com/iConsole source code form on GitHub]. We welcome you to check out the extensive resources below to learn more about Console OS with Android!

</div>
<div class="col-md-12 cos-main">
<div class="panel panel-info-white-border">
<div class="panel-heading">
<h2 class="panel-title">Introduction</h2>
</div>
<div class="panel-body">
*[[Getting Started with Console OS]] - Finding out if Console OS is right for you, and where we're headed...
*[[Obtaining Console OS]] - Learn who can get Console OS today and how to get it in the future
*[[FAQ]] - Frequently asked questions
*[[Source Code]]
</div>
</div>
</div>
<div class="col-md-12 cos-main">
<div class="panel panel-info-white-border">
<div class="panel-heading">
<h2 class="panel-title">Hardware</h2>
</div>
<div class="panel-body">
*[[Devices]] - Important Details about Console OS compatibility per-machine
*[[Custom PCs]] - Guidelines for building your own PC that runs Console OS
*[[Unsupported Systems]] - Console OS is currently built to target iconic and popular systems, but it may work for other PCs too
</div>
</div>
</div>
<div class="col-md-12 cos-main">
<div class="panel panel-info-white-border">
<div class="panel-heading">
<h2 class="panel-title">Console OS Lollipop</h2>
</div>
<div class="panel-body">
*[[Release Notes]] - Read me first, before installing
*Also visit the [[Devices]] page for device-specific details, required firmware updates, and other information
*[[Storage Requirements]]
</div>
</div>
</div>
<div class="col-md-12 cos-main">
<div class="panel panel-info-white-border">
<div class="panel-heading">
<h2 class="panel-title">Console OS Open Source Project</h2>
</div>
<div class="panel-body">
*[[Source Code|Source Code Home Page]] - Learn more about Console OS in Open Source, or check the links below:
*[[Build Instructions]] - How to configure a build environment, download the source code, and create your first build
*Contributing - How to commit code and help make Console OS even better
*Console Developer Rewards - Programs where we are incentivizing contribution
</div>
</div>
</div>
<div class="col-md-12 cos-main">
<div class="panel panel-info-white-border">
<div class="panel-heading">
<h2 class="panel-title">Archived</h2>
</div>
<div class="panel-body">
*[[Release Notes DR1 KitKat]]
</div>
</div>
</div>
<div class="col-md-12">
<div class="row">
<div class="col-md-4">
<div class="panel panel-info-white-border">
<div class="panel-heading">
<h3 class="panel-title">Community</h3>
</div>
<div class="panel-body pix">
<div class="thumbnail" style="margin-top: 15px;">[[File:Console-Inc-Console-os-android-for-pc-startup-1085x635.png |link=Community]]</div>
</div>
</div>
</div>
<div class="col-md-4">
<div class="panel panel-info-white-border">
<div class="panel-heading">
<h3 class="panel-title">Video Demos</h3>
</div>
<div class="panel-body pix">
<div class="thumbnail" style="margin-top: 15px;">[[File:Console-Inc-Console-os-android-pc-video-preview-1085x635.png |link=Video Demos]]</div>
</div>
</div>
</div>
<div class="col-md-4">
<div class="panel panel-info-white-border">
<div class="panel-heading">
<h3 class="panel-title">Resources</h3>
</div>
<div class="panel-body pix">
<div class="thumbnail" style="margin-top: 15px;">[[File:Console-Inc-Console-os-android-pc-links-1085x635.png |link=Resources]]</div>
</div>
</div>
</div>
</div>
</div>

<div class="col-md-12 cos-main txt bot">
<div class="col-md-10">
=== Console OS™ with Android™ ===
* Production-grade Android on the Desktop
* Industry-licensed, native Android that can really toggle with Windows on your PC
* Raising Android up to be your primary PC operating system
* Creating a touch-optional Android – and touch-friendly for massive multitouch displays
* Perfect for existing PC tablets and 2-in-1 devices
</div></div>

OpenHU Source Code

2016-06-24T11:25:43Z

AdminTeam:

'''[http://consoleos.com/ Console OS] > [[Main_Page|Wiki]] > [[OpenHU]] > OpenHU Builds'''

=Compiling OpenHU=

This is a very, very early draft. You will need to do considerable footwork to get the app to compile... we're working on making it easier.

=Requirements=

OpenHU is a direct continuation of Mike Reid's Android Auto Head Unit app. He built the app using ant from the command line. It was originally built prior to Android Studio.

It is a high priority for us to migrate to a Gradle-and-Studio build structure, embracing Android Studio. We have not even started on that effort.

If you're new to Android, and have built using Android Studio exclusively, that means you'll need to install some tools. Specifically, you'll need to install '''Eclipse''', the '''Android SDK with Eclipse support''', the '''Android NDK''', and '''ant'''.

We have successfully built OpenHU, in its current form, on '''Linux''' and '''macOS / OS X'''. We have not built it successfully on Windows, but it may be straightforward to do so.

=Building=

Until we do a round of cleanup, you're best off matching the late Mike Reid's build environment. The configuration for this is inside the build_headunit script.

Theoretically, you should just be able to invoke ./build_headunit and have a successful build.

In practice, you will have to undergo several rebuilds until you can match Mike's environment. Over time, we hope to both make this easier, and provide a reproducible step-by-step.

OpenHU Source Code

2016-06-24T11:23:48Z

AdminTeam: Created page

'''[http://consoleos.com/ Console OS] > [[Main_Page|Wiki]] > [[OpenHU]] > OpenHU Builds'''

=Compiling OpenHU=

This is a very, very early draft. You will need to do considerable footwork to get the app to compile.

=Requirements=

OpenHU is a direct continuation of Mike Reid's Android Auto Head Unit app. He built the app using ant from the command line. It was originally built prior to Android Studio.

It is a high priority for us to migrate to a Gradle-and-Studio build structure, embracing Android Studio. We have not even started on that effort.

If you're new to Android, and have built using Android Studio exclusively, that means you'll need to install some tools. Specifically, you'll need to install '''Eclipse''', the '''Android SDK with Eclipse support''', the '''Android NDK''', and '''ant'''.

We have successfully built OpenHU, in its current form, on '''Linux''' and '''macOS / OS X'''. We have not built it successfully on Windows, but it may be straightforward to do so.

=Building=

Until we do a round of cleanup, you're best off matching the late Mike Reid's build environment. The configuration for this is inside the build_headunit script.

Theoretically, you should just be able to invoke ./build_headunit and have a successful build.

In practice, you will have to undergo several rebuilds until you can match Mike's environment. Over time, we hope to both make this easier, and provide a reproducible step-by-step.

OpenHU Builds

2016-06-24T11:16:42Z

AdminTeam:

OpenHU Builds

2016-06-24T11:09:56Z

AdminTeam:

'''[http://consoleos.com/ Console OS] > [[Main_Page|Wiki]] > [[OpenHU]] > OpenHU Builds'''

== Downloading Builds of OpenHU ==

OpenHU is very much a work in progress. When we're ready, builds of OpenHU will be pubished here. Until then, you can [https://github.com/iConsole/OpenHU download the source code from GitHub] and [[OpenHU Source Code|build it yourself]]!

'''Important:''' Only you are responsible for how you drive, and for how use this app. This app may contain bugs and glitches. It is offered without warranty. Focus on driving at all times, and don't allow any infotainment device to distract you.

== Installing ==

You must enable unsigned sources, which is typically inside the Security tab of the Android Settings app. Google repeatedly removed Mike Reid's submissions of his predecessor app to the Google Play Store, routinely giving intentionally vague reasons for removal. As such, we have no immediate plans to submit the app to the Google Play Store, and we discourage you to attempt doing so either.

If you are running Lollipop, KitKat, or Jelly Bean, you will need to activate USB Debugging. This should not be necessary on Marshmallow.

Once done, simple sideload the APK to your device and install it, as you would any other APK file obtained from the internet.

For best results, launch OpenHU once, then reboot the device. This loads the proper USB ID associations with the ADB system.

== Requirements & Important Notes ==

OpenHU requires an Android device running Android 4.1 "Jelly Bean" or later. Android 4.4 "KitKat" or higher is strongly recommended. We are only focused on developing for Android 5.1 "Lollipop" and above, so we encourage you to at least use that version.

Currently Android N (Developer Preview) devices cannot run OpenHU. Android N adds additional security layers to ADB networking that will require reworking the app, routing USB networking calls through JNI instead of NDK. This is something we hope to incentivize the developer community to help us do. It may also change as Android N is in an active state of development - so we aren't going to treat this as a priority, until Android N ships.

* It is important to note that phones running Android Auto as a client app, and the Android N Developer Preview, from our testing can communicate with an OpenHU tablet running Android versions prior to Android N. In other words, if your phone has Android N installed, you should be fine... just don't update the tablet you want to run OpenHU on to Android N Developer Preview. ''Currently the only tablets that this is an issue on, are the Nexus 9 and Google Pixel C.''

It is a project goal to resolve any lingering concerns about the app with the Google Play team, but we ask that you aid this process by not flooding Google Play with your own APK builds of OpenHU. It may, in fact, endanger your developer credentials with Google Play to attempt submitting this app to the Google Play Store (''though we are not aware of any Play Store rule that it inherently violates'').

In terms of hardware, your device must support USB On The Go (OTG) mode, and your build of the Android operating system must support it as well.

Your device also needs to be able to decode H.264, which is an Android compatibility requirement - but some low-end uncertified devices lack.

Currently x86 device support requires Intel's ARM translator "Houdini" - which all production Intel-based Android devices have. Still, this is a high priority to resolve, as it will improve power consumption and performance on x86, and there are no major roadblocks to making the app cross-architecture. While Mike Reid had crafted a fix for this, he passed away before uploading these changes to GitHub.

Finally, the phone or device you wish to connect - must be running the Android Auto app, obtained from Google Play. Unlike the OpenHU app, which is not a Google-endorsed app, the Android Auto client app must be obtained from Google Play - and the phone in question must have Google Play Services installed. In the very, very long term, the OpenHU project may pivot to developing a client-side app, but this is not a priority right now.

OpenHU Builds

2016-06-24T11:03:44Z

AdminTeam: Play Store notes

OpenHU Builds

2016-06-24T11:00:24Z

AdminTeam: Requirements, etc

OpenHU Builds

2016-06-24T10:39:42Z

AdminTeam: Disclaimer before builds

2016-03-24T12:44:09Z

AdminTeam: CHT stick

'''[http://consoleos.com/ Console OS] > [[Main_Page|Wiki]] > Devices'''
----
Console OS is built to target specific, iconic PCs. However, you may find Console OS works just fine on many other PCs too.

Support for specific machines is listed below. You can also check out [[Unsupported Systems]] for tips and guidance on how to better prepare your system to run Console OS with Android™.

'''Just because your PC isn't below, doesn't mean it won't work!''' You can now test Console OS fully, without modifying your machine - using Console OS Express builds. They are available right alongside the regular version of Console OS, at [https://account.console.com.co account.console.com.co] - ''And like Console OS, Console OS Express is free!''

<span class="cos-alert">Also, be sure to read the general [[Release Notes]] as they provide the most current release's late-breaking information.</span>

Systems that are not listed below are not necessarily being ignored - they may not appear because we haven't thoroughly tested or do not have enough confirmations from users to run the device properly. Before installing Console OS, you should check the links below to see if your system needs a BIOS or other firmware update before installing - as well as to see any device-specific release notes for current releases.

=Current Target Systems=
----
Console OS is built per-device (other than our generic/testing build target). As such, you should read the device-specific notes below before installing:

* [[Acer Aspire S7]]
* [[Acer Aspire ES1]]
* [[ASUS Transformer Book T100]]
* [[ASUS Transformer Book T300]]
* [[ASUS X200CA X200MA|ASUS X200CA & X200MA]]
* [[ASUS X205]]
* [[Clevo W740SU]]
* [[Dell XPS 11]]
* [[Dell XPS 12]]
* [[Dell XPS 13]]
* [[Dell XPS 15]]
* [[Dell Venue 8 Pro]]
* [[Dell Venue 11 Pro (Atom)]]
* [[Dell Venue 11 Pro (Core)]]
* [[Dell Venue 11 Pro (Core M)]]
* [[Gigabyte BRIX]]
* [[Gigabyte BRIX s]]
* [[Gigabyte BRIX Pro]]
* [[HP Pavilion x2 (Atom)]]
* [[HP Stream 11]]
* [[HP Stream 13]]
* [[Intel Compute Stick Bay Trail|Intel Compute Stick (Atom "Bay Trail")]]
* [[Intel NUC D34010]]
* [[Intel NUC D54250]]
* [[Intel NUC DC3217]]
* [[Intel NUC DC53427]]
* [[Intel NUC DE3815]]
* [[Intel NUC DN2820]]
* [[Lenovo IdeaPad U430p]]
* [[Lenovo Miix 2 8]]
* [[Lenovo Miix 2 10]]
* [[Lenovo ThinkPad 8]]
* [[Lenovo ThinkPad Twist S230u]]
* [[Lenovo ThinkPad X1 Carbon]]
* [[Lenovo Yoga 2 11]]
* [[Lenovo Yoga 2 13]]
* [[Lenovo Yoga 2 Pro]]
* [[Microsoft Surface Pro]]
* [[Microsoft Surface Pro|Microsoft Surface Pro 2]]
* [[Clevo W740SU|Sager NP2740]]
* [[Sony VAIO Tap 11]]
* [[Sony VAIO Pro 11]]
* [[Sony VAIO Pro 13]]
* [[Clevo W740SU|System 76 Galago UltraPro]]
* [[Toshiba Encore 8]]
* [[Toshiba Encore 10]]
* [[Toshiba Portégé R30]]
* [[Toshiba Portégé Z30]]
* [[Toshiba Satellite L55]]
* [[Toshiba Tecra A50]]
* [[Toshiba Tecra Z40]]
* [[Toshiba Tecra Z50]]
----
=Staging=
----
These are devices that do not yet work with Console OS, but we are working hard to get up and running in upcoming releases.

* [[Intel Compute Stick Cherry Trail|Intel Compute Stick (Atom "Cherry Trail")
* [[HP Stream 7]]
* [[Microsoft Surface 3]]
* [[Microsoft Surface Pro 3]]
* [[Microsoft Surface Pro 4]]

----
=System Boards=
----
Building a machine for Console OS? Individual system boards will be certified for Console OS, in concert with industry partners.

Contact us if you are interested in certifying your system board for Console OS.

Don't see your system board or motherboard? It may work just fine with Console OS! Visit our [[Unsupported Systems]] page to learn more.

* [[Intel NUC D34010|Intel NUC System Board D34010WYB]]
* [[Intel NUC DC53427|Intel NUC System Board D53427RKE]]
* [[Intel NUC D54250|Intel NUC System Board D54250WYB]]
* [[Gigabyte Z77N-WIFI|Gigabyte H77N-WIFI]]
* [[Gigabyte Z87N-WIFI|Gigabyte H87N-WIFI]]
* [[Gigabyte Z77N-WIFI]]
* [[Gigabyte Z87N-WIFI]]
* [[Minnowboard MAX]]
* [[MSI Z87I]]

----
=Accessories=
----
Want to use a device with Console OS? It may or may not work, depending on its Android compatibility. Some PC devices may also need new firmware updates. Devices below have special guidance:

* [[Pantech UML295]] - 4G LTE Aircard

{{FeedbackMessage}}