Reading through Adafruit AS7341 Arduino library implementation of
readAllChannels(), I was happy to see it mostly confirmed information I understood from datasheet reading. It also had something else: how to configure AS7341 sensor multiplexor (SMUX). Details of which were critical information completely missing from the datasheet, mere a note that AMS provides sample code. [Update: Details were in an Application Note.] I say sample code is a poor substitute for proper documentation and my position remains unchanged.
I thought I might have a good shot at figuring out SMUX configuration registers, given that I have found three sample points. DFRobot has an Arduino AS7341 library. Adafruit has their own implementation of an Arduino AS7341 library. And hidden in the examples folder of Adafruit’s library is an Arduino sketch that doesn’t use Adafruit’s library at all, written by an AMS application support engineer. Comparing and contrasting between them should tell me a lot!
Unfortunately, as soon as I took a closer look my expectation went down in flames. These three examples are writing the exact same bytes to the exact same registers. There’s nothing to compare and contrast at all. This feels like someone at AMS wrote a SMUX configuration at one point and it’s just been copied and pasted ever since. All we really have to work with are the skimpy comments in these configuration routines.
Based on these comments, each register corresponds to a single sensor, except when it controls two sensors. Bits in the register control which ADC is connected. It was easy to infer that zero representing no connection to any ADC at all, but other than that the bits are inconsistent. Setting register 0x0F to 0x30 supposedly connected to ADC2, but for register 0x0A it was 0x03 that connected to ADC2. Some of the sensors have a “left” and “right” but it’s not clear what that means. My best guess is from the datasheet figure showing sensor array layout:
Maybe “F3 left set to ADC2” means connecting only the left side F3 sensor, leaving the right side F3 sensor unused? That would mean we’re using half the available sensor area to gather light, which seems sub-optimal.
And most critically, the comments weren’t enough for me to figure out how I’d create a different SMUX configuration. There’s nothing about any of these in the datasheet, which remains my biggest complaint to AMS. The only description I found in the datasheet is that flicker detection sensor must be connected to ADC5.
One odd thing I noticed about this copied-and-pasted code snippet is the fact it sends twenty bytes of SMUX configuration as twenty write operations of single bytes to sequential registers 0x00 through 0x13 inclusive. Why do it in such an efficient way? For my project I converted that to a faster and more efficient single write operation of twenty bytes and it seems to work.
The good news is that these sample code snippets help us configure SMUX to do something useful in line with functionality demonstrated by these samples. The bad news is that we don’t have enough information to design and build our own SMUX configurations to suit specific needs. I guess if someone wants to use AS7341 professionally they can ask AMS application support team to build a custom SMUX configuration for them. For an electronics hobbyist like myself, these fixed configurations are sufficient for me to complete my project, but I am still grumpy with AMS about it.
Code for this project is publicly available on GitHub.
3 thoughts on “Sample Code Gave Incomplete Picture of AS7341 SMUX Configuration”
Hi, I’m currently also fiddling with the AS7341 and read your posts with high interest.
In return I want to help you out on one thing: There actually is all the documentary availible, that you’re missing.
On the sensors AMS site on the tab “Tools & Ressources” (https://ams.com/as7341#tab/tools) are some zip files called “Evaluation Software” for download. Contained are also various application notes and documents, that help a lot.
The newest ressources I’ve found to be in “AS7341_EvalSW_ALS_v1-26-3.zip”.
Hope that brings you one step further, looking forward to you next post.
Thanks for the pointer! I remember seeing links to those two evaluation kits, but I don’t remember seeing large ZIP files for evaluation software before. Quite promising for further investigation.
Inside AS7341_EvalSW_ALS_v1-26-3 is Documents/application notes/SMUX/AS7341_AN000666_1-01.pdf. Titled “SMUX Configuration: How to Configure SMUX for Reading Out Results”, this application note has the information I had expected to find in the datasheet (and was disappointed not to.) Wonderful.
Thanks for the pointer!