SETUP HELP WITH YOUR SENSOR?
Do you need help with your sensor? The setup and configuration page is at https://domesticlight.art/setup/
If you need additional help please email, use our contact form, or ask a question on our discord channel.
All “Production” series sensors (#300001 and higher) have shipped with the latest software and can be updated using the web browser based “OTA” process. These sensors also come with a additional I2C port on the board intended for you to add other environmental sensors such as a air quality or greenhouse gas monitor.
The March 2024 software release provides “OTA” or Over the Air update functionality that greatly improves user experience. If your sensor has a software date prior to March 15th, 2024 we strongly encourage updating, and are happy to help walk you through the process.
Guidance on doing your own software update via the Arduino IDE is on our GitHub code page and this step-by step guide https://domesticlight.art/software-update-aug-12-2023/
If you have a “Prototype” version (with a device # in a range of 1002xx and 300xxx) this update to the new software must be done using the Arduino IDE but after that all further updates can be done easily uisng the new Over The Air functionality. If you need help updating please get in touch.
OPEN SOURCE CODE:
The project code is being developed as open source code is available for re-use and review. The initial Domestic Light sensor client code for the prototype and artist proof versions of the sensors is now available on github along with our internal code reference and troubleshooting details. https://github.com/thirtysevennorth/domesticlight_public
We welcome help from programmers with experience in working with the ESP-32 S3 platform using Arduino IDE and environmental sensors and also with experience in applying machine learning to investigate whether spectral profiles from the AMS sensor can be used to help identify specific VOC gases for the next phase of the project.
If you are interested in contributing please get in touch!
WHAT DATA ARE WE COLLECTING:
The primary data gathered by Domestic Light is the color of differing spectra of light in domestic settings (windowsills) in order to build a nuanced multi-spectral data time-lapse of the color ranges of light in domestic settings world-wide in order to answer the primary question of “what is the color of home?”
The data gathered by Domestic Light centers on the output of a small sensor “bauble” that hosts of the project place on their windowsill for a year. The sensor is an AMS7341 or AMS7343 multispectral light sensor gathering the intensity of light spectra from 350nm to 1000nm.
Data collected by the sensors consists of a time-series set of data that consists packets recorded once per second that include (11) 10 bit readings of the spectral intensity of 9 light spectra ranging in wavelength between approximately 350 nanometers to 1000 nanometers, and two additional channels recording overall light intensity and flicker hertz rate if any.
Additional control and configuration metadata transmitted in each packet: a time stamp generated by the real time clock chip, a network clock timestamp, a hashed value encoding the MAC address of the microcontroller for identification, hashed key and channel information for the MQTT database and the current sensor health state. This data is recorded locally on the controller at once per second, cached by the microcontroller and transmitted using an SSL encrypted MQTT protocol to a cloud based MQTT broker SQL database (between once per minute and once per day depending on local network bandwidth.
On the hardware side: The sensor package consists of custom PCB to mount the AS7341 or AS7343 sensor from AMS, alongside an onboard real time clock (RTC) (Maxim 31343) synced at time of shipment to the other sensors, and a microcontroller (Rev A uses a Raspberry Pi Zero 2 W, Rev B uses ESP32-S3 Feather). Power is provided by a 5v USB-C power input and a power cord appropriate to the location hosted.
WHERE IS IT BEING COLLECTED?:
The data from sensors will be stored on the devices while being buffered and then transmitted to longer term cloud storage. After trasnmission the data will be stored in a virtual private server hosted by one of a number of private server providers including AWS (Amazon Web Services, Inc.), Digital Ocean (DigitalOcean Holdings, Inc) or AliBaba as may be appropriate for national data residency requirements. Prior to processing data will only be accessible to the project technical staff using encrypted access.
LONG TERM ARCHIVING:
At the completion of the project the underlying data set of the raw color data and masked geographic location will be archived along with an associated .csv file containing a metadata reference. The intent is that the long term storage will be archived by the University of Sussex Library for the Sussex Humanities Lab, as well as mirror archive included as part of ancillary materials for a special section of the Leonardo Journal (published by MIT press) in Winter 2024. Leonardo currently hosts the data sets and other materials for those issues as part of their publication process. Finally as artist I will maintain a full archive of the project in perpetuity as part of my artistic records and papers.
CREATIVE COMMONS ARCHIVAL PUBLICATION OF DATA: The underlying dataset produced by the data collection project will be published under a CC BY-SA 4.0 (Creative Commons Attribution Share Alike or “copy-left” license), with all data contributors named as contributors unless they elect to be listed anonymously.
Other artists , participants and researchers may utilize the data set to create their own artworks or publications.
WORKS CREATED FROM THE DATA SET:
Any derivative artworks or publications created from the data set will be the IP of the creating artists to do with as they wish so long as the CC BY-SA terms for any distribution of the data set itself are honored.