From a4adaf1696a94b886f0a44416bcf910319c3b6de Mon Sep 17 00:00:00 2001
From: Erwin Douna <e.douna@gmail.com>
Date: Sun, 3 Aug 2025 13:51:09 +0000
Subject: [PATCH 1/8] Initial commit for device auth

---
 README.md                          |  19 +++
 examples/example.py                |  17 ++-
 screenshots/tado-device-flow-0.png | Bin 0 -> 12615 bytes
 screenshots/tado-device-flow-1.png | Bin 0 -> 23955 bytes
 screenshots/tado-device-flow-2.png | Bin 0 -> 7724 bytes
 src/tadoasync/tadoasync.py         | 180 +++++++++++++++++++++++++----
 tests/conftest.py                  |  16 ++-
 tests/const.py                     |   3 +-
 tests/test_tado.py                 |  12 +-
 9 files changed, 213 insertions(+), 34 deletions(-)
 create mode 100644 screenshots/tado-device-flow-0.png
 create mode 100644 screenshots/tado-device-flow-1.png
 create mode 100644 screenshots/tado-device-flow-2.png

diff --git a/README.md b/README.md
index 306ebf3..e14c286 100644
--- a/README.md
+++ b/README.md
@@ -64,6 +64,25 @@ based on the following:
 - `MINOR`: Backwards-compatible new features and enhancements.
 - `PATCH`: Backwards-compatible bugfixes and package updates.
 
+## Usage
+
+As of the 15th of March 2025, Tado has updated their OAuth2 authentication flow. It will now use the device flow, instead of a username/password flow. This means that the user will have to authenticate the device using a browser, and then enter the code that is displayed on the browser into the terminal.
+
+PyTado handles this as following:
+
+1. The `_login_device_flow()` will be invoked at the initialization of a PyTado object. This will start the device flow and will return a URL and a code that the user will have to enter in the browser. The URL can be obtained via the method `device_verification_url()`. Or, when in debug mode, the URL will be printed. Alternatively, you can use the `device_activation_status()` method to check if the device has been activated. It returns three statuses: `NOT_STARTED`, `PENDING`, and `COMPLETED`. Wait to invoke the `device_activation()` method until the status is `PENDING`.
+
+2. Once the URL is obtained, the user will have to enter the code that is displayed on the browser into the terminal. By default, the URL has the `user_code` attached, for the ease of going trough the flow. At this point, run the method `device_activation()`. It will poll every five seconds to see if the flow has been completed. If the flow has been completed, the method will return a token that will be used for all further requests. It will timeout after five minutes.
+
+3. Once the token has been obtained, the user can use the PyTado object to interact with the Tado API. The token will be stored in the `Tado` object, and will be used for all further requests. The token will be refreshed automatically when it expires.
+The `device_verification_url()` will be reset to `None` and the `device_activation_status()` will return `COMPLETED`.
+
+### Screenshots of the device flow
+
+![Tado device flow: invoking](/screenshots/tado-device-flow-0.png)
+![Tado device flow: browser](/screenshots/tado-device-flow-1.png)
+![Tado device flow: complete](/screenshots/tado-device-flow-2.png)
+
 ## Contributing
 
 This is an active open-source project. We are always open to people who want to
diff --git a/examples/example.py b/examples/example.py
index f1f5544..b0a6b11 100644
--- a/examples/example.py
+++ b/examples/example.py
@@ -1,14 +1,27 @@
 """Asynchronous Python client for the Tado API. This is an example file."""
 
 import asyncio
+import logging
 
 from tadoasync import Tado
 
+logging.basicConfig(level=logging.DEBUG)
+
 
 async def main() -> None:
     """Show example on how to use aiohttp.ClientSession."""
-    async with Tado("username", "password") as tado:
-        await tado.get_devices()
+    async with Tado(debug=True) as tado:
+        print("Device activation status: ", tado.device_activation_status)  # noqa: T201
+        print("Device verification URL: ", tado.device_verification_url)  # noqa: T201
+
+        print("Starting device activation")  # noqa: T201
+        await tado.device_activation()
+
+        print("Device activation status: ", tado.device_activation_status)  # noqa: T201
+
+        devices = await tado.get_devices()
+
+        print("Devices: ", devices)  # noqa: T201
 
 
 if __name__ == "__main__":
diff --git a/screenshots/tado-device-flow-0.png b/screenshots/tado-device-flow-0.png
new file mode 100644
index 0000000000000000000000000000000000000000..17a59f129a9f72c5208682036ff1103dc8bb18eb
GIT binary patch
literal 12615
zcmbWec|4Tu_Xke4geZlwj1;OTG-PKip=7J{6j??LB4Z6%W=43jW-YQ#RAh;SvCoiY
z>|-B>3=PJ<8_Y2C)AM|KUZ2nR_4@t(`28{W%yrLo-RE5AT<2WpeVubh-8H>+;`|9F
zCMF)k+j{qzm{?hke!CoJKf0P_FESr}G5g%VrOQ;(E3$CZV0G3p(P3gLi|0Cc!gkc=
z^t^59!^Cv5`PYXT>+u<Kbo2CceT(Pj9!}5wpLjbm-ST#HboY7c@!a;$<3~fTV+{3l
z9=xz!$-)&$cDyB$d4cVAoR2lXX`GIQTgbc5pBgY|zWvuQD&LCj^|`SMzQ=F$E_`N|
zYY}(tJM-M7kxlV^L`DBlZpDkFyb8YUz>39Tw_-*U1!Ur+2gz0;2bt>4^#l<c)?k8w
zLR*8j{j;aiyiDgBcH=>t{djiW;}^pDeqAQu^x<0|wL{vi+LwRd_;sn`7hw6_Awiuz
zhWVeqe7fzTB)4d0#@rbGmD#}xMiFa<E1#Y;V_XlWMc}l@#UT4y`;t%V9>j^3D~en|
z^CCb8`&x$+Vp^Qw^KcpwqkPbX$FLGc5@zeSUQgHML1ltE7fE#<=%YVA`}}N}7DNU^
z_gd9w*Ao3Bc6Bhr#tw%W(}Nx_QL<t@I9nSY-tG<3=G6Y$D?zhKC9IX(3LZP&OiIPR
zK`4kQJ1tdrp{`K}G=eC7+2z+ux`;d&`2O>1X988F5^)M!`PUL<)UDF-8OGeFZp0~`
z7wc%F5#QzI&=B_p<+kGQYU)DHy38ItSE>9e)#0ZngT9UdZPdDy?#*#DS0Sj=>vI|J
zp@MM<#gjMw?EZ#GItga%(EuYbr;)hU-i@rJX5Lp?2s$1Gb-wRiluS^NWf!uFZ;{3T
z4?vO3apMms&w&m%!+2Ve^*N_9H(xa@<ZX-$PPg9U60Evj@Y&u8dw|CQ#z5&2k9?77
zI}T+o6Y)*`<fPmIe7O$j`t+|!+^YI(Nx*w>i84<@^9$B1ZB%dXdFnmHZbdE&EonBA
zhNrrNBS&Y52CI6&shCoP%ic=eKIc#MHSV=KwwDpj8Cqk&#PH?J;z<=Xr$w2U$_Uj7
z@a$U7hH3?7rZhq>^E2P|&}4$oHTKMu&4-O1S{~yDo)af8#M8Pk9MH&$v@}@)=~bDt
zLydx!`}y5$>(bToxbf5nLqH=E+O0bYb4WtG2u8)yfGTwB!h#)9L|CvZLn6+jYkF&Q
zqMB!kvPVMmrv74FgcuQNj#aS7S*$UOmA>=Yx?mrJuu6+zMpB1`eM!5MLNjIY4SR(3
z0`S?s8lyVnMJ?Gl#9}MC5MJ3`3m&E{4_2ai4ytem`0eMwtH+Jasu|ZOXmfl1rrte8
zYn#>Z6LcL|uNhqRz{~Izf*LVR-vtmLic8j1*R&n}T^f<`>1nE2k1s|-E(cjJZ596I
z)0aEBmB#CD(9vo07k^U50D0(H;vIuk%qU56iy*LobZ2Sh9F?2<fY=o#zunk`h&1G`
zRxW(By+j`VV?A_XVqi`9XXV~@dOZrC3oVFY9)3pI-=l#!HnkY5&wJO12gX~&!7E*(
z`4tynBTii?`w)s|r5QQ&do(D!jUG15rK$X*U?5miLyX+fTm+MwTy%Led1eYF*2d$7
z8f#c+e;pB+E|vZB4Vq+vs>lZg4q8Ko%v6{8Q5$<tGls7Gv0sRU=MD*%yKb$GNfbCZ
zB}eDdT<KLwPvRE#R8SA-F6#G!?_mULJp6S((mJb0d6sS{JB<+{B&F!qi~SMgm^Y4C
zjdbU1w0{0u;r1J(H4(1q+DeB=x5W94x)$Fe*zxO>MF(4ru#IP(*Pg1IH7JF_+b4sI
zzulA{J42g_2iqAbw_|uvv2YL~9eWt~;=psF{HawXk;f|Z#rFVqoDG3C5|%O+l;s&5
zS$&(q_gE@B%m-*^Owgh?e3}L`R#M5Atm(w-XOE#Zf|rF+P~&-%P~>c^$FbXKn>|cF
z@@B<t8KdM^$iw`#ktnkkFr7T@VO!+*5%Q<xcAii|l2JxQC&mak)jUnN;CsivdXM5g
zdH?cPebyDEv1^gNK4`aG>x`j$Vg^+1uMo*6a<}Wk;|jo#E?rRtnVVS-ry1`t1531g
zTq@!gbR;$Xptd^T4{fa{r3^S@N#e>ETMyo7=KX_*_cM~7$Y5`Fl`=|vInyLI<i6d1
z`5whJc3yI&1msX9K5l>auviAYrnZnuHbUYX&fb?r;hW3J>JPK>GdR&+uZ05w6dDa*
znq_5<VfZ^rH%n`-%x+0rwe+|o?Q9k-rn-j=7!;egKQhEgFgo4hoN9gmi)j0(Yok6%
zX4eatpn=^LJTYQKEg6S%{xU^kACv;Z24M8i*G2;?XIYl_xhAcXIucg^xKuh^?Uk*T
z444uFA*jBD+?wCoAx3>1q?+S6<wn|_O03j9mNhmG2jxdftd?$u@90o=Nd;J3FN;|o
z!nkXQ8bn)A*`Xv;i+Kqtj@BtY#m2%48t{8sSBUv5;CvZXpeW3232uBmwPh5^pD3f0
zy(toeZnRl@Tos#-Di<q-g7mDj5s`hSP1f9foD8h(HBS0a9+CYW&gZo6j#E>MGDtbt
zUgIJCEcBbuy4MenH=ic2_8oLQ^WetR@}B01_g~{(!^lErSO+f^%BKl-<ijLvlU8~4
zlNvPGz=S)x)F-m6?b5Sd=7Aa2L54~%9s{IWj^W5xRO8(?Xu|46EjDL`a_Q~1&*RQT
ze1@Lm5LPg`!%jS?^Is&X>b&LjxD(nxNR{NQ<os%Caqs>gy<AkC*sSj<)*shT(>qRP
z-7Yn4WaELg`RPA^2mw(-#8hDVwyDxwm55$WUJ5cs=Lg_yyP%DE&yPEvWgN(W<_w|u
zOXF^@T6wN?+{s|GxFD!xtb8Ty>ny4@B3~*;$Z$jVPgg8xuf=$BIrN<gI;0bpvM_$1
zNhz&IH%nz$dD@Zm$<aPY&`GtwTDk3Z*97kw!JuxpT#>r^nu^S4j?E6@Vt(cj+D;~a
zkK}XoMgyU5LG{!VN1q>os52oZf>rK`yg<6f7Ab1GIHL}wrNJJ&YU!^@ZgdDlvpU4A
zeRw!`jbkqte`@(r$L`m|{xVrBJ??H_iFf?esLJfH{>*i}(^t3zpu4sY?Y4E{=eL9A
zJ-?A_#B<{O+Z&9l``OteVfg(WVK#-!FW0WH8$)-n9DTRA`M|J4pJw90f^fnvgLF9S
za161d^(qxXEtrnU^|*7ozi0=*jXZ0%KFH7tHyeinnHrL^lZQj$TiU_J;yLJdW|?3~
z)E1V9^_$T9o!Ivv{xNraiW(>fai^-{ob;S2kZDX!z_nZD+95O}pMQOX$m<bm&veJQ
z$et-M9oB6h(w|DTQr8DIZtK84X`%X_K!^QKoTs`4F@!nV1)jq<t{l=<*Wm%r9O#&x
zjUDn*H1k$ZZha^oHh62Er%1fsC1gu+UP`_*Gfwk-wkGC$wh1a<I3Wm*YQkr^M;B=4
zD#t}#xd3E4<2jh3+;6x$;1N(e7M-@JAaU>=b^K6`-4glc(M~ey21R+RY3zo$RZ!9i
zC_n|_pJ00(9>~AkN<bPdZC@Z(@_a_BaxB~=C6n))=T$tj^%+QI!U>dE*~RpgI(WJ)
z31kg^&v0&U6EV91FPf9B80@@3chNM}@-Zz1DR3N?wLbgaS$x_PdUNCyrD#T7d@RxU
zIlN52BF$d=y0nw!ZB)Wq4`;nn*iPK`89-xw8cek%BGPCBS7D_((wn}>#fr^8aIn`x
zb21?*&TYrEUF2Zfs_Q)=-o=*OjUE@=X3cDAyv=fSdFk`-`KF}0&5u!=*5`J$L{<@u
zu{Tph+7q=`r+YR(qKkyqlffsEJ@SjvBrg41J8Ja-3R5gwWg#~wxz|5KPpLico*?-K
zMdfSqjtcKNV=uVIOy>1XDYM+owFEhPV0P$pliXkZ+C12YKKfuOvxb4NxJt#ZMFnzg
z)cYTxI%J%~jk98tqVSEmpys39b6{w<3T%d5tS&_;Xg~DG7p_3hmwunzcFxUs1riLw
z^`OXW8ZXulTwf%3z=xd*#p9j?T<prLvB@%3?z_aXm+g_e6HovhvwI0=<5K_>vCxDj
zwxtDv+UOLGHxDd+lp`7=t`_vsa~#yeNcPw!A}gM5AF#BOW0G3gL>VM&!|X(;j<PEx
zuZ!wTgzvsfqe*d30CLZM*aIG`Y;li<Qr|c{o0CNic4{mVSPxxc8>5uYOeklY+>xze
zmtA8bn<V@*%RdQC^+dI&5X5ds3!KMC>CUix^+9n}xC8?vWU&~~vTxztvn=;dO$|0<
zZCg6351wjopE_oFqwjD=n9b0@#?BM-!HxwSeAu;sXQeMTOwT$$zaakNaVGItwUz)g
zI<2>kk<6QQ$x5mT)*3Qf$C~+Qqu-fiq<d}r!F?_1)iKl?ri-G9S&1?_-4$6O_Pi)V
z?682$RmK~e^5r=pmxl9l=Y|YRZ;$*rV3jmbD3n0^G*e-kJ)OD>y~aNOJ$xje|EbB<
zWA$XIjn9bwmq~ul;c}O2QZ2^R3<6^(h2cj$fRGRdJ!@B610U?HE#>ijZ8k$^&4k!Y
zjKpV*Jr_ea3QuI*xpP&FjBALK$4bBM;DE6dC^yqhMzZsjU+!7M6y8#Y4d9#3QI&vl
zMTh(2qS)@51;IR%(aL~arXBILw}}2~tizDh&MuZ?s!e|(TS?t^c}2tv>OODP#!Pcp
z{#lDu%g>S9#J){qz&B?4*Y_loR;G@0R)lN#b7^EpXMx%8XMjMfc|0+?W{FVXm^*5z
zi6YikMv?760<kL}n?>;QpJX1xE5s6zCx6g=38&Apd{;d+_H91GCpTBjAJM=83SXMP
z4j3uD*uz7^^VlLT&gHY^doUhFRntchKWvi%)*M*BA`jR?osmi&7oTSJXPnSHNHv2$
z*+U`^{PXziKv>(vWNgy4)JMZzHB?2aYDa96+uQdi&c%RUnnH5WYE5GCscY&XD}RE`
zWK}?2OOcjuJeO2*>4h?z9<nDxln}9mYK+u%jD7a0(l(r-Kgd?oGPSgM2^E!D@z7gY
zfCU0PwrF1a1`zW_ykq2DD0>noH8=hYlP8d=J)@mc>+pbD5Py081?WIkEJ)AL?-B>N
zf`9gvo$W@F8d9rM`C8CR{9Z<4aQPMG=3pOdNS^T7%~IupcfRdB$KSY&e>_l=a*%*1
z7gv``<HeLW?Yh;HPWWu4&hK5)WqkMA#eVLQSDLT%3<n67)tnF5fBxb+QW$&W1`|Pl
zD4gHYcXn+SUb+oP`GcG!t&oWAcnd9)KVe-pnsV7GwcH&Bkk>g)!YK$>-6WT2mVV-@
zlA&W!ZiA0#cJX0!QPds@zepw_@ktA#r_Znq>`caIco;GFaQ<P|wT`bN-Q2h-Qi@L;
z9$RT%^o97k?B{Reu#|p30b}4)FEbjls<CkUn^|iPu#1yAN0)Y3S?ft2Z+caA%%F{{
z#wSOUcczDtStgvFLF#)aN?<&1F$+=5r!1kCVpOE9B&ywaXGPrRr-%FusDX2KLktlW
zX<Bbb%9jatKpbxjvtaYNvn(ei0*j`&)3W(IZgY41m82!MX{N;i1^S*%b<20Y>3`0c
zlVT|t*)kZps>^iYc!`zwU<Fwmo5IKSYy7MrOUk3eeynuwy8`jAAk|BP?dkCx2^ae(
z`?AyrUnO%Y)tGz!NXlqKhKX3|23v58|Ay(SLf6>;1@r#g|L<U4BAS`LHl3|bGJ8DH
zEtq0$+kGGhS3L^@)&-~=W-Kb(PAhW|CkPsfUG<=ziMLCiHBZ9yp7~^fZmiN;KjBT0
zhi<CuFpvd`qOOSjx-}&K0rgi`n)8Yx>}s#NQ&ko^pyBNe6gK%EbUy0ZH3G-Zoxy)H
zr^4y2AywHY<$huM?G2tx`LCQ68yd{&ZOcMaUe)`;GAJXTEk8enp0MDuz)w(9cw>xZ
zUui8<s2@@roV>F1^qb%!L3XPGqTXPUTDE!cxr8l0t?sGlKB<o*Np;$KDH!&2!aq93
z!Ki5`$6nehPNx|Y2_lX!OLBOJAY_%r%jFDGm2n40oVs6kTJ@c*(_-Bn|1d#}k5!PS
zkOTx+3f~QHwRCgFZ<d$8+HvUjx4AC@o8Tos#ed?b!6~gFnuxlfK}fweC3XzhNb(F*
zCUF1FGX+Qp(A1FCN>sKPO2ym)r*c`;-n&F3!L7(CrMPS>-~#5nSiGQh`6*YQ3a*_i
z?HNjllG&QQgU;6`nznyWLR9VK?YT&00DfUyS~gpT4HuCPI})@ELxLLYQJyN&a)BN&
z5#Eg!vYFJds>+LRGHLCu>E+nvV8DYiX|ys`v`tm1&|U1c9%l1vi?(JF*!;EH2R;X0
zTA2<usirG+m)U1Jm<tUY`K0q5E3bPD6?N+Sx`lOjHhLY4;d*pQ0W9RWp2zjGsOZkE
zR=4<zK4{O*!u0J&JN(eMrV95Symd!6df>@zZX)qyGat;-^u|q_C##7CoXgyEdKxEZ
z4Y(k^@F>s^U`!vnYoEV|6W2R{n*S_!=DiwiQH^pT(is`g=B4m%<W570l=>50OQN2V
z&HIN7$r|UgXML!>RqwefF-l=xk!?!VlyHZkd1X4$mj5jsC`AemDeK4MzW69dcMS-Z
zUX(E+kiP)?*ddP@_OOlWATJ%%doO*|JUlfRwy@4y5AB}~!d7aa{h8A2gR9mQPtHD&
zf7C*iAfNk|!`CB;i)ifaR1(Eqc4|x+_TeMhkblsc3u(~J+4nSBe*u}*^y=)3qWuE<
zSJ(?X;2D8)JLwj4;TmE+k{)oUDGipx#=}m6ME}xfF|z*dS=)%YcX9C!M!TAgfQv*9
z@$!~WWvTLq(P(ik*LY~|Qtk8gy_fI^YRS78W?#uNvAs(#T;v1=ZZtvcQ0;FFa>Z}S
z53=?$-$)*-i`0`h;_G@pL`{I54~nyWV2OR+dun?&rboq~i`7ypT@}Lx&5zB=;`a@1
z@amIaQE`j1)Pp=?WG0aFP$fHe|J=Elw(^2<VP<~D3w<F#@DqzNSJC#9zMY(ir|@wl
z&69o;4P{W9AnOTuz-v%q2HOR5_r2%Ai7<WwX0oP;HvG&OcdG*ZMW&VrlCP?CVYnVr
zg1OYBH=A}fze%3|K(YlVAdXIddNxO5kwm#~gPn<c8{JT0%J~TIt7-RQ532RbK&1f!
zm6da+DLUhpxYWgT>oLCFEr%b<92Zu7LDgFGG@TciAJcR=WV?C^!+&K`ZFTEiM-5k7
z&T6W?1S!P##J*?mtu2Lg=MC#ksO4Ak=*}aG@aLWq6H$CFcGs-SqQvO&LrsGix0SGz
zb1mj8P1fpL1R<E2k3&cNV~4t7)8}aREdGv(nYsa0L6+<VuD`0^8ymF8#Oz(W3Elqu
znbn<pUMX#0-gQ$65{Hluy8kJE^$%$Wq%kCH+n<VAExI07$nGjZgI9yb!PwxM(NA8k
zU3x8nu1G<fS!<1xM=**U@~-CHejaI1OFAW{5NhStFKAtJ8H!QdSk8Iuq3<`@-of=g
zr3mkmF6X%QL@qYrELB6QK{G>o2v^pR8uPN~jUvnt_XzyVw6_+V``*_I6+f1|<a{Ql
zF{0=nhVm4BxkYwpI=__U0*&6$hia!(&wW${*j&_M^hGrKUn+VQ8y5g$K4gAI4qu4a
z{#^5Vc5h<>jaPZY-*E#yF&W^5|00=g^o+19A{<5CFI&wB6WUb+OaMkEJSuG#9#?JB
z;Sb!pr5WFBcC0ZaCF5KB5+ej~LwxYYOu-e_*u7mQEXYSoz&m~GTDB2dhRrV7vT9*1
z7vm2-!l$*X%&&n-N5=wiYk|WR%~7}f#~+5Rb(KQOD)FC2dsj&0F6(8B={hx#Aj^RM
z%_pG{wnt$qbTGL1hNk>2?LI5{!GJ3X?UtVv5~A4kIlODDXFvu@D#YC)U;fp;2na`V
zL!sY=G$|!V`N!%-Y_jC=YEL6T?25M3<FA!a7%=QzO#IibJyBc~$ZDuQlllhu^{|%Y
z;#Mhm&SxVHQskqfVXPH~8M&&qqi>9ARPCFtb3j7NN$;_|Rl|p`(Ro?#0nuh@&Vicq
zm<ET&2t^-36tj9iRjEuKc<Nd4Evap}K0%Zvqk?Bu(VKPb^giFd*k~wWTWAFi+c?Oe
zT>%8nh2u*d^Hcc85=k`yrCyiwlg_oOMRLXN)buJigrRCYWL*HB8K&u%bhIGYbk)ed
zjRZuP7ZU3cz5f|p5w;~gUKx8rapY7R;>)<pvmA%JGbUIu6XJ(;H!)>TkIWtEEV>E=
zEKPeZk=eM*q%OUj`N$_%5qB4PYFZGbKaU5tQ$K3d;dw`#D1-C5DAX!*I|zmjG8GZ@
z@6AP%RCRIk%I8~|D&jtZJ{pbH1RkhCN+>qj=7KB-Y>RU5TSI_$4tE!Y=?~LPgKo|Z
ztewiNUUDRK*s;U&N-Ao|VI4;&`GvexL1Vw5rgC}UNN?aVxs?y5u%<A-V`=4Ub*;us
zZLlNcB4Yt-^&gUgCJKg7CG2QlqMY?=r;Ez656rPcY{w}q+gP;`y!}A=&x1nb-#Yl3
z$zS;i^Wm8p>ng{{)3j7qF~ewB!?R+KRd%S|7x5oz4?ly4@*Ed2iU#0Or^79BeuIIo
zl>|WBDqiOE${D=iJRtHWG4nW8apk!iGxgF}Tr@={(^zW#(62|q?WX+?YXSjfH=e61
z=d%B*&nrc5HzJ$10;vLV*g3!-drsW{$(WiR9->U`53k#8*VLcQ!Rm-KZyF4Y#zC(r
z(Je-{dV8ZBMZaVq6<*iOjQ>J;g8_Gmdi6?<!4<~yfb}P+BA~%=&8CRBc``Mp;f+JS
zg<wo?1!_v@CG4f;MNvOli*eJrx<xHP76az_aQ&!kYpxILknkHyY~IPn_zepu#hgYq
zuM?qTQ~L5Nko99xf?R4~-neD|5RjZx6QoM{*m9WucmeEcU}>tdK5M^<9kKG@Eil9W
zL($WnR^SgN*R*>Rg0PX4v0fJt_3eFd9z{7W|JG&)z`4Qj59$FtS_Hpn&*>n#v_+Gd
zQXOpT{_Cqre3*u`(D=RwgFrgHouL%=9dzg~d9$r8>lp#lTl0)MRvCpqrG^>dIdtiG
zei*Z@4<%?_*BY*Y9*JIpc+n~p=)IyX|Hv9_UE}IwIpX1Cs&`26`?;ij2KOb1XKd9v
zwH}q+8EY@vs*j~wlgC1Bs#a=PVb}dezL|3;%G|?T9(k=g8dKZ5L~GjgN43@vr5I|f
zW~$i(#N?m7QC<^Ru+SakUt))8a2FlxpcD%{nntq2DLmuLE+U5y0eWy0jjg%UYW|cf
zv6c?k8Y-i<#nb*+W1bY+2i^GjbM@0P_15%({d*dy7~3El*HKHaF!Uei=%t*;^AFh`
z+&=Lo6e<t(RENyPG-NIhhL*?%7OoXHC%Q<nRPV)r66<R<v0Wm>Lb*swEMyl#9fkW{
z+xY(S@Gr#Zu6}l9`LNum-CG{r6lKbw;N_(c{?-efRI%e$1HpPQVfnupl<J7+)USr_
ze8nIPa+O8-jBT+E?4H&aGuqVj_SQ(Es}DIz8D)bP(=G=*mW~rS#jn6{E?$HARGkv^
z7qx^{0#Gm%_H9isMxR)VnpYF|rJ-6t;x)G2)V6sQd}=$U0Gg79pqHyk=fXAp0-t?f
ztAmwJ+ob+PC3kV#uV7o%OP1SF6B8Qc^3t0%bnEEg+wwn_(h{v`<lS-<rMt;}$aiwS
z=;xy<nOfd@43bY%ifgR*bc{xCNxbeWt&@g%Hp*XM-=N8x&HFBdMEDP<c;SHSPFJsl
zPgP!7>4)YZrhPk(LYs)zll-Y|ww;wej_@<D%~m3yT5bo&(yU;QHuZtpf1s}nXiv=O
z&u^;ub`N}X16!E745lgk`1+vLL+#bogyU_=+n(d(4%K~s1C+=tH8f5%SxkL*Mu=_`
z-TitZI>4Y8X_UsV=|g`Ya=!c~ZLLXl^sdUz=w$Jl^AX4)n*}8rzrAu7R$Fd7To=gy
z_Nw1r5bupx=?g8h53Rujza-(ghusRglw3`+99xM=&&s)Rv7>Rq>w+BzCoTlCZN@o(
zORr^IZA<3!7D`3HHdZc?n`d!HBfcZIQjg*Du(R<i=l}n}sVRHy9pP8Es8XG?y8x*0
ze^RV`x+7km!1veBvi;XHd&T}6m9<%O@9k{m4|-gsQ-^of_ofG@_31x4wyk3D&7`WM
z)Mxivr|i+wsab71fQxqzZ9D8kE^bY~t>h9_V5R5K=Y@XL^47W58uADuoULhWHf{b*
zT?&hr*caoU8*)**B}w@#bQhUAv#l|W-<-{0Mt8sIjt9Mgw@Vq#Am0{1FaE}lvadf0
zt#2-PmfopfvJWwi%+Dw7A9#05O*$afAK2_D)GMOj-rX&NZaR)Ay^*GC-_l<O%P6#d
zlu7=LI#t0aL6!&i-J_Y!?}IUmT3)w-?<LJCq734IV*k2Xr%3$P7p7nN=U)Q^dnxwX
zOFc{pL;lRv;ntAbbM{M5&2YC)6X-H4A4G=(e)HAN_AN&!0d%XBA8O8h8QBUxywpI?
zq+jwM!Kb7}GsVBc%IWmKueZE=R$lEOBbo)D<#GNuM;FK@{=oN38HZepTy#%j$b#ab
z{=>sJ7)b@jRi>*#tgTGoNr^!*>EE<u<7<T83kz%~Z;czoBMyFQ|K_%eLx4r?fP~{b
z{hvEECKK8~aZKBq*XGCZU5~5B-o>B&mujlXEnvvMtt!s{*82Y>*27x=mB&n+SE#)<
z{d;2!{WRK~=IILi&D82?AD}j(h!G?0k&#^GbuMaUuZtOtqy6e*6}7TGMp%0u0<Pr4
zK!A*-a9e&4O;Ov=K3bdWuIGyuz(dYza)+*LZoH6`4b1M$<Lx>zG0dmK|16yZ_)*5#
z^~K%u-rnAm9TVtGwE)dZ^cS~EpJ$lC#AxO&vpaJTP3f7E!$Cr|m~H);rB7GcD@N`O
zn2T~j;#xx<yyJs@h$Sn7FH8KxuC;8n(DnP0N{a<f0igxS0N>)k^ef1~hh#queSO%4
zqeSJmliR~))?ZBV5wF&=Wiob5KIe~>BR-UDxRkj)Le<PmkJv4TWaWWV5e2xU5b~C0
zT3f_2GOA19Iq<z0rdr5TQ3LMXP!ZJ1B&i^}70n#iZGCwvgXtgg37Q)*%o3bw*~W$8
zGLkY%IfcpU42wHSo=K#oa`H%ENw~(aT;HST25QB;WotPy8QU)BRJ{ZYDL;`QJa(~Q
zV|ii@Y|Z_2%-ggzgu{VxKQ=0wSt_lnEE-}8?AMq1kM>phFhbWQjqv;6^$K$kXUS>*
z4A1dPyqEOe+JcdqMCX3t1*7T?Wa6x7Gn(Y1JnzHbQ{<E+3e3u%J@MG@p?5mH)eq%1
zCTPQb8zGo6ShTM=SmX0EyEiRPzcr*jjvCGU(CJU^%S0LR$(FD1Q~yxCEsPOLKt6rQ
z8Ts+fU2ozBL)@@GD%Yf?Vp1E-x~RUuv+d})S!)M-y0=RBb`Nkha``T|P-0Xms-w~;
z839$lXhqS7&FC&PQ^J4%XnZttfas0@OGS5~&|Phx-*q4lrvz9!%?VfUy}ZUbIm#h<
zS8e*H;k2<i^41~5AJQ*8-}P%=lJP<4TPU}oh|@j6-22W{|0gSLeuS+G(1ge9tcO^1
z3!8)+CL6gAO^}8I-xq(FwfG>!<XEU|`mZw-IWEg?%z4}J&Hc?#ew5ywZ~#yIY*kK?
z-w&dc;a@0F?48xl<fUs^eCj(w7%SKQ-8d_vgB5CFu%pcQD*n>gDW!X@e(pPF9k?y-
zaTjPBa;|v`|Lqn~e1H9?<L2-gmO|eLOmKbquE2yc$Zuox7S9zD2d9l7VK~mHtviaQ
z18#t<y-%#79Tl)A_IaOYKY2K>4RSm;JuDVAvYM$IafAZD)om9%8Yh#iVwkm&3t`I>
zi%9B=rmp<vuo`f@jLOLPQ$d!iR-M89Q9)%cvh3|33W@odV@f!2wAr5NA1j+-nzIja
z|M#G-eI@+A&A#b(w{Sjhtle)`b&uCLd==9EU63;Y{8w^(y8nC97t4Q!W!WPSEXD&U
zB&McfWQg-s>iHx7tM!^1@cp{!v74}igMjq||K?u~gjBmSnY`q<s)>N~{^$+p{d8HD
z+|n~vL(Gg1jwFnf?P_#w+O9Yf1ImdizdYECto+f5B*bs+_0VKSLx%X~h05t3{~-_I
zjX4hlETLe}OHqRfdq@6$k969{II`$CI?d1iOsj&c`qf{4Xns$LkeAz-CdfjGB#X(%
z#VHsBg*o)U+e(IZ5n^#$u*TY|uM7<%NKIWy)RsfMmyqMoE<$zH$g6dgYY|n8tmTc|
z_;TW1nm1_Ekr%*uB+$@PtxR4Qal!_ZA?i=v(s$>sDH({ihDdhY7H%7J5@1P>&2Tg;
z#iI~FJH$UkUn~D2da7r?%%r~N#uv+dsX^T?j$&H(yON$!%=q_J(p{Tz-%wdDqF=U&
z{$C5{-*7Q+?R=(>*F7}B_B1>h3aG;-90{Yw&=Y9K>ULu84!kCj!*KdV@%{;)oxp~P
z=PFc*^C&&}u2**mR!XWc(5SsO7;}=iHFsRoB=MUAY>~6Ke)?+1OSdYtPy)^!s13cG
zadeo7oIh(-jJT)q0p-^{w6~z5co?IEfeTOC1(8k?q>|havX#NumW^xPn(Dq9Q14Kh
zq9-1C(MN-^Kj_wV6fr!3e|LYL3-pGVzCbVeR>XRVm?3&IgdTKcfl6SJZA~>Oc06Y}
zd(Xt{w)TGK1p59)xcmpj9|3Dme^RUL(QeU3AtDOb;YQudB5C8=T9)sc@K^I+4Az7H
z);!;VeMmJ>?kuBB2C6c^-r_FR|5{AcNSM80+IWw;T*Fl+li0nl*f9axF&E}rxmkZ<
zmuA9>CI)#+9vQ2ZS!gjx=AwsCzE9^|*=R1#S35(qR49QcpT=-^U)?mYz`F568M!Zh
zD#?^*TPe}gM=_rnwMr{RBL0<P+d_&EgN@k6jaYJUgZn4$FLe~T78}IN?#$}fz&rRD
zFFFV3z4-1v|H`-!HxZno1Ee(Vwpst|0;TlJLr~J|xP6B+3+Cj99gZSqPj5z`vx7KV
zcFbtzxKt?Vy)WzhQ3;N|h}DP=jHjv0dhVDzpiGIRYI<aC2@UHp%mE)V=xkBoNxmUv
z%7&A>vI=F+!-HD+w{IW32#s<y%{YGrP*3%M@p)G)e+AFf>F;_#<F@zv(97UwVauVA
zLi@)1;x!%8n*Yr3kHKON(G2&H<r1YOL6Hvu6TV5W$R86q-M*6drd~XDO0yH~l|RP#
zIqCqGK9)ueOr#!#V6V+C@sHKC40aBbwQacVCLgXmt~g9=@a1l-oRV7ORR!vs^)yuP
zEh&vS+aI@g<UHV-<4XFWaMFkQzC)Ys5*{CQ?G`1YcQ@t(SE0~*w<~ISC`+_0_}4}`
z_V-p&*#7$L#O-#T&OOA}rmq>A4IO=fEU;7AGCXN7%xxTC?eBZ6M&;IFtYZXYrem<c
z4;o7<?m+Pl)(l$+uKy`bu$8~cGEGfv&`BjeYX!j9D&@)oZ`vBJ#*xXDCCWbxq}G3A
zlfp>ny7w>da~^Ds*h^R-UK(dHeYa;?jE`GbI<whuaYQA11-=D5Q<T#1Sos@b=4fVj
z&D3Q*e<*EF1D~GS6Kr9;_nOxSkLP1z>WikE_Wa{4|2*D7evNv7b$$SBtaCDk&nW(7
zuk%ZJHeNBzj^&X`;)-2T&z8fK42~41?4)1<I~8{{DNSLurJDvG+3APJh+D4=3AwZ?
zw_);4+9nVZvk<Sn(Jice(R@j3fxUDEe8z0T$&m^gJ6eNO0`ww5j^E$cSPJy#CVvMj
zdfX@YE3cA4x$$+J(>WeS#VXs<%~4G8SzucXz!%6w73_!&=I~pzxCs+I%){txVBem5
z&GNL!tEA%?6tMXuuK?HFSrN!(Z+)I>SD$WS<&?XB%xyt9;y@1^R$_S@V<&bqt)d8h
z_tjTiJneRL&u0fKw_mRB8@o04JNG%q@+9|OdQY7jpBPU(_@@bL?S4Mb6*bHkxntv}
zyOzhEivy(k+VcBxyEdA@t7bvl24c{k)-bhc3ni<k=B~7h+sR*U=efn4CO`HYe<fBS
zGlIFCU2W1ev{6YOfyN>Foj|T#Pcg+d-&0NoSmaSeGtK9UqcQ|>PkZrDmmg=4#~9~P
z6(fK*V^`U$fjp2`=rG?wUztek<^4D=W*NY`N(+9(8{Hs<U#Z1t8NjH;@hdNW`Z&Ne
zcTa||ff>P;>L=e-MPPBMsyEJZik=$|?(+Gwx4fWq&mxqPlO7fqr;n?YQTpYCApUwl
zZIEK0@^r9*AbChw{LR!TC~)gfC54B1E901HT~v$wAy3xI2Uufkh@Td2m%2B+KI)eF
zX1U<YCpm13h}mI%%Y~1ZWJTr8V_S-lgx;$;8*Lt3BLYi+Xy+j(2hkp@B@POXFg(b<
z{pYs^uPP7rYj8bz^`8rururr)<TAIs(K8+c;GZir{I^ysL`k;+u(2iQd!ozoU38Zs
zWpiP@ab9~Pw(a)V1xP&nFHktij@)fB3AnEX<Bj?0GF#~eC8`tl==)o<U%fo<dRdN~
zNC)R4(J5W%)x#Vh4g&t_{<m)Bj-q^JK3zVgF||y|0&6_#)Hdr2HB@=Fdh@Ba`I(~(
zV|&f12A5wUK|)5vQ3UbOE7ra-irJ(5WBwZ|kD%^x)$l19j$g6jgvwDW@LROiUG5M7
zzukq91ehl%t||Q8FNr$;4*+qHWj{D7v7o(77!S{0{*5?JUt>?OiuwO&JKJ#Y_2XB0
z5F1~#6tM9<MSuxm^cG1jon%#g1wfe@0xf?sGxPh!%TfLC#-0{qjnVra(-Cm*EKA-c
z<Mj^+i_=A#{4=^nbGC-lk01Mena&HgxY<Q)fT_F%X^#C8$kE{Zmuw+h&POaRTX}_!
z+?hgoa;F7(miURrnA3u;!UDhX|3kr)C5D-dJA%`_c(mHVG61T(gVUnB?w}gGc_-iD
z&T(;Wd2Q%bU4q?j+e7IXIStEhU$Xg-<q=sWgqE*Ay+U1ih4DNXcmN9iV*0QMWslPe
zZk<oTN&r%P9?dT`3Uind=e&->>alN@;Jouz(@16MZODH>V<x)*OD}S<C*-mhC3}v(
z6_2^UljtE73p4)45zY2^PJ&h>b!Eu!JZ$y=aZo<3zWCv!*q>UCsqV?twi)xzTa;Xf
zD_(77aohTOB)$dVG5M2;N4P|I$K~9hMmzb1kM6%>bg=_Y9TcDyv_WaZ9gqKb`A55+
z`yIDg{>3Xg;B2ufNT6X(YWO1SpVA3@j)RdEOSk4ZtAht@Bv+NDN5~(yg6kw;&k_PJ
z!Y*31=>Tq`gUBT#5tDj+q`4l>|B`rX$QB19T^n9F`L^+`Pt!A^J2Is^*6>7FOKC+9
z+01XBbJ6$#w>G-t(U9XW4B~PNG@q*vHF__1Y{xhHQo0O@k196$&F~0+{ElDS$G+P)
z?uW%NOXe)T_=GUNG3%Aq9sqkRpI984x_34}p7}KdcO!;*F{&bWRDtkvduQ+ZU=Hr$
zd5%Y5r!JM-HH6*v6ccJ+2J_E%l=$DVv-?rHwii$(bXU`nqxGfk&X8rpy}q~G%xQlH
zT};fzsa{W%m6r~XNE`O*`>40~dfJ)zy*828kOPGIboA(m+r$a9w@9bgOc12&A*{Ah
zT#GvOe+6;0^xi!h)Y(*)EG%rego`TW*5Z${E)tsRD2{un^k(lYtQKs<2tUX>1k@)c
zPpECgLQIMFywL&#fn+{)d0+4s-czr`pjGntxSP!Tliym~SBI(&9&5uUGWh>@@y64f
z8e3mZa=(l74fbHFc{|_nD;PPl0ac!(qHL|Id?6;#qsc(c><Rb(v+~M>)}zc|a{^~r
zrm(CQ$E&;k@6bXa?MS`<T|`Ia*1rn>j|`Jy#+b^*N&cc#bHjpL1@Q}JBnUSeQ5#5q
nn;^N@g6Z<#mV5LH0H9#UG-&CMkHn)F9heODP4!B2?Lz+_$x=)B

literal 0
HcmV?d00001

diff --git a/screenshots/tado-device-flow-1.png b/screenshots/tado-device-flow-1.png
new file mode 100644
index 0000000000000000000000000000000000000000..cde471bf69dfbbfdb6c315f28d85a55bfc549cd3
GIT binary patch
literal 23955
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
H`s)7x=_pBp

literal 0
HcmV?d00001

diff --git a/screenshots/tado-device-flow-2.png b/screenshots/tado-device-flow-2.png
new file mode 100644
index 0000000000000000000000000000000000000000..1a38436f856cb2be1f7e95464cdca9456b14112b
GIT binary patch
literal 7724
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

literal 0
HcmV?d00001

diff --git a/src/tadoasync/tadoasync.py b/src/tadoasync/tadoasync.py
index ca60e61..6d56ca4 100644
--- a/src/tadoasync/tadoasync.py
+++ b/src/tadoasync/tadoasync.py
@@ -3,11 +3,14 @@
 from __future__ import annotations
 
 import asyncio
+import enum
+import logging
 import time
 from dataclasses import dataclass
-from datetime import datetime, timezone
+from datetime import datetime, timedelta, timezone
 from importlib import metadata
 from typing import Self
+from urllib.parse import urlencode
 
 import orjson
 from aiohttp import ClientResponseError
@@ -54,10 +57,9 @@
     ZoneState,
 )
 
-CLIENT_ID = "tado-web-app"
-CLIENT_SECRET = "wZaRN7rpjn3FoNyF5IFuxg9uMzYJcvOoQ8QWiIqS3hfk6gLhVlG57j5YNoZL2Rtc"  # noqa: S105
-AUTHORIZATION_BASE_URL = "https://auth.tado.com/oauth/authorize"
-TOKEN_URL = "https://auth.tado.com/oauth/token"  # noqa: S105
+CLIENT_ID = "1bb50063-6b0c-4d11-bd99-387f4a91cc46"
+TOKEN_URL = "https://login.tado.com/oauth2/token"  # noqa: S105
+DEVICE_AUTH_URL = "https://login.tado.com/oauth2/device_authorize"
 API_URL = "my.tado.com/api/v2"
 TADO_HOST_URL = "my.tado.com"
 TADO_API_PATH = "/api/v2"
@@ -66,6 +68,16 @@
 EIQ_API_PATH = "/api"
 VERSION = metadata.version(__package__)
 
+_LOGGER = logging.getLogger(__name__)
+
+
+class DeviceActivationStatus(enum.StrEnum):
+    """Device Activation Status Enum."""
+
+    NOT_STARTED = "NOT_STARTED"
+    PENDING = "PENDING"
+    COMPLETED = "COMPLETED"
+
 
 @dataclass
 class Tado:  # pylint: disable=too-many-instance-attributes
@@ -73,22 +85,11 @@ class Tado:  # pylint: disable=too-many-instance-attributes
 
     def __init__(
         self,
-        username: str,
-        password: str,
         debug: bool | None = None,
         session: ClientSession | None = None,
         request_timeout: int = 10,
     ) -> None:
-        """Initialize the Tado object.
-
-        :param username: Tado account username.
-        :param password: Tado account password.
-        :param debug: Enable debug logging.
-        :param session: HTTP client session.
-        :param request_timeout: Timeout for HTTP requests.
-        """
-        self._username: str = username
-        self._password: str = password
+        """Initialize the Tado object."""
         self._debug: bool = debug or False
         self._session = session
         self._request_timeout = request_timeout
@@ -107,15 +108,151 @@ def __init__(
         self._me: GetMe | None = None
         self._auto_geofencing_supported: bool | None = None
 
+        self._user_code: str | None = None
+        self._device_verification_url: str | None = None
+        self._device_flow_data: dict[str, str] = {}
+        self._device_activation_status = DeviceActivationStatus.NOT_STARTED
+        self._expires_at: datetime | None = None
+
+        _LOGGER.setLevel(logging.DEBUG if debug else logging.INFO)
+
+    async def async_init(self) -> None:
+        """Asynchronous initialization for the Tado object."""
+        if self._refresh_token is None:
+            self._device_activation_status = await self.login_device_flow()
+        else:
+            self._device_ready()
+
+    @property
+    def device_activation_status(self) -> DeviceActivationStatus:
+        """Return the device activation status."""
+        return self._device_activation_status
+
+    @property
+    def device_verification_url(self) -> str | None:
+        """Return the device verification URL."""
+        return self._device_verification_url
+
+    async def login_device_flow(self) -> DeviceActivationStatus:
+        """Login using device flow."""
+        if self._device_activation_status != DeviceActivationStatus.NOT_STARTED:
+            raise TadoError("Device activation already in progress or completed")
+
+        data = {
+            "client_id": CLIENT_ID,
+            "scope": "offline_access",
+        }
+
+        if self._session is None:
+            self._session = ClientSession()
+            self._close_session = True
+
+        try:
+            async with asyncio.timeout(self._request_timeout):
+                request = await self._session.post(url=DEVICE_AUTH_URL, data=data)
+                request.raise_for_status()
+        except asyncio.TimeoutError as err:
+            raise TadoConnectionError(
+                "Timeout occurred while connecting to Tado."
+            ) from err
+        except ClientResponseError as err:
+            await self.check_request_status(err, login=True)
+
+        if request.status != 200:
+            raise TadoError(f"Failed to start device activation flow: {request.status}")
+
+        self._device_flow_data = await request.json()
+
+        user_code = urlencode({"user_code": self._device_flow_data["user_code"]})
+        visit_url = f"{self._device_flow_data['verification_uri']}?{user_code}"
+        self._user_code = self._device_flow_data["user_code"]
+        self._device_verification_url = visit_url
+
+        _LOGGER.info("Please visit the following URL: %s", visit_url)
+
+        expires_in_seconds = float(self._device_flow_data["expires_in"])
+        self._expires_at = datetime.now(timezone.utc) + timedelta(
+            seconds=expires_in_seconds
+        )
+
+        _LOGGER.info(
+            "Waiting for user to authorize the device. Expires at %s",
+            self._expires_at.strftime("%Y-%m-%d %H:%M:%S"),
+        )
+
+        return DeviceActivationStatus.PENDING
+
+    async def _check_device_activation(self) -> bool:
+        if self._expires_at is not None and datetime.timestamp(
+            datetime.now(timezone.utc)
+        ) > datetime.timestamp(self._expires_at):
+            raise TadoError("User took too long to enter key")
+
+        # Await the desired interval, before polling the API again
+        await asyncio.sleep(float(self._device_flow_data["interval"]))
+
+        data = {
+            "client_id": CLIENT_ID,
+            "device_code": self._device_flow_data["device_code"],
+            "grant_type": "urn:ietf:params:oauth:grant-type:device_code",
+        }
+
+        if self._session is None:
+            self._session = ClientSession()
+            self._close_session = True
+
+        try:
+            async with asyncio.timeout(self._request_timeout):
+                request = await self._session.post(url=TOKEN_URL, data=data)
+                if request.status == 400:
+                    response = await request.json()
+                    if response.get("error") == "authorization_pending":
+                        _LOGGER.info("Authorization pending. Continuing polling...")
+                        return False
+                request.raise_for_status()
+        except asyncio.TimeoutError as err:
+            raise TadoConnectionError(
+                "Timeout occurred while connecting to Tado."
+            ) from err
+
+        if request.status == 200:
+            response = await request.json()
+            self._access_token = response["access_token"]
+            self._token_expiry = time.time() + float(response["expires_in"])
+            self._refresh_token = response["refresh_token"]
+
+            get_me = await self.get_me()
+            self._home_id = get_me.homes[0].id
+
+            return True
+
+        raise TadoError(f"Login failed. Reason: {request.reason}")
+
+    async def device_activation(self) -> None:
+        """Start the device activation process and get the refresh token."""
+        if self._device_activation_status == DeviceActivationStatus.NOT_STARTED:
+            raise TadoError(
+                "Device activation has not yet started or has already completed"
+            )
+
+        while True:
+            if await self._check_device_activation():
+                break
+
+        self._device_ready()
+
+    def _device_ready(self) -> None:
+        """Clear up after device activation."""
+        self._user_code = None
+        self._device_verification_url = None
+        self._device_activation_status = DeviceActivationStatus.COMPLETED
+
     async def login(self) -> None:
         """Perform login to Tado."""
         data = {
             "client_id": CLIENT_ID,
-            "client_secret": CLIENT_SECRET,
             "grant_type": "password",
             "scope": "home.user",
-            "username": self._username,
-            "password": self._password,
         }
 
         if self._session is None:
@@ -189,7 +326,6 @@ async def _refresh_auth(self) -> None:
 
         data = {
             "client_id": CLIENT_ID,
-            "client_secret": CLIENT_SECRET,
             "grant_type": "refresh_token",
             "scope": "home.user",
             "refresh_token": self._refresh_token,
@@ -610,7 +746,7 @@ async def close(self) -> None:
 
     async def __aenter__(self) -> Self:
         """Async enter."""
-        await self.login()
+        await self.async_init()
         return self
 
     async def __aexit__(self, *_exc_info: object) -> None:
diff --git a/tests/conftest.py b/tests/conftest.py
index 4d2ae8f..4269fc4 100644
--- a/tests/conftest.py
+++ b/tests/conftest.py
@@ -10,7 +10,7 @@
 from syrupy import SnapshotAssertion
 from tests import load_fixture
 
-from .const import TADO_API_URL, TADO_TOKEN_URL
+from .const import TADO_API_URL, TADO_DEVICE_AUTH_URL, TADO_TOKEN_URL
 from .syrupy import TadoSnapshotExtension
 
 
@@ -24,8 +24,6 @@ def snapshot_assertion(snapshot: SnapshotAssertion) -> SnapshotAssertion:
 async def client() -> AsyncGenerator[Tado, None]:
     """Return a Tado client."""
     async with aiohttp.ClientSession() as session, Tado(
-        username="username",
-        password="password",
         session=session,
         request_timeout=10,
     ) as tado:
@@ -35,6 +33,18 @@ async def client() -> AsyncGenerator[Tado, None]:
 @pytest.fixture(autouse=True)
 def _tado_oauth(responses: aioresponses) -> None:
     """Mock the Tado token URL."""
+    responses.post(
+        TADO_DEVICE_AUTH_URL,
+        status=200,
+        payload={
+            "device_code": "XXX_code_XXX",
+            "expires_in": 300,
+            "interval": 5,
+            "user_code": "7BQ5ZQ",
+            "verification_uri": "https://login.tado.com/oauth2/device",
+            "verification_uri_complete": "https://login.tado.com/oauth2/device?user_code=7BQ5ZQ",
+        },
+    )
     responses.post(
         TADO_TOKEN_URL,
         status=200,
diff --git a/tests/const.py b/tests/const.py
index a1d9d75..dcd74ce 100644
--- a/tests/const.py
+++ b/tests/const.py
@@ -1,6 +1,7 @@
 """Constants for tests of Python Tado."""
 
 TADO_API_URL = "https://my.tado.com/api/v2"
-TADO_TOKEN_URL = "https://auth.tado.com/oauth/token"
+TADO_TOKEN_URL = "https://login.tado.com/oauth2/token"
+TADO_DEVICE_AUTH_URL = "https://login.tado.com/oauth2/device_authorize"
 
 TADO_EIQ_URL = "https://energy-insights.tado.com/api"
diff --git a/tests/test_tado.py b/tests/test_tado.py
index abfd27f..ee5d711 100644
--- a/tests/test_tado.py
+++ b/tests/test_tado.py
@@ -38,7 +38,7 @@ async def test_create_session(
         body=load_fixture("me.json"),
     )
     async with aiohttp.ClientSession():
-        tado = Tado(username="username", password="password")
+        tado = Tado()
         await tado.get_me()
         assert tado._session is not None
         assert not tado._session.closed
@@ -48,7 +48,7 @@ async def test_create_session(
 
 async def test_close_session() -> None:
     """Test not closing the session when the session does not exist."""
-    tado = Tado(username="username", password="password")
+    tado = Tado()
     tado._close_session = True
     await tado.close()
 
@@ -61,7 +61,7 @@ async def test_login_success(responses: aioresponses) -> None:
         body=load_fixture("me.json"),
     )
     async with aiohttp.ClientSession() as session:
-        tado = Tado(username="username", password="password", session=session)
+        tado = Tado(session=session)
         await tado.login()
         assert tado._access_token == "test_access_token"
         assert tado._token_expiry is not None
@@ -77,7 +77,7 @@ async def test_login_success_no_session(responses: aioresponses) -> None:
         body=load_fixture("me.json"),
     )
     async with aiohttp.ClientSession():
-        tado = Tado(username="username", password="password")
+        tado = Tado()
         await tado.login()
         assert tado._access_token == "test_access_token"
         assert tado._token_expiry is not None
@@ -142,7 +142,7 @@ async def test_refresh_auth_success(responses: aioresponses) -> None:
         headers={"content-type": "application/json"},
     )
     async with aiohttp.ClientSession() as session:
-        tado = Tado(username="username", password="password", session=session)
+        tado = Tado(session=session)
         tado._access_token = "old_test_access_token"
         tado._token_expiry = time.time() - 10  # make sure the token is expired
         tado._refresh_token = "old_test_refresh_token"
@@ -603,7 +603,7 @@ async def response_handler(_: str, **_kwargs: Any) -> CallbackResult:  # pylint:
     )
 
     async with aiohttp.ClientSession() as session, Tado(
-        username="username", password="password", request_timeout=0, session=session
+        request_timeout=0, session=session
     ) as tado:
         with pytest.raises(TadoConnectionError):
             assert await tado.get_devices()

From f603dcae316162dfedc817a546dc99a66b341250 Mon Sep 17 00:00:00 2001
From: Erwin Douna <e.douna@gmail.com>
Date: Mon, 25 Aug 2025 13:25:59 +0000
Subject: [PATCH 2/8] Fixing test (incomplete code coverage, yet)

---
 tests/conftest.py  | 1 +
 tests/test_tado.py | 9 +++++----
 2 files changed, 6 insertions(+), 4 deletions(-)

diff --git a/tests/conftest.py b/tests/conftest.py
index 4269fc4..f6e08f6 100644
--- a/tests/conftest.py
+++ b/tests/conftest.py
@@ -27,6 +27,7 @@ async def client() -> AsyncGenerator[Tado, None]:
         session=session,
         request_timeout=10,
     ) as tado:
+        await tado.login()
         yield tado
 
 
diff --git a/tests/test_tado.py b/tests/test_tado.py
index ee5d711..a243217 100644
--- a/tests/test_tado.py
+++ b/tests/test_tado.py
@@ -602,8 +602,9 @@ async def response_handler(_: str, **_kwargs: Any) -> CallbackResult:  # pylint:
         callback=response_handler,
     )
 
-    async with aiohttp.ClientSession() as session, Tado(
-        request_timeout=0, session=session
-    ) as tado:
+    async with aiohttp.ClientSession() as session:
+        tado = Tado(session=session, request_timeout=0)
+        await tado.login()
         with pytest.raises(TadoConnectionError):
-            assert await tado.get_devices()
+            await tado.get_devices()
+        await tado.close()

From f2bcfe84fd8fbf599327154e8509c81d3f50b062 Mon Sep 17 00:00:00 2001
From: Erwin Douna <e.douna@gmail.com>
Date: Mon, 25 Aug 2025 14:05:16 +0000
Subject: [PATCH 3/8] Add refresh token and expand tests

---
 src/tadoasync/tadoasync.py |  3 ++-
 tests/test_tado.py         | 16 ++++++++++++++++
 2 files changed, 18 insertions(+), 1 deletion(-)

diff --git a/src/tadoasync/tadoasync.py b/src/tadoasync/tadoasync.py
index 6d56ca4..c46d90e 100644
--- a/src/tadoasync/tadoasync.py
+++ b/src/tadoasync/tadoasync.py
@@ -85,11 +85,13 @@ class Tado:  # pylint: disable=too-many-instance-attributes
 
     def __init__(
         self,
+        refresh_token: str | None = None,
         debug: bool | None = None,
         session: ClientSession | None = None,
         request_timeout: int = 10,
     ) -> None:
         """Initialize the Tado object."""
+        self._refresh_token = refresh_token
         self._debug: bool = debug or False
         self._session = session
         self._request_timeout = request_timeout
@@ -102,7 +104,6 @@ def __init__(
 
         self._access_token: str | None = None
         self._token_expiry: float | None = None
-        self._refresh_token: str | None = None
         self._access_headers: dict[str, str] | None = None
         self._home_id: int | None = None
         self._me: GetMe | None = None
diff --git a/tests/test_tado.py b/tests/test_tado.py
index a243217..58b5be7 100644
--- a/tests/test_tado.py
+++ b/tests/test_tado.py
@@ -21,6 +21,7 @@
     TadoError,
     TadoReadingError,
 )
+from tadoasync.tadoasync import DeviceActivationStatus
 
 from syrupy import SnapshotAssertion
 from tests import load_fixture
@@ -209,6 +210,10 @@ async def test_get_devices(
         body=load_fixture("devices.json"),
     )
     assert await python_tado.get_devices() == snapshot
+    assert (
+        python_tado.device_verification_url
+        == "https://login.tado.com/oauth2/device?user_code=7BQ5ZQ"
+    )
 
 
 async def test_get_mobile_devices(
@@ -608,3 +613,14 @@ async def response_handler(_: str, **_kwargs: Any) -> CallbackResult:  # pylint:
         with pytest.raises(TadoConnectionError):
             await tado.get_devices()
         await tado.close()
+
+
+async def test_async_init_with_refresh_token() -> None:
+    """Cover where refresh token exists and _device_ready is invoked."""
+    tado = Tado()
+    tado._refresh_token = "existing"
+
+    # Ensure device_activation_status starts NOT_STARTED
+    assert tado.device_activation_status == DeviceActivationStatus.NOT_STARTED
+    await tado.async_init()
+    assert tado.device_activation_status == DeviceActivationStatus.COMPLETED

From e5fdc18fcc478edd3710241b9b5c301388dc7c79 Mon Sep 17 00:00:00 2001
From: Erwin Douna <e.douna@gmail.com>
Date: Mon, 25 Aug 2025 14:25:47 +0000
Subject: [PATCH 4/8] Add test for already in progress

---
 tests/test_tado.py | 10 ++++++++++
 1 file changed, 10 insertions(+)

diff --git a/tests/test_tado.py b/tests/test_tado.py
index 58b5be7..7eaee0e 100644
--- a/tests/test_tado.py
+++ b/tests/test_tado.py
@@ -624,3 +624,13 @@ async def test_async_init_with_refresh_token() -> None:
     assert tado.device_activation_status == DeviceActivationStatus.NOT_STARTED
     await tado.async_init()
     assert tado.device_activation_status == DeviceActivationStatus.COMPLETED
+
+
+async def test_login_device_flow_already_in_progress() -> None:
+    """Ensure calling login_device_flow again raises TadoError."""
+    tado = Tado()
+    tado._device_activation_status = DeviceActivationStatus.PENDING
+    with pytest.raises(
+        TadoError, match="Device activation already in progress or completed"
+    ):
+        await tado.login_device_flow()

From baa9440cd18249ba086a3d988bca971f08090c09 Mon Sep 17 00:00:00 2001
From: Erwin Douna <e.douna@gmail.com>
Date: Mon, 25 Aug 2025 16:47:24 +0000
Subject: [PATCH 5/8] Update to extra

---
 .devcontainer/devcontainer.json | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/.devcontainer/devcontainer.json b/.devcontainer/devcontainer.json
index 41f8f67..b5e06d8 100644
--- a/.devcontainer/devcontainer.json
+++ b/.devcontainer/devcontainer.json
@@ -52,7 +52,7 @@
     }
   },
   "features": {
-    "ghcr.io/devcontainers-contrib/features/poetry:2": {},
+    "ghcr.io/devcontainers-extra/features/poetry:2": {},
     "ghcr.io/devcontainers/features/github-cli:1": {},
     "ghcr.io/devcontainers/features/node:1": {},
     "ghcr.io/devcontainers/features/python:1": {

From fc798f6e9017492b4481c2dcb24310dec75ada71 Mon Sep 17 00:00:00 2001
From: Erwin Douna <e.douna@gmail.com>
Date: Mon, 25 Aug 2025 16:53:57 +0000
Subject: [PATCH 6/8] Add launch.json

---
 .devcontainer/launch.json | 17 +++++++++++++++++
 .gitignore                |  3 ---
 .vscode/launch.json       | 17 +++++++++++++++++
 3 files changed, 34 insertions(+), 3 deletions(-)
 create mode 100644 .devcontainer/launch.json
 create mode 100644 .vscode/launch.json

diff --git a/.devcontainer/launch.json b/.devcontainer/launch.json
new file mode 100644
index 0000000..21c880d
--- /dev/null
+++ b/.devcontainer/launch.json
@@ -0,0 +1,17 @@
+{
+  "version": "0.2.0",
+  "configurations": [
+    {
+      "name": "Run example.py",
+      "type": "python",
+      "request": "launch",
+      "program": "${workspaceFolder}/examples/example.py",
+      "console": "integratedTerminal",
+      "justMyCode": true,
+      "env": {
+        "PYTHONPATH": "${workspaceFolder}/src"
+      },
+      "envFile": "${workspaceFolder}/.env"
+    }
+  ]
+}
diff --git a/.gitignore b/.gitignore
index 12ea934..d3db5ec 100644
--- a/.gitignore
+++ b/.gitignore
@@ -94,9 +94,6 @@ ENV/
 # ruff
 .ruff_cache
 
-# Visual Studio Code
-.vscode
-
 # IntelliJ Idea family of suites
 .idea
 *.iml
diff --git a/.vscode/launch.json b/.vscode/launch.json
new file mode 100644
index 0000000..ad1df69
--- /dev/null
+++ b/.vscode/launch.json
@@ -0,0 +1,17 @@
+{
+  "version": "0.2.0",
+  "configurations": [
+    {
+      "name": "Run tadoasync example.py",
+      "type": "debugpy",
+      "request": "launch",
+      "program": "${workspaceFolder}/examples/example.py",
+      "console": "integratedTerminal",
+      "justMyCode": true,
+      "env": {
+        "PYTHONPATH": "${workspaceFolder}/src"
+      },
+      "envFile": "${workspaceFolder}/.env"
+    }
+  ]
+}

From 50c9de3e205b0601c6c8d1037d02f51a4e374f08 Mon Sep 17 00:00:00 2001
From: Erwin Douna <e.douna@gmail.com>
Date: Mon, 25 Aug 2025 20:36:38 +0000
Subject: [PATCH 7/8] Enhancing tests

---
 poetry.lock                |  15 ++---
 pyproject.toml             |   2 +-
 src/tadoasync/tadoasync.py |  42 +++++++++----
 tests/conftest.py          |   4 +-
 tests/test_tado.py         | 123 ++++++++++++++++++++++++++++++-------
 5 files changed, 142 insertions(+), 44 deletions(-)

diff --git a/poetry.lock b/poetry.lock
index 0298591..de6aef4 100644
--- a/poetry.lock
+++ b/poetry.lock
@@ -1,4 +1,4 @@
-# This file is automatically @generated by Poetry 2.1.1 and should not be changed by hand.
+# This file is automatically @generated by Poetry 2.1.4 and should not be changed by hand.
 
 [[package]]
 name = "aiohappyeyeballs"
@@ -126,18 +126,19 @@ speedups = ["Brotli ; platform_python_implementation == \"CPython\"", "aiodns (>
 
 [[package]]
 name = "aioresponses"
-version = "0.7.6"
+version = "0.7.8"
 description = "Mock out requests made by ClientSession from aiohttp package"
 optional = false
 python-versions = "*"
 groups = ["main"]
 files = [
-    {file = "aioresponses-0.7.6-py2.py3-none-any.whl", hash = "sha256:d2c26defbb9b440ea2685ec132e90700907fd10bcca3e85ec2f157219f0d26f7"},
-    {file = "aioresponses-0.7.6.tar.gz", hash = "sha256:f795d9dbda2d61774840e7e32f5366f45752d1adc1b74c9362afd017296c7ee1"},
+    {file = "aioresponses-0.7.8-py2.py3-none-any.whl", hash = "sha256:b73bd4400d978855e55004b23a3a84cb0f018183bcf066a85ad392800b5b9a94"},
+    {file = "aioresponses-0.7.8.tar.gz", hash = "sha256:b861cdfe5dc58f3b8afac7b0a6973d5d7b2cb608dd0f6253d16b8ee8eaf6df11"},
 ]
 
 [package.dependencies]
 aiohttp = ">=3.3.0,<4.0.0"
+packaging = ">=22.0"
 
 [[package]]
 name = "aiosignal"
@@ -1278,7 +1279,7 @@ version = "24.1"
 description = "Core utilities for Python packages"
 optional = false
 python-versions = ">=3.8"
-groups = ["dev"]
+groups = ["main", "dev"]
 files = [
     {file = "packaging-24.1-py3-none-any.whl", hash = "sha256:5b8f2217dbdbd2f7f384c41c628544e6d52f2d0f53c6d0c3ea61aa5d1d7ff124"},
     {file = "packaging-24.1.tar.gz", hash = "sha256:026ed72c8ed3fcce5bf8950572258698927fd1dbda10a5e981cdf0ac37f4f002"},
@@ -1773,7 +1774,7 @@ description = "C version of reader, parser and emitter for ruamel.yaml derived f
 optional = false
 python-versions = ">=3.9"
 groups = ["dev"]
-markers = "platform_python_implementation == \"CPython\" and python_version < \"3.13\""
+markers = "platform_python_implementation == \"CPython\" and python_version == \"3.12\""
 files = [
     {file = "ruamel.yaml.clib-0.2.12-cp310-cp310-macosx_13_0_arm64.whl", hash = "sha256:11f891336688faf5156a36293a9c362bdc7c88f03a8a027c2c1d8e0bcde998e5"},
     {file = "ruamel.yaml.clib-0.2.12-cp310-cp310-manylinux2014_aarch64.whl", hash = "sha256:a606ef75a60ecf3d924613892cc603b154178ee25abb3055db5062da811fd969"},
@@ -2151,4 +2152,4 @@ propcache = ">=0.2.0"
 [metadata]
 lock-version = "2.1"
 python-versions = "^3.12"
-content-hash = "6c31074ce3998cda67a718a5563fd929decef11f765b9961d767e15178f4b4fe"
+content-hash = "5703f1c01a14f2b2b31738201ec60baf947a3910cbab01a76cddccc80327176b"
diff --git a/pyproject.toml b/pyproject.toml
index b9630ed..bb46b30 100644
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -26,7 +26,7 @@ mashumaro = ">=3.10"
 orjson = ">=3.9.8"
 python = "^3.12"
 yarl = ">=1.6.0"
-aioresponses = "^0.7.6"
+aioresponses = "^0.7.7"
 
 [tool.poetry.urls]
 "Bug Tracker" = "https://github.com/erwindouna/python-tado/issues"
diff --git a/src/tadoasync/tadoasync.py b/src/tadoasync/tadoasync.py
index c46d90e..a20089f 100644
--- a/src/tadoasync/tadoasync.py
+++ b/src/tadoasync/tadoasync.py
@@ -144,13 +144,10 @@ async def login_device_flow(self) -> DeviceActivationStatus:
             "scope": "offline_access",
         }
 
-        if self._session is None:
-            self._session = ClientSession()
-            self._close_session = True
-
         try:
             async with asyncio.timeout(self._request_timeout):
-                request = await self._session.post(url=DEVICE_AUTH_URL, data=data)
+                session = self._ensure_session()
+                request = await session.post(url=DEVICE_AUTH_URL, data=data)
                 request.raise_for_status()
         except asyncio.TimeoutError as err:
             raise TadoConnectionError(
@@ -159,6 +156,15 @@ async def login_device_flow(self) -> DeviceActivationStatus:
         except ClientResponseError as err:
             await self.check_request_status(err, login=True)
 
+        content_type = request.headers.get("content-type")
+        if content_type and "application/json" not in content_type:
+            text = await request.text()
+            raise TadoError(
+                "Unexpected response from Tado. Content-Type: "
+                f"{request.headers.get('content-type')}, "
+                f"Response body: {text}"
+            )
+
         if request.status != 200:
             raise TadoError(f"Failed to start device activation flow: {request.status}")
 
@@ -198,13 +204,10 @@ async def _check_device_activation(self) -> bool:
             "grant_type": "urn:ietf:params:oauth:grant-type:device_code",
         }
 
-        if self._session is None:
-            self._session = ClientSession()
-            self._close_session = True
-
         try:
             async with asyncio.timeout(self._request_timeout):
-                request = await self._session.post(url=TOKEN_URL, data=data)
+                session = self._ensure_session()
+                request = await session.post(url=TOKEN_URL, data=data)
                 if request.status == 400:
                     response = await request.json()
                     if response.get("error") == "authorization_pending":
@@ -216,6 +219,15 @@ async def _check_device_activation(self) -> bool:
                 "Timeout occurred while connecting to Tado."
             ) from err
 
+        content_type = request.headers.get("content-type")
+        if content_type and "application/json" not in content_type:
+            text = await request.text()
+            raise TadoError(
+                "Unexpected response from Tado. Content-Type: "
+                f"{request.headers.get('content-type')}, "
+                f"Response body: {text}"
+            )
+
         if request.status == 200:
             response = await request.json()
             self._access_token = response["access_token"]
@@ -565,7 +577,8 @@ async def _request(
 
         try:
             async with asyncio.timeout(self._request_timeout):
-                request = await self._session.request(  # type: ignore[union-attr]
+                session = self._ensure_session()
+                request = await session.request(
                     method=method.value, url=str(url), headers=headers, json=data
                 )
                 request.raise_for_status()
@@ -745,6 +758,13 @@ async def close(self) -> None:
         if self._session and self._close_session:
             await self._session.close()
 
+    def _ensure_session(self) -> ClientSession:
+        """Return an active aiohttp ClientSession, creating one if needed."""
+        if self._session is None or self._session.closed:
+            self._session = ClientSession()
+            self._close_session = True
+        return self._session
+
     async def __aenter__(self) -> Self:
         """Async enter."""
         await self.async_init()
diff --git a/tests/conftest.py b/tests/conftest.py
index f6e08f6..13fefae 100644
--- a/tests/conftest.py
+++ b/tests/conftest.py
@@ -27,7 +27,7 @@ async def client() -> AsyncGenerator[Tado, None]:
         session=session,
         request_timeout=10,
     ) as tado:
-        await tado.login()
+        await tado.device_activation()
         yield tado
 
 
@@ -40,7 +40,7 @@ def _tado_oauth(responses: aioresponses) -> None:
         payload={
             "device_code": "XXX_code_XXX",
             "expires_in": 300,
-            "interval": 5,
+            "interval": 0,
             "user_code": "7BQ5ZQ",
             "verification_uri": "https://login.tado.com/oauth2/device",
             "verification_uri_complete": "https://login.tado.com/oauth2/device?user_code=7BQ5ZQ",
diff --git a/tests/test_tado.py b/tests/test_tado.py
index 7eaee0e..d77d3e3 100644
--- a/tests/test_tado.py
+++ b/tests/test_tado.py
@@ -3,7 +3,7 @@
 import asyncio
 import os
 import time
-from datetime import datetime, timezone
+from datetime import datetime, timedelta, timezone
 from typing import Any
 from unittest.mock import AsyncMock, MagicMock, patch
 
@@ -21,7 +21,7 @@
     TadoError,
     TadoReadingError,
 )
-from tadoasync.tadoasync import DeviceActivationStatus
+from tadoasync.tadoasync import DEVICE_AUTH_URL, DeviceActivationStatus
 
 from syrupy import SnapshotAssertion
 from tests import load_fixture
@@ -63,7 +63,8 @@ async def test_login_success(responses: aioresponses) -> None:
     )
     async with aiohttp.ClientSession() as session:
         tado = Tado(session=session)
-        await tado.login()
+        await tado.async_init()
+        await tado.device_activation()
         assert tado._access_token == "test_access_token"
         assert tado._token_expiry is not None
         assert tado._token_expiry > time.time()
@@ -79,39 +80,94 @@ async def test_login_success_no_session(responses: aioresponses) -> None:
     )
     async with aiohttp.ClientSession():
         tado = Tado()
-        await tado.login()
+        await tado.async_init()
+        await tado.device_activation()
         assert tado._access_token == "test_access_token"
         assert tado._token_expiry is not None
         assert tado._token_expiry > time.time()
         assert tado._refresh_token == "test_refresh_token"
 
 
-async def test_login_timeout(python_tado: Tado, responses: aioresponses) -> None:
-    """Test login timeout."""
+async def test_activation_timeout(responses: aioresponses) -> None:
+    """Test activation timeout."""
+    responses.post(
+        DEVICE_AUTH_URL,
+        status=200,
+        payload={
+            "device_code": "XXX_code_XXX",
+            "expires_in": 1,
+            "interval": 0,
+            "user_code": "7BQ5ZQ",
+            "verification_uri": "https://login.tado.com/oauth2/device",
+            "verification_uri_complete": "https://login.tado.com/oauth2/device?user_code=7BQ5ZQ",
+        },
+    )
     responses.post(
         TADO_TOKEN_URL,
+        status=400,
+        payload={"error": "authorization_pending"},
+    )
+
+    async with aiohttp.ClientSession() as session:
+        tado = Tado(session=session)
+        await tado.async_init()
+        tado._expires_at = datetime.now(timezone.utc) - timedelta(seconds=1)
+        with pytest.raises(TadoError, match="User took too long"):
+            await tado.device_activation()
+
+
+async def test_login_device_flow_timeout(responses: aioresponses) -> None:
+    """Test timeout during device auth flow."""
+    responses._matches.clear()
+    responses.post(
+        DEVICE_AUTH_URL,
         exception=asyncio.TimeoutError(),
+        repeat=True,
     )
-    with pytest.raises(TadoConnectionError):
-        await python_tado.login()
 
+    async with aiohttp.ClientSession() as session:
+        tado = Tado(session=session)
+        with pytest.raises(TadoConnectionError):
+            await tado.async_init()
 
-async def test_login_invalid_content_type(
-    python_tado: Tado, responses: aioresponses
-) -> None:
+
+async def test_login_invalid_content_type(responses: aioresponses) -> None:
     """Test login invalid content type."""
+    responses._matches.clear()
     responses.post(
-        TADO_TOKEN_URL,
+        DEVICE_AUTH_URL,
         status=200,
         headers={"content-type": "text/plain"},
         body="Unexpected response",
     )
 
-    with pytest.raises(TadoError):
-        await python_tado.login()
+    async with aiohttp.ClientSession() as session:
+        tado = Tado(session=session)
+        with pytest.raises(TadoError):
+            await tado.async_init()
+
+
+async def test_login_invalid_status() -> None:
+    """Test login with non-200 status triggers."""
+    mock_response = MagicMock(spec=ClientResponse)
+    mock_response.status = 400
+    mock_response.headers = {"content-type": "application/json"}
+    mock_response.raise_for_status = MagicMock(return_value=None)
+    mock_response.json = AsyncMock(return_value={"error": "bad_request"})
+    mock_response.text = AsyncMock(return_value="Unexpected response")
+
+    async def mock_post(*args: Any, **kwargs: Any) -> ClientResponse:  # noqa: ARG001 # pylint: disable=unused-argument
+        return mock_response
+
+    async with aiohttp.ClientSession() as session:
+        tado = Tado(session=session)
+        with patch("aiohttp.ClientSession.post", new=mock_post), pytest.raises(
+            TadoError
+        ):
+            await tado.async_init()
 
 
-async def test_login_client_response_error(python_tado: Tado) -> None:
+async def test_login_client_response_error() -> None:
     """Test login client response error."""
     mock_request_info = MagicMock(spec=RequestInfo)
     mock_response = MagicMock(spec=ClientResponse)
@@ -124,10 +180,12 @@ async def test_login_client_response_error(python_tado: Tado) -> None:
     async def mock_post(*args: Any, **kwargs: Any) -> ClientResponse:  # noqa: ARG001 # pylint: disable=unused-argument
         return mock_response
 
-    with patch("aiohttp.ClientSession.post", new=mock_post), pytest.raises(
-        TadoAuthenticationError
-    ):
-        await python_tado.login()
+    async with aiohttp.ClientSession() as session:
+        tado = Tado(session=session)
+        with patch("aiohttp.ClientSession.post", new=mock_post), pytest.raises(
+            TadoAuthenticationError
+        ):
+            await tado.async_init()
 
 
 async def test_refresh_auth_success(responses: aioresponses) -> None:
@@ -188,6 +246,29 @@ async def mock_post(*args: Any, **kwargs: Any) -> ClientResponse:  # noqa: ARG00
             await python_tado._refresh_auth()
 
 
+async def test_device_flow_sets_verification_url(responses: aioresponses) -> None:
+    """Test device flow sets verification URL."""
+    responses.post(
+        DEVICE_AUTH_URL,
+        status=200,
+        payload={
+            "device_code": "XXX",
+            "expires_in": 600,
+            "interval": 0,
+            "user_code": "7BQ5ZQ",
+            "verification_uri": "https://login.tado.com/oauth2/device",
+        },
+    )
+
+    async with aiohttp.ClientSession() as session:
+        tado = Tado(session=session)
+        await tado.login_device_flow()
+        assert (
+            tado.device_verification_url
+            == "https://login.tado.com/oauth2/device?user_code=7BQ5ZQ"
+        )
+
+
 async def test_get_me(
     python_tado: Tado, responses: aioresponses, snapshot: SnapshotAssertion
 ) -> None:
@@ -210,10 +291,6 @@ async def test_get_devices(
         body=load_fixture("devices.json"),
     )
     assert await python_tado.get_devices() == snapshot
-    assert (
-        python_tado.device_verification_url
-        == "https://login.tado.com/oauth2/device?user_code=7BQ5ZQ"
-    )
 
 
 async def test_get_mobile_devices(

From d936b106924d394b298fba0156372a3f8d2eacfa Mon Sep 17 00:00:00 2001
From: Erwin Douna <e.douna@gmail.com>
Date: Mon, 25 Aug 2025 21:20:39 +0000
Subject: [PATCH 8/8] Expand example to demonstrate refresh token works

---
 examples/example.py        | 15 +++++++++++++++
 src/tadoasync/tadoasync.py | 17 ++++++++++++-----
 tests/test_tado.py         | 21 +++++++++++++++++++++
 3 files changed, 48 insertions(+), 5 deletions(-)

diff --git a/examples/example.py b/examples/example.py
index b0a6b11..69d7a1b 100644
--- a/examples/example.py
+++ b/examples/example.py
@@ -1,5 +1,7 @@
 """Asynchronous Python client for the Tado API. This is an example file."""
 
+from __future__ import annotations
+
 import asyncio
 import logging
 
@@ -10,13 +12,26 @@
 
 async def main() -> None:
     """Show example on how to use aiohttp.ClientSession."""
+    refresh_token: str | None = None
     async with Tado(debug=True) as tado:
         print("Device activation status: ", tado.device_activation_status)  # noqa: T201
         print("Device verification URL: ", tado.device_verification_url)  # noqa: T201
 
         print("Starting device activation")  # noqa: T201
         await tado.device_activation()
+        refresh_token = tado.refresh_token
+
+        print("Device activation status: ", tado.device_activation_status)  # noqa: T201
+
+        devices = await tado.get_devices()
+
+        print("Devices: ", devices)  # noqa: T201
+
+    print("Trying to use the stored refresh token for another run...")  # noqa: T201
+    await asyncio.sleep(1)
 
+    async with Tado(debug=True, refresh_token=refresh_token) as tado:
+        print("Refresh token: ", tado.refresh_token)  # noqa: T201
         print("Device activation status: ", tado.device_activation_status)  # noqa: T201
 
         devices = await tado.get_devices()
diff --git a/src/tadoasync/tadoasync.py b/src/tadoasync/tadoasync.py
index a20089f..b373514 100644
--- a/src/tadoasync/tadoasync.py
+++ b/src/tadoasync/tadoasync.py
@@ -123,6 +123,8 @@ async def async_init(self) -> None:
             self._device_activation_status = await self.login_device_flow()
         else:
             self._device_ready()
+            get_me = await self.get_me()
+            self._home_id = get_me.homes[0].id
 
     @property
     def device_activation_status(self) -> DeviceActivationStatus:
@@ -134,6 +136,11 @@ def device_verification_url(self) -> str | None:
         """Return the device verification URL."""
         return self._device_verification_url
 
+    @property
+    def refresh_token(self) -> str | None:
+        """Return the refresh token."""
+        return self._refresh_token
+
     async def login_device_flow(self) -> DeviceActivationStatus:
         """Login using device flow."""
         if self._device_activation_status != DeviceActivationStatus.NOT_STARTED:
@@ -340,17 +347,15 @@ async def _refresh_auth(self) -> None:
         data = {
             "client_id": CLIENT_ID,
             "grant_type": "refresh_token",
-            "scope": "home.user",
             "refresh_token": self._refresh_token,
         }
 
-        if self._session is None:
-            self._session = ClientSession()
-            self._close_session = True
+        _LOGGER.debug("Refreshing Tado token")
 
         try:
             async with asyncio.timeout(self._request_timeout):
-                request = await self._session.post(url=TOKEN_URL, data=data)
+                session = self._ensure_session()
+                request = await session.post(url=TOKEN_URL, data=data)
                 request.raise_for_status()
         except asyncio.TimeoutError as err:
             raise TadoConnectionError(
@@ -364,6 +369,8 @@ async def _refresh_auth(self) -> None:
         self._token_expiry = time.time() + float(response["expires_in"])
         self._refresh_token = response["refresh_token"]
 
+        _LOGGER.debug("Tado token refreshed")
+
     async def get_me(self) -> GetMe:
         """Get the user information."""
         if self._me is None:
diff --git a/tests/test_tado.py b/tests/test_tado.py
index d77d3e3..11640ad 100644
--- a/tests/test_tado.py
+++ b/tests/test_tado.py
@@ -188,6 +188,27 @@ async def mock_post(*args: Any, **kwargs: Any) -> ClientResponse:  # noqa: ARG00
             await tado.async_init()
 
 
+async def test_login_client_response_still_pending() -> None:
+    """Test login client response error."""
+    mock_request_info = MagicMock(spec=RequestInfo)
+    mock_response = MagicMock(spec=ClientResponse)
+    mock_response.raise_for_status.side_effect = ClientResponseError(
+        mock_request_info, (mock_response,), status=400
+    )
+    mock_response.status = 400
+    mock_response.text = AsyncMock(return_value="authorization_pending")
+
+    async def mock_post(*args: Any, **kwargs: Any) -> ClientResponse:  # noqa: ARG001 # pylint: disable=unused-argument
+        return mock_response
+
+    async with aiohttp.ClientSession() as session:
+        tado = Tado(session=session)
+        with patch("aiohttp.ClientSession.post", new=mock_post), pytest.raises(
+            TadoAuthenticationError
+        ):
+            await tado.async_init()
+
+
 async def test_refresh_auth_success(responses: aioresponses) -> None:
     """Test successful refresh of auth token."""
     responses.post(