Skip to content

Latest commit

 

History

History
118 lines (69 loc) · 5.46 KB

README.md

File metadata and controls

118 lines (69 loc) · 5.46 KB
Raw

Pimoroni Yukon

This repository is home to the MicroPython build, library, and examples for Pimoroni Yukon.

Build Status GitHub release (latest by date)

Introduction

Yukon is a high-power modular robotics and engineering platform, designed to drive the most ambitious of robots, props and devices!

Powered by RP2040, Yukon leverages the chip's unique pin capabilities to offer six slots for attaching a range of interchangeable hardware modules for driving high-powered devices. This lets you drive unique combinations of motors, servos, steppers, speakers, LED strips, and more, all from a single Yukon board!

Powering Yukon is easy thanks to its XT30 connector, which enables you to attach 2 to 4 cell Lithium Polymer (LiPo) batteries (or any other source from 5V to 17V) to deliver up to 15A continuous for your high-power projects. An e-Fuse with switchable output is included to protect from accidental overvoltage and overcurrent events, along with internal sensors for monitoring voltage, current, and temperature whilst your programs run.

Yukon is supported by a comprehensive MicroPython library with a whopping 50 (!) examples to show you how to use the individual features of the board and all of its modules. There are even showcases of Yukon as a remote-controlled rover, spider tank, and pen plotter!

Download MicroPython

All Yukon boards come pre-flashed with MicroPython and the libraries needed to get you started. The instructions below are for if you wish to update your board to the latest firmware or restore it back back to a factory state.

Grab the latest release from https://github.com/pimoroni/yukon/releases/latest

There are two .uf2 files to pick from:

Firmware Only

  • pimoroni-yukon-vX.X.X-micropython.uf2

This build includes only the firmware needed for Yukon to function. You will need to manually update the lib/pimoroni_yukon library afterwards to get the latest features and bug fixes.

With Filesystem

⚠️ This option will overwrite the entire contents of your Yukon! Be sure to back up files to your PC before installing!

  • pimoroni-yukon-vX.X.X-micropython-with-filesystem.uf2

This build contains both the firmware for Yukon and the library files needed to take full advantage of the hardware.

Flashing the Firmware

  1. Connect Yukon to your computer using a USB A to C cable.

  2. Turn off your board by pressing the PWR button. The green light should turn off.

  3. Put your board into bootloader mode by holding the BOOT/USER button whilst pressing the PWR button to turn the board on. The green light should turn on, and the lights next to the A and B buttons should have a dim glow.

  4. Drag and drop one of the pimoroni-yukon-vX.X.X... .uf2 files to the "RPI-RP2" drive that appears.

  5. After the copy completes your board should reset and, if you used the with-filesystem variant, should start playing a flashing pattern on the A and B LEDs.

ℹ️ Overwriting Yukon's filesystem can take multiple minutes to complete.

Examples

There are many examples to get you started with Yukon, located in the examples folder of this repository. Details about what each one does can be found in their respective sections:

Documentation

To find out more about how Yukon works, the following documentation is available:

Library Reference

To take Yukon further, the full API for the library is described in the following documentation pages.

Boards

Modules

Devices