12. Run factory workflows at your desk#
Caution
This section and the ones after it require a Pimoroni Enviro+ Pack. See Set up your hardware for a review of the hardware setup options. If you don’t have an Enviro+, skip ahead to 15. Wrapping up to wrap up your tutorial experience.
Bringing a consumer electronics product from concept to mass market requires a lot more than just good firmware. The new hardware also needs to be easy to test in factories. A lot of the Pigweed primitives that you tried earlier such as pw_rpc also make manufacturing workflows easier. Try flashing a factory app to your Pico now and running through a Python script that exercises all of the Enviro+ sensors.
Flash the factory app to your Pico#
Flash the
factorybinary to your Pico.In Bazel Build Targets expand //apps/factory, then right-click :flash (native_binary), then select Run target.
Run the flashing command:
$ bazelisk run //apps/factory:flash
Exercise the sensors#
Run through the factory testing script.
In Bazel Build Targets expand //tools, then right-click :factory (py_binary), then select Run target.
The factory testing script launches in a VS Code terminal tab.
Run the factory script.
$ bazelisk run //tools:factory
Troubleshooting
serial.serialutil.SerialException: [Errno 16] could not open port ... [Errno 16] Device or resource busy. Close the browser tab running the web app. The factory script couldn’t connect to your Pico because the web app is still connected to the Pico.Follow the prompts in the factory testing script. It’s OK if some tests don’t pass. This is just an example factory-at-your-desk workflow.
See Appendix: Example for an example of a successful walkthrough of the factory script.
Tip
One easy way to do the gas resistance test is to dip a cotton swab in rubbing alcohol and then hold the cotton swab close to the BME688 sensor.
Summary#
For low-volume products a workflow like what you just tried can sometimes be good enough for verifying that every newly manufactured product works as expected. For high-volume products you usually need to integrate into the manufacturer’s workflows, so the script we demonstrated here won’t suffice. But Pigweed’s abstractions, primitives, and tools often make that easier high-volume production easier, too. These factory-at-your-desk scripts can also help development teams quickly prototype and iterate on the basic workflows that will be expanded upon during the real high-volume manufacturing process.
Next, head over to 13. Use Bazel’s cloud features to learn about Bazel’s cloud features.
Appendix: Example#
Here’s an example of a successful walkthrough of the factory testing workflow.
===========================
Pigweed Sense Factory Tests
===========================
Operator: kayce
Date: 2024/08/06 19:01:08
Device flash ID: 2a4b9643086461e6
4 tests will be performed:
- LedTest
- ButtonsTest
- Ltr559Test
- Bme688Test
>>> Press Enter when you are ready to begin
Starting hardware tests.
==========================
[1/4] Running test LedTest
==========================
>>> Is the Enviro+ LED white? [Y/n] y
PASS: led_white
>>> Is the Enviro+ LED red? [Y/n] y
PASS: led_red
>>> Is the Enviro+ LED green? [Y/n] y
PASS: led_green
>>> Is the Enviro+ LED blue? [Y/n] y
PASS: led_blue
>>> Is the Enviro+ LED off? [Y/n] y
PASS: led_off
==============================
[2/4] Running test ButtonsTest
==============================
>>> Press Button A
PASS: button_a
>>> Press Button B
PASS: button_b
>>> Press Button X
PASS: button_x
>>> Press Button Y
PASS: button_y
=============================
[3/4] Running test Ltr559Test
=============================
Setting LTR559 sensor to proximity mode.
>>> Place your Enviro+ pack in a well-lit area
Press Enter to continue...
Getting initial sensor readings
100.0% [==============================================================================================================>] 5/ 5 eta [00:00]
DONE
Samples 5
Min 0.00
Max 0.00
Mean 0.00
>>> Fully cover the LIGHT sensor
Press Enter to continue...
Reading sensor - 28992.00, 29440.00, 29248.00, 29088.00, 29056.00
10.0% [===========> ] 5/ 50 eta [00:00]
Samples 6
Min 28992.00
Max 29440.00
Mean 29440.00
PASS: ltr559_prox_near
>>> Fully uncover the LIGHT sensor
Press Enter to continue...
Reading
10.0% [===========> ] 5/ 50 eta [00:00]
Samples 6
Min 0.00
Max 0.00
Mean 0.00
PASS: ltr559_prox_far
Setting LTR559 sensor to ambient mode.
>>> Place your Enviro+ pack in an area with neutral light
Press Enter to continue...
Getting initial sensor readings
100.0% [==============================================================================================================>] 5/ 5 eta [00:00]
DONE
Samples 5
Min 116.34lux
Max 116.34lux
Mean 116.34lux
>>> Cover the LIGHT sensor with your finger
Press Enter to continue...
Reading - 7.34, 7.34, 7.34, 7.34, 7.34
100.0% [==============================================================================================================>] 100/100 eta [00:00]
Samples 100
Min 5.39lux
Max 11.62lux
Mean 11.62lux
FAIL: ltr559_light_dark
=============================
[4/4] Running test Bme688Test
=============================
Testing gas resistance in the BME688 sensor.
To test the BME688's gas sensor, you need an alcohol-based
solution. E.g. dip a cotton swab in rubbing alcohol.
>>> Are you able to continue this test? [Y/n] y
Getting initial sensor readings - 5684.85, 5684.85, 5684.85, 5684.85, 5684.85
100.0% [==============================================================================================================>] 10/ 10 eta [00:00]
DONE
Samples 10
Min 5684.85
Max 1173639.00
Mean 1173639.00
>>> Move the alcohol close to the BME688 sensor.
Press Enter to begin measuring...
Reading sensor - 5684.85, 5684.85, 5684.85, 5684.85, 5684.85
10.0% [===========> ] 5/ 50 eta [00:00]
Samples 6
Min 5684.85
Max 5684.85
Mean 5684.85
PASS: bme688_gas_resistance_poor
>>> Move the alcohol away from the BME688 sensor
Press Enter to continue...
Reading sensor - 30468.94, 31067.96, 31573.75, 31928.16, 32290.62
100.0% [==============================================================================================================>] 50/ 50 eta [00:00]
Samples 50
Min 5684.85
Max 32290.62
Mean 32290.62
FAIL: bme688_gas_resistance_normal
Testing BME688's temperature sensor.
Getting initial sensor readings - 28.11, 28.11, 28.12, 28.12, 28.11
100.0% [==============================================================================================================>] 10/ 10 eta [00:00]
DONE
Samples 10
Min 27.86C
Max 28.12C
Mean 28.12C
>>> Put your finger on the BME688 sensor to increase its temperature
Press Enter to begin measuring...
Reading sensor - 30.62, 30.53, 31.27, 31.78, 32.02
88.0% [================================================================================================> ] 44/ 50 eta [00:00]
Samples 45
Min 29.70C
Max 32.02C
Mean 32.02C
PASS: bme688_temperature_hot
>>> Remove your finger from the BME688 sensor
Press Enter to begin measuring...
Reading sensor - 29.86, 30.11, 30.05, 29.99, 29.93
5.0% [=====> ] 5/100 eta [00:00]
Samples 6
Min 29.81C
Max 30.11C
Mean 30.11C
PASS: bme688_temperature_normal
============
Test Summary
============
Operator: kayce
Date: 2024/08/06 19:01:08
Device flash ID: 2a4b9643086461e6
LedTest
PASS | led_white
PASS | led_red
PASS | led_green
PASS | led_blue
PASS | led_off
ButtonsTest
PASS | button_a
PASS | button_b
PASS | button_x
PASS | button_y
Ltr559Test
PASS | ltr559_prox_near
PASS | ltr559_prox_far
FAIL | ltr559_light_dark
Bme688Test
PASS | bme688_gas_resistance_poor
FAIL | bme688_gas_resistance_normal
PASS | bme688_temperature_hot
PASS | bme688_temperature_normal
14 tests passed, 2 tests failed.
========================================
Device logs written to /home/kayce/tmp/cli/sense/factory-logs-20240806190108-device.txt
Factory logs written to /home/kayce/tmp/cli/sense/factory-logs-20240806190108-operator.txt