{"id":59,"date":"2014-12-11T10:21:25","date_gmt":"2014-12-11T09:21:25","guid":{"rendered":"https:\/\/pa3csg.nl\/?page_id=59"},"modified":"2016-06-24T07:21:22","modified_gmt":"2016-06-24T05:21:22","slug":"electronic-compass-arduino","status":"publish","type":"page","link":"https:\/\/pa3csg.nl\/?page_id=59","title":{"rendered":"Electronic Compass Arduino"},"content":{"rendered":"

Electronic Compass with the HMC5883<\/p>\n

My friend Jac is active on 10 & 24 GHz portable. To aim his 90cm offset dish which is mounted 90 degrees tilted, the idea was born to use an electronic compass. This needs no calibration and should have an accuracy of around 2 degrees. The HMC5883 is easily found on ebay for very little money. It was Jac’s idea to have 2 buttons to calibrate his dish and to compensat for his 31 degrees of off-set because of his mounting. The code for the compass was found as opensource on the web. A few additions and an LCD were added. It required a bit of simple coding.<\/p>\n

You have to make sure that the electronic compass is mounted levelled with the earth and that you donnot rotate it too quick. Keep it away from magnetic materials.<\/p>\n

The code can be found below. Make sure you have the libraries in the correct place. These can be found on the Adafruit website! Check:<\/p>\n

https:\/\/learn.adafruit.com\/adafruit-hmc5883l-breakout-triple-axis-magnetometer-compass-sensor\/wiring-and-test<\/a><\/p>\n

 <\/p>\n

\/<\/pre>\n
\n
\/***************************************************************************<\/code><\/div>\n
\u00a0\u00a0<\/code>This is a library example for the HMC5883 magnentometer\/compass<\/code><\/div>\n
<\/div>\n
\u00a0\u00a0<\/code>Designed specifically to work with the Adafruit HMC5883 Breakout<\/code><\/div>\n
\u00a0\u00a0<\/code>http:\/\/www.adafruit.com\/products\/1746<\/code><\/div>\n
\u00a0<\/code><\/div>\n
\u00a0\u00a0<\/code>*** You will also need to install the Adafruit_Sensor library! ***<\/code><\/div>\n
<\/div>\n
\u00a0\u00a0<\/code>These displays use I2C to communicate, 2 pins are required to interface.<\/code><\/div>\n
<\/div>\n
\u00a0\u00a0<\/code>Adafruit invests time and resources providing this open source code,<\/code><\/div>\n
\u00a0\u00a0<\/code>please support Adafruit andopen-source hardware by purchasing products<\/code><\/div>\n
\u00a0\u00a0<\/code>from Adafruit!<\/code><\/div>\n
<\/div>\n
\u00a0\u00a0<\/code>Written by Kevin Townsend for Adafruit Industries with some heading example from<\/code><\/div>\n
\u00a0\u00a0<\/code>Love Electronics (loveelectronics.co.uk)<\/code><\/div>\n
\u00a0<\/code><\/div>\n
\u00a0<\/code>This program is free software: you can redistribute it and\/or modify<\/code><\/div>\n
\u00a0<\/code>it under the terms of the version 3 GNU General Public License as<\/code><\/div>\n
\u00a0<\/code>published by the Free Software Foundation.<\/code><\/div>\n
\u00a0<\/code><\/div>\n
\u00a0<\/code>This program is distributed in the hope that it will be useful,<\/code><\/div>\n
\u00a0<\/code>but WITHOUT ANY WARRANTY; without even the implied warranty of<\/code><\/div>\n
\u00a0<\/code>MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.\u00a0 See the<\/code><\/div>\n
\u00a0<\/code>GNU General Public License for more details.<\/code><\/div>\n
<\/div>\n
\u00a0<\/code>You should have received a copy of the GNU General Public License<\/code><\/div>\n
\u00a0<\/code>along with this program.\u00a0 If not, see <<\/code>http:<\/code>\/\/www.gnu.org\/licenses\/>.<\/code><\/div>\n
<\/div>\n
\u00a0<\/code>***************************************************************************\/<\/code><\/div>\n
<\/div>\n
#include <<\/code>Wire.h<\/code>><\/code><\/div>\n
#include <<\/code>Adafruit_Sensor.h<\/code>><\/code><\/div>\n
#include <<\/code>Adafruit_HMC5883_U.h<\/code>><\/code><\/div>\n
#include <<\/code>LiquidCrystal.h<\/code>><\/code><\/div>\n
#include <<\/code>EEPROM.h<\/code>><\/code><\/div>\n
<\/div>\n
<\/div>\n
\/\/ initialize the library with the numbers of the interface pins<\/code><\/div>\n
LiquidCrystal lcd(12, 11, 5, 4, 3, 2);<\/code><\/div>\n
<\/div>\n
int corr = 31;<\/code><\/div>\n
int corraz = 0;<\/code><\/div>\n
int incrementState = 0; \/\/will read increment<\/code><\/div>\n
int lastIncrementState = 0;<\/code><\/div>\n
int decrementState = 0; \/\/will read decrement<\/code><\/div>\n
int lastdecrementState = 0;<\/code><\/div>\n
<\/div>\n
<\/div>\n
byte incrementButton = 6; \/\/ the pin that the pushbutton is attached to<\/code><\/div>\n
byte decrementButton = 7; \/\/ the pin that the pushbutton is attached to<\/code><\/div>\n
<\/div>\n
\/* Assign a unique ID to this sensor at the same time *\/<\/code><\/div>\n
Adafruit_HMC5883_Unified mag = Adafruit_HMC5883_Unified(12345);<\/code><\/div>\n
<\/div>\n
void displaySensorDetails(void)<\/code><\/div>\n
{<\/code><\/div>\n
\u00a0\u00a0<\/code>sensor_t sensor;<\/code><\/div>\n
\u00a0\u00a0<\/code>mag.getSensor(&sensor);<\/code><\/div>\n
\u00a0\u00a0<\/code>Serial.println(\"------------------------------------\");<\/code><\/div>\n
\u00a0\u00a0<\/code>Serial.print\u00a0 (\"Sensor:\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0 \"); Serial.println(sensor.name);<\/code><\/div>\n
\u00a0\u00a0<\/code>Serial.print\u00a0 (\"Driver Ver:\u00a0\u00a0 \"); Serial.println(sensor.version);<\/code><\/div>\n
\u00a0\u00a0<\/code>Serial.print\u00a0 (\"Unique ID:\u00a0\u00a0\u00a0 \"); Serial.println(sensor.sensor_id);<\/code><\/div>\n
\u00a0\u00a0<\/code>Serial.print\u00a0 (\"Max Value:\u00a0\u00a0\u00a0 \"); Serial.print(sensor.max_value); Serial.println(\" uT\");<\/code><\/div>\n
\u00a0\u00a0<\/code>Serial.print\u00a0 (\"Min Value:\u00a0\u00a0\u00a0 \"); Serial.print(sensor.min_value); Serial.println(\" uT\");<\/code><\/div>\n
\u00a0\u00a0<\/code>Serial.print\u00a0 (\"Resolution:\u00a0\u00a0 \"); Serial.print(sensor.resolution); Serial.println(\" uT\");\u00a0 <\/code><\/div>\n
\u00a0\u00a0<\/code>Serial.println(\"------------------------------------\");<\/code><\/div>\n
\u00a0\u00a0<\/code>Serial.println(\"\");<\/code><\/div>\n
\u00a0\u00a0<\/code>delay(500);<\/code><\/div>\n
}<\/code><\/div>\n
<\/div>\n
void setup(void) <\/code><\/div>\n
{<\/code><\/div>\n
\u00a0\u00a0\u00a0\u00a0<\/code>\/\/ set up the LCD's number of columns and rows:<\/code><\/div>\n
\u00a0\u00a0<\/code>lcd.begin(20, 2);<\/code><\/div>\n
\u00a0\u00a0<\/code><\/div>\n
\u00a0\u00a0\u00a0\u00a0<\/code>\/\/ A little bit of PR<\/code><\/div>\n
\u00a0\u00a0<\/code>lcd.setCursor(7,0);<\/code><\/div>\n
\u00a0\u00a0<\/code>lcd.print(\"PE1KXH\");<\/code><\/div>\n
\u00a0\u00a0<\/code>lcd.setCursor(4,1);<\/code><\/div>\n
\u00a0\u00a0<\/code>lcd.print(\"Kloat get aan!\");<\/code><\/div>\n
\u00a0\u00a0<\/code>delay(1000);<\/code><\/div>\n
\u00a0\u00a0<\/code>lcd.clear();<\/code><\/div>\n
\u00a0\u00a0<\/code><\/div>\n
\u00a0\u00a0\u00a0\u00a0<\/code><\/div>\n
\u00a0\u00a0<\/code>Serial.begin(9600);<\/code><\/div>\n
\u00a0\u00a0<\/code>Serial.println(\"HMC5883 Magnetometer Test\"); Serial.println(\"\");<\/code><\/div>\n
\u00a0\u00a0<\/code><\/div>\n
\u00a0\u00a0<\/code>\/* Initialise the sensor *\/<\/code><\/div>\n
\u00a0\u00a0<\/code>if(!mag.begin())<\/code><\/div>\n
\u00a0\u00a0<\/code>{<\/code><\/div>\n
\u00a0\u00a0\u00a0\u00a0<\/code>\/* There was a problem detecting the HMC5883 ... check your connections *\/<\/code><\/div>\n
\u00a0\u00a0\u00a0\u00a0<\/code>Serial.println(\"Ooops, no HMC5883 detected ... Check your wiring!\");<\/code><\/div>\n
\u00a0\u00a0\u00a0\u00a0<\/code>while(1);<\/code><\/div>\n
\u00a0\u00a0\u00a0\u00a0\u00a0<\/code><\/div>\n
\u00a0\u00a0<\/code>}<\/code><\/div>\n
\u00a0<\/code><\/div>\n
\u00a0\u00a0<\/code><\/div>\n
\u00a0\u00a0<\/code><\/div>\n
\u00a0\u00a0<\/code>\/* Display some basic information on this sensor *\/<\/code><\/div>\n
\u00a0\u00a0<\/code>displaySensorDetails();<\/code><\/div>\n
}<\/code><\/div>\n
<\/div>\n
<\/div>\n
void loop(void) <\/code><\/div>\n
<\/div>\n
{<\/code><\/div>\n
\u00a0\u00a0<\/code><\/div>\n
\u00a0<\/code><\/div>\n
\u00a0\u00a0\u00a0<\/code><\/div>\n
\u00a0\u00a0\u00a0<\/code><\/div>\n
\u00a0\u00a0<\/code>\/* Get a new sensor event *\/ <\/code><\/div>\n
\u00a0\u00a0<\/code>sensors_event_t event; <\/code><\/div>\n
\u00a0\u00a0<\/code>mag.getEvent(&event);<\/code><\/div>\n
\u00a0<\/code><\/div>\n
\u00a0\u00a0<\/code>\/* Display the results (magnetic vector values are in micro-Tesla (uT)) *\/<\/code><\/div>\n
\u00a0\u00a0<\/code>Serial.print(\"X: \"); Serial.print(event.magnetic.x); Serial.print(\"\u00a0 \");<\/code><\/div>\n
\u00a0\u00a0<\/code>Serial.print(\"Y: \"); Serial.print(event.magnetic.y); Serial.print(\"\u00a0 \");<\/code><\/div>\n
\u00a0\u00a0<\/code>Serial.print(\"Z: \"); Serial.print(event.magnetic.z); Serial.print(\"\u00a0 \");Serial.println(\"uT\");<\/code><\/div>\n
<\/div>\n
\u00a0\u00a0<\/code>\/\/ Hold the module so that Z is pointing 'up' and you can measure the heading with x&y<\/code><\/div>\n
\u00a0\u00a0<\/code>\/\/ Calculate heading when the magnetometer is level, then correct for signs of axis.<\/code><\/div>\n
\u00a0\u00a0<\/code>float heading = atan2(event.magnetic.y, event.magnetic.x);<\/code><\/div>\n
\u00a0\u00a0<\/code><\/div>\n
\u00a0\u00a0<\/code>\/\/ Once you have your heading, you must then add your 'Declination Angle', which is the 'Error' of the magnetic field in your location.<\/code><\/div>\n
\u00a0\u00a0<\/code>\/\/ Find yours here: http:\/\/www.magnetic-declination.com\/<\/code><\/div>\n
\u00a0\u00a0<\/code>\/\/ Mine is: -13* 2' W, which is ~13 Degrees, or (which we need) 0.22 radians<\/code><\/div>\n
\u00a0\u00a0<\/code>\/\/ If you cannot find your Declination, comment out these two lines, your compass will be slightly off.<\/code><\/div>\n
\u00a0\u00a0<\/code>float declinationAngle = 0.017453292519943; \/\/value for JO21wd abt 1 degree in radians<\/code><\/div>\n
\u00a0\u00a0<\/code>heading += declinationAngle;<\/code><\/div>\n
\u00a0\u00a0<\/code><\/div>\n
\u00a0\u00a0<\/code>\/\/ Correct for when signs are reversed.<\/code><\/div>\n
\u00a0\u00a0<\/code>if(heading < <\/code>0<\/code>)<\/code><\/div>\n
\u00a0\u00a0\u00a0\u00a0<\/code>heading += 2*PI;<\/code><\/div>\n
\u00a0\u00a0\u00a0\u00a0<\/code><\/div>\n
\u00a0\u00a0<\/code>\/\/ Check for wrap due to addition of declination.<\/code><\/div>\n
\u00a0\u00a0<\/code>if(heading > 2*PI)<\/code><\/div>\n
\u00a0\u00a0\u00a0\u00a0<\/code>heading -= 2*PI;<\/code><\/div>\n
\u00a0\u00a0\u00a0<\/code><\/div>\n
\u00a0\u00a0<\/code>\/\/ Convert radians to degrees for readability.<\/code><\/div>\n
\u00a0\u00a0<\/code>float headingDegrees = heading * 180\/M_PI; <\/code><\/div>\n
\u00a0\u00a0<\/code><\/div>\n
\u00a0\u00a0<\/code><\/div>\n
\u00a0\u00a0<\/code><\/div>\n
\u00a0\u00a0\u00a0<\/code>\/\/Reading and counting the UP button<\/code><\/div>\n
\u00a0\u00a0<\/code><\/div>\n
\u00a0\u00a0<\/code>incrementState = digitalRead(incrementButton); \/\/read the increment button state<\/code><\/div>\n
\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0<\/code>if(incrementState != lastIncrementState) \/\/compare increment button state to its last state<\/code><\/div>\n
\u00a0\u00a0\u00a0<\/code>{<\/code><\/div>\n
\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0<\/code>if(incrementState == LOW)\/\/increment button is pressed<\/code><\/div>\n
\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0<\/code>{<\/code><\/div>\n
\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0<\/code>corr = corr + 1; \/\/increment the corr value<\/code><\/div>\n
\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0<\/code>delay(10); \/\/debounce delay<\/code><\/div>\n
\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0<\/code>}<\/code><\/div>\n
\u00a0\u00a0\u00a0<\/code>}<\/code><\/div>\n
\u00a0\u00a0\u00a0<\/code>lastIncrementState = incrementState;<\/code><\/div>\n
\u00a0\u00a0\u00a0<\/code><\/div>\n
\u00a0\u00a0\u00a0\u00a0\u00a0<\/code>\/\/Reading and counting the DOWN button<\/code><\/div>\n
\u00a0\u00a0<\/code><\/div>\n
\u00a0\u00a0<\/code>decrementState = digitalRead(decrementButton); \/\/read the increment button state<\/code><\/div>\n
\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0<\/code>if(decrementState != lastdecrementState) \/\/compare increment button state to its last state<\/code><\/div>\n
\u00a0\u00a0\u00a0<\/code>{<\/code><\/div>\n
\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0<\/code>if(decrementState == LOW)\/\/increment button is pressed<\/code><\/div>\n
\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0<\/code>{<\/code><\/div>\n
\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0<\/code>corr = corr - 1; \/\/increment the corr value<\/code><\/div>\n
\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0<\/code>delay(10); \/\/debounce delay<\/code><\/div>\n
\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0<\/code>}<\/code><\/div>\n
\u00a0\u00a0\u00a0<\/code>}<\/code><\/div>\n
\u00a0\u00a0\u00a0<\/code>lastdecrementState = decrementState;<\/code><\/div>\n
\u00a0\u00a0\u00a0<\/code><\/div>\n
\u00a0\u00a0<\/code>corraz = headingDegrees - corr;<\/code><\/div>\n
\u00a0\u00a0<\/code>if(corraz < 0)<\/code><\/div>\n
\u00a0\u00a0\u00a0\u00a0<\/code>corraz = (corraz + 360);<\/code><\/div>\n
\u00a0\u00a0<\/code><\/div>\n
\u00a0\u00a0<\/code>Serial.print(\"Heading (degrees): \"); Serial.println(headingDegrees);<\/code><\/div>\n
\u00a0\u00a0<\/code>Serial.print(\"Correction (degrees): \"); Serial.println(corr);<\/code><\/div>\n
\u00a0\u00a0<\/code>Serial.print(\"Corrected Azimuth): \"); Serial.println(corraz);<\/code><\/div>\n
<\/div>\n
\/\/first line<\/code><\/div>\n
\u00a0\u00a0<\/code>lcd.setCursor(9,0);<\/code><\/div>\n
\u00a0\u00a0<\/code>lcd.setCursor(0,0);<\/code><\/div>\n
\u00a0\u00a0<\/code>lcd.print(\"Azimuth: \");<\/code><\/div>\n
\u00a0\u00a0<\/code>lcd.setCursor(9,0);<\/code><\/div>\n
\u00a0\u00a0<\/code>lcd.print(\"\u00a0\u00a0 \");<\/code><\/div>\n
\u00a0\u00a0<\/code>lcd.setCursor(9,0);<\/code><\/div>\n
\u00a0\u00a0<\/code>lcd.print(headingDegrees, 0);<\/code><\/div>\n
\u00a0\u00a0<\/code>lcd.setCursor(14,0);<\/code><\/div>\n
\u00a0\u00a0<\/code>lcd.print(\"Cor:\");<\/code><\/div>\n
\u00a0\u00a0<\/code>lcd.setCursor(18,0);<\/code><\/div>\n
\u00a0\u00a0<\/code>lcd.print(\"\u00a0 \");<\/code><\/div>\n
\u00a0\u00a0<\/code>lcd.setCursor(18,0);<\/code><\/div>\n
\u00a0\u00a0<\/code>lcd.print(corr);<\/code><\/div>\n
\u00a0\u00a0<\/code><\/div>\n
\/\/second line<\/code><\/div>\n
\u00a0<\/code><\/div>\n
\u00a0<\/code><\/div>\n
\u00a0<\/code>lcd.setCursor(0,1);<\/code><\/div>\n
\u00a0<\/code>lcd.print(\"Calc Az: \");<\/code><\/div>\n
\u00a0<\/code>lcd.setCursor(9,1);<\/code><\/div>\n
\u00a0<\/code>lcd.print(\"\u00a0\u00a0 \");<\/code><\/div>\n
\u00a0<\/code>lcd.setCursor(9,1);<\/code><\/div>\n
\u00a0<\/code>lcd.print(corraz);<\/code><\/div>\n
\u00a0\u00a0<\/code><\/div>\n
\u00a0\u00a0<\/code>delay(500);<\/code><\/div>\n
}<\/code><\/div>\n<\/div>\n","protected":false},"excerpt":{"rendered":"
Electronic Compass with the HMC5883 My friend Jac is active on 10 & 24 GHz portable. To aim his 90cm offset dish which is mounted […]<\/a><\/p>\n<\/div>","protected":false},"author":1,"featured_media":928,"parent":0,"menu_order":14,"comment_status":"closed","ping_status":"closed","template":"","meta":[],"categories":[29],"tags":[],"_links":{"self":[{"href":"https:\/\/pa3csg.nl\/index.php?rest_route=\/wp\/v2\/pages\/59"}],"collection":[{"href":"https:\/\/pa3csg.nl\/index.php?rest_route=\/wp\/v2\/pages"}],"about":[{"href":"https:\/\/pa3csg.nl\/index.php?rest_route=\/wp\/v2\/types\/page"}],"author":[{"embeddable":true,"href":"https:\/\/pa3csg.nl\/index.php?rest_route=\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/pa3csg.nl\/index.php?rest_route=%2Fwp%2Fv2%2Fcomments&post=59"}],"version-history":[{"count":2,"href":"https:\/\/pa3csg.nl\/index.php?rest_route=\/wp\/v2\/pages\/59\/revisions"}],"predecessor-version":[{"id":920,"href":"https:\/\/pa3csg.nl\/index.php?rest_route=\/wp\/v2\/pages\/59\/revisions\/920"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/pa3csg.nl\/index.php?rest_route=\/wp\/v2\/media\/928"}],"wp:attachment":[{"href":"https:\/\/pa3csg.nl\/index.php?rest_route=%2Fwp%2Fv2%2Fmedia&parent=59"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/pa3csg.nl\/index.php?rest_route=%2Fwp%2Fv2%2Fcategories&post=59"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/pa3csg.nl\/index.php?rest_route=%2Fwp%2Fv2%2Ftags&post=59"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}