Windows and MacOS Installation Guide

Prerequisites

To be able to run the app, you'll need a combination of:

• Android Studio
• SMCE-gd
• MQTT (we suggest Eclipse Mosquitto)

Download and install all of these first by clicking on their respective links.

MQTT

By default, AlSet connects to MQTT localhost. However, you can change these settings by creating a secrets.hpp file with the following structure below in arduino/smartcar.

const auto MQTT_HOST = "host"; const auto MQTT_PORT = 1883;

Edit the MQTT_HOST and MQTT_PORT to your preferred MQTT host and port.

Installing the app itself

1. Clone or download the master-branch onto your computer.
2. Launch Android Studio and point it to where you have saved your project
3. Go to Build and click Build APK.
4. Locate the file and transfer it to your Android device.
5. Install the APK.
6. Done!

Running the app itself

IMPORTANT NOTE: AlSet does not support more than one active user session. If you forget to logout and you run AlSet on a device other than the one you forgot to log out on, your AlSet is considered MIA and you will have to send a support ticket to the dev team.

1. Ensure MQTT is up and running
2. Launch AlSet app, login and change settings as needed, then go to the drive screen.
3. Launch SMCE-gd and compile the sketch in arduino/smartcar. Click "Start".
4. In the AlSet app, set the car to Drive Mode (D).
5. Enjoy!

Using voice functionality on an Android Virtual Device

1. Launch your AVD
2. Go to Extended controls
3. Select Microphone
4. Toggle the option "Virtual microphone uses host audio input"
5. Recompile the application without closing the virtual device.
6. You should now hear a sound when you press the microphone-button from the drive-screen.

Any problems can usually be solved by doing the following steps: Go to AVD Manager and select "Wipe Data" on your AVD. Follow "Running on an Android Virtual Device" steps.