.. note::

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

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

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

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

.. _ar_passive_buzzer:

5.7 ``Tone()`` または ``noTone()``
======================================

``Tone()`` は、指定された周波数（および50％のデューティサイクル）の方形波をピンに生成するために使用されます。持続時間を指定することもできますが、そうしない場合、 ``noTone()`` が呼び出されるまで波は続きます。

このプロジェクトでは、この2つの関数を使用して、受動ブザーを振動させて音を出します。
アクティブブザーと同様に、受動ブザーも電磁誘導の現象を利用して動作します。
違いは、受動ブザーには振動源がないため、DC信号を使用するとビープ音が鳴らないことです。
ただし、このことにより、受動ブザーは自身の振動周波数を調整し、“ド、レ、ミ、ファ、ソ、ラ、シ”などの異なる音符を出すことができます。

**必要な部品**

このプロジェクトには、以下の部品が必要です。

キット全体を購入すると非常に便利です、リンクは以下の通りです：

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

    *   - 名前	
        - このキットのアイテム
        - リンク
    *   - 3 in 1 Starter Kit
        - 380+
        - |link_3IN1_kit|

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

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

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

    *   - :ref:`cpn_uno`
        - |link_Uno_R3_buy|
    *   - :ref:`cpn_breadboard`
        - |link_breadboard_buy|
    *   - :ref:`cpn_wires`
        - |link_wires_buy|
    *   - :ref:`cpn_buzzer`
        - |link_passive_buzzer_buy|


**回路図**

.. image:: img/circuit_6.1_passive.png

ブザーのカソードをGNDに、アノードをデジタルピン9に接続します。

**配線図**

.. image:: img/custom_tone_bb.jpg

**コード**

.. note::

    * ``3in1-kit\basic_project\5.7.tone_notone`` のパスの下の ``5.7.tone_notone.ino`` ファイルを開きます。
    * または、このコードを **Arduino IDE** にコピーします。
    
    * または、 `Arduino Web Editor <https://docs.arduino.cc/cloud/web-editor/tutorials/getting-started/getting-started-web-editor>`_ を通じてコードをアップロードします。

.. raw:: html

    <iframe src=https://create.arduino.cc/editor/sunfounder01/9212e985-1f31-4bd9-bee6-f29357035aae/preview?embed style="height:510px;width:100%;margin:10px 0" frameborder=0></iframe>

コードをR3ボードにアップロードすると、7つの音符を含むメロディーが聞こえます。

**どのように動作するのか？**

注意すべき2点があります：

1. ``tone()`` & ``noTone()`` : この関数は受動ブザーの音を直接制御するために使用され、そのプロトタイプは次のとおりです：

**文法**
    void tone(int pin, unsigned int frequency)

    void tone(int pin, unsigned int frequency, unsigned long duration)

**パラメータ**
    * ``pin``: トーンを生成するArduinoのピン。
    * ``frequency``: トーンの周波数（ヘルツ単位）。
    * ``duration``: トーンの持続時間（ミリ秒、オプション）

パッシブ・ブザーを振動させて音を出すように）指定された周波数の矩形波（デューティ・サイクルは50%）をピンに発生させる。継続時間を指定することができ、指定しない場合は ``noTone()`` が呼び出されるまで波が継続する。
このピンをピエゾブザーなどのスピーカーに接続し、音を鳴らすことができる。

一度に生成できるトーンは1つだけである。トーン が既に別のピンで再生されている場合、 ``tone()`` を呼び出しても効果はない。トーンが同じピンで再生されている場合、呼び出しはその周波数を設定する。

``tone()`` 関数の使用は、ピン3および11のPWM出力を妨害します。

31Hzより低いトーンを生成することはできません。

**文法**
    void noTone(int pin)

**パラメータ**
    ``pin``: トーンを生成するArduinoのピン。

``tone()`` によってトリガーされた方形波の生成を停止します。トーンが生成されていない場合、効果はありません。

これらの2つの関数を知ったら、コードの理解ができるでしょう—配列 ``melody[]`` と配列 ``noteDurations[]`` の設定は、後続の複数回の ``tone()`` 関数の呼び出しと、ループ内でのトーンと持続時間の変更が、音楽の再生効果をより良くするための準備です。

2. ``pitches.h`` : コードは追加のファイル、 ``pitches.h`` を使用します。このファイルには、典型的な音符のピッチ値がすべて含まれています。たとえば、NOTE_C4は中央のCです。NOTE_FS4はF#です。この音符テーブルは、 ``tone()`` コマンドの基礎となっているBrett Hagmanによって元々書かれていました。音楽の音符を作成したい場合、これが役立つでしょう。

.. code-block:: arduino

    #include "pitches.h"

.. note::
    このサンプルプログラムにはすでに ``pitches.h`` ファイルが含まれています。メインのコードと同じフォルダに置く場合、 ``pitches.h`` のインストールの後続の手順は省略できます。

.. image:: img/image123.png

コードファイルを開いた後、 ``pitches.h`` コードを開くことができない場合は、手動で1つ作成することができます。手順は以下の通りです：

``pitches.h`` ファイルを作成するには、シリアルモニターアイコンのすぐ下のボタンをクリックして **New Tab** を選択するか、 **Ctrl+Shift+N** を使用します。

.. image:: img/image124.png

次に、以下のコードを貼り付けて、それを ``pitches.h`` として保存します：


.. code-block:: arduino

    /*****************
    Public Constants
    *****************/
    #define NOTE_B0  31
    #define NOTE_C1  33
    #define NOTE_CS1 35
    #define NOTE_D1  37
    #define NOTE_DS1 39
    #define NOTE_E1  41
    #define NOTE_F1  44
    #define NOTE_FS1 46
    #define NOTE_G1  49
    #define NOTE_GS1 52
    #define NOTE_A1  55
    #define NOTE_AS1 58
    #define NOTE_B1  62
    #define NOTE_C2  65
    #define NOTE_CS2 69
    #define NOTE_D2  73
    #define NOTE_DS2 78
    #define NOTE_E2  82
    #define NOTE_F2  87
    #define NOTE_FS2 93
    #define NOTE_G2  98
    #define NOTE_GS2 104
    #define NOTE_A2  110
    #define NOTE_AS2 117
    #define NOTE_B2  123
    #define NOTE_C3  131
    #define NOTE_CS3 139
    #define NOTE_D3  147
    #define NOTE_DS3 156
    #define NOTE_E3  165
    #define NOTE_F3  175
    #define NOTE_FS3 185
    #define NOTE_G3  196
    #define NOTE_GS3 208
    #define NOTE_A3  220
    #define NOTE_AS3 233
    #define NOTE_B3  247
    #define NOTE_C4  262
    #define NOTE_CS4 277
    #define NOTE_D4  294
    #define NOTE_DS4 311
    #define NOTE_E4  330
    #define NOTE_F4  349
    #define NOTE_FS4 370
    #define NOTE_G4  392
    #define NOTE_GS4 415
    #define NOTE_A4  440
    #define NOTE_AS4 466
    #define NOTE_B4  494
    #define NOTE_C5  523
    #define NOTE_CS5 554
    #define NOTE_D5  587
    #define NOTE_DS5 622
    #define NOTE_E5  659
    #define NOTE_F5  698
    #define NOTE_FS5 740
    #define NOTE_G5  784
    #define NOTE_GS5 831
    #define NOTE_A5  880
    #define NOTE_AS5 932
    #define NOTE_B5  988
    #define NOTE_C6  1047
    #define NOTE_CS6 1109
    #define NOTE_D6  1175
    #define NOTE_DS6 1245
    #define NOTE_E6  1319
    #define NOTE_F6  1397
    #define NOTE_FS6 1480
    #define NOTE_G6  1568
    #define NOTE_GS6 1661
    #define NOTE_A6  1760
    #define NOTE_AS6 1865
    #define NOTE_B6  1976
    #define NOTE_C7  2093
    #define NOTE_CS7 2217
    #define NOTE_D7  2349
    #define NOTE_DS7 2489
    #define NOTE_E7  2637
    #define NOTE_F7  2794
    #define NOTE_FS7 2960
    #define NOTE_G7  3136
    #define NOTE_GS7 3322
    #define NOTE_A7  3520
    #define NOTE_AS7 3729
    #define NOTE_B7  3951
    #define NOTE_C8  4186
    #define NOTE_CS8 4435
    #define NOTE_D8  4699
    #define NOTE_DS8 49