Skip to the content
2 layers77.5 × 142.5 mmProto1, the printed circuit board in 3D

Electronic Badge for the JoCo 2018 Cruise

Size
77.5 × 142.5 mm
Copper layers
2
Thickness
1.6 mm
Parts
84
Nets
69
Pads
323
Tracks, vias
977, 103
Routed
Yes
KiCad
KiCad 4
Created
28 Feb 2018
Updated
6 Jun 2018

Overview

Proto1 is an open-source printed circuit board by OpenResearchInstitute, from the OpenResearchInstitute/joco-2018-badge repository on GitHub, published under the Apache-2.0 licence. It is a 2-layer board of 77.5 × 142.5 mm with 84 parts on 69 nets, routed with 977 tracks and 103 vias.

It is built around the WS2812B. Its parts include 30 capacitors, 19 connectors, 16 diodes, 8 resistors and 6 switches. It belongs with the lEDs and displays boards of this library.

Main components

1

README

README.md

joco-2018-badge

Code and documentation for the unofficial electronic badge for the JoCo Cruise 2018.

This is based on the excellent work that the AND!XOR team produced for the DEFCON 25 Bender Badge.

All code and hardware design files are closed until Feb 26th, 2018 and then are licensed under the Apache license 2.0 unless superceded by notices in individual files or directories.

Getting Started

Some resources must be installed outside of this source tree. One of these is the Nordic SDK.

Choose a place to install these on your file system. For example, we'll use "/src/joco-support/".

Download the version 12.3 of the Nordic SDK from here and unzip it into the directory you chose.

It's known that later versions of the SDK are not compatible with the existing badge code. We may work on fixing that, which is why we don't install the SDK in the source tree for the project.

Now edit your shell init or rc file to set the following environment variable when you create a shell, substituting your chosen path:

text
export SDK_ROOT=/src/joco-support/nRF5_SDK_12.3.0_d7731ad

Ubuntu Installation (non-ARM host)

Download the GNU ARM Embedded Toolchain. Choose one of these methods:

Then edit $SDK_ROOT/components/toolchain/gcc/Makefile.posix and change the value for GNU_INSTALL_ROOT to the directory where your toolchain was installed.

If you plan to hook up hardware for programming and debugging, you'll need the Segger JLink software. It's available from https://www.segger.com/downloads/jlink/ for a variety of host platforms. We used version V6.18b, but the latest version is probably fine. To install on Ubuntu on an Intel PC:

sudo dpkg -i <path-to-downloads>/JLink_Linux_V618b_x86_64.deb

You'll also need a couple of command line tools from Nordic. These are available from http://infocenter.nordicsemi.com/topic/com.nordic.infocenter.tools/dita/tools/nrf5x_command_line_tools/nrf5x_installation.html?cp=5_1_1. We used version 9.7.0, but the latest version is probably fine. Install them in a location outside this project, like the Nordic SDK. For example using the location "/src/joco-support", you can do the following:

text
mkdir -p /src/joco-support/bin
cd /src/joco-support/bin
tar xvf <path-to-downloads>/nRF5x-Command-Line-Tools_9_7_0_Linux-x86_64.tar

Now edit your shell init or rc file to set the following environment variable when you create a shell, substituting your chosen path:

text
export NRFJ_BIN=/src/joco-support/bin
Ubuntu on an ARM Host

If you want to develop on an ARM-based host, most of the components are available.

The Nordic SDK is the same.

You should be able to sudo apt-get install gcc-arm-none-eabi to get the toolchain.

You can get JLink software from Segger here

The command line tools nrfjprog and mergehex are not currently available for ARM hosts. You can use the JLink tools to program the device, so you can probably work around nrfjprog.

Build the code

cd firmware/manbearpig

make

cd ..

./update.sh

JTAG interface hardware

To flash the code to the badge and use the Ozone debugger, you'll need a JTAG hardware interface. The one that was used by the development team is the Segger J-Link EDU Mini.

It's much easier to connect to the board if you use a short flat cable and a mating header on the board end. All these can be purchased from these retailers:

Flashing the target

Two ways, either:

cd firmware

./provision.sh

or

cd firmware/manbearpig

make flash_softdevice

make flash

The make flash_softdevice can be omitted after the first time.

Setting up the Segger Ozone debugger

This was correct for Ubuntu 14.04.5 64 bit

Install the Ozone package from here

The manual is useful (same link)

IMPORTANT NOTE:

Ozone version 2.56 would not work for me. It would halt execution in seemingly random places and not load source code.

Version 2.54b works fine

If you're using the Segger edu device, Select the device as Nordic nRF52832_xxAA

Choose SWD for the debugger device and NOT USB.

open the badge .out file to bring in source files

Parts

84
QtyValueFootprintReferences
260.1Capacitors_SMD:C_0805C10, C11, C12, C13, C14, C15, C16, C17, C18, C19, C20, C21, C22, C25, C26, C27 +10
16WS2812BWS2812B:LED_WS2812BD1, D2, D3, D4, D5, D6, D7, D8, D9, D10, D11, D12, D13, D14, D15, D16
61KResistors_SMD:R_0805R2, R3, R4, R5, R6, R7
210 uFCapacitors_SMD:C_1206C31, C32
2300 pFCapacitors_SMD:C_0805C1, C2
1+3.3VPin_Headers:Pin_Header_Straight_1x04_Pitch2.54mmJ4
1.975 uHNFC-antenna-test:nfc-test2L1
1220Resistors_SMD:R_0805R1
13.3V OutPin_Headers:Pin_Header_Straight_1x02_Pitch2.54mmJ15
14.7 uHinductor:MAMK2520L2
147Resistors_SMD:R_0805R8
1ACTIONpts810:PTS810SW5
1BatteryResistors_THT:R_Axial_DIN0411_L9.9mm_D3.6mm_P12.70mm_HorizontalBT1
1DOWNpts810:PTS810SW4
1ExpansionPin_Headers:Pin_Header_Straight_2x04_Pitch2.54mmJ3
1GNDPin_Headers:Pin_Header_Straight_1x04_Pitch2.54mmJ10
1J11Pin_Headers:Pin_Header_Straight_2x03_Pitch2.54mmJ11
1J11APin_Headers:Pin_Header_Straight_2x03_Pitch2.54mmJ11A1
1J5Pin_Headers:Pin_Header_Straight_1x08_Pitch2.54mmJ5
1J5APin_Headers:Pin_Header_Straight_1x08_Pitch2.54mmJ5A1
1J6Pin_Headers:Pin_Header_Straight_1x10_Pitch2.54mmJ6
1J6APin_Headers:Pin_Header_Straight_1x10_Pitch2.54mmJ6A1
1J7Pin_Headers:Pin_Header_Straight_1x08_Pitch2.54mmJ7
1J7APin_Headers:Pin_Header_Straight_1x08_Pitch2.54mmJ7A1
1J8Pin_Headers:Pin_Header_Straight_1x06_Pitch2.54mmJ8
1J8APin_Headers:Pin_Header_Straight_1x06_Pitch2.54mmJ8A1
1J9Pin_Headers:Pin_Header_Straight_1x10_Pitch2.54mmJ9
1J9APin_Headers:Pin_Header_Straight_1x10_Pitch2.54mmJ9A1
1LCDkicad-libs:ZIF-505110-1092J14
1LED_DOUTPin_Headers:Pin_Header_Straight_1x01_Pitch2.54mmJ2
1LEFTpts810:PTS810SW2
1MCP1603T-330I/OSMCP1603T-330I_OS:SOT95P280X110-5NU1
1Micro_SD_Card_Detsdcard:newsdcardJ1
1PowerSSSS810701:SSSS810701B1
1RIGHTpts810:PTS810SW3
1TILTResistors_THT:R_Axial_DIN0207_L6.3mm_D2.5mm_P15.24mm_HorizontalSW6
1UPpts810:PTS810SW1

More from OpenResearchInstitute/joco-2018-badge

1
  • 2 layers41 × 27.2 mmAntenna test-1, the printed circuit board in 3D

    Antenna test-1

    OpenResearchInstitute/joco-2018-badge

    Electronic Badge for the JoCo 2018 Cruise

    4 parts10Apache-2.0

Similar boards

  • 4 layers99 × 53.3 mmPSLab, the printed circuit board in 3D

    PSLab

    fossasia/pslab-hardware

    PSLab Hardware Design and Schematics https://pslab.io

    199 parts1.7kApache-2.0
  • 2 layers26 × 30 mmMicrocontroller, the printed circuit board in 3D

    Microcontroller

    FrameworkComputer/ExpansionCards

    Reference designs and documentation to create Expansion Cards for the Framework Laptop

    34 parts1.1kCC-BY-4.0
  • 4 layers82.6 × 82.5 mmJumperless2, the printed circuit board in 3D

    Jumperless2

    Architeuthis-Flux/Jumperless

    A jumperless breadboard

    208 parts914
  • 2 layers95.3 × 161.9 mmDfh badge, the printed circuit board in 3D

    Dfh badge

    tanaes/whopping_Voron_mods

    135 parts787GPL-3.0
  • 2 layers42.8 × 28.8 mmMM Skirt, the printed circuit board in 3D

    MM Skirt

    PrintersForAnts/Micron

    If you want to purchase full kits there are 3 available (Kits are slowly updating to R1 hardware just make sure to double check the included hardware in your kit and if you have any questions reach out in the discord)

    11 parts741GPL-3.0
  • 2 layers149.6 × 127.1 mmErgodash, the printed circuit board in 3D

    Ergodash

    omkbd/ErgoDash

    keyboard

    187 parts732MIT
  • 2 layers285.5 × 95 mmReviung46 ver1 1, the printed circuit board in 3D

    Reviung46 ver1 1

    gtips/reviung

    The REVIUNG41 is 41-key column staggered keyboard.

    119 parts517MIT
  • 2 layers177.7 × 144.5 mmCOMM PANEL, the printed circuit board in 3D

    COMM PANEL

    jrsteensen/OpenHornet

    OpenHornet 1:1 F/A-18C Simulator Repository

    275 parts431

Questions

How big is the Proto1 PCB?

It measures 77.5 × 142.5 mm and has 2 copper layers, 1.6 mm thick.

What parts does the Proto1 use?

84 parts, built around the WS2812B. The full list of its parts is on this page, with links to each part's symbol and footprint where PCBKit's library has them.

Where can I download the Proto1 KiCad files?

From the OpenResearchInstitute/joco-2018-badge repository on GitHub, at the commit this page was made from: the board is board/proto1/proto1.kicad_pcb. PCBKit opens the board in the browser, with nothing to install.

Can I use the Proto1 design in my own project?

Its repository publishes it under the Apache-2.0 licence: you may reuse it on that licence's terms (keep the author's notice, and for a copyleft licence share your changes alike).