analogWriteResolution() の解説と実装リファレンス

この記事の目次

【概要】
【仕様】
【技術的特徴】
【注意点】
【サンプルコード】
【活用例】

【概要】

analogWriteResolution() は、Arduino環境においてPWM（パルス幅変調）出力の解像度（ビット数）を動的に設定する関数です。
通常、ArduinoのanalogWrite()は8ビット（0〜255）の解像度で動作しますが、この関数を使用することで、ハードウェアがサポートする範囲内で、より高精度なDuty Cycle（デューティ比）の制御が可能になります。

【仕様】

関数シグネチャ: void analogWriteResolution(uint8_t resolution)
引数:
- resolution: 設定する解像度（ビット数）。一般的に 8, 9, 10, 11, 12, 13, 14, 16 などの値を受け取ります。
戻り値: void（なし）
初期状態: 多くのボードではデフォルトで 8ビットに設定されています。
影響範囲: この関数を呼び出すと、以降の analogWrite() および analogWriteNoDelay() で指定する値の範囲が、2^resolution - 1 に更新されます。

【技術的特徴】

量子化精度の向上:
例えば、8ビットから12ビットに変更した場合、Duty Cycleの制御ステップは $1/256$ から $1/4096$ へと細分化されます。これは、精密なモーター速度制御や、滑らかなLEDの調光が必要なアプリケーションにおいて極めて重要です。
PWM周波数との関係:
PWMの周波数は一般的に TimerClock / Resolution で決定されます。したがって、解像度を上げると、ハードウェアのタイマークロックが固定されている場合、PWM周波数が低下する可能性があります。実装前に目標の周波数と必要な解像度のトレードオフを確認する必要があります。
ハードウェア依存性:
この関数は、すべてのArduino互換ボードで利用できるわけではありません。ESP32やSTM32などの高度なマイコンでは広くサポートされていますが、AVRアーキテクチャ（Arduino Uno等）では制限があるか、実装されていない場合があります。

【注意点】

ハードウェアの最大制限:
指定したビット数がハードウェアの最大解像度を超えている場合、関数は無視されるか、あるいは最大値にクランプされます。使用するマイコンのデータシートを確認してください。
実行時の挙動:
PWMが出力されている最中にこの関数を呼び出すと、タイマーの再設定が発生し、Duty Cycleの一時的な跳ね上がりや、PWM信号の瞬断が発生する可能性があります。安定性が求められるシステムでは、初期化プロセス内での呼び出しを推奨します。
analogReadResolution() との混同:
analogReadResolution() はADC（アナログ入力）の解像度を制御するものであり、PWM出力の解像度を制御する本関数とは全く別の回路・レジスタを操作します。

【サンプルコード】

以下は、ESP32環境を想定した12ビット解像度でのPWM制御例です。

/* 
 * 12ビット解像度を使用した精密なPWM出力の例 
 */
const int ledPin = 18; // ESP32のPWM対応ピン

void setup() {
  // PWM解像度を12ビットに設定 (0-4095)
  analogWriteResolution(12);

  pinMode(ledPin, OUTPUT);
}

void loop() {
  // 12ビット解像度に基づき、Duty Cycleを徐々に変化させる
  for (int i = 0; i <= 4095; i += 10) {
    analogWrite(ledPin, i);
    delay(5);
  }

  for (int i = 4095; i >= 0; i -= 10) {
    analogWrite(ledPin, i);
    delay(5);
  }
}

【活用例】

精密モーター制御:
DCモーターの回転速度を極めて微細なステップで制御する必要があるロボットアームやドローンにおいて、8ビットよりも高い解像度（12ビット等）を適用する。
高精度LED調光:
PWMの量子化ノイズ（ステップ感）を最小限に抑え、シームレスな光の強弱変化を実現する照明システム。
サーボモーターの微細位置調整:
標準的なPWM幅よりも細かい分解能を要求する特殊なサーボ制御において、解像度を上げることでより正確な角度制御を行う。