描述

項目更新到 V1.0 Release Candidate 2（2022 年 12 月 31 日）

在這個 Meadow 項目中，我們將學習如何使用幾個旋轉編碼器和一個 TFT SPI 顯示器來構建非常流行的復古繪畫玩具 Etch-A-Sketch。我們將看到使用強大的驅動程序平臺Meadow.Foundation及其 GraphicsLibrary編寫邏輯來完成所有繪圖是多么容易。

構建此項目所需的一切都包含在Wilderness Labs Meadow F7 w/Hack Kit Pro 中。我們將看到使用 Meadow.Foundation 對這些外圍設備進行編程是多么容易。

Meadow.Foundation是一個平臺，用于在 Meadow 上使用 .NET 快速輕松地構建連接的事物。它由Wilderness Labs 創建，完全開源，由 Wilderness Labs 社區維護。

如果您是 Meadow 的新手，我建議您通過控制板載 RGB LED 項目轉到 Meadow 入門，以正確設置您的開發環境。

第 1 步 - 組裝電路

像下面的 Fritzing 圖一樣連接你的 EdgeASketch 電路：

?

EtchASketch with Meadow 的 Fritzing 圖

?

關于 Meadow F7中斷的注意事項

如果仔細查看圖表，您會發現我們將頂部旋轉編碼器連接到模擬引腳 A1、A2 和 A3。這是可能的，因為您實際上可以將這些引腳配置為數字輸入端口來處理中斷。檢查這個 Meadow 引出線圖：

Meadow F7v2 微型引出線

?

請注意標有中斷組的引腳范圍從組 00 到組 15。在配置數字輸入端口時要記住這一點很重要，您必須確保每個中斷組只使用一個引腳，否則您將嘗試獲取事件時遇到問題。例如，在配置引腳D08和D09時不會收到中斷事件，因為它們都屬于中斷組06 。

第 2 步 - 創建 Meadow 應用程序項目

在 Visual Studio 2019 for Windows或macOS中創建一個新的Meadow Application項目并將其命名為EdgeASketch 。

第 3 步 - 添加所需的 NuGet 包

對于這個項目，搜索并安裝以下 NuGet 包：

• Meadow.Foundation.Displays.TftSpi

第 4 步 - 為 EdgeASketch 編寫代碼

復制下面的代碼：

// public class MeadowApp : App <- If you have a Meadow F7v1.*
public class MeadowApp : App
{
    int x, y;
    MicroGraphics graphics;
    RotaryEncoderWithButton rotaryX;
    RotaryEncoderWithButton rotaryY;

    public override Task Initialize()
    {
        var onboardLed = new RgbPwmLed(
            device: Device,
            redPwmPin: Device.Pins.OnboardLedRed,
            greenPwmPin: Device.Pins.OnboardLedGreen,
            bluePwmPin: Device.Pins.OnboardLedBlue);
        onboardLed.SetColor(Color.Red);

        var config = new SpiClockConfiguration(
            speed: new Frequency(48000, Frequency.UnitType.Kilohertz),
            mode: SpiClockConfiguration.Mode.Mode3);
        var spiBus = Device.CreateSpiBus(
            clock: Device.Pins.SCK,
            copi: Device.Pins.MOSI,
            cipo: Device.Pins.MISO,
            config: config);
        var st7789 = new St7789(
            device: Device,
            spiBus: spiBus,
            chipSelectPin: null,
            dcPin: Device.Pins.D01,
            resetPin: Device.Pins.D00,
            width: 240, height: 240);

        graphics = new MicroGraphics(st7789);
        graphics.Clear(true);
        graphics.DrawRectangle(0, 0, 240, 240, Color.White, true);
        graphics.DrawPixel(x, y, Color.Red);
        graphics.Show();

        x = graphics.Width / 2;
        y = graphics.Height / 2;

        rotaryX = new RotaryEncoderWithButton(
            device: Device,
            aPhasePin: Device.Pins.A01, 
            bPhasePin: Device.Pins.A02, 
            buttonPin: Device.Pins.A03);
        rotaryX.Rotated += RotaryXRotated;

        rotaryY = new RotaryEncoderWithButton(
            Device,
            Device.Pins.D03, 
            Device.Pins.D04, 
            Device.Pins.D05);
        rotaryY.Rotated += RotaryYRotated;
        rotaryY.Clicked += RotaryYClicked;

        onboardLed.SetColor(Color.Green);

        return base.Initialize();
    }

    void RotaryXRotated(object sender, RotaryChangeResult e)
    {
        if (e.New == RotationDirection.Clockwise)
            x++;
        else
            x--;

        x = Math.Clamp(x, 1, graphics.Width - 1);

        graphics.DrawPixel(x, y + 1, Color.Red);
        graphics.DrawPixel(x, y, Color.Red);
        graphics.DrawPixel(x, y - 1, Color.Red);
    }

    void RotaryYRotated(object sender, RotaryChangeResult e)
    {
        if (e.New == RotationDirection.Clockwise)
            y++;
        else
            y--;

        y = Math.Clamp(y, 1, graphics.Height - 1);

        graphics.DrawPixel(x + 1, y, Color.Red);
        graphics.DrawPixel(x, y, Color.Red);
        graphics.DrawPixel(x - 1, y, Color.Red);
    }

    void RotaryYClicked(object sender, EventArgs e)
    {
        x = graphics.Width / 2;
        y = graphics.Height / 2;

        graphics.DrawRectangle(0, 0, 240, 240, Color.White, true);
        graphics.DrawPixel(x, y, Color.Red);
    }

    public override async Task Run()
    {
        while (true)
        {
            graphics.Show();
            await Task.Delay(500);
        }
    }
}

草地建設者

在 MeadowApp 中Constructor，我們首先初始化ST7789 SPI 顯示和 MicroGraphics 庫，我們立即繪制一個覆蓋整個屏幕的白色填充矩形，并在顯示中間使用先前初始化的 x 和 y 整數繪制一個紅色像素。我們也初始化了兩個Rotary Encoders，一個控制X軸的繪制，一個控制Y軸的繪制。兩個扶輪社都Rotated 注冊了該事件。

RotatyXRotated 和 RotatyYRotated 事件處理程序

e.Direction在事件處理程序中，您可以通過訪問屬性并與枚舉進行比較以查看其是順時針還是逆時針來檢查旋轉編碼器轉向的方向。RotationDirection如果它是順時針方向，我們增加 X 或 Y 坐標（取決于旋轉的是哪個 Rotaty），如果它以相反的方向旋轉，我們將減少。

請注意，我們在兩個方向上一次繪制三個像素，我們這樣做是為了讓線條描邊更粗一些，因為顯示器的分辨率太高了，繪制的線條太長了，很難看清是什么你正在做的。

旋轉Y點擊

由于我們使用帶按鈕的旋轉編碼器，您可以像處理按鈕一樣處理 Click 事件處理程序。事件RotaryYClicked 處理程序將清除顯示并將 x 和 y 坐標重新初始化回顯示的中間。

第 5 步 - 運行項目

單擊Visual Studio中的“運行”按鈕。它應該類似于以下 GIF：

查看 Meadow.Foundation！

就您可以使用 Meadow.Foundation 做的大量令人興奮的事情而言，這個項目只是冰山一角。

• 它帶有一個龐大的外設驅動程序庫，其中包含適用于最常見傳感器和外設的驅動程序。
• 外設驅動程序封裝了核心邏輯并公開了一個簡單、干凈、現代的 API。
• 該項目得到了不斷發展的社區的支持，該社區不斷致力于構建酷炫的互聯事物，并且總是樂于幫助新來者和討論新項目。

參考

• 草地向導
• 草地基金會
• Meadow.Foundation.Displays.Tft.St7789 API
• Meadow.Foundation.Sensors.Rotary.RotaryEncoderWithButton API