in today's video we're going to be having a look at the new two-year integration for home assistant
we're going to be having a look at some of the new features and what you can expect from the
new integration and i'll also be running through the setup and install of the beta check it out
what's going on guys i hope you're all doing well a lot of you will have seen or heard about
the new two-year integration from a tweet that home assistant shared the other day
in that tweet it mentioned that home assistant had been in talks with two-year
in regards to getting their new integration moved from a custom component and getting it
turned into a full-fledged integration this new integration has been kicking around for
a couple of months now and it's gone through a couple of changes since it originally launched
i've actually been in talks with tyria and the two-year developers and i've been testing out
and using this integration for a little while now now this video was originally supposed to
come out the other week but i ran into a bug with the integration and until that bug was fixed i
didn't want to release this video and version 1.3 of the integration just released this week
and it fixed that bug and also added a ton of new features okay so why don't we start with
what this thing actually is if you didn't already guess this thing is the new two-year integration
one of the key features about this integration is it's built using two years new open api whereas
the existing two integration is built on the old api technology utilizing the new api allows
the integration to support more devices that were previously not supportable in the old integration
it also offers better response times which are now measured in milliseconds as opposed to seconds
and it uses two years later security in order to help secure your account and probably the best
feature which i know most home assistant users are going to love is local control
now hold your horses before you go rushing off installing an integration expecting every single
device to work and expecting local control the important thing to note is that this integration
is in beta local control isn't currently in the integration but it is a feature that's planned
and the two developers will be working on it if you're interested in checking out what devices
and now supported by the integration i'll have a link to the supported device category page which
can be found on the two-year github in the description below on this page you can find
all the supported devices and you can find out what version that they actually became available
and in that list just here we can see that the robot vacuum became available in version 1.3
and i think you can probably tell by just looking at this list especially if you compare
it to the current integration there's now lots of different supported devices and there's plans to
add more and more as time goes on in addition to adding support for the robot vac in version 1.3
they also added support for pet water feeders the thermostat and fixed a few of the issues that have
been knocking around in the other versions so lots more supported devices with plans to add more as
time goes on this integration should also be able to control any of the powered by two-year devices
powered by two-year devices can usually be identified by the two-year or the powered by
two-year sticker on the outside packaging of smart home devices and if you saw the
home assistant tweet you'll know that home assistant and two-year have now been in talks
in regards to getting this integration put into their home assistant integration list
and this is going to be great for home assistant and two-year users because
the two-year integration will be able to make use of native home assistant features and also
the actual install process for the integration is going to be simplified you won't have to download
it through hacks and go through a clunky setup you'll be able to access it directly from the home
assistant official integrations list for those of you that follow me on my other social media
platforms you listen i shared a post the other day where i collated collated collated combined
that word i got a bunch of different questions and information regarding this integration and i put
it all together i also asked you guys if you had any questions that you wanted me to ask to you so
there's a couple of those questions and answers in there too and if you're interested in following me
on those other social media platforms there'll be links to them in the description below and
while you're down there checking those out if you're not already hit that subscribe button
and ding donk the notification bell you'll then be alerted to any future video that i do
my information for the answers to these questions comes directly from my contacts at two-year and
also the two-year developers so we're going to quickly run through those questions and answers
and then we'll follow that up with how you can go about installing and setting up this beta and as
always this video will be chaptered so if there's a specific question you want to hear the answer to
then be sure to make use of those timestamps in the description below okay then question one who's
making the integration we did briefly touch on this the integration is going to be maintained by
the two-year developer team and home assistant are going to help to you with getting the integration
ship shape and ready to be integrated into home assistant question two what can we expect from
this integration again we did briefly touch on this so you can expect more supported devices
quicker response times eventually local support and one that i didn't yet mention
is auto discovery so when you actually add the integration it should be able to detect two
devices that are on your network and you should be able to add them in question three when can i get
this integration this integration is available now but again the important thing to note is it isn't
beta so don't expect it to be absolutely flawless you can install the integration through hacks so
if you stick around or skip ahead i'll be showing you how you go about doing that question four do
i need to uninstall two-year so with this one i'm assuming you mean the current two-year integration
in which case no you don't both integrations can co-exist so you can be running both the existing
two integration and the new two integration both at the same time and i would recommend doing this
rather than just jumping straight into the beta because again it is a beta so if you've got a ton
of different two devices and they will suddenly start acting up then you're probably going to
be a little bit sad one thing to note is that if you're using both integrations at the same time
they can cause each other to go out of sync and i think this is because they're on different apis
so if you turn a light on on one it's not going to update the light on the other one
so just bear that in mind if you're creating scripts and automations using both integrations
question five how can i contribute to the integration absolutely anyone can contribute
to the development of the integration you don't need to be a crazy coding wizard or a mad to
your api god all you really need to do is just install the beta and have a play around with it
while you're having a play around with it if you notice things aren't working as they should or
you think of features that i'm missing and you'd like to see added you just need to report these
things to the 2d developers to do this you're just going to head over to the github page and
you're going to create an issue so at the top here we're going to press issues and if you had
a particular issue with something not working or a particular feature you want to see add in
you're just going to press that new issue button and then you're just going to populate that issue
with whatever problem you run into or a new feature that you want to see added and just
give the developers as much information as you can it's always best practice to first check through
the reported issues to see if somebody else has already reported something similar to you that
way you're not creating a duplicate issue and you might be able to provide more information on that
issue with details from your own home assistant the developers are very active and responsive
with these issues so we can see here i actually created an issue with the robot vacuum not working
so when 1.3 initially released there was an issue with the robot vacuum not working correctly
and i created an issue for this and you can see that information just there and within about half
an hour or so the two developers had got back in touch with me and they'd actually resolved my
problem there is still an issue with the robot vacuum where it's stuck in the cleaning state
and the actual developers are actually waiting for me to give them some information so i'm sorry
about that guys i'll actually get around to this as soon as i finish this video and i think you
get the idea with that so the more people that try out the beta and have a play around with it
the more issues and problems can be found and fixed and that way we're going to get a better
integration created overall number six my device isn't in the supported list if it's a device you
absolutely love then create an issue and make the developers aware and that way they'll know to add
it in to the integration just as a quick note which also refers to the previous two questions
i'm going to be putting together a video with the help of the two developers which will give
you a guide on how to actually report an issue and what information to include that way you'll
be able to quickly and easily set up an issue and the two developers will get all the information
that they'll need back to the questions then with question seven do i have to use the integration
now you currently don't have to use the beta integration but the existing two-year integration
is no longer being maintained or developed and it's actually going to be removed from
the integration listing in about five months time hopefully by then this new integration will be
a proper official home assistant integration and you won't have to install it through hacks and it
will just be a simple and smooth transition and if you want the specific date for when the existing
integration is going to be scrapped it's december 31st 2021 question eight do you work for two-year
question nine what about local two-year if you don't know what local two-year is i've
created a bunch of different videos on this but essentially it's a third-party integration
that's going to give you local control of your two devices as local 2 year makes use of the
old api i imagine it's also not going to work in about five months time but hopefully by the
time we reach that december 31st endpoint the new two-year integration will have hopefully already
implemented local control so you won't even need to use local 2 anymore you'll be able to do all
through this one integration which i know again might make you a little bit sad if you've spent
ages adding 30 or 40 different local to your devices okay question 10 what about tasmota and
two you convert these processors require flashing your devices with custom firmware and this process
usually involves either dismembering or soldering parts of your device this isn't everyone's cup of
tea but the trade-off is you're going to get full local control and get your devices out of the
cloud so i guess if you're doing those processes you're not going to be using this integration
anyway another thing to know is that both of these methods are not supported by two-year
they directly conflict with two years business model and any issues caused by modification or
corruption are down to you the user okay question 11 and i'm going to stop counting now because i
haven't got that many fingers what about zigbee and ir devices there are plans for controlling
zigbee gateways and the device is connected to those gateways but there's currently no plans at
all for ir devices and speaking of plans here's a sneak peek at the q3 roadmap for the integration
so on there we can see we've got things like local support and getting the integration merged
into home assistant we've then also got things on there like auto discovery for devices that
support the two-year integration there's gonna be an improvement to the home assistant powered
by two-year product driver tutorial and also more products being supported we're going to
get an faq for error codes and an improved login process which is going to remove that region
and country code setting and finally there's going to be more sections on the github wiki which is
going to house tutorials and a section for voting on features now there's no dates attached to those
things but that's a little sneak peek at what you can expect to see in the coming weeks and months
for this integration and the last question then which is going to segue us nicely to the end of
the video is how do i set up and install the beta to get started you're going to first needed to
register for a 2d developer account you're then also going to have needed to register either your
two-year or smart life apps to your developer account now in this video i'm not actually going
to be going through the process of how you do that as i've covered that in a couple of other videos
and in a recent video i did on the two-year api i actually ran through this process step by step
so if you're interested in how to do that then check that video out and then come back here
and if you're carrying on i'm going to be assuming that you've done all this and you're ready to go
so let's jump over to our home assistant dashboard and get started
okay so we're here on our home assistant dashboard but in order to get the new two-year integration
added on we're gonna first needed to set up and install hacks if you haven't got hacks and have
no idea what it is i created a handy video where i went through five add-ons for beginners and
one of those add-ons is hacks so check that video out go and install hacks and then come back here
and if you've got hacks installed then you're good to go so in the left-hand menu there we're
gonna navigate to hacks and then from here we're going to head into integrations we then want to
choose the three dots in the top right corner and we're going to press custom repositories
from here it's going to ask us to add the custom repository url so we're going to
paste in the new to your integration url and you can find that in the description below
for the category drop down we're going to choose integration and we're just going
to press add you should then see that appear in your custom repos list and we can close that down
we then want to press this blue explore and add repositories button in the bottom right corner
and from here we're going to start typing two year and we should see the two-year v2 integration
appear so we're just going to press that and then from here we're going to choose install this
repository in hacks and at the time of recording this the latest version is version 1.3 so we're
just going to hit install once that's installed we'll see the integration in our hacks list and
it's going to tell us that it's pending a restart so we're just going to reboot home assistant now
and once home assistant comes back to life we're going to head into our integrations so i'm going
to choose configurations and integrations from the integrations page we're going to choose add
integration in the bottom right and then we're going to search for our new two-year integration
so in search integrations we're going to start type interior and we should see the two-year v2
we then just need to give that a minute to install the integration once that's done we're going to
just need to quickly configure the integration so for the drop down here we're going to want to make
sure that the to two-year cloud project is set to smart home pass and i think it now does that
by default so if yours does just hit submit we now just need to provide the integration with some of
our two-year details so let's go ahead and do this now we're going to start off with the availability
zone you're going to need to set this zone or region to be the same as whatever your two-year
or smart life account is registered as so for me i'm in the uk so in the drop down here i'm gonna
choose eur it's then gonna ask us for an access id and an access secret and we can get both of
these from the 2e developer page over on the developer pages then or the iot platform we're
going to choose cloud in the left hand menu here and we're going to choose development once that's
open you should see any projects that you've created and you're going to want to choose your
project and make sure that the development method is set a smart home pass so i've got my 2uv21
here so i'm just going to press that from here we can see our access id and our access secret
and we can just copy these and paste them into the respective boxes so let's do that now with both of
those pasted in we're going to need to set our mobile app so from here you're going to want to
choose either two-year or smart life so whichever one you've registered all your devices to
in my case it's smart life next up we're going to need to set our country code if you're not sure
what your country code is i'd recommend using a website like countrycode.org where you can
just pick your country and it will actually show you in a big blue box what your country code is
so from that i know that mine's plus four four so i'm just going to type plus four four in there
and finally we're going to just need to enter our account information for our two year or
smart life account so this will be the account that you've got all of your devices registered to
and with all that information entered we're going to just press submit and you should then hopefully
see a success message and from here you can see all of your different two-year devices and you
can assign them to areas if you want to a quick tip if you're seeing this invalid authentication
method and you're 100 sure that all of your details are correct on the country code make
sure you add that plus because it seems to be sensitive to whether that plus is there or not
hopefully that saved somebody a headache if it did then drop me a like in the future this whole
process is going to be changed and it's going to be made simpler and easier to use i'm happy
with that so i'm just going to press finish and from here i can now see my new 2uv2 integration
now it hasn't got a logo and i'm not sure if that's just a cache issue with my browser or
if the logo isn't working in the integration so on that integration i can see i've got 15 devices and
15 entities if i just press on that that's going to show me a list of all my different two devices
so i can see my blinds there i can see all my different lights and most importantly i can see my
robot vacuum here so let's just click on the robot vacuum and see what that looks like as i mentioned
earlier there is still an issue with the robot vacuum where it's reporting its status as cleaning
even if it's at the dock or it stopped moving i imagine this one's going to just be a simple fix
but it's nothing detrimental to the robot and it doesn't affect its operation at all so if i was to
click on that and click onto the information about the robot i can see there it's battery
level i've got the option to play which is going to send it out and make it clean i can stop it
or i can return it to the dock so if we jump back to our device list and choose a different device
let's go for something simple we'll go for a light so i'm going to choose light 3 there
so i can see the light there and it's got its toggle so if i toggle this on
it's going to turn the light on and if i toggle it off it's going to turn it off
and there we go guys that's the new 2 integration so we've had a look at what's currently available
and what's upcoming and we've also had a look at how you go about installing the beta if you choose
to use it let me know in the comments below what features you're most looking forward to before i
go i want to just say a big thank you to the two developers for the work that you're doing at the
minute and then even bigger thank you to these awesome dudes these awesome dudes on my patreons
if you're interested in supporting my channel and becoming one of these awesome dudes then
they'll be linked to my patreon in the description below if you've enjoyed this video or found it
informative then don't forget to drop me a like rating and if you're new around here feel free
to hit that subscribe button and ding dong the notification bell you'll then be alerted to any
future video that i do if you're stuck and running into issues feel free to head on over to my
facebook group where myself and others can further assist you if you're having a problem that's to
you related then head on over to the to your github page which is linked in the description
below and open up an issue there if you want to see any behind the scenes or sneak peeks of
upcoming projects and videos then be sure to be following me on my instagram account and yeah i
think that's about it thank you for watching and i'll catch you in the next one cheers you