Just finished up development for the RA Client Suite 2.1. The big thing in this version is Relay Expansion box support, though there are a bunch of other features added and bug fixes.
Important:
The installer has been significantly modified. Previously, I was attempting to update some configuration and database files from the installer itself. This caused a number of issues right away, and also made future upgrades difficult. To rectify this, the installer will now come in two parts. A normal Client Suite MSI Installer like we're all used to, and also a "Upgrade Assistant" utility. If you are installing a fresh version of the suite, then there is no need to worry about the upgrade utilities, you will get the already upgraded database and config files each time you run the main installer. If you care about retaining your historical data, settings and profiles - you will need to follow a specific upgrade path.
The gist of it is, you will need to backup your database and config files, then do a full Uninstall of the 2.0 suite. After that you need to install the newest 2.1 copy, followed by restoring your backed up files and then upgrading them with the Upgrade Assistant. I've made a video of how the exact process works below.
Because of the 2.0 issues, it is necessary to uninstall 2.0 through the control panel in order to upgrade, ONLY this one time. Each upgrade from here on out will not require you to back anything up or uninstall anything. You will just need to run the MSI Installer followed by the Upgrade Utility.
HOW TO INSTALL:
A Fresh Copy:
- If you're running 2.0 and want to start from fresh, make sure you STOP the Listener and Logger service and fully exit the Client. Uninstall 2.0 from the Control Panel fully once everything is stopped.
- Run ReefAngelClientSuite.msi and follow the prompts. Congratulations, you're at the latest version of the Client Suite.
- From the Client, browse to Settings -> General Tab. Press "Launch Service Dash". Stop both services. Close Service Dash
- FULLY Exit the Client by going to File-> Exit or right clicking and pressing Exit on the blue fish in the system tray. The upper right "X" will only minimize it!
- Run the RAClientMigrate.exe and press "Backup". Exit utility. This step backs up your existing configuration files and database history.
- Uninstall Client Suite 2.0 from the Control Panel. You shouldn't get any errors if all the services are stopped and the client is fully closed.
- Install the latest 2.1 Client Suite software from the MSI. (ReefAngelClientSuite.msi)
- Immediately restore your data by running the RAClientMigrate application again and pressing "Restore". Exit.
- Upgrade your restored files by running the UpgradeAssistant.exe application. This will go through and get your legacy database files and configuration files 2.1 ready.
- Finished! Run the Client and go back into Settings -> General tab and run the Service Dash. Make sure both your services are in the running state.
http://www.youtube.com/watch?v=RWRejvlNBhA
RAGen.exe notes:
In order to enable expansion support in the Client Suite, you will need to enable it first in RAGen.exe features tab. This will put an entry in your arduino0022/libraries/ReefAngel_Features/ReefAngel_Features.h file that looks like this:
Code: Select all
#define RelayExp
If you are running over USB, the feature "PC Logging" is no longer needed/provided/supported. If you have a current sketch file that you are running with this enabled, please remove it. Either by creating a new sketch from RAGen with the feature disabled or manually removing the following lines inside the pde sketch file:
Code: Select all
// Timer used to indicate when to dump the parameters
ReefAngel_TimerClass ParamTimer;
...
ParamTimer.SetInterval(15); // set interval to 15 seconds
ParamTimer.Start();
...
// Dump Params
if(ParamTimer.IsTriggered())
{
ParamTimer.Start();
ReefAngel.PCLogging();
}
Wifi OR USB = #define wifi
Expansion box? = #define RelayExp
No More PCLogging!
Notes on Expansion Box Functionality:
To enable an expansion box, you need to go into Settings -> Relays tab and along the top are checkboxes 1-9 representing the possible boxes the suite/controller can support. By default, 1 will always be enabled (your standard box) and then you can toggle up to 8 additional boxes.
Each box can have 8 individually named relays. If you don't enable an expansion box, the client will display the relays like normal. 2 or more enabled boxes will display a yellow name in the center of the relays letting you know which box you are currently viewing. Also, you will see an up/down arrow next to the 8 relays with a number between them. This also shows the current box index that is displayed. Pressing up/down will scroll through the enabled boxes from the previous step, with the yellow name and index updating accordingly. Each box relay can be individually controlled by right-clicking the status like normal. Also, each box has its own set of profiles. Pressing the triangle button to the right of the relays will pop-up the profiles associated with that relay box. This means you can only have 1 active profile to a box at a time. Or in other words, you can apply a profile to box1, scroll up to view box2 and then apply another profile to box2. Each box would then have its own active profile applied to it. Here's a video demonstrating that functionality:
http://www.youtube.com/watch?v=QpTpeDn3yZs
ChangeLog:
- - Removed label next to email recipient as it implied gmail addresses are the only supported. This is not the case.
- Added validation for gmail addresses before enabling SMS/Email notifications.
- USB setup no longer requires PC Logging enabled in RAGen. Client Suite will always pull data instead of controller pushing.
- Added Relay Expansion support.
- Fixed bug in Service Dash that would stop users from switching to USB after choosing WiFi
- Only allow 1 instance of Client to run at a time
- Available COM Ports in Dashboard are now read from computer and listed rather than a user entered textbox.
- Fixed bug that would keep icon in system tray after fully exiting the Client
- Various service related checks now take place during install/uninstall
- Created a new utility to facilitate upgrading Client Suite in the future (Upgrade Assistant)
- Removed Database and Configuration file logic from installer
- Aggregate values are now displayed at start-up as expected, if they are enabled in the settings screen.
- Fixed bug that would send cold notifications on the third sensor without hitting defined threshold
- Updated the image on Settings screen to display version 2 of the Relay Box.
- Fixed bug that would always display 3D settings when switching to Chart view from Grid View
- Whole number temperatures are now formatted correctly on the Client with one fixed figure after the decimal. i.e 136.0
- Whole number temperatures and pH values are now correctly sent to ReefAngel.com taking into account the fixed digit after the decimal.
- Added custom SMS Carrier feature which lets users add their own carriers that are not included in the default list.
- Added customizable temperature labels.
Where to Download?
ReefAngel Client Suite 2.1:
https://github.com/davemolton/Client-Suite-Installer
Upgrade Utilities:
https://github.com/davemolton/Client-Su ... -Assistant
Like normal, Curt's latest dev libraries are required for the Suite to work properly. This means as of today, 0.8.5.14
As always, questions/comments/feedback is appreciated.
-Dave