Comments (9)
The only thing we have is https://docs.px4.io/main/en/modules/modules_driver_ins.html#vectornav, which has a broken link to Setup/usage information: https://docs.px4.io/master/en/sensor/vectornav.html
I don't even know what a vectornav is, so perhaps you could expand on what you'd like to see. I can guess from the docs at that module that it is enabled by specifying https://docs.px4.io/main/en/advanced_config/parameter_reference.html#SENS_VN_CFG on a particular serial port - but that's it.
from px4-user_guide.
I've been working on getting a driver for the VectorNav INS over the last few months, and was going to add a page for the VectorNav driver similar to this. I'm happy to work this issue and submit the work to you for a review
from px4-user_guide.
Thanks @lashVN - that would be excellent. Looking forward to it.
from px4-user_guide.
Hi @hamishwillee I apologize for my procedural ignorance, I haven't contributed to the user guide before, and have fairly limited contribution to public github pages (my experience is largely with private gitlab codebases)
If you'd be willing to help, where should I go to create a branch for this issue? I don't see any evident "create branch" button, and I'm prevented by git from pushing a local branch to origin.
from px4-user_guide.
Hi @lashVN
Not a problem. So the broad instructions on writing docs are here: https://docs.px4.io/main/en/contribute/docs.html
You should be able to fork the guide repo at https://github.com/PX4/PX4-user_guide and push to that - then you can create a PR for to the PX4 org version.
Does that help?
from px4-user_guide.
Hi @hamishwillee , thanks for your help.
I have a rough cut pushed here. I'd be interested in any feedback, but in particular if there is anything that is inappropriately placed.
I mostly took a guess at where everything belongs. The VectorNav driver is in a bit of an awkward place: it's both an external sensor (IMU+GNSS), but is more commonly used as an external INS to replace PX4's internal EKF. I don't particularly care where the pages go, whatever makes the most sense to the overall architecture.
I don't see other pages that are documenting the driver behavior in the same way (such as configuration parameters set and published topics), is that appropriate?
I didn't see a place where I can link my kconfig parameters (such as CONFIG_COMMON_INS) in the same way I link my runtime parameters (such as VN_MODE). Is there somewhere else I should be looking?
Lastly, are the couple tips I have (such as dmesg or listener commands) appropriate?
from px4-user_guide.
Hi @lashVN
Can you please create a PR from your branch to PX4 org version - that will make this reviewable. As it is now it is hard for me to see the delta. I work on Weds/Thurs, so will look at this next week.
In general though don't worry about "where everything goes" or whether you have put too much. My aim for these things it to write everything that I personally would need to understand "what this is for" and "when you might want to use it" and "how do I set it up from scratch, including wiring, powering, PX4 config, device config, firmware building etc.
The only way you can do too much is if you duplicate general config stuff - in which case I will tidy that with cross links in review.
There are no docs for kconfig params. I usually just provide a link to source code for those.
from px4-user_guide.
That sounds good, I wasn't sure procedurally if you expected me to wait until it was done to submit a PR. It's still WIP, as I have to clean up some of the language. I'll fill it out a bit more to answer some of those questions in the page
from px4-user_guide.
Thanks. We won't merge the PR until it is ready, so WIP is fine.
from px4-user_guide.
Related Issues (20)
- Wrong Env name for PX4 standalone run HOT 1
- Does anybody know how to contact the PX4 user guide document/website management team? HOT 4
- Broken QGroundControl related links HOT 1
- How to use MAV_CMD_DO_SET_ACTUATOR in MATLAB? HOT 5
- I have run into the following error when I run command make px4_sitl_default gazebo. It seems to be in conflict with my OpenCV environment. How can I fix? HOT 1
- Introduction of the Kconfig definition file in "Development/Writing your First Application" is incorrect HOT 1
- VIO guide for px4 v1.14 and above HOT 2
- A big problem of PX4(Pico900) HOT 1
- Unable to download Px4 simulation with MacOS
- Create Ukrainain build of PX4 User Guide HOT 11
- 1.9.0 Documentation unavailable HOT 7
- A conflict between the table and the right menu HOT 1
- Troubleshooting tips for ethernet and gimbal connection HOT 2
- The angle of the camera image does not change with the change of yaw&pitch angle during multi plane simulation HOT 4
- GitHub Repository Link Shows 404 HOT 1
- Spelling error "Possibly" instead of "Possible" HOT 2
- Various ROS links are broken HOT 1
- Unable to run 'make px4_sitl gazebo-classic HOT 1
- error: externally-managed-environment HOT 4
Recommend Projects
-
React
A declarative, efficient, and flexible JavaScript library for building user interfaces.
-
Vue.js
🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.
-
Typescript
TypeScript is a superset of JavaScript that compiles to clean JavaScript output.
-
TensorFlow
An Open Source Machine Learning Framework for Everyone
-
Django
The Web framework for perfectionists with deadlines.
-
Laravel
A PHP framework for web artisans
-
D3
Bring data to life with SVG, Canvas and HTML. 📊📈🎉
-
Recommend Topics
-
javascript
JavaScript (JS) is a lightweight interpreted programming language with first-class functions.
-
web
Some thing interesting about web. New door for the world.
-
server
A server is a program made to process requests and deliver data to clients.
-
Machine learning
Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.
-
Visualization
Some thing interesting about visualization, use data art
-
Game
Some thing interesting about game, make everyone happy.
Recommend Org
-
Facebook
We are working to build community through open source technology. NB: members must have two-factor auth.
-
Microsoft
Open source projects and samples from Microsoft.
-
Google
Google ❤️ Open Source for everyone.
-
Alibaba
Alibaba Open Source for everyone
-
D3
Data-Driven Documents codes.
-
Tencent
China tencent open source team.
from px4-user_guide.