bmercier Posted Thursday at 01:47 PM Posted Thursday at 01:47 PM (edited) Hello, Here's the first alpha release of eisy-ui. If you are familiar with SSH, you can proceed with a manual install of eisy-ui for testing purposes. For now, I'm expecting just a few installs by technical folks. If you are not familiar with ssh, please wait for the beta release. If you have installed this alpha release, please give this post a "Thanks" and feel free to provide feedback. Prerequisite Please run an Upgrade packages from the admin console. eisy-ui relies on new APIs available only on the latest IoX. The latest PG3x 3.3.19 is also required. To install eisy-ui Go to the latest post in this thread to find the latest alpha release Install: sudo sudo kg install -f <package name> Start the service: sudo service eisyui restart Using eisy-ui Launch your browser to: https://eisy.local Login with your portal user and password eisy-ui features Favorites page This allows you to create a dashboard like page to interact with your nodes. Organize them the way you like it. Just display the properties and controls that are relevant to you. Use widgets to create an intuitive interface to manage your lights, color bulbs and thermostats. Group relevant nodes within the same tile. PG3x integration You can access PG3x from within eisy-ui. For the most part, it's just the same PG3x served within iframes, except that there is now a single sign-on. In PG3x you used to have to login with your IoX user and password, and there was a separate portal login that was required. That portal login could be reset using System | Switch Portal Profile. This is no longer the case. With eisy-ui, you login once to eisy-ui with your portal user profile and can access PG3x. That's it. Portal connection IoX used to make the outbound connection to portal. This is no longer the case. When eisy-ui is installed, eisy-ui connects to portal instead of IoX. This change is transparent. This however lays the groundwork for multi-connections to portal which will allow parallel requests from portal to eisy, and thus enhance speed. Rest API The IoX rest API can now be accessed on ports 80 and 443. However, this works with your portal credentials instead of IoX user and password. The rest API can also be accessed using a JWT, but that's beyond the scope of this post. Logging eisy-ui's log is on the file system as you would expect, but it is also sent to our cloud log server. Eventually there will be a setting to allow/disallow this. But for now, this can't be disabled. This allows us to troubleshoot problems that may arise more easily. Backward compatibility Please note that IoX can still be accessed directly on port 8443 and 8080, using IoX user and password. PG3x can also be accessed directly on port 3000, using IoX user and password, just like before. However, it is not recommended to switch between using PG3x from eisy-ui vs directly on port 3000. If you do so, you may have to use System | Switch portal profile when using PG3x on port 3000. The only permanent change when eisy-ui is installed is that IoX no longer connects to portal. So if your eisy is offline, make sure the eisyui service is running. FAQ Can I see the eisy-ui log? At this time there's no UI to see the logs like PG3x does. To see the logs in real-time: tail -f /var/eisyui/logs/ui-current.log What devices are supported? https://eisy.local/nodes, which is the main page to see your nodes is very similar to what you are used to in the Admin Console, and this supports any nodes. The Favorites page likewise supports any nodes. There are specialized widgets that allow to make a better UI like switches, sliders, etc. You can create a nice UI for thermostats and color bulbs in particular. There is however no specific widgets for locks. Only the "Generic command" can be used for those. There is also no supports for scenes or programs yet. I have a 994/Polisy, can I install eisy-ui? Unfortunately no. eisy-ui can only run on eisy. What's next? In addition to a nicer UI, the goal of eisy-ui is to replace the Admin Console. One of the biggest upcoming feature will be the ability create and manage programs. We will also make enhancements based on the feedback from this alpha release. Eventually, the Favorites page tiles will support scenes, programs and variables directly. This will allow such things as displaying the status of a node, but control through a scene or program. Here's a few screen shots Edited yesterday at 06:13 AM by bmercier Added reference to the latest eisy-ui download 5 5
bmercier Posted Thursday at 04:57 PM Author Posted Thursday at 04:57 PM For alpha testers, please provide feedback on this post:
bmercier Posted yesterday at 06:10 AM Author Posted yesterday at 06:10 AM eisy-ui 0.4.1 changes Updated the DB creation process to use the prisma bin instead of npx Portal proxy connection keep-alive set to 30 seconds. To install eisy-ui 0.4.1 Download this package to your eisy: eisyui-0.4.1.pkg Install: sudo pkg install -f eisyui-0.4.1.pkg Start the service: sudo service eisyui restart
Recommended Posts