GPIO

• Functions
  • pinMode
  • digitalRead
  • digitalWrite
  • analogRead
  • dacWrite
  • Ledc
    • ledcSetup
    • ledcAttachPin
    • ledcWrite
    • ledcDetachPin
    • ledcRead
    • ledcReadFreq
  • ADC
    • adcAttachPin
    • adcStart
    • adcBusy
    • adcEnd
    • analogReadResolution
    • analogSetAttenuation
    • analogSetCycles
    • analogSetPinAttenuation
    • analogSetSamples
    • analogSetWidth
    • attachInterrupt
    • detachInterrupt
  • hallRead

*Refer to Arduino API of Arduino *

M5STACK ピン配列です:

pinMode

機能です:

ピン入出力モードを設定します

原型関数です:

void pinMode(uint8_t pin, uint8_t mode);

使用例です:

#include <M5Stack.h>

void setup() {
    M5.begin();
    M5.Power.begin();
    pinMode(16, OUTPUT);
}
void loop() {
}

digitalRead

機能です:

指定のピンの状態を読み込みます

原型関数です:

int digitalRead(uint8_t pin);

戻り値です:

ピンの入力状態（0/1）

使用例です:

#include <M5Stack.h>

void setup() {
    M5.begin();
    M5.Power.begin();
    M5.Lcd.setTextSize(2);
}
void loop() {
    M5.Lcd.printf("Read value:%d\n", digitalRead(39));
    delay(500);
}

digitalWrite

機能です:

指定のピンに値を書き込みます

原型関数です:

void digitalWrite(uint8_t pin, uint8_t val);

使用例です:

#include <M5Stack.h>

void setup() {
    M5.begin();
    M5.Power.begin();
    M5.Lcd.setTextSize(2);
    pinMode(16, OUTPUT);
}
void loop() {
    M5.update();
    M5.Lcd.printf("Read value:%d\n", digitalRead(16));
    delay(500);
}

analogRead

機能です:

アナログピンの値を読み込みます

原型関数です:

uint16_t analogRead(uint8_t pin);

戻り値です:

analogSetWidth()によって決定される最大応答値を読み込みます

使用例です:

#include <M5Stack.h>

void setup() {
    M5.begin();
    M5.Power.begin();
    M5.Lcd.setTextSize(2);
}
void loop() {
    M5.Lcd.printf("Read value:%d\n", analogRead(35));
    delay(500);
}

dacWrite

機能です:

指定のピンに DAC 出力を送信します

原型関数です:

void dacWrite(uint8_t pin, uint8_t value);

使用例です:

#include <M5Stack.h>

void setup() {
    M5.begin();
    M5.Power.begin();
    M5.Lcd.setTextSize(2);
    pinMode(25, OUTPUT);
}
void loop() {
    dacWrite(25,0x40);
    delay(500);
}

ledcSetup

機能です:

占空比出力を設定します

原型関数です:

double ledcSetup(uint8_t channel, double freq, uint8_t resolution_bits);

戻り値です:

実際の出力周波数

ledcAttachPin

機能です:

指定の ledc チャンネルにピンをバインドします

原型関数です:

void ledcAttachPin(uint8_t pin, uint8_t chan);

ledcWrite

機能です:

指定の占空比値を出力します

原型関数です:

void ledcWrite(uint8_t chan, uint32_t duty);

使用例です:

#include <M5Stack.h>

uint8_t pin = 25;  // Set output pin number.设置输出引脚号

void setup() {
    M5.begin();
    M5.Power.begin();
    double f = ledcSetup(1, 1000, 10);  // Use ledc channel 1, set the frequency to 1kHz and the resolution to 10 bits.使用ledc通道1，设置频率为1kHz，分辨率为10位
    Serial.printf("F=%.0f\n",f);  // print the actual setting. 打印实际设置的频率
    ledcAttachPin(pin,1);  // Bind the  pin to ledc channel 1.将引脚绑定到ledc通道1
    ledcWrite(1, 511);  // Set the duty cycle of ledc channel to 512/1024=50%.设置ledc通道占空比为512/1024=50%
}

void loop() {
    delay(100);
}

ledcDetachPin

機能です:

指定のポートを解放し、出力を停止します

原型関数です:

void ledcDetachPin(uint8_t pin);

使用例です:

#include <M5Stack.h>

uint8_t pin = 25;  // Set output pin number. 设置输出引脚号

void setup() {
    M5.begin();
    M5.Power.begin();
    double f = ledcSetup(1, 1000, 10);  // Use ledc channel 1, set the frequency to 1kHz and the resolution to 10 bits.使用ledc通道1，设置频率为1kHz，分辨率为10位
    Serial.printf("F=%.0f\n",f);  // print the actual setting. 打印实际设置的频率
    ledcAttachPin(pin,1);  // Bind the pin to ledc channel 1.将引脚绑定到ledc通道1
    ledcWrite(1, 511);  // Set the duty cycle of ledc channel to 512/1024=50%.设置ledc通道占空比为512/1024=50%
    ledcDetachPin(pin);  // Stop the pin output.  停止引脚输出
}

void loop() {
    delay(100);
}

ledcRead

機能です:

指定された通路のデューティサイクルに戻ります。

原型関数です:

uint32_t ledcRead(uint8_t channel)

戻り値です:

デューティサイクルです

使用例です:

#include <M5Stack.h>

uint8_t pin = 25;  // Set output pin number.设置输出引脚号

void setup() {
    M5.begin();
    M5.Power.begin();
    double f = ledcSetup(1, 1000, 10);  // Use ledc channel 1, set the frequency to 1kHz and the resolution to 10 bits.使用ledc通道1，设置频率为1kHz，分辨率为10位
    Serial.printf("F=%.0f\n",f);  // print the actual setting. 打印实际设置的频率
    ledcAttachPin(pin,1);  // Bind the  pin to ledc channel 1.将引脚绑定到ledc通道1
    ledcWrite(1, 511);  // Set the duty cycle of ledc channel to 512/1024=50%.设置ledc通道占空比为512/1024=50%
    M5.Lcd.printf("ledcRead:%d\n", ledcRead(1));  // print the actual duty cycle. 打印实际占空比
}

void loop() {
    delay(100);
}

ledcReadFreq

機能です:

現在のチャネル周波数に戻ります。

原型関数です:

double ledcReadFreq(uint8_t channel)

戻り値です:

チャネル周波数です

使用例です:

#include <M5Stack.h>

uint8_t pin = 25;  // Set output pin number.设置输出引脚号

void setup() {
    M5.begin();
    M5.Power.begin();
    double f = ledcSetup(1, 1000, 10);  // Use ledc channel 1, set the frequency to 1kHz and the resolution to 10 bits.使用ledc通道1，设置频率为1kHz，分辨率为10位
    Serial.printf("F=%.0f\n",f);  // print the actual setting. 打印实际设置的频率
    ledcAttachPin(pin,1);  // Bind the  pin to ledc channel 1.将引脚绑定到ledc通道1
    ledcWrite(1, 511);  // Set the duty cycle of ledc channel to 512/1024=50%.设置ledc通道占空比为512/1024=50%
    M5.Lcd.printf("ledcRead:%d\n", ledcRead(1));  // print the actual duty cycle. 打印实际占空比
}

void loop() {
    delay(1000);
    M5.Lcd.printf("ledcReadFreq:%.3f\n",ledcReadFreq(1));  // print the actual duty cycle. 打印实际占空比
}

adcAttachPin

機能です:

非ブロッキングモード,接続設定ピンを ADC に設定します

原型関数です:

bool adcAttachPin(uint8_t pin)

使用例です:

#include <M5Stack.h>

uint8_t pin = 25;  // Set output pin number. 设置输出引脚号

void setup() {
    M5.begin();
    M5.Power.begin();
    if (adcAttachPin(pin)) {  // Attach the pin to ADC. 将引脚绑定到ADC
        M5.Lcd.printf("Pin %d attached to ADC", pin);
    };
}

void loop() {}

adcStart

機能です:

非ブロッキングモードで、ADC 変換を開始。

原型関数です:

bool adcStart(uint8_t pin)

戻り値です:

成功開始したら 1 を返す、そうでない場合は 0 を返す。

adcBusy

機能です:

非ブロッキングモードで、ADC 変換が進行中かどうかを検査。

原型関数です:

bool adcBusy(uint8_t pin)

adcEnd

機能です:

非ブロッキングモードで、変換結果を返す。変換が完了していない場合は待ちます。

原型関数です:

uint16_t adcEnd(uint8_t pin)

戻り値です:

変換結果を返す。

analogReadResolution

機能です:

模拟データ読み込みの分解能を設定。116 の範囲で指定。既定値は 12。範囲が 912 の間の場合は、設定したハードウェア分解能が使われ、それ以外の場合は値が調整されます。

原型関数です:

void analogReadResolution(uint8_t bits)

analogSetAttenuation

機能です:

ADC の全体的入力減衰を設定。ADC_0db, ADC_2_5db, ADC_6db, ADC_11db のいずれかを指定。既定値は 11db。

原型関数です:

void analogSetAttenuation(adc_attenuation_t attenuation)

analogSetCycles

機能です:

サンプリング周期を 1~255 の範囲で設定。既定値は 8。

原型関数です:

void analogSetCycles(uint8_t cycles)

analogSetPinAttenuation

機能です:

個々のピンの減衰を設定。

原型関数です:

void analogSetPinAttenuation(uint8_t pin, adc_attenuation_t attenuation)

analogSetSamples

機能です:

単一のサンプリングの実際のサンプル倍率を 1~255 の範囲で設定。既定値は 1。adc の感度を高める効果をもたらし、サンプル数を N 倍に拡大。

原型関数です:

void analogSetSamples(uint8_t samples)

analogSetWidth

機能です:

adc のサンプリング分解能を 9~12 の範囲で設定。既定値は 12。

原型関数です:

void analogSetWidth(uint8_t bits)

attachInterrupt

機能です:

ピン割り当ての割り込みを設定。

原型関数です:

void attachInterrupt(pin, ISR(callback function), interrupt type/mode)

detachInterrupt

機能です:

指定のピン割り当ての割り込みを無効化。

原型関数です:

void detachInterrupt(pin)

hallRead

機能です:

ホールセンサーを読み込み。

原型関数です:

int hallRead(void));