From 3dad7837856d29e1b1db7626908d99f5f00c30f8 Mon Sep 17 00:00:00 2001 From: jcarolinares Date: Thu, 7 Mar 2024 16:11:20 +0100 Subject: [PATCH 1/3] Bluetooh section updated --- .../user-manual/assets/user-manual-bt.png | Bin 0 -> 79509 bytes .../tutorials/user-manual/content.md | 147 +++++++++--------- 2 files changed, 77 insertions(+), 70 deletions(-) create mode 100644 content/hardware/06.nicla/boards/nicla-voice/tutorials/user-manual/assets/user-manual-bt.png diff --git a/content/hardware/06.nicla/boards/nicla-voice/tutorials/user-manual/assets/user-manual-bt.png b/content/hardware/06.nicla/boards/nicla-voice/tutorials/user-manual/assets/user-manual-bt.png new file mode 100644 index 0000000000000000000000000000000000000000..228e2c57ee383706349e90405b9904075e0806ad GIT binary patch literal 79509 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 z zq*yG#rT77z5*|00FHoxNAQ@XW+P}SS$_oI#-!FRghMDg*S0wUuvNkg!iYQ684<@~u zzC`yj>L`dj@pukvGwF50^TvF7qhcTPO5g793F&Q##)rK#ZSCuG9n60{Ro!!EWnrbI zdr*Ga+lxOUUYgyC%OE;Ty*=>gJuNJXd0eXHVcmXu*==U{_F!tEilC?+k@GGtI)6Da_mA;+rABWl+ zR*)7vb|sy1Z%I%e9LowlKW&>~{DE1kiZ#QRsl&4bg;XP|oTLswPblkpOBzLY){yhI zTPC|7-0Qk5hqSNdRytP6x&C90)}!8kx=*GJt&GjFaCk_0-X6GEQm|fkVey@>XpWS# za9g&o*^W-nu-y;n@>e%|W0N;D9#6LX6j>SAPJE+)!6{`=t{)yPi6FXqG|L{1-L=!W z+60w1?r>uXicj&y&EtqGe^ z0EO?|wvw{|nySyQ$p+E^;6w-2?!`TB{o!;IJBG?#=h%9_WQWQN?CYjH=176J@l6fy znO8AuS~o2Ac?Uc1}Q9b?}GyhZN3|8+~&c(}?_>oIBg z+~SRl{v9SmgV}ZHpsnHgDuj$!(=V=)p(VkWUrR4^kB^!Qff@#`A`5G-1<4^A*1 z+#3(NFYlTqrVp-(2~e3q(<=&sv;#{&Jhn3Wvd~m*@!xRtY5m^L%(o*7gpB+L;W?^U zwSbKM_ida#a|5AAeg%wc$cZNAM}{@-wcQ-YX(p#EmoV%CCP=uF|SC|^PxEy+MPpHUsb71iE3iQ!;tbM zp!~p2vM|ph1KoqyLK&R}KOJ0aQqj0=SL<7$)C9}88mPsDnynkBBPo-t+uLdQEYu*= z?|Z!hA?~^MDLSn*MZK{ycH$!Gv7yfw)M$cniddP#`XV`k=Z(i1qs>|U)5{5;-yi$= zc0*MOJ zBD1S&N>m6I?an(NZlf7N8IEVd?z>-_`SN_EuJav z=a!s{1cg=HBbh)Ip$KlnBJ}q&N4cIp{Q^|bx|2NbIsL7nW9*7H9gS5Po8JnthHFFv6R6<0%i@i}gQn=L z({Ef2FH7MrmkWnnzTT*Jh)##p0p#@N$VZ>0EXgEpk{CdwdEC+)bP&}Amu}X7NrKA$ zjE_(a7adVDjn#)Z2;mLN)Yr21Uz#mEr9iXv`u?^qOsa{` ztajD5eWSuuP~nWXdV(w5d*yIuufo%(4z))vzkp&hHSY%wM(-ql-efM(|4{X3fYI|+ zW#AI_#Ri<(uZ;d=aJ!+Pj1G{jG7`F<&>`%4>R|*p@aP!2v$xdDSuP^i0VHI_PJP{9 zsQH%!c|@mc%Xepz*B?rj>4mR)n$`k`KU~tIMZo*|9SalXvCCzC{=GiNkW_-7oxO7| z+Qa{Eoj19|AE*5v{xgp2VKOI}TlWIIv6uQ4XUI+$-52CNq)E-KALMuG^u1V{{9KYw ze`r{1c%fK8#BQ5&d)orey9iN7tL?we_^B%GqwiPJJEw91)JPj^>eC^E`h34Tckf#0 z_>K}Ih!*KS@n4XD@^uw&JEPLir%NfWIUwcgL`GJLuAErZnSNb$` zFu2K|pEnO5`An0rH|?6Np>;c_PrhKJq;ZoSL~yf8@~E$-_kX978SNtE>E(}unn!J2 zV>?91R_C%#?WL~InXj7ZZH~RU^2gsT>%ZjgGj_zMmXu_veLW`W`>Ao{Yv$vQcBjX7 z9mj1ibtPd^ZK`BG)Lige7*8@v?ACZbd?;wES==R`pH8($_n(BA2Fe>%%D0Y;Cb^5$L z{+{;eCVS)7?0iw8P=hovvsJaVo|K!7z#qh*I6=EYkf< z%Ll(WmCu^VqlL6LZJ4b8M-^{aPU*C`+88Sx7T^EAyDHkJv%5EO;VT$HWIi8C1zqeo zhbn$@Zso3aN0R4Pq^S@*ml>LCLc!qrl@>SGZIBJF7ugrNJ~la=EKR`UlyE@`i6m)S z9XBs*T#M@4|J@k>dHvPr5A75MsA`=;sT;sft>S`z(udHspnAMrr%}oGIcV+gBJfaM zod-E{PI8NRfiN*;)={oI4PrcrORt~cWT^lUyD>WU=2coEeG}BO%+OLNm%s^zK%21o z91s3rx%_t*-ReW-;m zA>{#I;5 z_TIWaTgSe3BhvHf6TR8V6TkK}3v|va?A>v-%_!qpXz=a{+~0FHdt?SRvp^!qpb0NU z;+zV0ycC=Af+Q1Apu%VW*am7@d}e3qU?$5gFvH@Dggw4?{Q7&^?sBGE*&*v?I`17( zvk?*b@!ST{zNNd&!D(FeNaf!02ZYZTZ(UNU&{sXORogqa^ulP!TcggPHba#|m8^No zPvch}+5r^R7+yll4?agesut^!*B9XQ#Hr=V@Qw!ef%GQ)c8@mvqD|KL%D__Xb03Mu z`?fm!hlX?8wS%lr#Ik^3_YlKFGA@nXRYAp<4rH0VYOa0!nWn2-(`Dy;Pr}-&q++~h zYr(b@bUr{FVt@qf_>wIX`4VjsxmBaD^U?5Hzn#}wHr6yh%>ERqHdYYSE`Qk;Ww<$E zt4DWi58PyrW2}K}siO?1Dh)PoTx%NBa?TUm92ivBJW}wZlbirhL(Cy87CuIqlwFUs zvX@H1gcAiynP*8KCymO2?smO0o~rWeZWE$3LfOLiAV%}n1Aif6D~kI=FogN>IOMmH zb?@W%w$M)%9}9E?HkAXs0y{N9)a(t=j*FXab`>LA`M`}i{?;gIQ+A>p74Zm^CZsfd zzlHTQSMRr8pI7%wUi`>7wzBgE9gSN9jub%0EY99H%S4B76B-0S5fa_SE~N~c z-p}6J`_^u#l{vg8;^Hf%e{3JGLd{BW(iotb-#RqTtfDWRh&2+Vn$`4WZD?ROU}y;X zd_foVU|@h*8*>3ycY=fDeXX5kK3agBs7EnMR{oLgI}c1tQZCM2YFuGNDfd;nSankE zNX(h-YaEzzgbH^tnhO^-87M=SpKV4zV{UwAj+`V|6xc(4iZ&A6uj5@m(snm*$JNDq zuDW(v3}>diZmxuJKI=Sa0nbC621(KSJwDscwzqxiyL=y8AVa8{EiMkX`(-jZY4ziW z@3xb;6h_L(PfB@pibU^!dQ@nK9`uLi7J%p?yJ&N@ z306DSXyk-~hzGaSf1I;dK@Xkj?H(^!(^iMZH77eSQZ8!;B!*{g&xv`k*CWw6V|B;X z9~bUybf)GcTYf$}rcgVX+IavCAizol`4~UJ9$hn_-ZtCF`E{3=ase|waXE7Y;H({N zyD>fTe0}ek{aLv;Y}!{`p2?5Zu@7WOOv;*?S6BS!eQ_O}-kRa1x9FLWLAU>z`SybI0C}8z+L=T z?pDj;76Vwpm!}irD=u==QKRsQ3OHRv4n^S9)|e|-3#Y@%om*+4_6;C3*~t%p4&i)z zllGNU2tmDXOK=BG?sa)qx1=5wb4wKWeI<27faCbn+DW^jMR8|2g`CN zb30k*WkdL;kF9F>m3U3m>JU zflf=GK;pq9XWifUz!(s6APEDbyAGT&1_p0=m8QVuBTxvf#?B5`vhwt-P~dK=tAUPBzeM-3D$ z_PMT5=;C2?fI!C=9plMGsKCDxD_XmyESQ%D*BwUtN^LQ5Wm!pb&(|1TqFZP@Wb_KG zB#4Lx*vE9Vo&JPtZXm-6oCuJzq+a0Sb@&syT^u>~J91K$8Y-ariA=U>lZ{lvS0j{; zw3Q#&y0EcIjWt_ip27NgW{#e|jMD}e3y#9Iql6wg3cMBJ8qkWjVnzCPw6ox5xQ-pC zx}YK(hOj7W70~kIJvxByEW2Tgj!~~!J;KETqyQN2*=rf{yX(29dKGWProN*TL%g~8 zIe;0LyHJ)wF$P@M`xq*Q^c~Lwv1Gg!1rQqP2>ZAC6J$2H|Zt5^Hlau2v8yOpWs=*^g_rj2&OTo{%}cbH_eFNzL1>F!+T45**)Idnk3XaV0B;&@+?0BUv;E@?M>eQziinTQ@i{M$+!!h?*O}d_l!5jG%N7I2xe9M(;(|&n%q*S1rL)<>lJ@peid- zGH=dlMIsLDFc*GHS44jETnUm^2LpaV&9q3v2h%&rG~3|{(3cAKuz?=Rup7C$1B|6JO$p?d%7L-WupAb{gDvCMO2J?c6*t z_#@boV+Prz;~kcVf8vS)yb>J_L*f4?uG~Gg5#cZV=Sp~yw%j#WD)YaoZ^oZ_zWOEm zz#j|_6gL4*mxzK&Y(gD7kl96goSlEcdh>?dUAhT5L=s)-agikGz;pa=Z?sq?u zC%4=hJ+{PgFcW9b{LVn6lRKa!eKfkbuHqRI-vEip06PFF+W?RIS+h(XI4A5dKlbr8 zI^Z*0It1u!Zp$%C@Wu>Y40h&f4DeljJEv#^Jl%>EW$YxoNpWRdw?lx33q-5r75{(- zNux_fAw8o^ax=n!YJkRw9Dz*-+z~J|BNN059D$-8aJzyi^xxP2NyMaFAGO4N-w0huVEI9!XDmlxUeY&@S zr}a3DqhJYKf&WeM_`T*+3GU?0nIw^-O64(t=*T(FXOoU|@CpRpda1w%Yw&3Y)am7= zntlM5R^FPIs5Ja*rjni@0zC!>KgIoE+79SJVf^Xr)W?%}9OQ)c=M8Eu| z>T~otwiiep7djXG7v?469K(NTFY;8_l0*nk{%JM8+l$M;k$#Z9AGvJ&jr70)k>OSg z11*N&O9J+R{ffxxtd0Ig?d@>IuqdDG;a&Xwhxj-^I|1X)(eRPo8{N1jAVvxtgo4Q-+M^@zcji6f z9@YcWBK{2!DDZzcHwGqVE5{e2qYeVdSrN>3l2kLV0_1n)&b+Wl58)<}z=mGrWeLF_ z`@byN-KWr9R(#c?Jp@+BTQE?3Jf)<)gg5`w7_vPtFjGJT?ti-@!w8nV)dPJB>XtZO zGdzPO7Q^fe-><+WqB#I);797(S9n^Fh%l0CU4hj_kbMCa7)|ro)9f@W;AuJ<0dxeP z18O5ilGbvFoU)9Q=KzEyTK=C+M)*5!2nn>7P16Ih-8rs-j6ZDNOpYyse@wAsRGN)i|H6L#OYg6|3d)Y#D> zEDqUxv(2&ld?)dDRnNC=zpMIUekP`JiCYEplE+v-ZY_yFVfPa2j1=|)s+phq-Cq1o zdiH+gvhg=--SLc>0>V0EhX5_cRrz3LTm!1b_btJ7grx?B=E!X#ubl4p6Asz5kk_!mj&1JU4=y}&#G#K__Rt%5l-rlo1; z(0rF~^u+&pp=rQWC~(Vrz}s&uQ9=god{++m9$cefij_=6+OWt$P2EA$X7qZhxoSde~9f; zW6L)jz;ohQ*K456IAir)o`{X`4nM%~!JWUyRQ*eQCaFQRGg5a0eh9F6`AXs`T)@py zjKFbad5;~r(_Z~*6XC=r!d({Yzt;cOj;{64h63YF^+u2UIQ9J5$y{C9BSf#wKo(~G zckoAyug-j_@_#gS(F~K-%#OBzB&r>%Xm`0RY=>AmsVzU3N3xQldb(s96xpXdVTA6U zL3)B|z7Sg#s=963xM-#v)zhhcpqTs72Thil69$_ab%b3k0D)oKo>7F?(!Qxs9e4w) z;?*uh^~|g~FTq}kDf#9ZCb(I%AQ}=ObSj7KcjgN#Yy-J4OKO;P{&sfM3+Dc4oW4r{ zDf1$O*Bh}^HKIniKfivXf+RzGr^OT<;~8`{X)f<^o->S{9@B@SC9m* zKv-dp?opH8$s41t!dRO2)|8wGWwSr~@B+0m`W8MRknCuko`?`}%#Q&6_n|`f0NFB_ z;LTmbF(+ncu&9yW!zdm_1%FbEml<|_tazD4*uh?eS{Zz#I5B2zM6ESFz@_Wsn+(!j zxRwvpxo-Lo&ft8gsDE(PgKZUe?X(6H1aLfO1k1Jw@`!jR5nrN3C2^^fR*nqpDwA)_ ze$%zXQGil&bd8L3dboDnVJ%8}uIh)2bY&lQsb$~+#GuYtyr z&^#%rTTU4JNx8$5k&AP|IcVOq{gN<`tfFAb0+IS8MINW|#qO9J(>V#_E6R?>!8GO} zWu7>dKSOl|q7ib_9tjcIvU2x6hmUWzlkb|6MaX$Z7!`wzT`g=*5`qoDorlTyD8rnv z>W$PJdJPBJB7f5!17yxqlI)n{eK``7IyAkGL)C;1z>_3h4FcY=1+O(WsBtD=Uk2G< z)E)^S2jMmt6RC=^^MnOG&LdJ?>_;vT(t-tyRNr7Ya+-q*5>B!frheCdl~_Vy%?~RK zgjuKaR`aRjO2Cw4zD5IVif5pzRcKtt13bbru(1XuXfrBqTuG+AW~4MP?m+RjjgK@g zGo{7C6#v)v?%psC3BV{RiqzMEi}a^E4vaU*4m@ScZ-^%b5V7ww9b%EHDfq$?gI_2< zJA4Q{KAPzZWJQ#=6qcy}4NEGlF;(3RdlfmNc~H@9tHN9h;+BLFcB9P<`NCf|E=fC? zXrI;yk$6hw7Qs5=&G(*?hJXKSp`db+wb^e65;v(GM$m21KCrkDxNyAmyGGfpB<>qm z4#&I+DGlv9=<17fMx)zrl4=uiQ=6 ze7*B#_~I=6psPXN?Wzs9K%8g*Pdv@u2x$an{3ErGdS(gXVr6ihX@8eLjh)1Hyb(mC z1Z>3cG8FSAr=}N3>ya*qH7>y06CX^WlJ;9ew3;2{_Fx_pEF>jpt|hBSmTU>LWI`iG z>t?eUwMm1oy9>cpogK^LS=LRJ#$^60^}$Wg59T&1WgJNY?=>qI85~0y&dBlQ<$*LV z@OSy)f42&NKAm~RQjSCCx;7I`Uw99%wAr(wsl z3RFm$yF;rEO4Al~LAONM@|%*6MWV~oA~WV%WY5DfW*FgdnLydFH*Yh@szzm*3gUWs zzYl=A=B@=>Rr19C%|7bGLH^^v1j-gZpL)KFtDHAdF9f5U9w6?#)RsGnQ3-gfV6NVu z0MbC6^|waxUnn0X75TPS!;Yul-)y9w>4vv2GQSTZ;f%O8?$TxDqtp&mG%~!os`qA? zKqO6z|NWgPwJ+tou{L;6&G8bv*LSR=xtfu<%(PggF*}w9ZZslqT9dWhB);-!Xti!9 zN*@WufLig-58?@E@OgL!#&_Y=&4=d4@6ha zu4QDgwI1Lf|B;uhCa!i-bmPrB5rj4T`3NFj2;e1dlo{M2zL~3hsYtj4L@0{C$)krdqZ zK5RMIwL6U9jE|efh5|B>!Nk~Ue{R*PC?tQof2SexNwns2=CwTAQ$MGI6+bqd5DVue6|+z zq?SpIhCQ4h6_+VATM!^TtKTNv8iBrCAlwSX12h&ns!#TM@*o+wSdUsbE4(=(dwzvN zd?)8d#%j7TSqlgXBB7sr3D${Mt)gQ3UEqasI3FZI3lI(X74MHmq(!zJ%Il}J$)2Zv zP#6GmhOB6t5A1oGx5r^KtQi(BySuJ@wwSI(%2`EmT250^v(>IBcc7~V3Uwf*{m!Ka=5Klga0 zT&cR>OEEfIE&|`12E^)6q+Vw1pDY$KJZhd`^8PNwn6wQv@t$#%E!Sc_PZ~oFWL{!R z*y<{wkc%cGIjFh?X_`D}A;R>nIJlxTyoq5oXHX@>736jV#$??f*M%Y*EAfA4dV-(7YQ7-e* za{*HM>l#+ckuRRvI5Ve3T{|&0B2t9tS`Zl&3(X1$;u0ki87WO1TfA$d1g@1NO#Bom z*<2z>HC7p$!{F8|g2$$`IeO;U2Nk#d>4nS4j)P;_SqWk(EE6Y8nZIZe1SeE!e;Jc~ znGX%fXk1W5SDqNzW4b~qn6Q8*E+bd2fDIhsXb0*@=c<8R)N7%a>5y{0sbJO}2B{S~ zng_MSvyE1nMW+Cj7_!a33o=GOY{@H`Z-$(XF>g!?ghkS#ZfdaSrzO4aS;};2& zI%eu7K`RlU{x?qq0So#IzVvr5n>6sRA7|n zjmgJ>bBQ-R(JW|19!l6v@g-F4;7pG;1Sxlb5$>=1zTsh1eDo?i;OK!y!+-+dbs_zd zxPdXqwt2M|Ve$a^naUMOk|LlhY?@pY35{5&D^%F<0(d}$_R6B6QKP|9w@`<(Cu#FS zMDOR%RcK`Zzt*2I9cd5g49QLvp>i{9M`}PATcM2tf>U;&1&W?-j0>4B8 z_DKxPub?K0Dkg@HS~om_v6pc_9Jj*o+EAF24DO2|-wKUd~gmyfXsH?cjPhi{Nhk)vlx;a{oqwPM^~8y3Y8 z8W%O}Y`%nuY(E<&1dN5({901^m(%B6eIu>mZbTsfAw3!@3q+SzV8j`|QnYuU4mo=5H(hT04d5Osy z?|d<-qrXtVRJRIbhoT?3pmVX_ghWKgfYAQkX#<-Qz5I6|Hj6(?9T6gC5wsBZscR*n zXMW^g;QtB6^pp@vp1T#xO91Wxh8PG?zpkaehyAaRCfR|$y{Bq6v7I|7P&VZ?E{PMZ z(y-gJMcGM!k%BLwuP(Mo=e+R~)KT4aVFVV3^7pQ56ymjaU;k`*b6)#E45G0B26*)@ z;H9b>kjWU&^r}AD>?96+wlTq$BvJ1Nm5WpvhrSKK8)JHURl{XsKq8JA?iq?OhbXLvI^$yPE3{tp&jxO zS_w=nxmV>r0sq|XJ&;Ewj5fMzogmFur1{;8K)rmn$gh9eE}Q*PJiBNc#!@uKR3`tw z7pNm~Pnz+0P%M&9!G(U7%?6OX7v1*`hKm+Wi3umtsuiF12}~V@j+}F2&mAj1^=_k^ z<4x+AUV7FI#=?Ro$(f^objBWBY0~j}Qz&dF5M$njdZbT&JT$5_J0b#WlZktln2U1pA>^Tm5sz1~ z?F7h|9vIm`Efyj=Mz3Fd7cD`%#K<<^$SL2g(2s1%lR|)B zi|XmZ60{TOcu_=^FVyeSO{g3idg&&#(qy~vWi3{a@y$p{`&lc5o1(1t>7608 zqE*h#P+w@+NWe&Y1Jx158N7F~gis>~cA2E2o1p@JY&*GAf|_QVB*T{Vu}2uw90Fd4kj>@m&WiiMbn%qN3JazH}P3Y>EKv%*}rF!L0f zoZ+)8af&wNMj<q4q0(qL>#2D4l)-X5}vVjEAi|Wk$F#DuOTt&uS z$!GzS9Ksp@a+y{;v;ktQ1eU}!pQgv`$Vn8(OAZGLIJEkK!4$M`aD^m3;SIS5B zlup|;T9I{7Rg0n_UC>dfU97_?lPQvHWiu&uPu{`sZm zIkEXCP$U6ydV)FSoZGYR<=L`TBd6aYysh%j_iG`f2$*yUC~I}g$B*thB&KxpFqz#D z@8?C4(srTLQqhoBD2|N7OMH8Q8lAvig4m_Kw<&7|WK&pPI;adknS6%Wg4C|qEy@Hr zEGGXjd#`=)k`ACaSyj8e|FrYG;YldNo@v7-qthiLfknM%{g*{cvj_{T?7r#x=RWQhR} z`90VE=p`Qyvbc^CgK| zQ5FVbz&41jOV695mqLT{*Wb9XRHiCcve)diO-<0$P)Mazns@?LWwNM0R}%I{d=h&T z56?qqL+TaP8}H@=vp_Mif_PcM?B8^b>Yb|XHy5>Uua>K46Dsduh{AgHT{U>^2DC3zq)6VKqw;1cMlE!*pR{Qsg zDuy?>h5(|>85J6BEly<*a17<6dbXpnXRjH~&%QC&q8#lTmtUL>-bW3Z@i$f5dbtNT@NuH=r4sX7ZR@7r@HVvlhIzF5A9$%Uq z(W(+z-nIPC#@_uCy6|M9hHv_sZSXToI7mN};q*Fbgg zAqu7C-DajDUJ#bDdqoOSu{G%yDN*W!=?)CsNdL)6wU_tI;v4_atJT$V?PIDt;(b(E z2h~{A=nLc4e^1U1^iS6>_Dx`Yeo)3oTo+-|ke~gM4tXr-r-viT+s)?IcC{Z<}mp}D6c<_i>{U_HdHh1do z67K8eZ%on^uZSDBMFy#Jw<{6vNQ+@wiCo&^8TWQ@=3f`_3M)q7{3_Tr@@dR}cUh#| zrn1D~R+6-L*XV;3zxu9ry@=#UXZAjwjgM;R5$|vjJJPu8R#~XlPwlJYGQ`kQsWeI< z&3j4@rkR)2p4j(_vj*$M{b}{C>(>=*DiL{P_Qd)vEfrh7=IJ85-wm@~qg?l24YAG~2D?Xg`forg(9+p&Y@7PLG(uECjcHxkwW${u5RJ0i1O%uYPVh1mV<9c?1etc!@MLNCmyXz zG&1a{yQA|qHh&x81BrfvoV!S|At)u@04Mam?p@?(Dsje V5WoC!2~Zq5xcA5(xqIBM{4YRSt(gD- literal 0 HcmV?d00001 diff --git a/content/hardware/06.nicla/boards/nicla-voice/tutorials/user-manual/content.md b/content/hardware/06.nicla/boards/nicla-voice/tutorials/user-manual/content.md index 1b039046f2..1239ba310e 100644 --- a/content/hardware/06.nicla/boards/nicla-voice/tutorials/user-manual/content.md +++ b/content/hardware/06.nicla/boards/nicla-voice/tutorials/user-manual/content.md @@ -1325,23 +1325,7 @@ Serial1.println("Hello world!"); ### Bluetooth® Low Energy -To enable Bluetooth® Low Energy communication on the Nicla Voice, you can use the [ArduinoBLE library](https://www.arduino.cc/reference/en/libraries/arduinoble/). The library works with the Nicla Voice with some minor modifications. - -To get started with the ArduinoBLE library and the Nicla Voice, follow these steps: - -Include the `Nicla System` header: - -```arduino -#include "Nicla_System.h" -``` - -In the `setup()` function, call `nicla::begin()` to initialize the Nicla Voice board: - -```arduino -void setup() { - nicla::begin(); -} -``` +To enable Bluetooth® Low Energy communication on the Nicla Voice, you can use the [ArduinoBLE library](https://www.arduino.cc/reference/en/libraries/arduinoble/). Here is an example of how to use the ArduinoBLE library to create a voltage level monitor application: @@ -1349,91 +1333,113 @@ Here is an example of how to use the ArduinoBLE library to create a voltage leve #include "Nicla_System.h" #include + // Define the voltage service and its characteristic BLEService voltageService("1101"); BLEUnsignedCharCharacteristic voltageLevelChar("2101", BLERead | BLENotify); + const int analogPin = A0; + /** - Read voltage level from an analog input of the Nicla Voice, - then maps the voltage reading to a percentage value ranging from 0 to 100. + Read voltage level from an analog input of the Nicla Voice, + then maps the voltage reading to a percentage value ranging from 0 to 100. - @param none - @return the voltage level percentage (int). + + @param none + @return the voltage level percentage (int). */ int readVoltageLevel() { - int voltage = analogRead(analogPin); - int voltageLevel = map(voltage, 0, 1023, 0, 100); - return voltageLevel; + int voltage = analogRead(analogPin); + int voltageLevel = map(voltage, 0, 1023, 0, 100); + return voltageLevel; } + void setup() { - // Initialize the Nicla system and the built-in RGB LED - nicla::begin(); - nicla::leds.begin(); + // Initialize the Nicla system and the built-in RGB LED + nicla::begin(); + nicla::leds.begin(); - Serial.begin(9600); - // Wait for the serial connection to be established - while (!Serial) - ; - // Initialize the BLE module - if (!BLE.begin()) { - Serial.println("starting BLE failed!"); - while (1) - ; - } + Serial.begin(9600); + // Wait for the serial connection to be established + while (!Serial) + ; + + + // Initialize the BLE module + if (!BLE.begin()) { + Serial.println("starting BLE failed!"); + while (1) + ; + } - // Set the local name and advertised service for the BLE module - BLE.setLocalName("VoltageMonitor"); - BLE.setAdvertisedService(voltageService); - voltageService.addCharacteristic(voltageLevelChar); - BLE.addService(voltageService); - // Start advertising the BLE service - BLE.advertise(); - Serial.println("- Bluetooth device active, waiting for connections..."); + // Set the local name and advertised service for the BLE module + BLE.setLocalName("VoltageMonitor"); + BLE.setAdvertisedService(voltageService); + voltageService.addCharacteristic(voltageLevelChar); + BLE.addService(voltageService); + + + // Start advertising the BLE service + BLE.advertise(); + Serial.println("- Bluetooth device active, waiting for connections..."); } + void loop() { - // Check for incoming BLE connections - BLEDevice central = BLE.central(); + // Check for incoming BLE connections + BLEDevice central = BLE.central(); - // If a central device is connected - if (central) { - Serial.print("- Connected to central: "); - Serial.println(central.address()); - // Set the LED color to red when connected - nicla::leds.setColor(red); + // If a central device is connected + if (central) { + Serial.print("- Connected to central: "); + Serial.println(central.address()); - // While the central device is connected - while (central.connected()) { - // Read the voltage level and update the BLE characteristic with the level value - int voltageLevel = readVoltageLevel(); - Serial.print("- Voltage level is: "); - Serial.println(voltageLevel); - voltageLevelChar.writeValue(voltageLevel); + // Turn off the LED when disconnected + nicla::leds.setColor(blue); - delay(200); - } - } - // Turn off the LED when disconnected - nicla::leds.setColor(off); + // While the central device is connected + while (central.connected()) { + // Read the voltage level and update the BLE characteristic with the level value + int voltageLevel = readVoltageLevel(); + - Serial.print("- Disconnected from central: "); - Serial.println(central.address()); + Serial.print("- Voltage level is: "); + Serial.println(voltageLevel); + voltageLevelChar.writeValue(voltageLevel); + + + delay(200); + } + } + + + // Turn off the LED when disconnected + nicla::leds.setColor(red); + + + Serial.print("- Disconnected from central: "); + Serial.println(central.address()); } ``` -The example code shown above creates a Bluetooth® Low Energy service and characteristic for transmitting a voltage value read by one of the analog pins of the Nicla Voice to a central device. +The example code shown above creates a Bluetooth® Low Energy service and characteristic for transmitting a voltage value read by the analog pin A0 of the Nicla Voice to a central device Bluetooth® device like a smartphone or another microcontroller. -- The code begins by importing all the necessary libraries and defining the Bluetooth® Low Energy service and characteristic. +- The code begins by importing all the necessary libraries and defining the Bluetooth® Low Energy service and characteristics. - In the `setup()` function, the code initializes the Nicla Voice board and sets up the Bluetooth® Low Energy service and characteristic; then, it begins advertising the defined Bluetooth® Low Energy service. -- A Bluetooth® Low Energy connection is constantly verified in the `loop()` function; when a central device connects to the Nicla Voice, its built-in LED is turned on (red). The code then enters into a loop that constantly reads the voltage level from an analog input and maps it to a percentage value between 0 and 100. The voltage level is printed to the Serial Monitor and transmitted to the central device over the defined Bluetooth® Low Energy characteristic. +- A Bluetooth® Low Energy connection is constantly verified in the `loop()` function, being the build-in LED in red while looking for a connection. When a central device connects to the Nicla Voice, its built-in LED will change its color to blue. The code then enters into a loop that constantly reads the voltage level from an analog input and maps it to a percentage value between 0 and 100. The voltage level is printed to the Serial Monitor and transmitted to the central device over the defined Bluetooth® Low Energy characteristic. + +You can use the [nRF Connect for Mobile](https://www.nordicsemi.com/Products/Development-tools/nrf-connect-for-mobile) app from Nordic Semiconductor® to test the functionality of the example code shown below. nRF Connect is a powerful tool that allows you to scan and explore Bluetooth Low Energy® devices and communicate with them. + +![Bluetooth® Low Energy service and characteristic information from a Nicla Voice device](assets/user-manual-bt.png) + ### ESLOV Connector @@ -1441,6 +1447,7 @@ The Nicla Voice board features an onboard ESLOV connector meant as an **extensio ![Nicla Voice built-in ESLOV connector](assets/user-manual-8.png) + The ESLOV connector is a small 5-pin connector with a 1.00 mm pitch; the mechanical details of the connector can be found in the connector's datasheet. The pin layout of the ESLOV connector is the following: From eba42692a8c83940f1e6845709ff40f5b743aed7 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Juli=C3=A1n=20Caro=20Linares?= Date: Thu, 7 Mar 2024 16:57:46 +0100 Subject: [PATCH 2/3] Update content/hardware/06.nicla/boards/nicla-voice/tutorials/user-manual/content.md Co-authored-by: Josefine Hansson <66409231+jhansson-ard@users.noreply.github.com> --- .../boards/nicla-voice/tutorials/user-manual/content.md | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/content/hardware/06.nicla/boards/nicla-voice/tutorials/user-manual/content.md b/content/hardware/06.nicla/boards/nicla-voice/tutorials/user-manual/content.md index 1239ba310e..8f4059aae5 100644 --- a/content/hardware/06.nicla/boards/nicla-voice/tutorials/user-manual/content.md +++ b/content/hardware/06.nicla/boards/nicla-voice/tutorials/user-manual/content.md @@ -1436,7 +1436,8 @@ The example code shown above creates a Bluetooth® Low Energy service and charac - In the `setup()` function, the code initializes the Nicla Voice board and sets up the Bluetooth® Low Energy service and characteristic; then, it begins advertising the defined Bluetooth® Low Energy service. - A Bluetooth® Low Energy connection is constantly verified in the `loop()` function, being the build-in LED in red while looking for a connection. When a central device connects to the Nicla Voice, its built-in LED will change its color to blue. The code then enters into a loop that constantly reads the voltage level from an analog input and maps it to a percentage value between 0 and 100. The voltage level is printed to the Serial Monitor and transmitted to the central device over the defined Bluetooth® Low Energy characteristic. -You can use the [nRF Connect for Mobile](https://www.nordicsemi.com/Products/Development-tools/nrf-connect-for-mobile) app from Nordic Semiconductor® to test the functionality of the example code shown below. nRF Connect is a powerful tool that allows you to scan and explore Bluetooth Low Energy® devices and communicate with them. +You can use the [nRF Connect for Mobile](https://www.nordicsemi.com/Products/Development-tools/nrf-connect-for-mobile) app from Nordic Semiconductor to test the functionality of the example code shown below. nRF Connect is a powerful tool that allows you to scan and explore Bluetooth® Low Energy devices and communicate with them. + ![Bluetooth® Low Energy service and characteristic information from a Nicla Voice device](assets/user-manual-bt.png) From c1d1ba125974c42dcee5a31083113936748ad572 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Juli=C3=A1n=20Caro=20Linares?= Date: Fri, 8 Mar 2024 09:41:53 +0100 Subject: [PATCH 3/3] Bulild-in typo fixed Bulild-in typo fixed --- .../boards/nicla-voice/tutorials/user-manual/content.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/content/hardware/06.nicla/boards/nicla-voice/tutorials/user-manual/content.md b/content/hardware/06.nicla/boards/nicla-voice/tutorials/user-manual/content.md index 8f4059aae5..70051e53fc 100644 --- a/content/hardware/06.nicla/boards/nicla-voice/tutorials/user-manual/content.md +++ b/content/hardware/06.nicla/boards/nicla-voice/tutorials/user-manual/content.md @@ -1434,7 +1434,7 @@ The example code shown above creates a Bluetooth® Low Energy service and charac - The code begins by importing all the necessary libraries and defining the Bluetooth® Low Energy service and characteristics. - In the `setup()` function, the code initializes the Nicla Voice board and sets up the Bluetooth® Low Energy service and characteristic; then, it begins advertising the defined Bluetooth® Low Energy service. -- A Bluetooth® Low Energy connection is constantly verified in the `loop()` function, being the build-in LED in red while looking for a connection. When a central device connects to the Nicla Voice, its built-in LED will change its color to blue. The code then enters into a loop that constantly reads the voltage level from an analog input and maps it to a percentage value between 0 and 100. The voltage level is printed to the Serial Monitor and transmitted to the central device over the defined Bluetooth® Low Energy characteristic. +- A Bluetooth® Low Energy connection is constantly verified in the `loop()` function, being the built-in LED in red while looking for a connection. When a central device connects to the Nicla Voice, its built-in LED will change its color to blue. The code then enters into a loop that constantly reads the voltage level from an analog input and maps it to a percentage value between 0 and 100. The voltage level is printed to the Serial Monitor and transmitted to the central device over the defined Bluetooth® Low Energy characteristic. You can use the [nRF Connect for Mobile](https://www.nordicsemi.com/Products/Development-tools/nrf-connect-for-mobile) app from Nordic Semiconductor to test the functionality of the example code shown below. nRF Connect is a powerful tool that allows you to scan and explore Bluetooth® Low Energy devices and communicate with them. @@ -1481,4 +1481,4 @@ Join our community forum to connect with other Nicla Voice users, share your exp Please get in touch with our support team if you need personalized assistance or have questions not covered by the help and support resources described before. We're happy to help you with any issues or inquiries about the Nicla Voice. -- [Contact us page](https://www.arduino.cc/en/contact-us/) \ No newline at end of file +- [Contact us page](https://www.arduino.cc/en/contact-us/)