hmc5883l: improve documentation and sample

Signed-off-by: Brendan Le Foll <brendan.le.foll@intel.com>