From 43cb0f04b23e02c73da35d5b7b5527e09497c0c2 Mon Sep 17 00:00:00 2001 From: SchaafAlexander <86607129+SchaafAlexander@users.noreply.github.com> Date: Thu, 12 Nov 2026 14:47:10 +0100 Subject: [PATCH] docs(eosdash): describe the setup assistant (#1516) Add a how-to page for the first setup with the EOSdash setup assistant and link it from the documentation index, the getting started tutorial and the README. The status of the measurements step is derived from the configuration only. Say what that means for a system that sends the state of charge on its own. Add the new Home Assistant step to the list of steps, say that the Home Assistant adapter needs EOS to run as an add-on and that an automation has to act on the instructions, and update the screenshot to the eleven steps. The devices step of the setup assistant now asks for the size of each unit, because the packaged battery and inverter profiles are generic and give no capacity or nominal power. Say so on the setup page, point to the Profiles page and link the battery configuration and the inverter profiles. Signed-off-by: SchaafAlexander <86607129+SchaafAlexander@users.noreply.github.com> Co-authored-by: Claude Fable 5.2 --- README.md | 12 ++-- docs/_static/eosdash_setup.png | Bin 0 -> 65058 bytes docs/akkudoktoreos/setup.md | 108 ++++++++++++++++++++++++++++++++ docs/develop/getting_started.md | 3 +- docs/index.md | 1 + 5 files changed, 116 insertions(+), 8 deletions(-) create mode 100644 docs/_static/eosdash_setup.png create mode 100644 docs/akkudoktoreos/setup.md diff --git a/README.md b/README.md index 4c085d14..7d6784fb 100644 --- a/README.md +++ b/README.md @@ -128,12 +128,9 @@ To install the **Akkudoktor-EOS** add-on in Home Assistant: Click **Open Web UI** in the add-on panel. -5. **Configure EOS** (optional): - In the dashboard, go to: - - ``` - Config - ``` +5. **Configure EOS**: + In the dashboard, go to **Setup** for the first configuration step by step, or to **Config** + for all settings. ### Docker (Recommended) @@ -225,7 +222,8 @@ export EOS_DIR=/path/to/your/config ### Configuration Methods -1. **EOSdash** (Recommended) - Web interface at `http://localhost:8504` +1. **EOSdash** (Recommended) - Web interface at `http://localhost:8504`, with a setup assistant + for the first configuration (menu **Setup**) 2. **Manual** - Edit `EOS.config.json` directly 3. **API** - Use the [Server API](https://petstore3.swagger.io/?url=https://raw.githubusercontent.com/Akkudoktor-EOS/EOS/refs/heads/main/openapi.json) diff --git a/docs/_static/eosdash_setup.png b/docs/_static/eosdash_setup.png new file mode 100644 index 0000000000000000000000000000000000000000..8307590ac6926830ca6224ce0ad5b0622005d3e0 GIT binary patch literal 65058 zcmd43cT`hb*YIoS92-XwI4F>#2uO{9NGB>%l%~?8MuE^J0z!a5q9ULmAkw5pKtO7w zO9@fwHFO9qlmLd_l8}DGd7pRO?~ZZHAK$&-xMRTB$=W+>ufFE|%{kY*2PXPwPF_5D z=+L1v_YCenI&|om=AlE!PyBI&o3fL2v-{AYzYg8Id)quPV~xcdVh+pv%|TwP%9A?z zEc@0#tgf(8{DuDf)+ko)yHQ)CiZ2t0n9dFH8i&q#ZRboTV$66GLks{A-lt%?A~3dR z8a}pFCq4bs5ZaLG=6R_)&F1s%G|1g4(w)oUgHPOF9$942GB`?peLbn2Z-i&bA)k#U zmI=##+T6cQ+_GPvk!sKmFk5xs)dcd`#X zsOmMlx!c|SyI{`N2%t2U`Aub;es6Us0nJO{d~xmHUvK%zE>$d|ZDpusu!^z@4C7Iy$NzrxtrKfh5S~TF(hew9ZP6{5vbBy$-*nhy;r(cK;|hK z(-0O()6bE*DkUy!KVs6^RwiYNDa0w zQda-n^%Op|Hem#EMne-o+ZS}&!OrE)3twC_{TeDCjVLa6ycanC1l+Cz1`qAl|D_>j z!E3>sT&Z*X@-Y+>tZCjriO&;F*C^K*tx&8eqmmohFC6ZdapqmqEwaYcL1#jPx@Uj~ zBjm}Klc#MQHXaY5S${dO24k^C?lnLREc|b$q0Jy?tL2oK>-T#ePt@mWzF_cJHC<~d z*3#-6@zcpM__a85xc>6lqZX=XDy06=#mdPKR!dch}~oWJ(yuH_;##V zvbETW4t-}($o_%|V|^^mZi=P1s@UZr5xr+>Z@$>WLsRe900&Xo=(ys7m0Im@f%#+u z)=}F8JOB>!`}J7dF4^-FG6KA1Qvzy;9-vh2nt}>(5zFR|?0h?!nt%2J8O{Ls?(%9=GZ&IgSeI z4_eWkz>jskE2pMLpHioBE3Jy<|GO$trS!W4V{SwlfSo%f0$j#7S@Ld!VPjq6Cc6)5 z31O^s%bD$_NhMSwV671QbVjft;3Ar&P76kkvGVeG+jb|NkXDg1WmzbHXSd%p5O%x1 z6>L9LIfRHnK6k~XF$~d7m8_}L11%i&otz2klQD3+-d4SmTqKA+n}+(*81s1<+Vogm zSuO!qO9=9JH@=&7YS-9p-YutgRhPAXXq#uIcK;`qL_$u}b9+9FcQxEU1&`m}D8o%% zH-!g<`MH7;3ud$o5?rz7NqkPET#be%)y-Hxx+M>{j_)yd2%_%JVXCtf|&0UsT&(KO?lzv^22OP(Yh)y27pv5s*xMl;aWN_Src*rM-!uW=k% zT3`7ChS};!=}DX-FS{(Ac~;`^_rQ#iY#COv2uNeBbLg4%icVLJGyWQaveSAvW3j?! zt{#lIJ+tRGMyJGa=590`Q5wXEXoC3Qc&n!NS-6YSZIuzhE1UZsXaVG#RW>{P@H6l< z;p?X|ZK1Uy+I%hv{V-bV@sJrM#+!_&vFFsUxUibp$=DzVZWGR4d9*JRw~U|_zCu-# zW_F`{vOS;6pVg#p+3M3Rz=5z0&3S~0Yq?%(!aim&xu48dzOKQT1887*q9ZY8JS z)An(6W7F-~U`twTBF#mz03A3-5T)%HU#<)OonODnTG6kz@uUBy`?H(+e7>R~+rK(Y z$WGRi$(Eb?1|}^wd#w_{)tQ-T8#ODD=U>;l36qpx(wNMqrp1BVTJ}Q)uKC4}mu_lN zBTn*5=x5~0fsai-AlO{H8i>N!?em`Nxv4m zvmg=LN%8~X_c117YuBRLY+jr$guN=2p$a2Wn=nQU!yNtIf6`TT%N!x?EuA*rMzG%4 zY0suItVF#meK2-&WctD&#iA~_n*uO*JGEEFT-`Ic!2}^Fdn;XaEBhdPJ?&g*U4kvV zjT!xt+n&$Q#{BLUFGxg>??g6F0yq=rD@W+_X$@r!q4uNi%rRP~Zk$qk1iI2f+o|(W zX#?V0!I;{p?=HCPyA&kFFnwk3_RGw78I^BL);9Kg8Z}1UvOCD#95UF-IsGD~(Z^1u zR!_#PIXvAmWWi;j9~X_jcf)Ugi4&jt5qrZdC&Fspezm&JX$(!jouEJ3@%>K5-yv$E zo}8sHGRpcz^O?%~P2cZv%zUq-H&gCW_S~F6DZse=b+7yDMT-+^T6ji?$AEQ3QD6D* zL{rP(V(Mr~90OXz-RWRqUEb6$q;kwC(tfm5GCuR3^@d61}fnyJ?>vdbC0`sHLK zAk+Z4a+R#M+D{%Dx_Ny%(8=dYJN!pPFgxU@zLiI1yabTeM-d^goJZrMo#%DYT2Vrm zoodWD#mhezE?Az8yd$*Roeze7aduU7m#hnU=X#@-F|cx}j6FNQ0*WbNJS|aCPz`*s z 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

JqF$ zXr`%Dh`35#Mk`W%4=Fo8cv-HjCkabb{z>C*^$HDNL)SvL&kUQ>N;l*6WECUyT6HO+ z;;x8RV*x%3bax)0p4^w-qO};+y;SqPJ#%wY#f9NA)YfAUK3O+Wz7(g`m9bB8u~^AN zBk*e|Kf+fk-B<98TB+YS_gJ0!i59U)1JtF(VG2|2hi&nO6H0inC1g>+My_1m8*|UI zFf%J5jWep;Z}_vaxv41}H4_%Hj64?8djoc|C|#p{TvxjmEKM`KxH)%=F?F`=Cne{C z{bV~02QLe{&kK@RY)P*WQT0~nw0@-iT%yojolxr7NMHW_>sRhif7}vWSh80a;tI_} znKjFm_$SGWhsj>S_4`YfFGQ3baqM<2N7BONQs@hVxd<);Y{~$K!WdzmOW~y*y-_G# z&ik5T`F;R;oiuK8A<)^e@JMFt`DneZ`6c^SzV|+~gGPV!6XkB)I2djle(qg#e*Giw zz#ZC?Zm4PRn=Yip+oGL;N-fnIVJi|7XDK16<^?_H7L%@kjIyf;ukS_n>Phjtm;+z) znixkV5fCp&0P#W(seIud1^3u8hCavJHw*_2(MO>(< zxp@?~_gJx8tHx?|D-*aJ856qVhd9zW9=(4!eXJ2SQo6p%+1qTBJjWDGk==Wex1r~4 zCVyUXw5a6$!(h`rBZ3hp|8wX_*+VA3Z+On~rDZ}H14|_9vua@uelTWU zrYqiDq*#$NyU_G1TJ*GhcejFCc|M_)&9n^J>QW>}Af>M+mA;v(@?RY0+#~n!3AZFD zsJSM<-BxQtGLx-w2>&W7Ta{yTV%vH)s?0H>aRv*OqJU-FO{11wANoz;9a2#jULtO$ zTo0XaY*n4lhzrF#k8 z>rp+Ox75g9OWC>?rx9lUtBQU%<|b}-yAK*y%+jf%P7Ai4-3;>&_b(zUFpJMney(E4 z>%A{>D;AcjlVUEy7(Jx)l--5J6mDg76?SYrx59yGI%3$eHOKBB3{!Y`LOO8_iTIO0qotLszzq8iCeo+MBxlTOi zf3Pk0aC+e>YO!6=;gW)sJojGeI@DQg;f`bE1ZVT8{8;RaZ>n%cUSTvlQX7txwlcl!5TmC5#sT!-o z?{Qg$9Odrl=m10kfSDOnH%|+J)aQ8(eJieC>~`1%HS)=mNPQrtZ})K(Wy4b#ttWi{Bo3Z+i@meE{sm z$0(th>Qh*eKb0X}VVa>-soc-factor` of a battery or an + electric vehicle goes from `0.0` (empty) to `1.0` (full), not from 0 to 100. +- **The state of charge must be fresh.** The GENETIC optimization does not use a state of charge + older than `optimization.genetic.measurement_max_age_seconds` (300 seconds by default) and then + plans with an empty battery. +- **The status of the Measurements step only looks at the configuration.** The assistant does not + check whether measurements actually arrive at EOS. If your own system sends the state of charge + with `PUT /v1/measurement/value` and no adapter is selected, the step keeps reporting that no + source for the state of charge is known - you can ignore this. The other way round, a step + without a warning does not prove that the state of charge arrives: the **Home Assistant** step + only checks that an entity is mapped, not that it delivers a value. Look at the **Plan** page or + the EOS log to see whether EOS plans with the real state of charge. +- **The Home Assistant adapter needs the add-on.** It reaches Home Assistant only when EOS runs as + a Home Assistant add-on; there is no setting for an address or a token. If EOS runs elsewhere, + let Home Assistant send the measurements with `PUT /v1/measurement/value`, e.g. with a + `rest_command`. +- **EOS does not switch your devices.** With the Home Assistant adapter EOS writes its instruction + for a device to the entity `sensor.eos_`. An automation in Home Assistant has to act + on it. + +## After the Setup + +Look at the **Prediction** page of EOSdash to check the forecasts and at the **Plan** page for the +result of the optimization. All settings, including those the assistant does not show, are on the +**Config** page and described in the [configuration guideline](#configuration-page). diff --git a/docs/develop/getting_started.md b/docs/develop/getting_started.md index 20069af0..9d949f1d 100644 --- a/docs/develop/getting_started.md +++ b/docs/develop/getting_started.md @@ -49,7 +49,8 @@ export EOS_DIR=/path/to/your/config There are three ways to configure AkkudoktorEOS: 1. **EOSdash (Recommended)** - The easiest method is to use the web-based dashboard at - [http://localhost:8504](http://localhost:8504) + [http://localhost:8504](http://localhost:8504). Its [setup assistant](#setup-page) takes you + through the first configuration step by step. 2. **Manual editing** - Create or edit the `EOS.config.json` file directly in your preferred text editor diff --git a/docs/index.md b/docs/index.md index c1c5e70b..e2e688af 100644 --- a/docs/index.md +++ b/docs/index.md @@ -28,6 +28,7 @@ develop/getting_started.md develop/CONTRIBUTING.md develop/install.md +akkudoktoreos/setup.md akkudoktoreos/configuration.md develop/update.md akkudoktoreos/upgrade-genetic.md