this post was submitted on 04 Jul 2023
73 points (100.0% liked)

flashlight

2985 readers
19 users here now

Portable illumination

Rules:

  1. Be excellent to each other
  2. Don't be the reason we need to make more rules

Related:

founded 2 years ago
MODERATORS
73
submitted 1 year ago* (last edited 11 months ago) by containerfan to c/flashlight
 

Advanced UI

Simple UI

Background: This was 100% inspired by Lux-Perpetua's Andúril 2 UI diagram on BLF. In fact, Lux's diagram is so good, that I would have been happy to just use it except for one thing: the source isn't published, so you can't modify it. I also wanted to be able to keep it up to date with u/ToyKeeper's code. So I created my own...

~~This is where I intend to store all of my Anduril 2 UI diagrams, and any updates to them. Since ToyKeeper split off the multi-channel version of Anduril 2, I have created two new diagrams for it:~~

  • ~~Anduril 2 Multi-Channel Advanced UI (PNG)~~
  • ~~Anduril 2 Multi-Channel Simple UI (PNG)~~

Diagrams now hosted on GitHub.

~~Yeah, it got complicated enough that I could no longer fit the Advanced and Simple UI diagrams on a single page, so I had to split them.~~

~~As always, you are free to do whatever you want with these diagrams. I make these for myself, and I'm happy to share them with the community. You can find the source MS Visio file here. Feel free to make your own copy and modify it to your heart's content. The Visio file contains several pages:~~

  • ~~Single-Channel - Advanced/Simple UI diagram for the single-channel version of Anduril 2. I still need to update and post it.~~
  • ~~Multi-Simple - Simple UI diagram for the multi-channel version of Anduril 2.~~
  • ~~Multi-Advanced - Advanced UI diagram for the multi-channel version of Anduril 2.~~
  • ~~Diagram Parts - Various bits and pieces that I use in the various UI diagrams.~~

If you find any errors, please post a comment here. I try to keep the diagrams as accurate and up-to-date as possible, but you know, life happens. Enjoy!

Updates:

  • 2023-07-06: Fixed several issues pointed out here. Thanks @lowprofile!
  • 2023-07-09: Fixed a few more issues pointed out here. Thanks again @lowprofile! Also trying to get the wording in a few places more inline with the text manual.
  • 2023-07-15: Updated for r728 which added channels for red, yellow, green, cyan, blue, purple, and white. Added 4H from ON to Momentary Turbo. Added 3C from Tactical Mode to Next Channel Mode. Several other minor fixes. Huge thanks to @lowprofile for continuing to provide valuable feedback. This multi-channel diagram has been a journey!
  • 2023-07-17: Multiple visual enhancements/fixes thanks to @lowprofile. Incremented the version to r732 even though there were no material impacts to the diagram.
  • 2023-07-20: Modified the ramp part of the diagram to reflect the default Anduril 2 configuration (2C to Ceiling). Thanks again to @lowprofile for feedback. I also switch from revisions to build dates as suggested by ToyKeeper.
  • 2023-07-22: Made several corrections to the Simple UI diagram that I had been neglecting. Also made a slight wording change to the ramp config boxed on the Advanced UI diagram. Thanks to @lowprofile for all corrections. Finally, I incremented the build date to 2023-07-21, although there were no material impacts to the diagrams.
  • 2023-08-06: Several cosmetic fixes to the Simple and Advanced UI diagrams thanks to feed back from @lowprofile. Also incremented the build date to 2023-08-04, although there were no material impacts to the diagrams.
  • 2023-08-07: Several clarifications thanks to feedback from @lowprofile. Also incremented the build date to 2023-08-07, although there were no material impacts to the diagrams.
  • 2023-08-10: Several cosmetic fixes to the Simple and Advanced UI diagrams thanks to feed back from @lowprofile.
  • 2023-10-03: I'm embarrassed to admit that I missed an update from the 2023-08-27 release in which "smooth steps" were added (see the Ramp Extras Config). Other than that, there have been no material changes to the diagrams.
  • 2023-11-07: I finally got around to making a couple of updates suggested by @lowprofile. In the Strobe Modes on the Advanced UI diagram, you'll notice that 3C allows you to save the channel mode per strobe mode. Very cool!
  • 2024-01-01: Last update here on Lemmy. Lemmy is great, but it makes more sense to host the diagrams on GitHub when I can issue diagram releases corresponding with ToyKeeper's Anduril 2 releases. From now on, please access the diagrams there. It's a fairly significant update, so please be sure to read the README.
you are viewing a single comment's thread
view the rest of the comments
[–] containerfan 2 points 1 year ago (1 children)

Thanks so much for the feedback. I corrected #1, 2, 3, and 5 in the diagram for the Advanced UI. I can't get #4 to work on my dual-channel D4V2. It looks like it's changing channels, but it switches back to the original channel almost immediately. Are you able to get this working on a light? How is it supposed to behave?

[–] lowprofile 2 points 1 year ago (1 children)

The updated diagram is looking very good, thanks! And yes, I had #4 working just fine, but I checked again, and it is not working with every Anduril 2 version. I do not want to overcomplicate this, but as the Anduril 2 multi-channel branch is in active development, a little extra detail seems to be in order here:

I am checking this with two D2s (but apparently, so far I only checked 3H in Lockout Mode with the first one of them):

  1. First D2: Running anduril.emisar-2ch-aux.hex by SiteRelEnby, as referred to in this Reddit post (there is also a Lemmy post, but that one does not include the GitHub links added at the top), version 0135-2023-07-03 (new version format).

  2. Second D2: Running anduril.2023-04-25.emisar-2ch.hex from ToyKeeper's /torches/fsm/anduril2, version 2023-04-26-0135 (old version format); please note: at the same site, also the newer version anduril.2023-05-30.emisar-2ch.hex is available.

Back to #4: 3H in Lockout Mode for Change channel works with the first D2, but not with the second D2.

(By the way, the newer Anduril 2 version of the first D2 also added aux LED channels to Change Channel, 3C from ON. This might be another addition to the diagram in the future, adding seven more channels, one each for red, yellow, green, cyan, blue, purple, and white aux LEDs. For example, I disabled all the aux LED channels via 9H from ON, but for the blinky modes, 3C from BattCheck, I set white aux LEDs.)

As 3H from Lockout to Change channel is in ToyKeeper's text manual, which is my point of reference, I guess it should also be in the diagram; cf. the UI Reference Table at the end:

Lockout Any 3H Next channel mode (if more than one enabled)

And on to #3: Arguably, this should read 3C: Change channel rather than presently 3C: Change channel for strobe modes, as this channel change is not limited to the strobe modes, but extends to ON as well. The same goes for 3H from Lockout, #4, which accordingly should also read Change channel. Both of these only show the enabled channels, not the disabled ones.

And both of these differ from 3C from BattCheck, which shows all the channels, enabled as well as disabled ones, and which is indeed limited to the blinky modes, so the present addition for blinky modes in Switch channel for blinky modes is correct. Cf. also the (for number blinks only) in the UI Reference Table at the end of ToyKeeper's text manual:

Batt check Full 3C Next channel mode (for number blinks only)

[–] containerfan 1 points 1 year ago (1 children)

Thanks for the continued feedback. I somehow missed 3H from lockout in the text manual the first time around. Even though I can't get it working properly on my D4V2 at the moment (hex compiled directly from ToyKeeper's r725 code), I included it. I assume it'll be fixed soon.

I also changed the wording slightly for channel switching to be more inline with the text manual, so now it reads "next channel mode" in a few places.

I'm a little confused about the feature to use 3C to cycle through the aux LED colors. So on my D4V2 which has RGB aux, would 3C turn on, for example, the red aux as the main emitters? For now, I added "Aux LED Channel(s)" to the Next Channel Mode boxes, but I don't know if that's appropriate. Take a look, and let me know what you think. Thanks!

[–] lowprofile 2 points 1 year ago (1 children)

Excellent, and thanks again for your work! This is the only diagram I am aware of that is displaying the (many) new Anduril 2 multi-channel features, and I consider this diagram to be a great contribution to the community.

As there are so many details to pay attention to, and things can get somewhat confusing, I will go along the individual points. For each of them, I will lay out what the two D2s at my end are doing.

The first D2 has remained as described above, running anduril.emisar-2ch-aux.hex from SiteRelEnby, version number 0135-2023-07-03.

The second D2 is now updated to the latest version from ToyKeeper's site, running anduril.2023-05-30.emisar-2ch.hex, version number 0135-2023-05-30.

  • 3H in Lockout Mode for Next Channel Mode: First D2: working. Second D2: working (but not for the aux LED channels).

The wording Next Channel Mode looks good to me, also for 3C from ON, and it is in line with the text manual.

The Aux LED Channel(s) work in the first D2, but not in the second D2. The aux LEDs indeed work as the main emitters in this situation, and as far as I have observed it is ON/OFF with one (high aux) brightness. As to whether to include the Aux LED Channel(s) in the diagram for 3H from Lockout and for 3C from ON, I would suggest: presently No. Although ToyKeeper's text manual apparently does not specify the channel modes, cf.

A light can have many different channel modes, so don't be shy about turning off any modes you don't use. It makes all the others easier to reach.

at least for the .hex from ToyKeeper's site these seem not be included at present, so including them might cause unnecessary confusion. They could simply be added at a later point in time. Then, for consistency, also the Channel Mode Config, 9H from ON, would have to include the aux LED channels (seven, adding up to 12 channel modes).

  • 3C: Next channel mode in Strobe Modes: First D2: working. Second D2: working.

All fine here (one detail I observed is that the police strobe runs with red and blue aux LEDs in the first D2, but with Channel 1 and 2 in the second D2, just an observation, nothing to be included in the diagram).

  • 3C from Batt Check for Next channel mode (for number blinks only): First D2: working. Second D2: sort of working (?).

Again, the new wording looks good to me, and it is in line with the text manual. Actually, it is clearer than before, when it referred to the blinky modes rather than the number blinks, as this channel change only applies to Batt Check and to Temp Check, not to Beacon and SOS. Within the Blinky/Utility Modes I had interpreted Blinky to refer to Batt Check and Temp Check, and Utility to refer to Beacon and SOS, but I might have misconstrued that. However that may be, referring to (for number blinks only) in the diagram clears that up.

The first D2 cycles through all the channel modes, enabled as well as disabled ones, and choosing a channel mode is indeed limited to the number blinks only (and also includes e.g. Version Check, 15C). This is in line with the text manual.

But with the second D2, 3C from Batt Check works just like 3C from ON, 3C in Strobe Modes and 3H in Lockout Mode, i.e. it only cycles through the enabled channels, and choosing a channel change extends to ON etc. and is not limited to the number blinks only. This is not in line with the text manual.

In this case, I would suggest to give priority to the text manual and leave the current wording in the diagram as it is.

[–] lowprofile 2 points 1 year ago* (last edited 1 year ago) (1 children)

PS: With the latest revision 728 from yesterday, 2023-07-10, as far as I can tell, ToyKeeper now integrated the 7 aux LED channel modes into the emisar-2ch build.

With this, I would now suggest to include the aux LED channel modes in Next Channel Mode, 3C from ON, and leave the present Aux LED Channel(s), or rather Aux LED Channels, in the diagram; there might be no need to individually specify the 7 aux LED channel modes: Red, Yellow, Green, Cyan, Blue, Purple, White.

And for Channel Mode Config, 9H from ON, to save space by not adding 7 additional points, there could e.g. be one additional point 6+) Release after sixth+ flash and Configure channel 6+.

Moreover, I noticed a couple of other details in the diagram, and I will post a new comment for those. With all the current additions, I figure it is expected to take a little while to get everything up to speed.

UPDATE 2023-07-14: I checked with r728 (hex compiled directly from ToyKeeper’s code), and indeed, the 7 aux LED channel modes are now integrated into the emisar-2ch build. One difference I observed compared to SiteRelEnby’s version from above is that the 7 aux LED channel modes are not enabled, but rather disabled by default (which I would have suggested as well).

[–] containerfan 1 points 1 year ago (1 children)

Yes! It's working on my D4V2! I updated the Channel Mode Config as you suggested (mostly). I'll have the updated version posted shortly. Thanks again for the recommendations!

[–] lowprofile 2 points 1 year ago

Excellent, looking very good! Thanks again!