.. note::

    こんにちは、SunFounderのRaspberry Pi & Arduino & ESP32愛好家コミュニティへようこそ！Facebook上でRaspberry Pi、Arduino、ESP32についてもっと深く掘り下げ、他の愛好家と交流しましょう。

    **参加する理由は？**

    - **エキスパートサポート**：コミュニティやチームの助けを借りて、販売後の問題や技術的な課題を解決します。
    - **学び＆共有**：ヒントやチュートリアルを交換してスキルを向上させましょう。
    - **独占的なプレビュー**：新製品の発表や先行プレビューに早期アクセスしましょう。
    - **特別割引**：最新製品の独占割引をお楽しみください。
    - **祭りのプロモーションとギフト**：ギフトや祝日のプロモーションに参加しましょう。

    👉 私たちと一緒に探索し、創造する準備はできていますか？[|link_sf_facebook|]をクリックして今すぐ参加しましょう！

.. _1.1.7_py_pi5:

1.1.7 I2C LCD1602
======================

はじめに
------------------

LCD1602は文字型液晶ディスプレイで、同時に32（16*2）文字を表示できます。

必要な部品
------------------------------

このプロジェクトには、次のコンポーネントが必要です。 

.. image:: ../python_pi5/img/1.1.7_i2c_lcd_list.png

一式を購入するのが便利です、こちらがリンクです： 

.. list-table::
    :widths: 20 20 20
    :header-rows: 1

    *   - 名前	
        - このキットのアイテム
        - リンク
    *   - Raphael Kit
        - 337
        - |link_Raphael_kit|

以下のリンクから別々に購入することもできます。

.. list-table::
    :widths: 30 20
    :header-rows: 1

    *   - コンポーネントの紹介
        - 購入リンク

    *   - :ref:`cpn_gpio_board`
        - |link_gpio_board_buy|
    *   - :ref:`cpn_breadboard`
        - |link_breadboard_buy|
    *   - :ref:`cpn_wires`
        - |link_wires_buy|
    *   - :ref:`cpn_i2c_lcd`
        - |link_i2clcd1602_buy|

回路図
---------------------


============ ========
T-Board Name physical
SDA1         Pin 3
SCL1         Pin 5
============ ========

.. image:: ../python_pi5/img/1.1.7_i2c_lcd_schematic.png


実験手順
-----------------------------

**ステップ1:** 回路を組み立てます。

.. image:: ../python_pi5/img/1.1.7_i2c_lcd1602_circuit.png


**ステップ2:** I2Cをセットアップします（ :ref:`i2c_config` を参照してください。I2Cを設定済みの場合は、このステップをスキップしてください。）

**ステップ3:** ディレクトリを変更します。

.. raw:: html

   <run></run>

.. code-block::

    cd ~/raphael-kit/python-pi5

**ステップ4:** 実行します。

.. raw:: html

   <run></run>

.. code-block::

    sudo python3 1.1.7_Lcd1602_zero.py

コードの実行後、LCDに ``Greetings!、From SunFounder`` と表示されます。

.. note::

    * ``FileNotFoundError: [Errno 2] No such file or directory: '/dev/i2c-1'`` というエラーが表示された場合、I2Cを有効にするには :ref:`i2c_config` を参照してください。
    * ``ModuleNotFoundError: No module named 'smbus2'`` エラーが表示された場合、 ``sudo apt install python3-smbus2`` を実行してください。
    * エラー ``OSError: [Errno 121] Remote I/O error`` が表示された場合、モジュールの配線が誤っているか、モジュールが壊れていることを意味します。
    * コードと配線が正常であるが、LCDにコンテンツが表示されない場合、背面のポテンショメータを回してコントラストを上げることができます。



.. warning::

    エラー メッセージ ``RuntimeError: Cannot determine SOC peripheral base address`` が表示された場合は、 :ref:`faq_soc` を参照してください。

**コード**

.. note::

    以下のコードは変更/リセット/コピー/実行/停止ができます。ただし、コードを変更する前に ``raphael-kit/python_5`` のようなソースコードのパスに移動する必要があります。コードを変更した後、直接実行して効果を確認できます。


.. raw:: html

    <run></run>

.. code-block:: python

   #!/usr/bin/env python3
   import LCD1602  # LCD1602とのインターフェースを行うモジュールをインポート
   import time     # タイミング関数のモジュールをインポート

   def setup():
       # I2Cアドレス0x27およびバックライトを有効にしてLCDを初期化
       LCD1602.init(0x27, 1) 
       # メッセージ 'Greetings!' を左上隅（行0、列0）に表示
       LCD1602.write(0, 0, 'Greetings!') 
       # メッセージ 'From SunFounder' を2行目（行1、列1）に表示
       LCD1602.write(1, 1, 'From SunFounder') 
       time.sleep(2)  # メッセージを2秒間表示

   try:
       setup()  # LCDの初期化およびメッセージの表示のためのセットアップ関数を実行します
       
   except KeyboardInterrupt:
       # キーボードの割り込み（例：Ctrl+C）が発生した場合、LCDディスプレイをクリアします
       LCD1602.clear()
       pass  # それ以上のアクションは不要です

**コードの説明**

1. このファイルはI2C LCD1602を制御するためのオープンソースファイルです。これを使用すると、I2C LCD1602を簡単に使用できます。

   .. code-block:: python

       import LCD1602  # Import module for interfacing with LCD1602

2. この関数は指定されたデバイスシンボルを使用してI2Cシステムを初期化します。最初のパラメータはI2Cデバイスのアドレスで、i2cdetectコマンドを使用して検出できます（詳細は付録を参照）。I2C LCD1602のアドレスは通常0x27です。

   .. code-block:: python

       # Initialize LCD with I2C address 0x27 and enable backlight
       LCD1602.init(0x27, 1) 

3. ``LCD1602.write`` はLCDにメッセージを表示するために使用されます。最初の2つのパラメータは行と列の位置で、3番目はメッセージです。これでLCDに "Greetings!! From SunFounder" と表示されるようになります。

   .. code-block:: python

       # Display the message 'Greetings!' at the top-left corner (row 0, column 0)
       LCD1602.write(0, 0, 'Greetings!') 
       # Display the message 'From SunFounder' on the second line (row 1, column 1)
       LCD1602.write(1, 1, 'From SunFounder')