Skip to content

Windows and MacOS Installation Guide

Jump to bottom
Gregory Sastrawidjaya edited this page May 30, 2021 · 13 revisions

Prerequisites

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

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

Optionally, you can choose to run the app in Android Studio if you do not have an Android device. This requires you to have an Android Emulator installed with your Android Studio. Please consult this link for more info.

MQTT

By default, AlSet connects to MQTT localhost. However, you can change these settings by creating a secrets.properties file with the following structure below in client:

MQTT_SERVER_URL="tcp://10.0.2.2:1883"
MQTT_CLIENT_ID="SmartCar-Android"
MQTT_USERNAME="android_user"
MQTT_PASSWORD="android_pass"
LOGIN_TEST_USERNAME="default@email.com"
LOGIN_TEST_PASSWORD="password"

Edit the MQTT_SERVER_URL to your preferred MQTT server.

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 log out and then run AlSet on a device other than the one you forgot to log out on, your AlSet is considered MIA. You will have to send a support ticket to the dev team.

  1. Ensure MQTT is up and running.
  2. Launch AlSet app, log in, 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 the "Running on an Android Virtual Device" steps.

Clone this wiki locally