mirror of
https://github.com/micropython/micropython.git
synced 2026-01-05 03:30:14 +01:00
3ec8b9a77c
Some checks failed
JavaScript code lint and formatting with Biome / eslint (push) Has been cancelled
Check code formatting / code-formatting (push) Has been cancelled
Check spelling with codespell / codespell (push) Has been cancelled
Build docs / build (push) Has been cancelled
Check examples / embedding (push) Has been cancelled
Package mpremote / build (push) Has been cancelled
.mpy file format and tools / test (push) Has been cancelled
Build ports metadata / build (push) Has been cancelled
alif port / build_alif (alif_ae3_build) (push) Has been cancelled
cc3200 port / build (push) Has been cancelled
esp32 port / build_idf (esp32_build_c2_c6) (push) Has been cancelled
esp32 port / build_idf (esp32_build_cmod_spiram_s2) (push) Has been cancelled
esp32 port / build_idf (esp32_build_s3_c3) (push) Has been cancelled
esp8266 port / build (push) Has been cancelled
mimxrt port / build (push) Has been cancelled
nrf port / build (push) Has been cancelled
powerpc port / build (push) Has been cancelled
qemu port / build_and_test_arm (bigendian) (push) Has been cancelled
qemu port / build_and_test_arm (sabrelite) (push) Has been cancelled
qemu port / build_and_test_arm (thumb_hardfp) (push) Has been cancelled
qemu port / build_and_test_arm (thumb_softfp) (push) Has been cancelled
qemu port / build_and_test_rv32 (push) Has been cancelled
qemu port / build_and_test_rv64 (push) Has been cancelled
renesas-ra port / build_renesas_ra_board (push) Has been cancelled
rp2 port / build (push) Has been cancelled
samd port / build (push) Has been cancelled
stm32 port / build_stm32 (stm32_misc_build) (push) Has been cancelled
stm32 port / build_stm32 (stm32_nucleo_build) (push) Has been cancelled
stm32 port / build_stm32 (stm32_pyb_build) (push) Has been cancelled
unix port / minimal (push) Has been cancelled
unix port / reproducible (push) Has been cancelled
unix port / standard (push) Has been cancelled
unix port / standard_v2 (push) Has been cancelled
unix port / coverage (push) Has been cancelled
unix port / coverage_32bit (push) Has been cancelled
unix port / nanbox (push) Has been cancelled
unix port / longlong (push) Has been cancelled
unix port / float (push) Has been cancelled
unix port / gil_enabled (push) Has been cancelled
unix port / stackless_clang (push) Has been cancelled
unix port / float_clang (push) Has been cancelled
unix port / settrace_stackless (push) Has been cancelled
unix port / repr_b (push) Has been cancelled
unix port / macos (push) Has been cancelled
unix port / qemu_mips (push) Has been cancelled
unix port / qemu_arm (push) Has been cancelled
unix port / qemu_riscv64 (push) Has been cancelled
unix port / sanitize_address (push) Has been cancelled
unix port / sanitize_undefined (push) Has been cancelled
webassembly port / build (push) Has been cancelled
windows port / build-vs (Debug, true, x64, dev, 2017, [15, 16)) (push) Has been cancelled
windows port / build-vs (Debug, true, x86, dev, 2017, [15, 16)) (push) Has been cancelled
windows port / build-vs (Debug, x64, dev, 2022, [17, 18)) (push) Has been cancelled
windows port / build-vs (Debug, x86, dev, 2022, [17, 18)) (push) Has been cancelled
windows port / build-vs (Release, true, x64, dev, 2017, [15, 16)) (push) Has been cancelled
windows port / build-vs (Release, true, x64, dev, 2019, [16, 17)) (push) Has been cancelled
windows port / build-vs (Release, true, x64, standard, 2017, [15, 16)) (push) Has been cancelled
windows port / build-vs (Release, true, x64, standard, 2019, [16, 17)) (push) Has been cancelled
windows port / build-vs (Release, true, x86, dev, 2017, [15, 16)) (push) Has been cancelled
windows port / build-vs (Release, true, x86, dev, 2019, [16, 17)) (push) Has been cancelled
windows port / build-vs (Release, true, x86, standard, 2017, [15, 16)) (push) Has been cancelled
windows port / build-vs (Release, true, x86, standard, 2019, [16, 17)) (push) Has been cancelled
windows port / build-vs (Release, x64, dev, 2022, [17, 18)) (push) Has been cancelled
windows port / build-vs (Release, x64, standard, 2022, [17, 18)) (push) Has been cancelled
windows port / build-vs (Release, x86, dev, 2022, [17, 18)) (push) Has been cancelled
windows port / build-vs (Release, x86, standard, 2022, [17, 18)) (push) Has been cancelled
windows port / build-mingw (i686, mingw32, dev) (push) Has been cancelled
windows port / build-mingw (i686, mingw32, standard) (push) Has been cancelled
windows port / build-mingw (x86_64, mingw64, dev) (push) Has been cancelled
windows port / build-mingw (x86_64, mingw64, standard) (push) Has been cancelled
windows port / cross-build-on-linux (push) Has been cancelled
zephyr port / build (push) Has been cancelled
Python code lint and formatting with ruff / ruff (push) Has been cancelled
With the aim of getting consistency, and removing the need to learn an additional term, replace uses of uPy/uPython with MPy/MicroPython. Rule of thumb was to use "MPy" abbreviation where "CPy" is used nearby, but the full word MicroPython otherwise. This work was funded through GitHub Sponsors. Signed-off-by: Angus Gratton <angus@redyak.com.au>
87 lines
2.7 KiB
ReStructuredText
87 lines
2.7 KiB
ReStructuredText
The LCD and touch-sensor skin
|
|
=============================
|
|
|
|
Soldering and using the LCD and touch-sensor skin.
|
|
|
|
.. image:: img/skin_lcd_1.jpg
|
|
:alt: pyboard with LCD skin
|
|
:width: 250px
|
|
|
|
.. image:: img/skin_lcd_2.jpg
|
|
:alt: pyboard with LCD skin
|
|
:width: 250px
|
|
|
|
The following video shows how to solder the headers onto the LCD skin.
|
|
At the end of the video, it shows you how to correctly connect the LCD skin to the pyboard.
|
|
|
|
.. raw:: html
|
|
|
|
<iframe style="margin-left:3em;" width="560" height="315" src="http://www.youtube.com/embed/PowCzdLYbFM?rel=0" frameborder="0" allowfullscreen></iframe>
|
|
|
|
For circuit schematics and datasheets for the components on the skin see :ref:`hardware_index`.
|
|
|
|
Using the LCD
|
|
-------------
|
|
|
|
To get started using the LCD, try the following at the MicroPython prompt.
|
|
Make sure the LCD skin is attached to the pyboard as pictured at the top of this page. ::
|
|
|
|
>>> import pyb
|
|
>>> lcd = pyb.LCD('X')
|
|
>>> lcd.light(True)
|
|
>>> lcd.write('Hello MPy!\n')
|
|
|
|
You can make a simple animation using the code::
|
|
|
|
import pyb
|
|
lcd = pyb.LCD('X')
|
|
lcd.light(True)
|
|
for x in range(-80, 128):
|
|
lcd.fill(0)
|
|
lcd.text('Hello MPy!', x, 10, 1)
|
|
lcd.show()
|
|
pyb.delay(25)
|
|
|
|
Using the touch sensor
|
|
----------------------
|
|
|
|
To read the touch-sensor data you need to use the I2C bus. The
|
|
MPR121 capacitive touch sensor has address 90.
|
|
|
|
To get started, try::
|
|
|
|
>>> import pyb
|
|
>>> i2c = pyb.I2C(1, pyb.I2C.CONTROLLER)
|
|
>>> i2c.mem_write(4, 90, 0x5e)
|
|
>>> touch = i2c.mem_read(1, 90, 0)[0]
|
|
|
|
The first line above makes an I2C object, and the second line
|
|
enables the 4 touch sensors. The third line reads the touch
|
|
status and the ``touch`` variable holds the state of the 4 touch
|
|
buttons (A, B, X, Y).
|
|
|
|
There is a simple driver `here <http://micropython.org/resources/examples/mpr121.py>`__
|
|
which allows you to set the threshold and debounce parameters, and
|
|
easily read the touch status and electrode voltage levels. Copy
|
|
this script to your pyboard (either flash or SD card, in the top
|
|
directory or ``lib/`` directory) and then try::
|
|
|
|
>>> import pyb
|
|
>>> import mpr121
|
|
>>> m = mpr121.MPR121(pyb.I2C(1, pyb.I2C.CONTROLLER))
|
|
>>> for i in range(100):
|
|
... print(m.touch_status())
|
|
... pyb.delay(100)
|
|
...
|
|
|
|
This will continuously print out the touch status of all electrodes.
|
|
Try touching each one in turn.
|
|
|
|
Note that if you put the LCD skin in the Y-position, then you need to
|
|
initialise the I2C bus using::
|
|
|
|
>>> m = mpr121.MPR121(pyb.I2C(2, pyb.I2C.CONTROLLER))
|
|
|
|
There is also a demo which uses the LCD and the touch sensors together,
|
|
and can be found `here <http://micropython.org/resources/examples/lcddemo.py>`__.
|