Sweet Home for Vantage Documentation
website·Indexed 31 days ago
https://docs.sweethomeforvantage.comUser guides and technical documentation for Sweet Home for Vantage, a tool for managing, controlling, and monitoring Vantage Infinity systems. Includes instructions for building touchscreen interfaces via Design Center, configuring Sweet Home Cloud licenses, managing operator mode, and utilizing advanced features like Text To Speech, URL schemes, and Web Widgets.
What's inside Sweet Home for Vantage
- Sweet Home for Vantage is a management, control, and monitoring application for Vantage Infusion automation systems, compatible with iOS, tvOS, and Android devices. It is specifically intended for Vantage installers. All graphics and programming interfaces must be created using the Infusion Design Center.
Requirements for Sweet Home Portrait Mode graphics
Portrait-mode graphics are supported on the Sweet Home application for iOS version 5.5.9 or later. This feature is not available on Android.Create a touchscreen interface in Vantage Design Center
To build an interface for Sweet Home for Vantage, use the Vantage Design Center software. Add a Generic TPT touchscreen to start designing.
Caveat: If your design requires the
Set LCD Pageprocedure, you must use a TPT 1210 touchscreen inherited from Design Center 3.2 instead of the Generic TPT. Existing touchscreens can be converted into TPT touch devices.Upgrade a Sweet Home license
You can upgrade your license type by clicking the upgrade button on the Licences Page to view available options and pricing. This process is specifically used to make Sweet Home 4.X licenses compatible with Sweet Home 5.X.Package and Export Portrait Graphics ZIP file
After exporting the graphics from the designer, the files must be organized into a specific ZIP structure before being imported into the app. The ZIP must contain a top-level folder namedportraitcontaining the images and the configuration file.zipname.zip └── portrait ├── Images/ └── LcdConfig.xmlOpen external applications from Sweet Home
External applications can be launched from Sweet Home by configuring a Touchscreen button to call a specificURL Schemesupported by the target mobile application.Activate a license ticket in Sweet Home Operator Mode
To activate a license ticket on a device, ensure the device has an active internet connection and provide the following details in the Ticket Activation screen:
- Ticket Code: The unique code for the license you wish to activate.
- Email Address: The email address associated with your username on www.sweethomeforvantage.com.
After entering the details, click Activate License. A confirmation message will appear upon successful registration and activation.
Constraint: Each ticket can only be associated with one single device.
Create a task to send a push notification
To trigger a notification, create a new Vantage task using the following configuration:
- Procedure: Select the
Sendprocedure. - SMS Device: Select the
SH5 Send Notificationdriver instance. - Phone Number: Instead of a number, enter one of the following priority keywords:
info,warning, oralarm. - Message: Enter the text content of the notification.
To verify the setup, connect to the Vantage Infusion controller, program the changes, and use the "Test" button on the created Task.
- Procedure: Select the
Import graphics into the Sweet Home mobile app
There are three methods to import the graphics ZIP file into the app. In all methods, navigate to the
Systemssettings page and select the target system.- Sweet Home Cloud: Upload the ZIP to the system page on the Sweet Home website (via the Licenses page cloud icon). In the app, tap
DOWNLOAD GRAPHICS. (Requires license activation first). - Local File Manager: Store the ZIP in the device's file manager (e.g., the
Filesapp on iOS). In the app, tapSELECT GRAPHICSand choose the file. - iTunes (Legacy): Rename the ZIP file to
system1.zip,system2.zip, etc., based on the system index. Import via iTunes, then restart the app.
- Sweet Home Cloud: Upload the ZIP to the system page on the Sweet Home website (via the Licenses page cloud icon). In the app, tap
Import custom fonts into Sweet Home 5.x
To add custom fonts to your graphics for use in the Sweet Home mobile app (iOS and Android), you must include aFontsdirectory in your graphics zip package. Only.ttffiles are supported. TheFontsdirectory must be at the same level as theImagesdirectory and theLcdConfig.xmlfile.zipname.zip ├── Fonts/ ├───── Angelina.ttf ├───── AngelinaBold.ttf ├── Images/ └── LcdConfig.xmlDesign Portrait Graphics using Touchscreen Designer
To create portrait-mode graphics, use a Generic TPT object with a specific resolution and the portrait background frame as a visual guide:
- Add a
Generic TPTobject to the Design Center project from theVantage Objectstab. - Set the resolution of the Generic TPT object to
1920x1280. - In the
Touchscreen Designer, select the19.5:9 frame background(imported during the background setup step) to use as a reference for the design.
- Add a
Activate the Sweet Home license
Activate the license on the app's Ticket Activation page. You will need the purchased license ticket and the user email associated with the Sweet Home site account. Successful activation is indicated by a green bottom banner and a confirmation popup.