Application Configuration Category
Table of Contents
-
Contents of Application Configuration
Application Configuration
How to configure the Activa application.
Activa Direct Wash Arming
Use Activa Direct arming to control the car wash through a direct wired connection to the Activa's I/O terminals.
To Select Activa Direct:
Log into the Activa using the technician login. (The owner login does not have access to modify this.)
Touch the System Setups button.
Touch the Carwash Options button.
Touch the Arming tab.
Select Activa Direct as the Arming Option. This reveals four new settings to tune Activa Direct to your specific car wash interface.
Out-Of-Service when
The Out-Of-Service when setting defines what kind of signal from the car wash indicates that it is out of service. The choices are:
-
Controller Power Off
The Controller Power signal is also called “Control Power Input”, “fault”, or “trouble” by various car washes. Select this option if the absence of this signal from the car wash indicates that it is out of service. (This is the recommended setting.)
-
Controller Power On
As with above, but in this case an active signal from the car wash indicates that it is out of service. This is often called a “fault” signal from the car wash.
-
Busy Signal Blink
Some car washes don't have a separate fault signal, but instead generate a pattern on the wash busy (or in-use) signal of off, on, off, and stay-on in one second transitions. The signal then remains on until the fault condition clears.
- Busy Signal Blink or Power Off
Combination option. The busy signal blink indicates a fault, while a signal must be received on the Controller Power input to indicate that the car wash is turned on.
Out-Of-Service delay seconds
This is the number of seconds that the Out-Of-Service condition must remain in effect before it takes effect. Some car washes have their Controller Power or fault signal twitch a bit at the beginning or end of a wash. This delay allows for this without indicating that the wash is off line every time.
The recommended value is 10 seconds.
Time in hold Arming Signal (or until wash becomes busy)
Different car washes require that the arming signal be held for different periods of time. The two most common requirements by car washes are a two seconds pulse and “until the car enters the bay” (at which point, it becomes busy). Additionally, a timeout is required should the car never enter the bay.
For a two second pulse, set this to 2.
To hold the signal until the car enters the bay, set this to 900 which is 15 minutes. (You can reach 900 either by pressing the up arrow for a while, or pressing down from 1.) The arming signal will thus be dropped after the car enters the bay or after a 15 minute timeout.
Many other possible values between 1 and 900 are available. The default is 2.
Time to wait for wash to begin
If the car wash does not begin (wash becomes busy) for this long, the Activa will stop waiting for the customer to enter the wash and go back to idle. The customer may loose the wash at this point. If the car wash has a timeout limiting how long it will wait after being armed, set this value to match.
Setting Arming Outputs
Selecting which outputs are activated when a wash package or additional service is armed is very much like any other arming system. When editing a package or additional service, the Wash Options tab displays the list of eight available Activa Direct outputs. (The last two are intended for use by the Additional Services, but that is not required.)
Presently, Output 1 must be included in every wash package if wash codes from the Site Controller are being used. Nothing needs to be wired to this output.
A typical car wash simply sets Output 1 and Output 2 to arm wash package #1 (with Output 2 being wired to the car wash), Output 1 and Output 3 to arm wash package #2 (with Output 3 wired to the car wash), and so on. However, any combination of outputs may be used for a single package.
Setting Arming on the Site Controller
The interface on the Site Controller is currently incomplete. It will always show the car wash as being Offline. Additionally, when setting the Wash Key Net Arming, it will show the Ryko names for the arming outputs. Simply ignore these names and all outputs above number 8, and numerically select the same arming outputs as on the Activa.
Activa Direct Wiring Terminals
The “Wash Option” arming outputs and other signals correspond to terminals on the inside back wall of the Activa as shown in the following table:
-
Output to car wash
|
Terminal
|
Arming Output 1
|
711
|
Arming Output 2
|
712
|
Arming Output 3
|
713
|
Arming Output 4
|
714
|
Arming Output 5
|
715
|
Arming Output 6
|
716
|
Arming Output 7 / Option 1
|
717
|
Arming Output 8 / Option 2
|
718
|
Arming Output Common wire
|
719
|
Input from car wash
|
Terminal
|
Busy or Wash-in-Use Input
|
720
|
Control Power or Fault Input
|
721
|
Input Common wire
|
722
|
Intelio Technologies
How to setup RykoNet over IP
Introduction
The Activa Virtual Attendant and Site Controller communicate with each other over over a protocol known as RykoNet. This software protocol can be physically transmitted Echelon or Ethernet (IP). At a site running a Ryko car wash, Echelon is typically used because that is the only connection possible with the Ryko car washes. (A mixed environment is possible, but unusual.)
For site with car washes from all other manufacturers, RykoNet over IP is the physical transmission method of choice.
Choose the RykoNet Server Computer
One of the computers, either the Virtual Attendant or the Site Controller, must be select to be the server computer. This choice is not trivial, as the server computer becomes a single point of failure for RykoNet. That is, if that one computer is offline, then no other device using it as the server can communicate via RykoNet. Use the following decision table to make a choice.
Scenario
|
Server Computer |
Does the site have just one Virtual Attendant and one Site Controller using RykoNet? |
Site Controller |
Does the site have a Ryko car wash, and you need to use RykoNet over IP? |
Virtual Attendant |
Does the site use the Intelio gate system? |
Site Controller |
Does the site have multiple car wash bays? |
Site Controller |
Set Static IP on the server
The server computer must be assigned a static IP address on the LAN.
Selecting a Static IP
- If the site's network is actively managed by the operator, then request an IP address to use.
- Check the router's DHCP settings. Choose an IP in the same subnet but outside of the range used by DHCP.
- Do not assign the computer to statically use the IP that it was given dynamically! The router could give that IP to another device, resulting in a conflict.
- Ping the IP that you plan to use, to ensure that nothing is already there.
Setting a Static IP on Windows XP
Ao the selected server computer:
- Bring up the Control Panel.
- Double click on Network Connections.
- Scroll the window sideways and identify the connection with a Device Name of RealTec.
- Right-click on the connection and select Properties.
- Scroll down on the item list to Internet Protocol (TCP/IP), and double-click on it.
- Click on the bubble to the left of Use the following IP address.
- Fill in the IP address (which you choose), Subnet mask (usually 255.255.255.0), and Default gateway (the nearest router).
- Fill in the Preferred DNS server. Use the router address again if you don't know of any other.
- Click on the OK button. (If you are running this remotely, you will be disconnect and need to VNC back in after some delay.)
- Click on the next OK button.
Configure the non-server device
If you selected the Site Controller as the server computer, then the Activa must now be configured to use it as the server. See the next section.
Otherwise, the section after the next describes how to configure the Site Controller to use the Virtual Attendant as the server.
Configure the Activa Virtual Attendant to use the Site Controller as the server
- Log in to the Activa maintenance mode.
- Go to the RykoNet tab by:
- Touch the System Setups button.
- Touch the Software Setups button.
- Touch the RykoNet tab.
- Use a keyboard (real or on screen by pressing the ABC button) to change the Connect To field to the static IP of the Site Controller.
- Touch the Accept button.
- Touch the Close buttons until the system returns to the idle screen.
Configure the Site Controller to use the Virtual Attendant as the server
Configuring the Site Controller requires changes in three places, including editing files on the file system. It is not for the non-technical.
- From the main application screen, touch the Setup Menu button.
- If the Setup Menu button is grayed out, you will need to Login first.
- Touch the RykoNet button.
- Touch the Setup tab.
- Use a keyboard (real or on screen by pressing the ABC button) to change the Connection field to the static IP of the Virtual Attendant.
- Touch the Accept button.
- Hold down the Windows key (it looks like a four-sectioned waving flag), press the e key, and then release the Windows key.
- Windows Explorer should appear, showing My Computer.
- Stop the EPI Server and WashTrax:
- In the notification area on the bottom right of the screen, next to the clock, are small icons of programs running.
- EPI Server looks like a red notebook with a hand holding a pen.
- Right click on the EPI Server icon and click on Exit.
- WashTrax looks like a blue-handled magnifying glass over two tire tracks.
- Right click on the WashTrax icon and click on Exit.
- Use the tree view on the left pane to navigate to C:\Program Files\Ryko\EPI Server\Setups
- Right click on the EPIServerSettingns.xml file, and click on Edit.
- Find the part that says <RykoNetHost>localhost</RykoNetHost> and change the localhost part to the static IP of the Virtual Attendant.
- Save the file and exit Notepad.
- Use the tree view on the left pane to navigate to C:\Program Files\Ryko\WashTrax
- Double-click on the WashTrax.ini file.
- On the ninth line it says Host=localhost . Change the localhost part to the static IP of the Virtual Attendant.
- Save the file and exit Notepad.
- Close the Windows Explorer window.
- You should be returned to the Setup Menu.
- Touch the red Exit button.
- On the next screen, touch the green Start button.
Adam Fanello
How to change activa video to "no pump" version
This has been completed.
I had the tech block off the lanes VNC'ed into the tellers.
Next, exited out of the Activa app, and went to internet explorer.
In internet explorer, go to https://systems.intelio.com/tools/Activa/video/.
There are 3 videos in this folder (3a.1, 3d.1, and 3g). Right-click on each video and select "save target as".
Be sure the video files are being placed into C:>Program Files>Ryko>Activa>MPEG2>English
Change the "Save as Type:" to "All Files" by using the down arrow to the right.
Be sure that the file extension is ".mpg", not ".mpeg".
Save the files.
Once all three files are saved, the new video must be renamed to be used.
Go into windows explorer and go to C:>Program Files>Ryko>Activa>MPEG2>English
If the site owner is onsite, play the new videos for them by double clicking on each of the new videos to see which one is preferred.
The current Video used is named "3b IN02 clip.mpg", rename it "3b IN02 clip_DISABLED.mpg".
Rename the desired Video "3x.x IN02 clip_IN_USE.mpg" and make a copy of it once renamed.
Rename the copy from "Copy of 3x.x IN02 clip_IN_USE.mpg" to "3b IN02 clip.mpg"
There are 2 ways to make the new video take effect;
Reboot the machine or open windows explorer, go to B:(ramdisk) and delete "3b IN02 clip.mpg". Then restart the Activa Application. When the app starts, it will copy the new video file to ramdisk and play it from there.
This site used video "3g IN02 clip.mpg". It was changed on both tellers.
How to adjust Activa display brightness and contrast
- Exit the application, to the O/S.
- Right click on the Intel Extreme Graphics icon on the task bar. (Blue trapezoid on the far right.)
- Click on Graphics Properties.
- Click on the Color Correction tab.
- Adjust the settings as desired, clicking the Apply button to see the result.
- Click OK when done.
Adam Fanello
Activa Operations Manual
Download the manual below. You need Adobe Acrobat Reader to view it.
Use $1 Coins
To use $1 coins in the Activa coin dispenser, rather than quarters, you must change settings in two different places.
On the Activa,
- Login to Maintenance mode.
- Touch the System Setups button.
- Touch the Hardware Setups button.
- Touch the Coin Dispenser tab.
- Enter 1.00 in the Coin Value field.
- Touch Accept.
In the Code-a-Wash application on the Site Controller:
- Login to the Code-a-Wash application.
- Touch the Setup Menu button.
- Touch the Coinbox button.
- Touch the Currency tab.
- Set Change Value to 1.00.
Adam Fanello
Set Escrow Video
The Escrow Video plays on the Activa screen after a customer has made a purchase and is waiting for a busy car wash to become available.
Supported video files have one of the extensions: MPEG, AVI, WMV, or MOV. (AVI and WMV are video containers, not codecs. Not all possible codecs are supported.)
Steps:
- Log into your Activa and touch System Setups followed by Exit to Boot App.
- Touch Exit to OS.
- Copy the video files(s) from a flash drive or web site to C:\Program Files\Ryko\Activa\MPEG2\English\
- Close all windows and double-tap CbxBoot on the desktop.
- Log into your Activa and touch System Setups followed by Software Setups.
- Touch the Escrow Video tab.
- Touch the Play Video button as needed so that it reads ENABLED.
- If you want the video to play repeatedly until the car wash is ready, touch the Loop Video button as needed so that it reads ENABLED. Otherwise touch it as needed so that it reads DISABLED.
- Select your video file from the list on the right.
- Touch the Accept button.
- Touch the Close button.
- Touch the Close button.
Remember, the escrow video will only play if the customer has completed a purchase but another customer is in the car wash. It will not play if the car wash is not busy when a purchase is completed.
Adam Fanello
Set Escrow Video - ssh method
The Escrow Video plays on the Activa screen after a customer has made a purchase and is waiting for a busy car wash to become available.
Supported video files have one of the extensions: MPEG, AVI, WMV, or MOV. (AVI and WMV are video containers, not codecs. Not all possible codecs are supported.)
Intelio tech support can setup this video remotely and without interrupting operations by using the SSH command-line.
Steps:
- Rename your local copy of the video files to something no more than roughly 25 characters in length.
- scp the video files(s) to the teller.
- ssh into the teller.
- mv the video file(s) to /cygdrive/c/Program\ Files/Ryko/Activa/MPEG2/English/
- Copy and paste the following command-line, replacing filename.wmv with the actual video file name to use:
- osql -U sa -P rykosa -d Coinbox -Q "UPDATE TAB_Setups SET EscrowVideoName='filename.wmv',PlayVideoInEscrow=1 "
- If you want the video to play repeatedly until the car wash is ready, copy and paste the following command-line:
- osql -U sa -P rykosa -d Coinbox -Q "UPDATE TAB_Setups SET LoopEscrowVideo=1"
- If you want the video to play only once while waiting for the car wash, copy and paste the following command-line:
- osql -U sa -P rykosa -d Coinbox -Q "UPDATE TAB_Setups SET LoopEscrowVideo=0"
Remember, the escrow video will only play if the customer has completed a purchase but another customer is in the car wash. It will not play if the car wash is not busy when a purchase is completed.
Adam Fanello
How to setup Activa Frequency Code
Introduction:
The Activa has Marketing feature called "Frequency Code" that can generate (issue) a new code to a WashMax Marketing Flex Program and print it on a paper receipt. This is typically used to offer a discount to customers who return within a certain number of days for another wash. Because it leverages the power of WashMax Marketing though, there are other possibilities.
Only Activas can issue codes, but the resulting code may be redeemed at any car wash with WashMax Market.
Program Creation:
The first step is to login to WashMax, click on Marketing and the Flex Programs. Create a Tracking or Prepaid Wash program as you normally would, or select an existing one. Do not create any keys, these will be generated from the Activa. (There's no harm if using an existing program that already has keys though.)
Examples of what you can do:
- Offer a one-time use discount to customers who return soon.
- Setup a Tracking program with a discount on one or more wash packages.
- Set the Total Use limit to 1. (Or more!)
- Provide a loyalty code.
- Setup a Tracking program that offers a free wash after x purchases with the code.
- Set the Total Use limit to x + 1, so that the code only works for one free wash in the end.
- Provide a donation to a charity when customers return soon.
- Setup a Tracking program with a donation on one or more wash packages.
- Set the Total Use limit as desired.
- Buy one, get one free.
- Setup a Prepaid Wash program with a single wash package designated.
- Set the Total Use limit to 1.
Do not set an expiration date on the program. The Activa will set individual expiration dates on each key it generates.
Here's an screen shot of an existing program that donates a portion of purchase to the Red Cross. This picture will be referenced later.
Configure the Activa(s):
Each Activa that is to issue codes must be configured. Login to the Activa and select System Setups, and then Marketing Setup. Click the DISABLED button to toggle it to ENABLED.
When you set up your WashMax Marketing program, there is a Program ID displayed in the top-right of the window. (See the screen shot above.) Touch the 123... button next to the Marketing Program ID, and enter the number.
The display will look something like below:
The other options are:
- Minimum Purchase
- Codes will only be issued to customers who purchase a wash with cash, credit, WashMax Value card, or a wash code whose value is at least this amount.
- Set it to at least $1.00 to prevent issuing codes to customers who are receiving a free wash. (This includes those redeeming other Marketing programs.)
- Set it higher to only issue a code to customers who choose higher value washes.
- Days until code Expires
- Every code issued with the Frequency Code feature is assigned an expiration date this many days beyond the current day.
- The code is good until the end of the expiration date. This date will be printed on the code receipt.
- Use the up/down arrows to select any number between 1 and 93.
- Odds of Receiving
- Set this to 100% to issue the code to all qualifying customers.
- Lower the odds to randomly issue the code.
- An example is to set this to 20% and pair it with a Prepaid Wash program to run a "One out of five gets a free Works wash!" promotion.
- Code Length
- The code issued may be between 4 and 8 digits long.
- Shorter codes are easier for customers to enter, but if you issue many codes and/or they have long expiration periods, it can become easy to randomly enter short codes and find a valid one.
Any of these settings may be changed, and existing codes will continue to function. Changing the Flex Program on WashMax however will change the behavior of existing codes.
Touch the ENABLED button to toggle it to DISABLED any time to stop issuing codes. Alrady issued codes will continue to function.
Code Issuance:
The Activa will issue a code after printing a purchase receipt (if one is to be printed) and before arming the car wash. The Marketing Code receipt is separate from any purchase receipt. The customer must qualify for the code under the conditions mentioned earlier. The Activa must also have an active network connection to the central WashMax Server, as codes are fetched from the server in real time.
Once issued, there is a short delay before the code may be redeemed. It will be available at all sites with active network connections within an hour. Since the purpose of Frequency Codes is to drive repeat business, this delay helps to ensure that the code is used on a later date.
Code Redemption:
Once issued, the code works just like any other WashMax Marketing code. The customer simply enters the code followed by a star, exactly as shown on the receipt, before making their purchase.
Customers may redeem the code at any of your wash sites that the Flex Program is configured to function at. Note however that 8-digit codes cannot be entered at Unitec Wash Select II tellers; this is a limitation of the teller.
Program Maintenance:
As codes are issued and used or expired, they continue to exist in the Flex Program's database of keys on WashMax. This allows for Flex Program Reports to be run. However, if thousands of old codes accumulate, it can impact performance of your marketing programs because codes cannot be reissued so long as they exist in any program. For long running programs, it's beneficial to log into WashMax monthly and click the Delete Expired button on the bottom of the Keys page. (See first screen shot above.) Upon ending any promotion, use the Delete Expired button to free up the codes.
Adam Fanello