Skip to content
Permalink
Browse files

Added rev 2

  • Loading branch information
arturo182 committed Dec 15, 2019
1 parent b1bb4fc commit 344aaecc1357cf0a71d6bb79984b6d7e6d1424ee
Showing with 407 additions and 36 deletions.
  1. +0 −10 content/docs/pinout.md
  2. +0 −9 content/menu/index.md
  3. +2 −1 content/{ → r1}/_index.md
  4. +3 −2 content/{ → r1}/docs/downloads.md
  5. +11 −10 content/{ → r1}/docs/gpios.md
  6. +4 −3 content/{ → r1}/docs/guided-tour.md
  7. +11 −0 content/r1/docs/pinout.md
  8. 0 content/{ → r1}/docs/shortcodes.md
  9. +9 −0 content/r1/menu/index.md
  10. +30 −0 content/r2/_index.md
  11. +44 −0 content/r2/docs/downloads.md
  12. +48 −0 content/r2/docs/gpios.md
  13. +29 −0 content/r2/docs/guided-tour.md
  14. +11 −0 content/r2/docs/pinout.md
  15. +195 −0 content/r2/docs/shortcodes.md
  16. +9 −0 content/r2/menu/index.md
  17. BIN static/{ → r1}/both_boards.jpg
  18. BIN static/{ → r1}/both_boards_small.jpg
  19. BIN static/{ → r1}/config-2xuart.png
  20. BIN static/{ → r1}/config-i2c.png
  21. BIN static/{ → r1}/config-spi-i2c.png
  22. BIN static/{ → r1}/config-spi-uart.png
  23. BIN static/{ → r1}/config-spi.png
  24. BIN static/{ → r1}/config-uart-i2c.png
  25. BIN static/{ → r1}/config-uart.png
  26. BIN static/{ → r1}/config-uart2.png
  27. BIN static/{ → r1}/pinout.png
  28. BIN static/{ → r1}/pinout_small.png
  29. BIN static/{ → r1}/schematics_plug.png
  30. BIN static/{ → r1}/schematics_serpente.png
  31. BIN static/{ → r1}/tour_plug.jpg
  32. BIN static/{ → r1}/tour_small.jpg
  33. BIN static/{ → r1}/tour_type_c.jpg
  34. BIN static/r2/config-2xuart.png
  35. BIN static/r2/config-i2c.png
  36. BIN static/r2/config-spi-i2c.png
  37. BIN static/r2/config-spi-uart.png
  38. BIN static/r2/config-spi.png
  39. BIN static/r2/config-uart-i2c.png
  40. BIN static/r2/config-uart.png
  41. BIN static/r2/config-uart2.png
  42. BIN static/r2/drawing_plug.png
  43. BIN static/r2/drawing_plug_c.png
  44. BIN static/r2/drawing_serpente.png
  45. BIN static/r2/pinout.png
  46. BIN static/r2/pinout_small.png
  47. BIN static/r2/schematics_plug.png
  48. BIN static/r2/schematics_plug_c.png
  49. BIN static/r2/schematics_serpente.png
  50. BIN static/r2/three_boards.jpg
  51. BIN static/r2/three_boards_small.jpg
  52. BIN static/r2/tour_plug.jpg
  53. BIN static/r2/tour_plug_c.jpg
  54. BIN static/r2/tour_serpente.jpg
  55. +1 −1 themes/book

This file was deleted.

This file was deleted.

@@ -1,6 +1,7 @@
---
title: Introduction
type: docs
rev: r1
---

# Introduction
@@ -25,4 +26,4 @@ Here are some of the technical details regarding the boards:
- User-controlled RGB LED
- Mounting holes on the Serpente Type-C board

[![Both Boards](/both_boards_small.jpg)](/both_boards.jpg)
[![Both Boards](/r1/both_boards_small.jpg)](/r1/both_boards.jpg)
@@ -1,6 +1,7 @@
---
title: Downloads
type: docs
rev: r1
---

# Downloads
@@ -18,8 +19,8 @@ The Serpente boards come with [UF2 Bootloader](https://github.com/microsoft/uf2-

### Serpente Type-C

[![Schematic](/schematics_serpente.png)](/schematics_serpente.png)
[![Schematic](/r1/schematics_serpente.png)](/r1/schematics_serpente.png)

### Serpente Plug

[![Schematic Plug](/schematics_plug.png)](/schematics_plug.png)
[![Schematic Plug](/r1/schematics_plug.png)](/r1/schematics_plug.png)
@@ -1,11 +1,12 @@
---
title: GPIO Configurations
type: docs
rev: r1
---

# GPIO Configurations

Thanks to the flexibility of the SAMD21 SERCOM peripheral, the Serpente boards give you access to multiple serial interfaces with just 6 GPIOs. See [Pinout]({{< relref "/docs/pinout.md" >}}) for an overview of the pins.
Thanks to the flexibility of the SAMD21 SERCOM peripheral, the Serpente boards give you access to multiple serial interfaces with just 6 GPIOs. See [Pinout]({{< relref "/r1/docs/pinout.md" >}}) for an overview of the pins.

Note that most of the interfaces are easily accessible using CircuitPython, altough some of them can't be used at the same time:
{{< highlight python >}}
@@ -20,28 +21,28 @@ uart2 = busio.UART(board.TX2, board.RX2)
Here's a list of some of the ways you can configure the GPIOs on your Serpente:

## SPI + 3 GPIOs
<img src="/config-spi.png" style="width: 500px">
<img src="/r1/config-spi.png" style="width: 500px">

## I2C + 4 GPIOs
<img src="/config-i2c.png" style="width: 500px">
<img src="/r1/config-i2c.png" style="width: 500px">

## UART + 4 GPIOs
<img src="/config-uart.png" style="width: 500px"><br>
<img src="/r1/config-uart.png" style="width: 500px"><br>
or<br>
<img src="/config-uart2.png" style="width: 500px"><br>
<img src="/r1/config-uart2.png" style="width: 500px"><br>

## 2x UART + 2 GPIOs
<img src="/config-2xuart.png" style="width: 500px"><br>
<img src="/r1/config-2xuart.png" style="width: 500px"><br>
**Note: Because of a quirk on CircuitPython's implementation, you need to initialize UART 2 before UART.**

## SPI + I2C + 1 GPIO
<img src="/config-spi-i2c.png" style="width: 500px">
<img src="/r1/config-spi-i2c.png" style="width: 500px">

## SPI + UART + 1 GPIO
<img src="/config-spi-uart.png" style="width: 500px">
<img src="/r1/config-spi-uart.png" style="width: 500px">

## UART + I2C + 2 GPIOs
<img src="/config-uart-i2c.png" style="width: 500px">
<img src="/r1/config-uart-i2c.png" style="width: 500px">

## 6 GPIOs
See [Pinout]({{< relref "/docs/pinout.md" >}}).
See [Pinout]({{< relref "/r1/docs/pinout.md" >}}).
@@ -1,23 +1,24 @@
---
title: Guided Tour
type: docs
rev: r1
---

# Guided Tour

Let's have a quick look at the boards and what's on them. Both boards have the same components except the USB connectors.

{{< columns >}}
[![Serpente Plug](/tour_plug.jpg)](/tour_plug.jpg)
[![Serpente Plug](/r1/tour_plug.jpg)](/r1/tour_plug.jpg)
<--->
[![Serpente Type-C](/tour_type_c.jpg)](/tour_type_c.jpg)
[![Serpente Type-C](/r1/tour_type_c.jpg)](/r1/tour_type_c.jpg)
{{< /columns >}}

- **USB A / USB Type-C Connector** - Two options to choose from, use the one that works best for you! USB is used for both data and power. The Type-C connector supports only USB 2.0 signals and is hardwired to be a Sink only.
- **Reset Button** - Allows you to reset the board quickly and if you double press it, the board boots into the bootloader.
- **4MB Flash Storage** - All 4MB of the storage are available to you, you can store your CircuitPython files as well as logs, images and more! When connected to a PC, the flash storage shows up as a disk drive.
- **ATSAMD21 Microcontroller** - Cortex-M0+ running at 48MHz, not the fastest thing around, but fast enough for prototyping and simple applications.
- **6 Flexible GPIOs** - All 6 GPIOs can be used as analog inputs, PWM outputs or regular digital IOs. You can also configure them to be SPI, I2C and/or UART. See [Pinout]({{< relref "/docs/pinout.md" >}}) and [GPIO Configurations]({{< relref "/docs/gpios.md" >}}) for more details.
- **6 Flexible GPIOs** - All 6 GPIOs can be used as analog inputs, PWM outputs or regular digital IOs. You can also configure them to be SPI, I2C and/or UART. See [Pinout]({{< relref "/r1/docs/pinout.md" >}}) and [GPIO Configurations]({{< relref "/r1/docs/gpios.md" >}}) for more details.
- **3.3V LDO** - The LDO provides up to 250mA of current for you.
- **RGB LED** - Each color is user-controllable with a possibility to PWM the colors.
- **Optional External Power** - If you don't want to use the USB to power the board, connect an external source (max 6V) to the `VIN` pin and you're ready to go!
@@ -0,0 +1,11 @@
---
title: Pinout
type: docs
rev: r1
---

# Pinout

[![Pinout](/r1/pinout_small.png)](/r1/pinout.png)

Click for a (lot) larger version.
File renamed without changes.
@@ -0,0 +1,9 @@
---
headless: true
---

- [Introduction]({{< relref "/r1" >}})
- [Guided Tour]({{< relref "/r1/docs/guided-tour.md" >}})
- [Pinout]({{< relref "/r1/docs/pinout.md" >}})
- [GPIO Configurations]({{< relref "/r1/docs/gpios.md" >}})
- [Downloads]({{< relref "/r1/docs/downloads.md" >}})
@@ -0,0 +1,30 @@
---
title: Introduction
type: docs
rev: r2
---

# Introduction

The Serpente boards are low-cost development boards designed to be used with Adafruit's CircuitPython. For more information and learning material regarding CircuitPython, please follow the [Welcome to CircuitPython!](https://learn.adafruit.com/welcome-to-circuitpython/overview) article from Adafruit.

All three boards are virtually the same, except for the USB connector. The standard Serpente board contains a female USB Type-C connector, the Serpente Plug C contains a male USB Type-C connector, and the Serpente Plug uses the board itself as a Type-A USB plug.

If you are familiar with the Digispark boards, you may notice some similarities. This fact is of course not incidental, the Serpente boards are inspired by the Digispark, both in form-factor as well as use-cases. The Serpente boards are meant to be used as quick and dirty, yet flexible, prototyping tools.

## Technical details

Here are some of the technical details regarding the boards:

- ATSAMD21E18A 32-bit Cortex-M0+ running at 48MHz
- 256KB flash and 32KB RAM
- 4MB Flash for storing files and CircuitPython code
- 6 highly customizable GPIOs
- 250mA LDO
- 3.3V logic and power
- Powered either from USB or external source
- User-controlled RGB LED
- Mounting holes on the Serpente female Type-C board
- Castellated edges so the boards can be used as modules easily

[![Both Boards](/r2/three_boards_small.jpg)](/r2/three_boards.jpg)
@@ -0,0 +1,44 @@
---
title: Downloads
type: docs
rev: r2
---

# Downloads

## Datasheets
- [ATSAMD21 Cortex-M0+ Microcontroller](http://ww1.microchip.com/downloads/en/devicedoc/40001884a.pdf)
- [GD25Q32C 4MB Serial Flash](http://www.gigadevice.com/datasheet/gd25q32c/)
- [SC662K-3.3V LDO](https://datasheet.lcsc.com/szlcsc/Shenzhen-Fuman-Elec-SC662K-3-3V_C83932.pdf)
- [FM-B2020RGBA-HG RGB LED](https://datasheet.lcsc.com/szlcsc/Foshan-NationStar-Optoelectronics-FM-B2020RGBA-HG_C108793.pdf)

## Firmware
The Serpente boards come with [UF2 Bootloader](https://github.com/microsoft/uf2-samdx1) and [CircuitPython](https://github.com/adafruit/circuitpython) pre-installed.

## Schematics

### Serpente

[![Schematic](/r2/schematics_serpente.png)](/r2/schematics_serpente.png)

### Serpente Plug

[![Schematic Plug](/r2/schematics_plug.png)](/r2/schematics_plug.png)

### Serpente Plug C

[![Schematic Plug](/r2/schematics_plug_c.png)](/r2/schematics_plug_c.png)

## Drawings

### Serpente

[![Drawing](/r2/drawing_serpente.png)](/r2/drawing_serpente.png)

### Serpente Plug

[![Drawing Plug](/r2/drawing_plug.png)](/r2/drawing_plug.png)

### Serpente Plug C

[![Drawing Plug](/r2/drawing_plug_c.png)](/r2/drawing_plug_c.png)
@@ -0,0 +1,48 @@
---
title: GPIO Configurations
type: docs
rev: r2
---

# GPIO Configurations

Thanks to the flexibility of the SAMD21 SERCOM peripheral, the Serpente boards give you access to multiple serial interfaces with just 6 GPIOs. See [Pinout]({{< relref "/r2/docs/pinout.md" >}}) for an overview of the pins.

Note that most of the interfaces are easily accessible using CircuitPython, altough some of them can't be used at the same time:
{{< highlight python >}}
import board, busio

spi = board.SPI()
i2c = board.I2C()
uart = board.UART()
uart2 = busio.UART(board.TX2, board.RX2)
{{< / highlight >}}

Here's a list of some of the ways you can configure the GPIOs on your Serpente:

## SPI + 3 GPIOs
<img src="/r2/config-spi.png" style="width: 500px">

## I2C + 4 GPIOs
<img src="/r2/config-i2c.png" style="width: 500px">

## UART + 4 GPIOs
<img src="/r2/config-uart.png" style="width: 500px"><br>
or<br>
<img src="/r2/config-uart2.png" style="width: 500px"><br>

## 2x UART + 2 GPIOs
<img src="/r2/config-2xuart.png" style="width: 500px"><br>
**Note: Because of a quirk on CircuitPython's implementation, you need to initialize UART 2 before UART.**

## SPI + I2C + 1 GPIO
<img src="/r2/config-spi-i2c.png" style="width: 500px">

## SPI + UART + 1 GPIO
<img src="/r2/config-spi-uart.png" style="width: 500px">

## UART + I2C + 2 GPIOs
<img src="/r2/config-uart-i2c.png" style="width: 500px">

## 6 GPIOs
See [Pinout]({{< relref "/r2/docs/pinout.md" >}}).
@@ -0,0 +1,29 @@
---
title: Guided Tour
type: docs
rev: r2
---

# Guided Tour

Let's have a quick look at the boards and what's on them. All three boards have the same components except the USB connectors.

{{< columns >}}
[![Serpente](/r2/tour_serpente.jpg)](/r2/tour_serpente.jpg)
<--->
[![Serpente Plug](/r2/tour_plug.jpg)](/r2/tour_plug.jpg)
<--->
[![Serpente Plug C](/r2/tour_plug_c.jpg)](/r2/tour_plug_c.jpg)
{{< /columns >}}

- **USB A, male or female USB Type-C Connector** - Three options to choose from, use the one that works best for you! USB is used for both data and power. The Type-C connectors supports only USB 2.0 signals and is hardwired to be a Sink only.
- **Reset Button** - Allows you to reset the board quickly and if you double press it, the board boots into the bootloader.
- **4MB Flash Storage** - All 4MB of the storage are available to you, you can store your CircuitPython files as well as logs, images and more! When connected to a PC, the flash storage shows up as a disk drive.
- **ATSAMD21 Microcontroller** - Cortex-M0+ running at 48MHz, not the fastest thing around, but fast enough for prototyping and simple applications.
- **6 Flexible GPIOs** - All 6 GPIOs can be used as analog inputs, PWM outputs or regular digital IOs. You can also configure them to be SPI, I2C and/or UART. See [Pinout]({{< relref "/r2/docs/pinout.md" >}}) and [GPIO Configurations]({{< relref "/r2/docs/gpios.md" >}}) for more details.
- **3.3V LDO** - The LDO provides up to 250mA of current for you.
- **RGB LED** - Each color is user-controllable with a possibility to PWM the colors.
- **Optional External Power** - If you don't want to use the USB to power the board, connect an external source (max 6V) to the `VIN` pin and you're ready to go!
- **Mount holes** (female Type-C only) - We used the extra space to provide you with two mounting holes in case you want to make sure your Serpente stays in place.
- **Breadboardable** - The spacing of the headers allows you to use the boards with a breadboard, both as GPIO and power!
- **Castellated edges** - You can easily use the Serpente boards as CircuitPython modules.
@@ -0,0 +1,11 @@
---
title: Pinout
type: docs
rev: r2
---

# Pinout

[![Pinout](/r2/pinout_small.png)](/r2/pinout.png)

Click for a (lot) larger version.

0 comments on commit 344aaec

Please sign in to comment.
You can’t perform that action at this time.