Warning! Ensure that the main electrical power (EB), UPS, and all other power sources are completely shut down before proceeding.
1. Power-Up Switch Box
Connect either EB or UPS power supply to the terminals labeled:
P (Phase)
N (Neutral)
E (Earth)
While using UPS is optional, it is recommended for uninterrupted power.
2. Switch Terminal Connection
There is no internal link between the power input terminals and the switch outputs. Connect wires from your power source (EB or UPS) to the IN terminal for each switch, and the appliance to the OUT terminal.
This design simulates a traditional switch for easier installation and familiarity.
Wi-Fi and Location Services are enabled on your phone.
Steps to Configure
Enable Wi-Fi Configuration Mode on the switch box using either method:
Option A — Remote control: Press L9, then L3 immediately.
Option B — Touch button: Press and hold the first touch switch for 15 seconds.
The switch box LED will start blinking, indicating Wi-Fi mode is active.
In the GSOFT app: Settings Device Wi-Fi Setup
Enter your Wi-Fi SSID and password (2.4GHz only).
Tap Submit and accept any permission prompts.
On success, a green confirmation message appears. The device will show on the Home screen.
Note: Use 2.4GHz Wi-Fi only. 5GHz networks are not supported by the device.
2
Software Features
Day-to-day usage and customization once your device is online: control switches, set timers and scenes, manage users and roles, voice control, and advanced options.
Automate switches and fan speeds with scheduled timers. Internet is needed only during timer creation or deletion — once set, timers run independently.
Timer Type
Description
Once
Executes once and auto-deletes.
Daily
Triggers every day at the set time.
Weekly
Triggers on selected days of the week. Supports multi-day selection (Weekdays, Weekend, All).
Cyclic
Repeats at a fixed interval (e.g., every 30 minutes). NEW
Monthly
Triggers on specific dates each month.
Yearly
Triggers on specific dates annually.
Create a New Timer
Navigate to: Device Configure Timer Icon
Tap Add Timer.
Choose timer type, set start/end time and ON/OFF state.
Tap Submit.
Delete a Timer
In the timer list, tap the red X icon next to the timer to remove it.
Control multiple switches across different devices with a single tap or automatic triggers. Scenes support per-switch delays for complex automation sequences.
Mode
Description
User Control
Triggered manually by tapping the scene button in the app.
Event Control
Triggered automatically when a switch/fan state changes (e.g., turning on switch 1 triggers a sequence).
Create a Scene
Tap Scene at the bottom of the app.
Tap New Scene.
Set scene name (e.g., "Party Mode", "Evening Mood").
Select scene mode in Enable by.
Configure trigger conditions and action list with optional delays.
Tap Submit.
Scenes require an active internet connection since they are executed by the server.
Mark frequently used switches as favorites for one-tap access without navigating into each device. Great for the few switches you operate dozens of times a day (porch light, master bedroom fan, front gate, etc.).
Add a Switch to Favorites
Navigate to: Home Device Configure Settings Gear on any switch.
Tap the heart icon in the header to add the switch.
A heart-shaped floating action button appears on the home page. Tap it to expand a horizontal wheel of your favorites.
Tap any favorite to toggle that switch from anywhere in the app.
Supports switches from any of your devices in one place.
Each user has their own favorites list — your favorites don't affect other users on the same device.
Add family members, tenants, employees, or guests to control the device without sharing your login credentials. Each user is invited by email and signs in with their own GSOFT account.
Add a User
Navigate to: Device User Tab
Tap Add User.
Enter the new user's registered email address.
Pick a role for the user (see Property Type & User Roles below).
Tap Submit.
Remove a User
In the User list, tap the red X icon next to the user to remove them. Tenants you remove also lose access for any guests they previously added (cascading delete preserves privacy).
The roles available for a device depend on its Property Type (Home / Stay / Hospital / Office). See the next section for the role catalog and what each role can do.
Each device has a Property Type that determines which user roles are available, so the access model fits the actual installation. Set it from Device Setting Property Type.
Roles Available per Property Type
Pick the Property Type that matches your installation, then assign each user one of the roles listed for that type. Each Property Type below is shown as its own card with the roles it supports.
HomeDefaultResidential homes & apartments
Owner
Highest
Holds top authority over the device. Can add or remove any user (including Tenants), assign any role, change Property Type, modify all device settings, configure switches, control all non-Tenant switches by voice. Only one Owner per device.
Privacy boundary with Tenants: The Owner manages Tenant lifecycle (add/remove) but does not see what Tenants are doing — Tenant switches' real-time on/off state, usage history, timers, and scenes are hidden from the Owner. Use the Tenant role when you want to grant a renter or sub-unit occupant true independent control without the Owner peering into their daily activity.
Member
Mid
For trusted family members. Can control all switches, can invite Guests, sees the full activity history of everyone on the device. No restrictions on visibility — use this when family members are comfortable seeing each other's usage.
Tenant
Mid
For renters, sub-units, or independent occupants who pay for their own privacy.
Independent control: Has full control over the switches assigned to them — turn on/off, set timers, create scenes, control by voice. Can add their own Guests. The Tenant's Guests are private (other Tenants and Members can't see them).
Privacy from the Owner: The device Owner can only add or remove the Tenant — the Owner cannot see the Tenant's switch states (on/off), usage history, timers, scenes, or who the Tenant added as Guests. Tenants effectively operate as their own private subtree on a shared device.
Cascade on removal: When the Owner removes a Tenant, every Guest the Tenant added is also removed automatically — preserving the privacy boundary even on exit.
Guest
Lowest
For visitors. Can use switches assigned to them. Cannot add or remove other users, cannot change any device setting, cannot change Property Type.
StayHotels, lodges, Airbnb rentals
Admin
Highest
For the property owner or manager who runs the establishment. Can add or remove any user, assign any role, change Property Type, modify device settings, configure switches, control everything by voice.
Manager
Mid
For front-desk staff or housekeeping leads. Can control switches and add Guests (e.g., check-in a new occupant). Can remove only Guests they themselves added. Cannot modify device settings or change Admin/Manager assignments.
Guest
Lowest
For staying guests (a hotel customer, an Airbnb visitor). Can use the switches in their room. Cannot add or remove users, cannot access settings, cannot see other guests.
HospitalPatient rooms, clinics, wards
Admin
Highest
For the hospital administrator or facility manager. Can add or remove any user, assign any role, change Property Type, modify device settings, configure switches, control everything by voice.
Manager
Mid
For ward in-charge, head nurse, or shift supervisor. Can control switches and add Guests (e.g., assign access to a new patient or attendant). Can remove only Guests they themselves added. Cannot modify device settings.
Guest
Lowest
For patients, attendants, or visitors. Can use the switches in their room (lights, fan, etc.). Cannot add other users, cannot access settings, cannot see other patients.
OfficeOffices, co-working spaces, shops
Admin
Highest
For the business owner or IT/facilities lead. Can add or remove any user, assign any role, change Property Type, modify device settings, configure switches, control everything by voice.
Manager
Mid
For team leads, department heads, or office supervisors. Can control switches and add Users (e.g., onboard a new employee). Can remove only Users they themselves added. Cannot modify device settings.
User
Lowest
For regular employees or co-working members. Can use the switches assigned to them (their workstation, meeting room, etc.). Cannot add other users, cannot access settings.
How to use: Set the Property Type first from Device Setting Property Type. When you then go to User Tab → Add User, the role dropdown will only show roles valid for that Property Type — no need to memorize.
Per-Switch Permissions NEW
Beyond roles, you can grant or restrict access to individual switches per user. This is useful when, for example, a Guest should only be able to control bedroom lights but not the AC. Navigate to Device User User name Permissions and select which switches they can control.
Tip: Changing Property Type after users are added will keep existing user assignments where possible. Roles that don't exist in the new type are mapped to the closest available level.
Control your switches by voice through Amazon Alexa or Google Home. Each device can be individually enabled or disabled for voice control.
Enable Voice Control
Navigate to: Device Setting Tab
Toggle Alexa Support or Google Home Support ON.
Link your GSOFT account in the Alexa/Google Home app.
Discover devices — only enabled devices will appear.
Tip for large installations: Voice assistants treat each switch as a separate device. For 60+ switch boxes, enable voice control only on frequently used devices to avoid hitting Alexa/Google node limits.
Per-Switch Voice Lock
You can lock individual switches from Alexa or Google control (e.g., to prevent children from controlling specific switches by voice). Navigate to the switch's settings gear in Configure page and use Lock Alexa or Lock Google.
Monitor voltage, current, and frequency for single-phase and 3-phase electrical systems. Sensors can be standalone devices or associated with specific switches for per-appliance monitoring.
Model
Sensors
VIF-1PH
1 Voltage + 1 Current + 1 Frequency (Single Phase)
VIF-3PH
3 Voltage + 3 Current + 1 Frequency (Three Phase R/Y/B)
3-phase models also display line-to-line voltage (V_RY, V_YB, V_BR ~400V) and per-phase/total power.
For developers, integrators, or power users who want to control GSOFT devices programmatically (Python scripts, custom dashboards, IFTTT-style automations). The Developer API Token is a long-lived credential tied to your account that authenticates HTTP / WebSocket calls without requiring your password.
Generate Your Token
Open the GSOFT app and tap your profile icon at the top right.
Select Developer API Token.
Enter your account password to verify.
Tap Generate Token. A 32-character hex token is created and displayed.
Copy the token now — it's shown in full only at generation time.
What You Can Do With the Token
Authenticate to the GSOFT API as your user.
Read device state, switch state, sensor values.
Send switch ON/OFF, fan speed, and timer commands programmatically.
Build custom dashboards, home automation bridges, or scripts.
Security Notes
The token grants the same access as your login. Treat it like a password.
If the token is exposed, tap Revoke on the same screen — all integrations using it will stop immediately.
Tapping Generate again replaces (regenerates) the token; the old one stops working.
The app shows when the token was created and last used, so you can audit it.
For Python SDK examples, REST endpoint reference, and message formats, see the developer integration docs (request via Contact Us).
3
Help & Support
Troubleshooting common issues, warranty terms, and how to reach us if you need a hand.