voti wrote: ↑Mon Apr 21, 2025 6:06 pmThat's it?

If so... then, I've contributed to leading you astray.
And also, this is really interesting from a community/troubleshooting/documentation perspective.
Let's start off with....
In this post:
viewtopic.php?p=79553#p79553
You were following these instructions:
https://openinverter.org/wiki/Toyota_Pr ... Controller
You had a question about Step 9, which said, and you quoted to say: "
default forward, ampnom @ 70%, and fslipspnt @1 Hz. Select - "Start Inverter in Manual Mode" Confirm flashing lights" And weren't sure what it all meant. So you correctly quoted the part you didn't understand, and, identified the problem (among a sea of other questions).
And in the next post, I replied and went through them one by one, and said: ""default forward" - One of the parameters is about which direction the motor should be spinning by default. I forget what it's called,
and it doesn't matter, because this'll be the default and even if it's not, it'll still work." So I knew at this point there was some parameter out there that could be set to this. But without the hardware in front of me, no way I could look it up the name or the value, and told you to ignore it anyways because it'd be done a different way.
...
And, I gave you bad advice. What I meant was, "it will still work, because you'll be connecting a physical wire to set the direction to be forward". And I was
presuming you were connecting that wire at some point in your procedure. Hence, the default doesn't matter (doesn't matter on my setup, works without it). So I was correct. But wrong.
Had we gone all the way through the "wire by wire" picture process, I think I might've caught that you hadn't connected it yet. In fact I could've sworn I asked about you hooking up that wire, but re-reading the entire thread here, I didn't. Too many things to keep track of.
But... there you go. I was often saying that in the end we'd discover there to be some breakdown between what you think you've followed correctly, or what I think I've described correctly, but you've done something different. Somewhere along the line, some presumption was being made, or some detail wasn't clear enough. The mistake was mine.
The instructions you were following don't say "On the OI device interface, type: "Set dirmode DefaultForward" or, whatever the numerical value is (I still don't know) and click the "send command" button next to it. They just rattle off an abbreviated: ""default forward", amprom @70%..."
In this post:
viewtopic.php?p=80567#p80567
You didn't know how to use the OI interface at all to change a command, so I described it for you.
But even then, on the list of parameters:
https://openinverter.org/wiki/Parameters
For DirMode, it only says: "dirmode 0=button (momentary pulse selects forward/reverse), 1=switch (forward or reverse signal must be constantly high)"
It doesn't say anything about defaulting to a certain direction, just to toggle between momentary and latched switches.
Is that outdated? I can't look it up anywhere without logging into the interface that I don't have handy.
...
And I think that's the root of the problem from a community perspective.
The instructions documented are from a perspective of "Someone already familiar with past OI boards, here's what you'd need to do to get this specific new type of board running." So, they'd recognize that the abbreviated verbal instruction "default forward" is referring to a specific unnamed parameter that they (the person writing instructions) already knew about, that the user following those instructions needs to change the parameter "dirmode" (that no one mentioned) needs to be set to value "DefaultFoward".
But to someone who doesn't know this all off by heart, they might not even pick up on that "default forward" refers to a setting of some parameter. Since it's listed first, they might think it's just a label, and that everything that follows is a list for someone who's setting it up to move forward by default.
Also, the power of open source is its curse. There's almost always multiple ways to do something, and conflicting presumptions about what will be obvious to someone. I say it's okay to ignore that instruction, because of course you'll be connecting a wire later. But those specific instructions don't tell you to ever connect that wire, and meanwhile I've skimmed them and presumed they did.
...
So what could have prevented this?
- A less ambiguous and more detailed procedure to follow to setting up the board.
- Perhaps, a properly documented Parameters list on the main page. As it seems that documentation is outdated (I think).
But... the OI software is regularly updated. This might change very specific procedures for specific boards. So if the procedure is highly detailed, every time Johannes makes an update to the software, he'd have to go through every single board procedure and double-check that it doesn't need to change.
Johannes is the one most familiar with the code, and especially the impacts of new changes he made, so he's the best person to do this. But, he's also the worst person to do this, because it's really difficult to un-learn what you know and think like a novice and what may or may not be obvious to them.
So maybe someone else in the community is best. Except, now we'll have various bits of documentation with inconsistent updates to them.
- So, perhaps a central procedure to follow that is kept current, and purge all the extra partially-documented procedures to follow. The procedure for a specific board should only describe the specific way to follow the central procedure, as pertains to the context of that board. Then, hopefully, that only needs updating if someone updates that specific board.
I dunno if any of that makes sense, but I feel that it's a pervasive issue holding back the DIY EV community. It's just not userfriendly enough to be followed by the majority of people who are capable of following it, if it was written for them rather than a much more technical audience.