Beta tester guide
If you are one of few persons in the world to receive a Chordata DIY kit during this, the first beta-testing experience, you will find yourself with a bunch of boards and components like the ones on the picture, and you might ask yourself "Well... how did I get here?",
And, more important: how can I turn this things into a working mocap suit?. You can find information on how to setup the system on the User Manual, while the intention of this guide is to make the process of building the suit starting from the DIY kit easier. Apart from the soldering, beta-testers (specially during the early stages of the program) will have to deal with the bare bones of the Chordata software in it's unfinished state. We have also collected here some explanations or advices that will help go through the process of orchestrating the framework by hand.
Beside, since during the early stages of the betatesting the Chordata framework still lacks the utility tools that will allow for
This guide is built upon the doubts or problems of others before you. If you have some issue that's not covered here, please ask in the forum.
- 1 Soldering the components
- 2 General FAQs
- 2.1 The led on the Hub is not turning on
- 2.2 The Notochord gives me an error
- 2.3 How can I transfer files from/to the SBC?
- 2.4 I'm a bit confused about the XML files
- 2.5 Still can't get what this "Hierarchy" is
Soldering the components
For each K-Ceptor
- Solder a 10 Kohm resistor to R1, R2, & R3
- Solder a 1 Kohm resistor to R4
- Solder an RJ12 jack to J1 & J2
- Solder a Blue LED to D1, the Long (+) leg to the square pad
For the Hub
- Solder 6 - RJ12 jacks to J1-J6
- Solder the USB A port to J11
- You'll need to snap off 8 pins of the male pin strip and solder them on J9
- Snap off 3 pins and solder them to JP1
- Solder a Blue LED to D1, Long (+) leg to the round pad
- Why this difference on the led's polarity between KCs and Hub?
- Our mistake. We put the simbol for the led backwards on the design of the PCB. It will be fixed for the next revision.
- Is the Hub supposed to have an SMD RGB LED at U4? I’m only seeing 4 soldered pads with nothing connected to them on that part of the board.
- Well, the idea is to include the RGB led in the future, and there is a placeholder footprint on the Hub, but it is not implemented on the software side yet.
- Since the R2.2 K-ceptors do not need ID Modules, are all the K-ceptors interchangeable or do they need to be connected to each other based on the translation value marked on their packaging (eg. a chain like this: K-ceptor 0>Kceptor 1>K-ceptor 2>Hub)?
- The ones we are sending you already include the resistors to assign a translation value which can be 0, 1 or 2.
- In order to capture a default byped configuration you should arrange them like the image here.
The led on the Hub is not turning on
We are using the jumper to bridge the pins #1 & #2 from the Hub's JP1, but the LED is no turning on.
- The led might be soldered backwards
- Another problem might be the power bank.
- Since they are conceived to recharge batteries, some of them might interrupt the power supply when the withdrew current is negligible (and that would be the case for the Hub, with just a led and the Mux in idle state). You can try as a test using a 5V wall-wart with an USB output instead.
- If none of the above applies:
- Please connect the wall-wart to the Hub, unplug RPi and KCs, and use a tester to measure the voltage at:
- Pin #1 of jumper JP1 (Should be 3.3V)
- TP10, the test point near the micro USB connector (should be 5V)
The Notochord gives me an error
You can use a free FTP program, in this example: Filezilla.
- Open the Site Manager (Ctrl + S)
- Create a new site:
- From the dropdown choose SFTP (SSH File Transfer Protocol).
- Enter the following data into the fields:
- Server: <YOUR PI’S IP ADDRESS> (you can also try just entering "notochord.local" here)
- Port: 22
- Username: pi (or whatever your custom username is)
- Password: raspberry (or whatever your custom password is)
- Click Connect
Now you can drag and drop files to and from your SBC using the Local site and Remote site panels.
I'm a bit confused about the XML files
This is indeed one of the trickiest parts of the process, specially if you don't have a programming background. The handling of this files is not supposed to be done by hand, at least not by the regular user. The plan is to have them completely hidden on the first production version of the system. But, until the Utility software is finished, and the Blender_add-on is improved you will have to edit them once in a while.
On the Armature parsing page you can find a brief technical explanation of how the configuration file works. But let's put it in another way here:
By default it will read a file called
Chordata.xml, but you can also tell the Notochord to read another file. This is done with the
./notochord -c my_own_configuration.xml
If there are no errors with the way the file is structured, the Notochord will begin it's execution trying to read the hardware devices described there.
Which file should I use for calibration? which for capturing?
The name of the file doesn't matter. The only important part is that the contents inside the
<Armature> tag match the way the devices are connected in reality.
- For calibration you have to connect just one K-Ceptor to the Hub. The Armature description would look like this one.
- When capturing the full body, the Armature description will be much longer.
You can copy-paste the right Armature description to the
Chordata.xml and run the Notochord without any flags, or create a new file and run the Notochord with the
A work scheme might be:
- Using the
Chordata.xmlfor the calibration, editing the value of the K-Ceptor each time.
- Keeping a separate
default_biped.xml, and use it for the actual capturing.
How can I edit these files?
You can do it with a regular text editor on your PC and then transfer them to the SBC.
Or the editing can be done directly on the SBC's terminal environment using the command-line editor GNU Nano which usually comes installed by default.
nano somefile.xml to edit a file, and keyboard shortcuts like
Ctrl + X to exit.
There are other command-line editors like Vim or Emacs, but unless you want to dedicate some time to learn how to use them just stick with Nano.
Still can't get what this "Hierarchy" is
That's chordata's way to say:
- All the hardware attached to the SBC, described on the same way that they are connected physically.
The Notochord internally works by creating this data structure, which is obtained by reading the configuration file. If the configuration file describes something different than what the Notochord will find in reality you will get error messages.