FAQ
ARUnchained GPS Injector
The ARUnchained GPS Injector app has two parts inside. One is the GPS service and one is the UI activity.
The service is the part that injects the GPS data into mock locations. ARU 0.14 and up will start this service automatically when a bluetooth connection is made to the HU (at the same moment that the rotation locker is started). The GPS service is stopped when bluetooth is disconnected.
The UI activity is started when you start the ARUnchained GPS Injector app from the launcher. It shows the status of the GPS service and also the actual GPS data. The purpose is to be able to check whether the service is working properly. With the start / stop buttons the GPS service can manually be started / stopped.
For the GPS service to work Mock locations has to be enabled. To use the phone built in GPS, Mock locations has to be disabled. It can become tedious to set this manually so ARUnchained GPS Injector has an auto on/off Mock locations feature. In order for this to work ARUnchained GPS Injector has to be converted into a system app.
This involves moving "mars.area51.arunchainedgps.apk" from "/data/app" to "/system/app". This can be done with root explorer for instance. Set permission to rw-r--r-- and reboot your phone. On Android 4.4 (KitKat) you should move the apk to "/system/priv-app" folder instead.
For
pre-KitKat Android versions converting to system app can be done using Titanium backup:
Open Titanium Backup
Search for ARUnchained GPS Injector
Long press and choose convert to system app
Reboot phone.
Converting to system app using free ES File Explorer
1. Make sure in ES File Explorer, Root Explorer is enabled and Mount R/W is on RW
2. Copy pkg.apk in /mnt/asec/mars.area51.arunchainedgps-1 to SDCard and rename it 'mars.area51.arunchainedgps-1.apk'
3. Install 'mars.area51.arunchainedgps-1.apk' from SDCard
4. Move 'mars.area51.arunchainedgps-1.apk' from 'data/app' to /system/app or /system/priv-app on 4.4.x
5. In /system/app or /system/priv-app select 'mars.area51.arunchainedgps-1.apk' and in menu select Install.
6. After install reboot
How to make a logcat using an app called Catlog
Start Catlog logcat through app menu and select record.
Select home button so you leave Catlog app running.
Go through process to start ARU and connect to AR.
Once you know the bug was created, open the Catlog app from notification bar (this stops recording).
Select the recording, which is named by date-timestamp...from action selection pick share by email...this zips the logcat and system info txt files into one zip.
Email to self and share the zip with dev by email or any other method you want.
On my Samsung phone not the whole screen is shown but a part is cut off
A) The default Samsung launcher doesn't handle landscape well. The solution is to install an alternative like Nova launcher.
On my Samsung phone touch stops working after calibration
A) Verify your phone is rooted properly.
B) On Android version 4.3 and higher Samsung has Knox security and SELinux is in enforcing mode.
This somehow prohibits accessing the /dev/uinput device which is required to be able to input touch/key events on system level.
In order for ARU to work Knox has to be disbled and SELinux has to be in permissive mode.
Possible fix 1:
First install an app called Android Terminal Emulator then open a terminal and type
the following lines pressing enter after each line:
su
pm disable com.sec.knox.seandroid
Now wait a bit till knox is killed and finally type:
setenforce 0
If this works, you have to do it every time you reboot your phone. It can be automated with Tasker for instance
Possible Fix 2:
Install the Xposed framework and the Wanam module.
At Security hacks tick " Disable Knox notifications" and "Disable SEandroid".
Reboot.
Possible Fix 3:
If the other fixes don't work and your bootloader isn't locked you can try to install a custom kernel that has Knox disabled and SELinux in permissive mode by default.
Keyboard use
It's not necessary to install Car Keyboard. Only the original Pioneer AppRadio app needs that.
Note that the virtual keyboard created by ARU is sometimes incorrectly detected as a hardware keyboard.
This prevents the software keyboard to be shown and makes it impossible to enter anything.
To check / set the keyboard settings:
- Click the menu button on ARU.
- At the right bottom click on "Change input method"
- A pop-up is shown that CarKeyBoard has to be installed. Ignore it by clicking OK.
- The dialog for selecting the input method is shown.
- Make sure hardware keyboard is switched off.
Use of the hardware buttons:
The home, menu and back button now work as advertised.
To go back to the native interface you have to open the AppRadio app manually and then press the home button.
To go to the AppRadio app easily, swipe down the status bar and click the AppRadio notification.
Fast option to go back to the native interface: Double click the home button, touch the blue bar in the middle with 4 squares on the left.
Release notes pre-beta release 2
Multitouch implemented.
Multitouch works now. AppRadio 3 has a bug which makes it a bit unpredictable.
Hardware keyboard issue fixed.
Sometimes the virtual keyboard created by ARU was incorrectly detected as a
hardware keyboard preventing the software keyboard to be shown. Fixed now.
Options menu available.
The options menu can be reached from the app's main screen. There's now an additional ARU
option sub menu available with two options:
Rotation locker.
Invert XY coordinates.
When in AppRadio Mode homescreen, select menu button, select ARU, there you will see the ARU feature options...only accessible when connected to HU at this time.
Options can be set but
will only become active after force stopping the app and then restarting it.
Go to Settings->Apps->AppRadio Unchained and do a Force stop. After that just start ARU again
and the options will take effect.
Rotation locker.
Forces rotation to be in landscape when enabled.
Locker becomes active when a bluetooth connection is established with the radio.
Locker is deactivated when bluetooth is disconnected.
Invert XY-coordinates.
Necessary for some tablets and HDMI sticks.
Currently this options doesn't work well. Somehow it will switch mode during calibration, giving
incorrect calibration results. After that touches are at the wrong position meaning app is useless.
Will look into it soon.
Release notes pre-beta release 3
Steering wheel controls
Steering wheel controls are working now.
Currently supported are: previous track and next track.
There might be more but I couldn't get it out of my radio.
Of course there's volume, mute etc. but that is handled directly by the radio
and never sent to the phone.
In case there are commands sent by the radio to the phone besides the ones already implemented the logcat will contain this:
Don't know how to translate RemoteCtrlInfo = <number>. Let me know the number and what remote control command you were
issuing and I can add it.
