User Tools

Site Tools


start

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revision Previous revision
Next revision
Previous revision
start [2019/02/24 17:58]
wtalen [other Wikis]
start [2020/01/12 17:16]
127.0.0.1 external edit
Line 2: Line 2:
  
 **AgOpenGPS** **AgOpenGPS**
 +
 +AgOpenGPS is an open source windows program that can be used in cab for autosteer, guidance, section control, and many other features that are typically found in expensive name brand precision agriculture companies. The difference is there are even more forward thinking features built in to this program and yet more in development. And these are built by farmers for farmers!
 +
 +This program was first written by Brian Tischler who made it available to all who are interested in learning more about coding and electronics and how they can benefit farmers all over the world. ​
 +
 +We don't want anyone to get hurt or sued so below you'll find a disclaimer. If you choose to install this stuff on your Ag. Equipment, do so at your own risk.
  
 *** Important *** *** Important ***
Line 23: Line 29:
  
 ====== Step by Step Software & Hardware Setup ====== ====== Step by Step Software & Hardware Setup ======
 +This Wiki is about to undergo some major updates please bear with some errors and oversights in the meantime.
 Follow these steps below. Follow these steps below.
-===== Software and Tablet ===== 
  
 +5 components are required for a vehicle that uses AgOpenGPS for autosteer
 +  - A Windows Laptop/​Tablet
 +  - A [[gps:​start|GPS receiver]] that outputs NMEA 0183 messages
 +  - Brian'​s PCB v2
 +  - A [[steering_angle_sensor:​start|Wheel Angle Sensor]]
 +  - A [[steering_motor:​start|Steering Motor]] or [[hydraulic_steering:​start|hydraulic valves]]
  
 +=====Laptop/​Tablet=====
 AgOpenGPS runs on the Windows operating system. ​ AgOpenGPS runs on the Windows operating system. ​
 It uses the .NET framework (4.0 minimum). It uses the .NET framework (4.0 minimum).
  
 The minimum screen resolution AgOpenGPS will work with is 1024 x 768.  The minimum screen resolution AgOpenGPS will work with is 1024 x 768. 
- 
 1920 x 1080 is preferred, and of course the higher resolutions found on the Acer transformer 300, Acer Switch 12, Microsoft Surface, or Samsung work even better. 1920 x 1080 is preferred, and of course the higher resolutions found on the Acer transformer 300, Acer Switch 12, Microsoft Surface, or Samsung work even better.
  
 A Touchscreen is preferred to work with AgOpenGPS. ​ A Touchscreen is preferred to work with AgOpenGPS. ​
  
-When selecting a tablet, ensure it has at least one USB port free with its charging cord plugged in. You need to charge the tablet and use a USB port for external hardware (arduino) at the same time. Another thing to consider is screen brightness, 1000 NITS is ideal. +When selecting a tablet, ensure it has at least one USB port free with its charging cord plugged in. You need to charge the tablet and use a USB port for external hardware (arduino) at the same time. Another thing to consider is screen brightness, 1000 NITS is ideal. Used Toughbooks/​Toughpads are a popular choice and well suited for a tractor cab
-Agopengps will also use Ethernet ​in future so keep this in mind if you upgrading.+AgOpenGPS can also use Ethernet ​and this is in fact the preferred connection method although USB/serial connection are still possible.
  
-Download software from [[https://​github.com/​farmerbriantee|https://​github.com/​farmerbriantee]] +Download software from [[https://​github.com/​farmerbriantee/AgOpenGPS|https://​github.com/​farmerbriantee/AgOpenGPS]]
-There are some repos:+
  
-agopen: is the actuall beta version +AgOpenGPS: is the stable version
-agopengps: is an old stable version+
  
  
-  * Click AgOpen or agopengps:+  * Click AgOpenGPS:
   * Click green button: Clone or download / Download zip   * Click green button: Clone or download / Download zip
   * unzip   * unzip
  
 Folder Contains: ​                                                         Folder Contains: ​                                                        
-  * agopen_dev: the software+  * AgOpenGPS: the software
     * Application:​ AgOpenGPS ​     -this is the software icon →                 {{{ :​aog_app_snip.jpg?​400|}}     * Application:​ AgOpenGPS ​     -this is the software icon →                 {{{ :​aog_app_snip.jpg?​400|}}
     * Source: ​                    -this is the source code     * Source: ​                    -this is the source code
Line 143: Line 152:
   * The BNO055 IMU has been found to only work reliably when placed as far from metal as possible. Usually it is placed on the roof in a weatherproof container or very high on the windshield. Keep this in mind when building your board.\\   * The BNO055 IMU has been found to only work reliably when placed as far from metal as possible. Usually it is placed on the roof in a weatherproof container or very high on the windshield. Keep this in mind when building your board.\\
   * There is a 5v version and a 3.3 v version of the MMA 8452/1. If using the 3.3v version you can  power it from the 3.3v supply pin of arduino and in series add 330 ohm resistors to SCL and SDA lines.\\   * There is a 5v version and a 3.3 v version of the MMA 8452/1. If using the 3.3v version you can  power it from the 3.3v supply pin of arduino and in series add 330 ohm resistors to SCL and SDA lines.\\
-  * If you use the ADS analog to digital ​converter try to place it as close to the wheel angle sensor as possible. If it is unsuitable to place away from main board the converter is still beneficial to install. If you do not use the converter connect the sense wire from the wheel sensor to A0 on the Nano.+  * If you do not use the ADS analog to digital converter connect the sense wire from the wheel sensor to A0 on the Nano.
  
  
Line 175: Line 184:
 Once the sensor reads zero, close the wizard and click on the red drive button. The button will now turn green and the steer motor should respond to changes when the slider moves. Move the slider side to side and ensure the vehicle corresponds to the input correctly. If not you may have to invert angle sensor in Arduino code, reupload, close and open agopengps and try again.{{roll.png?​250}}\\ ​ Once the sensor reads zero, close the wizard and click on the red drive button. The button will now turn green and the steer motor should respond to changes when the slider moves. Move the slider side to side and ensure the vehicle corresponds to the input correctly. If not you may have to invert angle sensor in Arduino code, reupload, close and open agopengps and try again.{{roll.png?​250}}\\ ​
 Once the vehicle corresponds correctly open the steer wizard and follow the instructions.\\ ​ Once the vehicle corresponds correctly open the steer wizard and follow the instructions.\\ ​
-After you obtain the counts per degree close the wizard and open the steer tab. Enter the counts per degree. Max steer angle is the maximum angle you want the vehicle to turn. Minimum pwm is the power that will be required before it is sent to the steer motor.(prevents the motor noise from PWM) At this point other settings will be variable and must be adjusted by trial and error. FarmerBrianTee has many youtube videos explaining theory on each setting. https://​www.youtube.com/​watch?​v=rYBWaVwWf ​+After you obtain the counts per degree close the wizard and open the steer tab. Enter the counts per degree. Max steer angle is the maximum angle you want the vehicle to turn. Minimum pwm is the power that will be required before it is sent to the steer motor.(prevents the motor noise from PWM) At this point other settings will be variable and must be adjusted by trial and error. Here are [[PID settings|a few sample settings]] with various motor and motor driver combinations. FarmerBrianTee has many youtube videos explaining theory on each setting. https://​www.youtube.com/​watch?​v=rYBWaVwWf ​
  
 ---- ----
Line 268: Line 277:
   * A - Autosteer   * A - Autosteer
  
 +==== Button Functions v4.0 ====
 +{{::​buttons_with_nums.png?​1000|}}
 +
 + ​Version 4, extanded interface mode
  
 +  * 1  - **5Hz**: GPS update rate, **3**: Frame build time in ms, **Sim**: simulator mode "​ON"​
 +  * 2  - Day\Night mode switch
 +  * 3  - full screen mode
 +  * 4  - zoom
 +  * 5  - Exit
 +  * 6  - GPS speed
 +  * 7  - Tram Lines
 +  * 8  -
 +  * 9  - Edit AB-line
 +  * 10 - AB-curve dialog
 +  * 11 - 
 +  * 12 -
 +  * 13 - 
 +  * 14 - AB-line dialog
 +  * 15 - Headland On\Off
 +  * 16 - Section control, manual mode
 +  * 17 - 
 +  * 18 - Section control, automatic mode
 +  * 19 - Place a flag 
 +  * 20 - U-turn enable
 +  * 21 - Auto\Manual steering mode
 +  * 22 -
 +  * 23 - zoom modes
 +  * 24 - GPS data dialog
 +  * 25 - 
 +  * 26 - Tool configuration dialog
 +  * 27 - Machine configuration dialog
 +  * 28 - Setup (UDP, NTRIP, Serial ports, Heading/​Roll,​ etc.)
 +  * 29 - 
 +  * 30 - New Field dialog, you can create new or make a clone from existing one
 +  * 31 - Headland & Boundary
 +  * 32 - Snap left  (value is set in MACHINE->​GUIDANCE->​ "<<>>​ Snap distance"​ )
 +  * 33 - Snap right 
 +  * 34 - 
 +  * 35 - 
 +  * 36 -
 +  * 37 -
 +  * 38 - 
 +  * 39 - 
 +  * 40 -
 +  * 41 -
 +  * 41 - 
 +  * 43 - displays: "//​Tool_width Machine_name - Tool_name -//"
 +  * 44 - Sections status. Red - off, Yellow - manually on, Green - automatic mode
 +  * 45 - swap direction in simulator
 +  * 46 - simulator speed
 +  * 47 - stop moving
 +  * 48 - steering control during simulation
 +  * 49 - set steering to zero
 +  * 50 - Resets the simulator
 +  * 51 - machine and tool
 +  * 52 - show\hide extended mode
 +  * 53 - GPS data, left bar
 +  * 54 - Tree planter, WebCam, GPS shift, G.Earth flags dialog)
 +  * 55 - View position setup
 +  * 56 - 2D\3D mode
 +  * 57 - UDP port load 
 +  * 58 - 
 +  * 59..61 - menu
  
 ===== First Test ==== ===== First Test ====
Line 294: Line 366:
 If you want to create a boundary using Google Earth... Click> Google Earth and then once Google Earth opens click >add polygon or >add path. The pop-up window that appears has to stay open while you are drawing a polygon or path. Once you've outlined your field boundary, title it in the pop-up window and click >​OK>​File>​Save>​Save Place As. Save as KML file and not the default KMZ to your desired location. Then go back to AgOpenGPS and click >Load KML and voila your boundary is ready to go. If you want to create a boundary using Google Earth... Click> Google Earth and then once Google Earth opens click >add polygon or >add path. The pop-up window that appears has to stay open while you are drawing a polygon or path. Once you've outlined your field boundary, title it in the pop-up window and click >​OK>​File>​Save>​Save Place As. Save as KML file and not the default KMZ to your desired location. Then go back to AgOpenGPS and click >Load KML and voila your boundary is ready to go.
  
-**Creating a Headland**+**Creating a Headland** ​(this feature is currently unavailable. For now adjust the headland in U-Turn settings)
 This can only be done after a boundary is created. And you must be in AB or AB Curve mode for this to work. This can only be done after a boundary is created. And you must be in AB or AB Curve mode for this to work.
  
start.txt · Last modified: 2020/01/12 17:18 (external edit)