Documentation is incomplete
-
Thanks for the confirmation @Manuel-Godinez
As an experienced Blynker I don't currently need the GPIO Tool but other users certainly will.
My +2 takes snapshots from a cheapo webcam and emails them to me, all done without port forwarding and with the power of Blynk. Currently snapshots are sent on demand but can be set based on sensors or button pushes etc.
Will post more details at some stage but the setup details for Blynk are at https://wiki.onion.io/Tutorials/blynk-library
It needs an update for +2 pinout but the developers at Blynk have it in their roadmap.
-
Just coming back to the documentation I can't fine the Omega, as opposed to Omega 2 stuff.
Looks like someone has edited the Omega stuff into Omega 2 and not made the appropriate changes for Omega 2.
First thing I looked at was the onboard LED at https://docs.onion.io/omega2-docs/the-omega-led.html#the-omega-led
The path's quoted are incorrect. Don't know if they were right for the Omega as I don't have one.
-
@Costas-Costas said in Documentation is incomplete:
Looks like someone has edited the Omega stuff into Omega 2 and not made the appropriate changes for Omega 2.
Yea, that's what i realized too... so check out on github ... might be better to see the difference ... and or if you find out something you can participate with pull requests to change the Omega2 Manual.
https://github.com/OnionIoT/Onion-Docs
versus
https://github.com/OnionIoT/wikiSometimes it my has something in work on git-hub where is not published yet in wiki/doku.
-
Looks like the GitHub is different to the WiKi.
What's the reason for 2 lots of docs that need to be corrected and kept up to date?
-
@Costas-Costas said in Documentation is incomplete:
What's the reason for 2 lots of docs that need to be corrected and kept up to date?
I bet the documentation will be the e-Book and the wiki will be the resources for omega1.
-
Oh yes with the Ebook that makes 3 lots of docs.
-
@Costas-Costas said in Documentation is incomplete:
Oh yes with the Ebook that makes 3 lots of docs.
No, did you not realize that the structure is all-ready different in the documentation? Just export as a e-document and you have your e-book where you can download ...
-
Also, I think we all would greatly benefit from an ongoing FAQ section. The answers have to be validated and clear. And they should be from the designers of the product. I have spent countless hours trying to figure things out and when I think I have the answer, a new problem arises. Or the figured out problem goes bad again. And I don't know why. Like being disconnected from WiFi for no reason. I finally got it working, but afraid to touch anything!
The documentation is very hard to follow. It makes you skip around and then you can't find where you were. It's very poor to show 1 page of a topic, which doesn't continue. One has to jump back to choose the sub-topic. About the not having to login all the time. Why can't it just be remembered in the OS? Another example, the section doing a command line: oupgrade. The word is in the middle of the sentence in a very light font. You can hardly see it. It should on a line by itself, bold and red. I see many more examples like this. Clear and clean documentation so important!
The first time user, very important person, should be shown step by step how to get the Omega2+ up and working in the most basic way. When appropriate, the steps should be illustrated and explained. For a while, I didn't know if my laptop was actually a wireless client of the Omega. And didn't know the laptop has to be a LAN client of my router. This setup is not usual for a new comer.
This is where a diagram of the connections should be shown.To Onion Management: You do know that hundreds of UNPAID Quality Control Experts are working for you. Without us..... No Omega2+ You need to live up our bargain more.
WE WANT YOU TO SUCCEED !
-
-
Yes the documentation would be better if you didn't have to skip about, poor design in my book (no pun intended).
-
Noticed the almost invisible grey commands hidden within the text. +1 for new line in red.
-
Looks like fast-gpio doesn't work as documented, comes back with:
segmentation error- Could the Onion doc person confirm they are watching this thread or advise how they want to be informed of the errors and omissions?
-
-
@Don-DeGregori , nice point ... i mentioned the FAQ 5 Month ago ....
http://community.onion.io/topic/989/onion-freshdesk-com-support-home-faq
-
- Looks like fast-gpio doesn't work as documented, comes back with:
segmentation errorYes, I ran into something like that before and the problem lies in the syntax, for example the docs says something like: (Example only)
fast-gpio call more -p
The syntax should be something like instead
fastgpio -p call more
AGAIN, this is just an example but you get the idea of what is going on. I just type words as an example and are not actual commands and options.
-
The syntax at https://docs.onion.io/omega2-docs/using-gpios.html is shown as:
fast-gpio read <gpio pin>but
fast-gpio read 5gives the error I stated (technically Segmentation fault) and
fast-gpio 5 readDoesn't error but gives no response.
-
Best way is to do a issue on github as far as there is not changed yet.
From own experiences i got there the best request times for answers.
-
@Costas-Costas The segmentation fault - error is due to missing /dev/mem, not due to something in fast-gpio being wrong. You just have to wait for Onion-devs to fix their kernel.
-
Just to clarify, it was a command but I never mention that it was fast-gpio, but the docs said one way and it was actually different. I will look around and see which one is the one I got the error. I just thought it might help Costas from something that happened to me too.
-
@administrators
When you solve this problem?The syntax at https://docs.onion.io/omega2-docs/using-gpios.html is shown as:
fast-gpio read <gpio pin>but
fast-gpio read 5gives the error I stated (technically Segmentation fault) and
fast-gpio 5 readDoesn't error but gives no response.
-
fast-gpio pulses - how to use this feature?
-
@Vlad-Leonov said in Documentation is incomplete:
The syntax at https://docs.onion.io/omega2-docs/using-gpios.html is shown as:
fast-gpio read <gpio pin>
but
fast-gpio read 5
gives the error I stated (technically Segmentation fault) and
fast-gpio 5 read
Doesn't error but gives no response.UP
-
@Manuel-Godinez said in Documentation is incomplete:
but the docs said one way and it was actually different.
The doc was first of all a copy of the wiki, the wiki was made for omega1. As hardware and software is changing from time to time, the documentation also has to be changed.
If you find something out other than documentation suggests, please do a pull request to simplify the doc's writers live
.
