From efec2a7fbf337091806f0bb2e8ca94b8a5aaf806 Mon Sep 17 00:00:00 2001 From: TomFahey Date: Thu, 17 Oct 2019 15:28:54 +0100 Subject: [PATCH] Updated MCP23017 Component To Cover 8 & 16 Port Chips (#277) * Updated MCP23017 Component To Cover 8 & 16 Port Chips * Made requested changes, adding short paragraph at top of MCP230xx.rst explaining the page is for MCP23008 and MCP23017, also deleted now obsolete MCP23017.rst * Added separate sections for MCP23017, MCP23008 * Remove MCP23017 page (merged with new one) Co-authored-by: Otto Winter --- components/{mcp23017.rst => mcp230xx.rst} | 51 +++++++++++++++- images/mcp230xx.svg | 67 ++++++++++++++++++++++ index.rst | 2 +- svg2png/mcp230xx.png | Bin 0 -> 2239 bytes 4 files changed, 116 insertions(+), 4 deletions(-) rename components/{mcp23017.rst => mcp230xx.rst} (50%) create mode 100644 images/mcp230xx.svg create mode 100644 svg2png/mcp230xx.png diff --git a/components/mcp23017.rst b/components/mcp230xx.rst similarity index 50% rename from components/mcp23017.rst rename to components/mcp230xx.rst index fc1995f22..5a09067e7 100644 --- a/components/mcp23017.rst +++ b/components/mcp230xx.rst @@ -1,9 +1,16 @@ -MCP23017 I/O Expander +MCP230xx I/O Expander ===================== .. seo:: - :description: Instructions for setting up MCP23017 digital port expanders in ESPHome. - :image: mcp23017.png + :description: Instructions for setting up MCP23017 or MCP23008 digital port expanders in ESPHome. + :image: mcp230xx.png + +The Microchip MCP230xx series of general purpose, parallel I/O expansion for I²C +bus applications come in two different variants: the 8-bit MCP23008 and the 16-bit +MCP23017, which provide 8 and 16 additional GPIO pins, respectively. + +MCP23017 +-------- The MCP23017 component allows you to use MCP23017 I/O expanders (`datasheet `__, @@ -41,6 +48,43 @@ Configuration variables: - **address** (*Optional*, int): The I²C address of the driver. Defaults to ``0x21``. + + +MCP23008 +-------- + +The configuration is essentially the same with the MCP23008 component +(`datasheet `__, +`Adafruit `__): + +.. code-block:: yaml + + # Example configuration entry + mcp23008: + - id: 'mcp23008_hub' + address: 0x20 + + # Individual outputs + switch: + - platform: gpio + name: "MCP23008 Pin #0" + pin: + mcp23008: mcp23008_hub + # Use pin number 0 + number: 0 + # One of INPUT, INPUT_PULLUP or OUTPUT + mode: INPUT_PULLUP + inverted: False + + +Configuration variables: +~~~~~~~~~~~~~~~~~~~~~~~~ + +- **id** (**Required**, :ref:`config-id`): The id to use for this MCP23008 component. +- **address** (*Optional*, int): The I²C address of the driver. + Defaults to ``0x21``. + + See Also -------- @@ -49,3 +93,4 @@ See Also - :doc:`binary_sensor/gpio` - :apiref:`mcp23017/mcp23017.h` - :ghedit:`Edit` + diff --git a/images/mcp230xx.svg b/images/mcp230xx.svg new file mode 100644 index 000000000..5e6224344 --- /dev/null +++ b/images/mcp230xx.svg @@ -0,0 +1,67 @@ + + + + diff --git a/index.rst b/index.rst index 88fe613a8..ff2c4b1c8 100644 --- a/index.rst +++ b/index.rst @@ -302,7 +302,7 @@ Misc Components Servo, components/servo, servo.svg PCF8574 I/O Expander, components/pcf8574, pcf8574.jpg - MCP23017 I/O Expander, components/mcp23017, mcp23017.svg + MCP230XX I/O Expander, components/mcp230xx, mcp230xx.svg SIM800L, components/sim800l, sim800l.jpg Captive Portal, components/captive_portal, wifi-strength-alert-outline.svg diff --git a/svg2png/mcp230xx.png b/svg2png/mcp230xx.png new file mode 100644 index 0000000000000000000000000000000000000000..53a89f5378437363a65e3e770925efeabb943389 GIT binary patch literal 2239 zcmV;w2tfCVP)6t&~b5b z$;rv9tE)UbJR~F}*4EZ%P5wd)>-9<^TW( zMM*?KRCwC$oY_JeF%*WyYPGdCsqBuTfZz@)pdzTa?_%Ax`u?xcQXv0i8FHZZZoWH{ z`A`}1vxly-h*9=I z)HY-D=kFWwB-y8tLn$-KdcoOvI=?=yvH#0x--z_{58mX+9R9Oay{VK>KI9|3 zMeuRErallX=Vq^trkO%{`%Od?4o^h+JU27T+|0aGTIDxqu1CisBL3VRJ}ZhB2qEs` zk-jfRTg%2K-rz=CPBFq|ey$m9!N^q7?P@$ISKm%_VJm(qRW1G!HM^p4%R&5(D7~VD zxcSl-FxukdOeeJ0u03{_uEG@joEi_xvR2f_%+PdR95ADidXosCvQ8*!9VvQ0a<7sP*sg$=2 zwx*-pgXN6T7Py5ho#isg)|9b&qg{Os{jCXYRg`Q~La4U*y&8Ipx^%m&23Z;@$7l=e zHU^ScLOKL**>c-^A^uZDI)cw!AmvA!4JkJ zi@}zi#ryU5JD0pzqn)Q*pc727CNV_s9nP;rxjyS|N@a)QhZ1A<5P~f*ylt^fErDKu>nMh)o5=#&Tu&m~ z8GKsJ!Obf{5b2RMgl?-MCi+*?5{JXz^&4Gy@^=`j;WYV^;JmCxNi=ESGsioi&7R z3ln{e8*GIm=vpd0_pNa;6zV7p=f!-qgwj(a6#8}}!ho|SC%)K8T0`izFwrNYCR-;+ zGrP03#JSf|$AU3`iF1%zDYs`EsZG^p#j${zwqb{A524#aYO}&kwldP-jsh6 z%;4O|QEY+8ZYx-t;fNDf}w zQWsg>7M8_hOq+&o8)q&~E8J9J38C9s7oMSgt|ZwyCfhmC4_EE%Nhz{CWdFJ`wT*-iYWP5 z@3GEIgx2N|lO<;m`l-+brb|l**%l6AG2CEF$xfXfY|Vu|;_@Np#R2{rdUlF~V|7zy z524$NOS`AM`xc|5?0lXrJ0G2!Cn=YnL(MHLYG7yjMBVvdtF4_lSwrZylr$?+lWf^` z)w`W-?d?c|EtI!3s-C`|lXunVj~Fab%xabpx~*i6%X^eGY;|{H11h=M@%vXMQQzlY zr&`IelGF@1s_T4W6U-u~z+5yZjTB}Lq1%%8A-SZKlf-&I4b+)T7?y6_QjFc7id6qb z?oA2HX`p^w%D`WnKogIdeUsSRW5KrblgRWu~4+xYIm1bFmAelS*DM@oNC?RxPxXeFex-I(c zYwxyVURCRu*E&^)6WY!A0*4%82;CN&DgGg=+Pb#i?C0X_pKV=m;BjBD!gc2L%pjV@ zWh=@EA!J)RGq43hhY?ezUT6Pq>pW`gwCmEUsSd_U$#7r1ffYD~*^LmQ*b4M&3pg*T zujdS7A7G1x?zJpCSXA!Nr{x`5wI(uyobjKIA@+d~BEQGxOE0$GJG|SC&#pSC`6pWq zoZWmBsvdVI41d;DMI557p%?=yg}hwK7`C46A&&I^tr7M?IE{BwK5a}V*@ttQNypCT z-_vo=XP<059X+KT_J0}a8)ZIJM*a6RcR|1Ze)%pK@;{3~=ac_ApDy_9e};_CfdBbK zI)P#Tv#)dp{m)g?>GwagPbM(ve;)*yfg%69MyTMsM*Q!w@kak1o8LUB!u}}rEAIdR N002ovPDHLkV1k>NO&I_H literal 0 HcmV?d00001