README.md

Meadow.ProjectLab

Project Lab is the most functional IoT prototyping platform on the planet. No more breadboards, complicated wiring, or soldering. Project Lab was built from the ground up using the industry's most powerful, capable, and reliable sensors, components, and connectors.

Contents

• Purchasing or Building
• Getting Started
• Hardware Specifications
• Pinout Diagram
  • Project Lab v3.e
  • Project Lab v2.e
  • Project Lab v1.e
• Industrial Enclosure Design
• Additional Samples
• Support

Purchasing or Building

You can get a Project Lab fully assembled from the Wilderness Labs store.	It's also designed so that it can be assembled at home for the adventurous. All design files can be found in the Hardware Design folder.

Getting Started

To make using the hardware even simpler, we've created a Nuget package that instantiates and encapsulates the onboard hardware into a ProjectLab class.

1. Add the ProjectLab Nuget package your project:

   • dotnet add package Meadow.ProjectLab, or
   • Meadow.ProjectLab Nuget Package
   • Explore in Fuget.org

2. Instantiate the ProjectLab class:

public class MeadowApp : App<F7FeatherV2>
{
    IProjectLabHardware projLab;

    public override Task Initialize()
    {
        projLab = ProjectLab.Create();
        ...

3. To Access the Project Lab onboard peripherals:

    if (projLab.EnvironmentalSensor is { } bme688)
    {
        bme688.Updated += Bme688Updated;
        bme688.StartUpdating(TimeSpan.FromSeconds(5));
    }

4. To use an I2C peripheral (with a Grove Character display as an example):

    var display = new CharacterDisplay
    (
        i2cBus: projLab.I2cBus,
        address: (byte)I2cCharacterDisplay.Addresses.Grove,
        rows: 2, columns: 16,
        isGroveDisplay: true
    );

Hardware Specifications

Onboard Peripherals	Connectivity
ILI9341 - SPI 320x240 color display	MikroBUS - Two sets of MikroBUS pin headers
BMI270 - I2C motion and acceleration sensor	Qwiic - Stemma QT I2C connector
BH1750 - I2C light sensor	Grove - Analog header
BME688 - I2C atmospheric sensor	Grove - GPIO/serial header
Push Button - 4 momentary buttons	RS-485 - Serial
Magnetic Audio Transducer - High quality piezo speaker	Ports - 3.3V, 5V, ground, one analog and two GPIO ports

You can find the schematics and other design files in the Hardware folder.

Pinout Diagram

Check the diagrams below to see what pins on the Meadow are connected to every peripheral on board and its connectors:  

Project Lab v3.e

Project Lab v2.e

Project Lab v1.e

Industrial Enclosure Design

The enclosure was designed in Autodesk Fusion 360. The source file can be found and STL files can be found here.

Additional Samples

1. Setup your Meadow Build Environment - If you haven't deployed a Meadow app before, you'll need to setup your IDE extension(s), deploy Meadow.OS, etc.
2. Run the Demo App - Deploy the Project Lab demonstration app to see the built in peripherals at work.
3. Check out the Project Lab Samples - We recommend cloning the Meadow.ProjectLab.Samples repo. There you'll find a bunch of awesome samples that you can run right out-of-the box!

Support

Having trouble building/running these projects?

• File an issue with a repro case to investigate, and/or
• Join our public Slack, where we have an awesome community helping, sharing and building amazing things using Meadow.