TD-1 Self-Source Files

EDIT: 4/2024

This is no longer the latest build for TD-1. Check the pinned post for version 1.

Here you will find all the most recent files for TD-1. I recommend that the sensor mount be printed in black filament. The rest of the parts can be printed in any filament color you choose.

THIS IS A BETA RELEASE AND NOT FULLY PRODUCTION READY. EVERYTHING ABOUT TD-1 COULD CHANGE BEFORE OFFICIAL RELEASE. IF YOU CHOOSE TO PURCHASE THE PARTS FROM THE BOM, YOU DO SO KNOWING THEY MAY NOT BE WHAT IS USED IN THE FINAL RELEASE. FURTHERMORE, THE 3MF FILES PROVIDED ARE ALSO BETA AND ARE SUBJECT TO CHANGE. BE VERY CAREFUL ABOUT SUBSTITUTIONS OF PARTS FROM THE BOM, AS THERE ARE MANY LOOK-ALIKE PARTS THAT MAY NOT FUNCTION THE SAME AS THE ORIGINALS. IF YOU HAVE ANY QUESTIONS, PLEASE MESSAGE ME EITHER HERE OR ON THE HUEFORGE DISCORD.

EDIT 1/31/2024:

When I uploaded the new.3mf file I selected the one that should be for PCB Kits rather than Self-Source. I have corrected this now with the attached "TD-1 v1.2 Self-Source.3mf" file.

EDIT 1/30/2024:

I uploaded the wrong .uf2 package with the release on 1/28/2024. I have corrected this now. The incorrect package was called "TD-1 Beta v3.1.uf2". The correct one is called "TD-1 Beta v3.1rc2.uf2". If you downloaded this file please delete it and download the new correct one. The update packaged that was release yesterday was correct and no action is needed if you used that package to update.

EDIT 1/28/2024:

Files have been updated to the new Beta v3.1rc2 version.
This firmware update changes the UI to now show TD as soon as scanning of it is complete and show scanning for color until it's scanning is complete. It also adds continuous mode (disabled by default). Also added is some code optimization and better error handling for device components not being detected. This eliminates the hardware.py file and moves its value to a new file, settings.py. If you wish to enable continuous mode, this is also done in the settings.py. Continuous mode has two options, enabling it will start sampling TD and update at the set sample rate. If continuous color is enabled, it will also be updated at the set sample rate. However, if continuous mode is disabled, continuous color will also be. Sample distance is a reference to the diameter of the filament and should not be changed. (this is here in case in the future we want to play with the swatch version, TD-1S, again) continuous start time is how long TD-1 will wait to start continuous scanning. I also made a slight change to the sensor mount as some people have reported that the Lux sensor was not fitting.

Script changes

collectData.py has been updated to collectDataBeta v3.1.py and now will create the csv file after the first scan an if continuous is enabled and begins, it will continue to write continuous values to the same file. If the scan is ended before continuous mode begins, the next scan will be added to the same file. This allows for users to still write all single read scans to a single file even if continuous mode is enabled.

Boot_out.txt Extractor.py has been updated to Extractor v3.py and allow users to retrieve emptyLux.txt, boot_out.txt, and settings.py

The Updater.py has been changed to Updater v1.1.py This updater is required as there is an error in v1 that won’t allow all files to be sent in a single update package. Once you update to Beta v3.1rc2 you will need to use the new Updater v3.py going forward.

Updater v1.1.py has been changed to Updater v3.py This update is to make a better change to how I was handling updates. DO NOT USE THIS UPDATER TILL YOUR TD-1 IS ON Beta v3.1rc2

Version Reader v3.py was added and will retrieve version from multiple code files on TD-1

All these companion scripts have been reworked to always show the SN of the pi or pis that are detected.

EDIT 1/13/2024:

A small issue was identified that was causing a "Remove Filament" message on bootup that would cause an infinite loop. This issue was caused by values from my test unit making into that file rather than letting your unit acquire these values on first boot. This has been corrected in the v2.1 .uf2 file that I have added here.

EDIT 1/7/2024:

I have updated the firmware to Beta v2, this version removes the collection of all the unnecessary raw data. The collectData.py has been updated to also have only the extracted data. This version also implements a fix for the very low TD hang. The color samples have been lowered to 3 (from 5). This change helps bring the reds slightly brighter (they are still coming in dark, just less so). Blacks/grays still show a hint of green. All these changes bring scanning time down dramatically. The Updater.py is still the same method for flashing the new firmware. If you are upgrading, follow the guide in TD-1 Beta Upgrade Files.

EDIT 12/22/2023:

I have updated the TD-1 Project Guide to reflect changes I have made to the process. I have also changed the name of the TD-1.uf2 file to TD-1 Beta.uf2 as it now contains everything for the Beta firmware. This is the Alpha release of color and has some known issues. These include, that reds read dark, and blacks/grays show a hint of green. When inputting the color values in HueForge, feel free to use the color as a starting point and adjust as you see fit. If you can get color codes from the filament manufacturer, this will almost always be the best color source. I have updated the collectData.py file for those who still wish to collect data into a csv file. This change is to also label the TD and color data (the old collectData.py still collects it, it just won't label the columns) you will want to rename, move, or delete any old "data.csv" files as this will also not add these labels to existing files. I have added two python scripts that are needed during the installation process, "boot_out.txt Extractor.py" and "Updater.py". When and how to use these are in the new Build Guide. If you are updating from the original Alpha firmware, the TD-1 Beta Upgrade Files has a complete guide for upgrading.

EDIT 11/21/2023:

I have changed the file system up a little and have replaced the 'first.uf2' and the 'second.zip' files with a new single file called 'TD-1.uf2'. The Project Guide has been updated to include these changes. Everything else remains the same. Today I am also releasing the first Alpha firmware. This firmware ONLY provides raw data output through the companion 'collectData.py' script. Please use the 'TD-1 Data Collection Script Guide' to see how to use it. if you do not already have python or know how to use it, this firmware is likely not for you. What we are looking for in this first firmware is if people have filaments with known TD values and would like to scan them and provide the data collected back to me.