Skip to the content
2 layers50.8 × 44 mmProto, the printed circuit board in 3D

Penelopean robot swarms for weaving ancient Greek looms and maypole dancing.

Size
50.8 × 44 mm
Copper layers
2
Thickness
1.6 mm
Parts
36
Nets
30
Pads
214
Tracks, vias
157, 0
Routed
Yes
KiCad
KiCad 4
Created
22 May 2018
Updated
19 May 2022

Overview

Proto is an open-source printed circuit board by fo-am, from the fo-am/penelopean-robotics repository on GitHub. It is a 2-layer board of 50.8 × 44 mm with 36 parts on 30 nets, routed with 157 tracks and 0 vias.

It belongs with the robots and motor control boards of this library.

README

README.md

Penelopean Robotics

Penelopean robots are modular, reconfigurable, dis-assemblable and soft. They are part of the Penelope Project, a Study of Weaving as a Technical Mode of Existence.

See a video of our first swarm robotics maypole dancing test.

Penelopean robot swarms are designed for weaving ancient Greek looms and maypole dancing. They can be livecoded remotely by a Raspberry Pi and can be synced to musical beats for performances. Here is an example of two maypole dances to create weaves we are currently working on:

All source code and hardware files are here, each robot is made from:

  • Tablet woven flexible structure holding everything together (see below)
  • 3 SG92R microservos to drive the legs
  • 1 3.7v li-ion battery
  • Nrf24L01 radio module for remote control/programming
  • GY91 accelerometer/gyro/compass sensor module
  • Custom Atmega328 main pcb
  • Radio, sensor and servo breakout secondary pcb
  • 3 laser cut ply leg pairs

Woven construction

Each robot is constructed using tablet weaving, an ancient human technology dating back to neolithic times (and one of the few forms of weaving that has never been mechanised).

Tablet looms are simple to set up, and consist of a stack of cards with holes punched in the corners through which the warp yarn passes. See here for a description of how to set up tablet loom.

Usually tablet weaving produces a strong braid. For the penelopean robotics we use a technique known as Icelandic double weave, where we weave with the cards rotated at 45 degrees and use two wefts at the same time. This converts the usually flat "2D" weave into a "3D" structure, which we can use to support all the components for the robot.

The exact spacing required will depend on the kind of yarn you are using (I recommend 100% cotton or other plant based yarns - as wool is too fluffy) but using this yarn I measured out 10 wefts to hold an SG92R microservo and 8 for the 18mm diameter cylindrical battery.

Here is an attempt at notating the steps required in full. We start with a supporting weave using normal single weft weaving, and then start splitting to to hold the 3 servos and a battery, finishing with an final supporting weave [todo: later version included a spacer to make the legs equidistant]

As the structure is woven into the fabric it is strong and able to cope with the forces involved. The final stage is to stitch the components into the structure to hold them in place along with some thick wire to give the legs something to push against.

[todo: bioresin research]

Raspberry Pi swarm controller setup

The swarm of robots is controlled by a Raspberry Pi running a python program which is in charge of distributing commands to the robots.

[under development]

Movement sequencer

The robot servos are controlled via a "movement pattern sequencer" which interprets symbols representing angles of rotation. This is designed to allow different kinds of movement to be experimented with as well as synchronisation with music, across the swarm.

By default a pattern consists of a 12 byte array, where each servo is controlled by 4 symbols that are looped.

Various predefined patterns can be selected via bytecode programs (see NEXT_PATTERN below) which correspond to:

text
0000 0000 0000 : All stop - all servos to their central position.
AAaa AaaA AAaa : Walk forward
AAaa aAAa AAaa : Walk backwards

The Yarn bytecode language

One of the problems with having numerous robots is updating and distributing code changes to them. In order to make this process more versatile we use a livecoding system where bytecode can be sent over radio and written directly to memory. This bytecode is interpreted by a machine running on the robot which can be halted and reset over radio (separately to the main process, running the radio, controlling servos and reading sensors etc, which continues as normal).

The robot bytecode (called yarn) has access to a set of registers that describe the current state of the robot, including the movement sequencer and sensor information. Registers can also be written to that change the current servo motion pattern or light the LED for example.

Writing the bytecode directly is considered a temporary inconvenience before a compiler for a decent high level language is designed.

Register description

NameAddressRead/WriteDescription
ROBOT_ID0rIdentifier of this robot (same code as the last byte of the radio pipe address)
PC_MIRROR1rA copy of the program counter for debugging. Writing to this has no effect.
LED2r/wThe state of the onboard blue LED.
COMP_ANGLE3rCurrent absolute compass angle from the magnetometer.
COMP_DELTA_RESET4wResets the relative compass angle calculation.
COMP_DELTA5rRelative compass angle calculation, from last reset.
STEP_COUNT6rHow many times the current movement sequence has run (not really a step as each sequence has two steps).
STEP_COUNT_RESET7wResets the step counter register to zero.
NEXT_PATTERN8r/wStores a pattern ID for use when the current motion sequence has finished. Can be one of NULL (Keep the last pattern), ALL_STOP (Cease all servo movement), WALK_FORWARDS: Move forward or WALK_BACKWARDS (Move backwards)
A9r/wUser defined register for convenience. A is currently used as the maypole dance status to synchronise multiple groups of robots.
B10r/wUser defined register for convenience.
C11r/wUser defined register for convenience.
D12r/wUser defined register for convenience.
SERVO_MS_PER_STEP13r/wThis controls the overall speed of the motion sequencer - in milliseconds per step.
SERVO_1_AMP14r/wSee below
SERVO_2_AMP15r/wSee below
SERVO_3_AMP16r/wSeparate control over the amplitude of each servos movement. Set these to zero will immediately prevent any movement while the sequencer still runs. This is a fixed point value where 1000 (the default) is equal to one, so setting to 2000 will double the amplitude and range of the servo.
SERVO_1_BIAS17r/wSee below
SERVO_2_BIAS18r/wSee below
SERVO_3_BIAS19r/wSets the effective zero degrees position of each servo. This can be used either for fine tuning or in the case of the middle servo (2) can be used to steer the robot when walking.
SERVO_1_SMOOTH20r/wSee below
SERVO_2_SMOOTH21r/wSee below
SERVO_3_SMOOTH22r/wTo prevent sudden movements from breaking the robot or causing it to jump, each servo has a smoothing (low pass filter) applied in software to the desired rotation. This can be removed by setting this to zero, this is a fixed point number where 200 (0.2) is the default value.

Yarn instruction set

Yarn bytecode is a 16 bit stack based microcode language.

Program flow control instructions

Bytecode instruction nameExampleDescription
nopnopNo operation, do nothing for one cycle
jmpjump labelUnconditional jump
jprjpr -2Unconditional jump relative (can be negative)
jpzjpz labelJump only if the top of stack is zero.
jprzjprz 10Jump relative if the top of the stack is zero.

Stack manipulation instructions

Bytecode instruction nameExampleDescription
ldlldl 1207Load literal value on to stack
ldld STEP_COUNTLoad the contents of address on to the sta
ldildi ALoad indirect: the contents of the address pointed to by value (for arrays).
stst NEXT_PATTERNStores the top of the stack in the supplied address
stisti AStores indirectly the stack top to the address at this location
dupdupPushes the value at the top of the stack to duplicate it

Number comparison instructions

Bytecode instruction nameExampleDescription
ltltLess than: Pushes 1 if the top of the stack is less than the stack item beneath it (pops both values) otherwise pushes 0
gtgtGreater than: Pushes 1 if the top of the stack is less than the stack item beneath it (pops both values) otherwise pushes 0
ltelteLess than or equal: Pushes 1 if the top of the stack is less than or equal to the stack item beneath it (pops both values) otherwise pushes 0
gtegteGreater than or equal: Pushes 1 if the top of the stack is greater than or equal to the stack item beneath it (pops both values) otherwise pushes 0
sltsltSigned version of lt
sgtsgtSigned version of gt
slteslteSigned verion of lte
sgtesgteSigned verion of gte

Maths

Bytecode instruction nameExampleDescription
addaddPops the top two stack items and pushes the sum of them
subsubPops the top two stack items and pushes the top subtracted from the second
incincAdds one to the top of the stack
decdecSubtracts one from the top of the stack
andandBitwise ands the top two stack items
ororBitwise ors the top two stack items
xorxorBitwise xors the top two stack items
notnotBitwise nots the top stack item
rrrrRotates the top stack item one bit to the right
rlrlRotates the top stack item one bit to the left
sinsinPushes the sine of the top stack item in degrees
coscosPushes the cosine of the top stack item in degrees
tantanPushes the tangent of the top stack item in degrees
rndrndPushes and random number
inciinciIncrements value in address in-place
decideciDecrements value in address in-place
incpincpIncrements value in address in-place and pushes it on the stack, convenience for looping
decpdecpDecrements value in address in-place and pushes it on the stack, convenience for looping

Parts

36
QtyValueFootprintReferences
16Conn_01x07Pin_Headers:Pin_Header_Straight_1x07_Pitch2.54mmJ12, J31, J32, J33, J34, J35, J36, J38, J39, J40, J42, J45, J46, J47, J48, J49
5Conn_01x08Pin_Headers:Pin_Header_Straight_1x08_Pitch2.54mmJ13, J20, J21, J22, J23
3Conn_01x04Pin_Headers:Pin_Header_Straight_1x04_Pitch2.54mmJ6, J11, J14
2Conn_01x01Pin_Headers:Pin_Header_Straight_1x01_Pitch2.54mmJ9, J10
2Conn_01x02Pin_Headers:Pin_Header_Straight_1x02_Pitch2.54mmJ15, J16
2Conn_01x05Pin_Headers:Pin_Header_Straight_1x05_Pitch2.54mmJ1, J8
1Conn_01x03Pin_Headers:Pin_Header_Straight_1x03_Pitch2.54mmJ19
1Conn_01x06Pin_Headers:Pin_Header_Straight_1x06_Pitch2.54mmJ18
1Port BPin_Headers:Pin_Header_Straight_1x06_Pitch2.54mmJ3
1Port CPin_Headers:Pin_Header_Straight_1x07_Pitch2.54mmJ4
1Port DPin_Headers:Pin_Header_Straight_1x08_Pitch2.54mmJ5
1Power/i2cPin_Headers:Pin_Header_Straight_1x04_Pitch2.54mmJ2

More from fo-am/penelopean-robotics

4
  • 2 layers81.3 × 70.4 mmProtomicro, the printed circuit board in 3D

    Protomicro

    fo-am/penelopean-robotics

    Penelopean robot swarms for weaving ancient Greek looms and maypole dancing.

    21 parts9
  • 2 layers50 × 43.3 mmProto, the printed circuit board in 3D

    Proto

    fo-am/penelopean-robotics

    Penelopean robot swarms for weaving ancient Greek looms and maypole dancing.

    20 parts9
  • 2 layers53.6 × 47.2 mmProto, the printed circuit board in 3D

    Proto

    fo-am/penelopean-robotics

    Penelopean robot swarms for weaving ancient Greek looms and maypole dancing.

    15 parts9
  • 2 layers55 × 29 mmLinefollower, the printed circuit board in 3D

    Linefollower

    fo-am/penelopean-robotics

    Penelopean robot swarms for weaving ancient Greek looms and maypole dancing.

    6 parts9

Similar boards

  • 2 layers65 × 30 mmRgb to hdmi, the printed circuit board in 3D

    Rgb to hdmi

    hoglet67/RGBtoHDMI

    Bare-metal Raspberry Pi project that provides pixel-perfect sampling of Retro Computer RGB/YUV video and conversion to HDMI

    36 parts1kGPL-3.0
  • 2 layers55 × 70 mmArduino v1, the printed circuit board in 3D

    Arduino v1

    hackclub/OnBoard

    💡 Join 1,000 teenagers and make your first PCB with a $100 grant!

    36 parts915
  • 2 layers50.4 × 24.8 mmLEDboardRev3, the printed circuit board in 3D

    LEDboardRev3

    Architeuthis-Flux/Jumperless

    A jumperless breadboard

    36 parts914
  • 2 layers45.7 × 31.8 mmLEDx16 board, the printed circuit board in 3D

    LEDx16 board

    tardate/LittleArduinoProjects

    a collection of "Little Electronic & Arduino Projects", most involving electronics or an Arduino in one way or another!

    36 parts803MIT
  • 2 layers32 × 24 mmEsp onelayer3, the printed circuit board in 3D

    Esp onelayer3

    cnlohr/colorchord

    Chromatic Sound to Light Conversion System

    36 parts712
  • 2 layers69 × 53.8 mmTUSS4470 shield, the printed circuit board in 3D

    TUSS4470 shield

    Neumi/open_echo

    Open Source echo sounder / depth sounder / SONAR for bathymetry and research. Arduino based and compatible.

    36 parts530
  • 2 layers99.1 × 53.3 mmABSIS Mega, the printed circuit board in 3D

    ABSIS Mega

    jrsteensen/OpenHornet

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

    36 parts431
  • 2 layers16.1 × 119 mmConnectorL, the printed circuit board in 3D

    ConnectorL

    thpoll83/PolyKybd

    PolyKybd

    36 parts411CERN-OHL-W-2.0

Questions

How big is the Proto PCB?

It measures 50.8 × 44 mm and has 2 copper layers, 1.6 mm thick.

What parts does the Proto use?

36 parts. 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 Proto KiCad files?

From the fo-am/penelopean-robotics repository on GitHub, at the commit this page was made from: the board is pcb/proto.kicad_pcb. PCBKit opens the board in the browser, with nothing to install.

Can I use the Proto design in my own project?

Its repository states no licence, so its author keeps all rights: ask fo-am before reusing the design.