Guide to fix errors in the Android and iPhone

Here, you'll find some guidance to fix errors and configure Switch King's Android and iPhone apps.

This is covered:

  • Software version
  • Switch King's demo environment
  • Port Forwardning
  • Settings in Switch King's Windows client
Please note that if you are using Android, it is necessary to configure the Switch King Application (server, port, username and password) before you can use widgets in your Android client.

Software version

Switch King's Android client requires the following software:

  • An Android client with at least v1.6 of the Android OS
  • Switch King v0.7.2 or later

Switch King's iPhone app requires the following software:

  • An iPhone, iPod Touch or iPad at least v3.2 of iOS
  • Switch King v0.9 or later

Switch King's demo environment

Switch King has a demo environment for Android and iPhone. You connect to the environment by setting the following parameters:

Adress: www.switchking.se
Port: 10800
User: user
Password: pass

Please note that this is a demo environment that all users have access to. The environment can change during the day due to that someone else makes configuration changes at the same time that you are logged in.

The demo environment is reset nightly.

Guide

1. Connect to the demo environment

If you have installed Switch King's app in your iOS device or Android device, start with connecting to the demo environment (described above). You should see devices, upcoming events and a data source.

If you can connect to the demo environment from your phone, the problem is probably on your side - on your server or in your router.

2. Confirm username and password

Confirm the username and password in Switch King's Windows client. Settings are found under Tools - Options - Server.

3. Connect with your browser

Use your browser and try to connect to two addresses - your public IP and your local IP.
In the examples below, change "your_local_ip" to the address your computer has in your LAN and "your_public_ip" to your public IP-address.

Addresses that are available are:

http://your_local_ip:8800/devices

and

http://your_public_ip:8800/devices

If the connection is working, you should get a list with your devices.

The same functionality is available through the demo environment:

http://www.switchking.se:10800/devices

use "user" and "pass" as username and password.

Due to a bug in the Microsoft .NET Framework you need to fully close your browser and reopen it if you enter the wrong username or password. If you enter the wrong username or password, you'll see a blank page.

4. Port forwarding

Confirm that both your router (if you have any) and your local firewall (on the computer) allows traffic on port 8800.

If you user port forwarding the port in the router must be the same port as the port that Switch King's REST services are using. It is not possible to configure the router to pass traffic from, for example, port 8900 to the internal port 8800.
It is possible to change the port of the Switch King REST service and use the same port in the router. The port used by default is 8800.

5. Hidden devices

In Switch King, it's possible to configure which devices that should be exposed to other clients (for example Android and iPhone). Make sure that your devices are configured to be visible in other clients. You can configure this for each device under the advanced settings for each device.

The Android client also contains settings to limit which devices that are shown. This is option is found in the menu option named "Visibility" (or similar).

6. Error messages in the Android and iPhone app

6.1 Connect to X timed out (1)

The port to Switch King's server is not configured correct or is closed. Another reason may be that Switch King's services aren't started.

6.1 Could not get data. Check username and password or server version

Username or password may be wrong. The message may also show if port forwarding isn't configured correct (see above).