#ifndef MISSION_DEVICES_DEVICEDEFINITIONS_MGMLIS3HANDLERDEFS_H_ #define MISSION_DEVICES_DEVICEDEFINITIONS_MGMLIS3HANDLERDEFS_H_ #include #include #include #include namespace mgmLis3 { enum Set { ON, OFF }; enum OpMode { LOW, MEDIUM, HIGH, ULTRA }; enum Sensitivies : uint8_t { GAUSS_4 = 4, GAUSS_8 = 8, GAUSS_12 = 12, GAUSS_16 = 16 }; /** * Sets the read bit for the command * @param single command to set the read-bit at * @param boolean to select a continuous read bit, default = false */ uint8_t readCommand(uint8_t command, bool continuousCom = false); /** * Sets the write bit for the command * @param single command to set the write-bit at * @param boolean to select a continuous write bit, default = false */ uint8_t writeCommand(uint8_t command, bool continuousCom = false); /** * This Method gets the full scale for the measurement range * e.g.: +- 4 gauss. See p.25 datasheet. * @return The ReturnValue does not contain the sign of the value */ mgmLis3::Sensitivies getSensitivity(uint8_t ctrlReg2); /** * The 16 bit value needs to be multiplied with a sensitivity factor * which depends on the sensitivity configuration * * @param sens Configured sensitivity of the LIS3 device * @return Multiplication factor to get the sensor value from raw data. */ float getSensitivityFactor(mgmLis3::Sensitivies sens); /* Actually 15, we just round up a bit */ static constexpr size_t MAX_BUFFER_SIZE = 16; /* Field data register scaling */ static constexpr uint8_t GAUSS_TO_MICROTESLA_FACTOR = 100; static constexpr float FIELD_LSB_PER_GAUSS_4_SENS = 1.0 / 6842.0; static constexpr float FIELD_LSB_PER_GAUSS_8_SENS = 1.0 / 3421.0; static constexpr float FIELD_LSB_PER_GAUSS_12_SENS = 1.0 / 2281.0; static constexpr float FIELD_LSB_PER_GAUSS_16_SENS = 1.0 / 1711.0; static const DeviceCommandId_t READ_CONFIG_AND_DATA = 0x00; static const DeviceCommandId_t SETUP_MGM = 0x01; static const DeviceCommandId_t READ_TEMPERATURE = 0x02; static const DeviceCommandId_t IDENTIFY_DEVICE = 0x03; static const DeviceCommandId_t TEMP_SENSOR_ENABLE = 0x04; static const DeviceCommandId_t ACCURACY_OP_MODE_SET = 0x05; /* Number of all control registers */ static const uint8_t NR_OF_CTRL_REGISTERS = 5; /* Number of registers in the MGM */ static const uint8_t NR_OF_REGISTERS = 19; /* Total number of adresses for all registers */ static const uint8_t TOTAL_NR_OF_ADRESSES = 52; static const uint8_t NR_OF_DATA_AND_CFG_REGISTERS = 14; static const uint8_t TEMPERATURE_REPLY_LEN = 3; static const uint8_t SETUP_REPLY_LEN = 6; /*------------------------------------------------------------------------*/ /* Register adresses */ /*------------------------------------------------------------------------*/ /* Register adress returns identifier of device with default 0b00111101 */ static const uint8_t IDENTIFY_DEVICE_REG_ADDR = 0b00001111; static const uint8_t DEVICE_ID = 0b00111101; // Identifier for Device /* Register adress to access register 1 */ static const uint8_t CTRL_REG1 = 0b00100000; /* Register adress to access register 2 */ static const uint8_t CTRL_REG2 = 0b00100001; /* Register adress to access register 3 */ static const uint8_t CTRL_REG3 = 0b00100010; /* Register adress to access register 4 */ static const uint8_t CTRL_REG4 = 0b00100011; /* Register adress to access register 5 */ static const uint8_t CTRL_REG5 = 0b00100100; /* Register adress to access status register */ static const uint8_t STATUS_REG_IDX = 8; static const uint8_t STATUS_REG = 0b00100111; /* Register adress to access low byte of x-axis */ static const uint8_t X_LOWBYTE_IDX = 9; static const uint8_t X_LOWBYTE = 0b00101000; /* Register adress to access high byte of x-axis */ static const uint8_t X_HIGHBYTE_IDX = 10; static const uint8_t X_HIGHBYTE = 0b00101001; /* Register adress to access low byte of y-axis */ static const uint8_t Y_LOWBYTE_IDX = 11; static const uint8_t Y_LOWBYTE = 0b00101010; /* Register adress to access high byte of y-axis */ static const uint8_t Y_HIGHBYTE_IDX = 12; static const uint8_t Y_HIGHBYTE = 0b00101011; /* Register adress to access low byte of z-axis */ static const uint8_t Z_LOWBYTE_IDX = 13; static const uint8_t Z_LOWBYTE = 0b00101100; /* Register adress to access high byte of z-axis */ static const uint8_t Z_HIGHBYTE_IDX = 14; static const uint8_t Z_HIGHBYTE = 0b00101101; /* Register adress to access low byte of temperature sensor */ static const uint8_t TEMP_LOWBYTE = 0b00101110; /* Register adress to access high byte of temperature sensor */ static const uint8_t TEMP_HIGHBYTE = 0b00101111; /*------------------------------------------------------------------------*/ /* Initialize Setup Register set bits */ /*------------------------------------------------------------------------*/ /* General transfer bits */ // Read=1 / Write=0 Bit static const uint8_t RW_BIT = 7; // Continous Read/Write Bit, increment adress static const uint8_t MS_BIT = 6; /* CTRL_REG1 bits */ static const uint8_t ST = 0; // Self test enable bit, enabled = 1 // Enable rates higher than 80 Hz enabled = 1 static const uint8_t FAST_ODR = 1; static const uint8_t DO0 = 2; // Output data rate bit 2 static const uint8_t DO1 = 3; // Output data rate bit 3 static const uint8_t DO2 = 4; // Output data rate bit 4 static const uint8_t OM0 = 5; // XY operating mode bit 5 static const uint8_t OM1 = 6; // XY operating mode bit 6 static const uint8_t TEMP_EN = 7; // Temperature sensor enable enabled = 1 static const uint8_t CTRL_REG1_DEFAULT = (1 << TEMP_EN) | (1 << OM1) | (1 << DO0) | (1 << DO1) | (1 << DO2); /* CTRL_REG2 bits */ // reset configuration registers and user registers static const uint8_t SOFT_RST = 2; static const uint8_t REBOOT = 3; // reboot memory content static const uint8_t FSO = 5; // full-scale selection bit 5 static const uint8_t FS1 = 6; // full-scale selection bit 6 static const uint8_t CTRL_REG2_DEFAULT = 0; /* CTRL_REG3 bits */ static const uint8_t MD0 = 0; // Operating mode bit 0 static const uint8_t MD1 = 1; // Operating mode bit 1 // SPI serial interface mode selection enabled = 3-wire-mode static const uint8_t SIM = 2; static const uint8_t LP = 5; // low-power mode static const uint8_t CTRL_REG3_DEFAULT = 0; /* CTRL_REG4 bits */ // big/little endian data selection enabled = MSb at lower adress static const uint8_t BLE = 1; static const uint8_t OMZ0 = 2; // Z operating mode bit 2 static const uint8_t OMZ1 = 3; // Z operating mode bit 3 static const uint8_t CTRL_REG4_DEFAULT = (1 << OMZ1); /* CTRL_REG5 bits */ static const uint8_t BDU = 6; // Block data update static const uint8_t FAST_READ = 7; // Fast read enabled = 1 static const uint8_t CTRL_REG5_DEFAULT = 0; static const uint32_t MGM_DATA_SET_ID = READ_CONFIG_AND_DATA; enum MgmPoolIds : lp_id_t { FIELD_STRENGTHS, TEMPERATURE_CELCIUS }; class MgmPrimaryDataset : public StaticLocalDataSet<4> { public: MgmPrimaryDataset(HasLocalDataPoolIF* hkOwner) : StaticLocalDataSet(hkOwner, MGM_DATA_SET_ID) {} MgmPrimaryDataset(object_id_t mgmId) : StaticLocalDataSet(sid_t(mgmId, MGM_DATA_SET_ID)) {} /** * Field strenghts in uT */ lp_vec_t fieldStrengths = lp_vec_t(sid.objectId, FIELD_STRENGTHS, this); lp_var_t temperature = lp_var_t(sid.objectId, TEMPERATURE_CELCIUS, this); }; } // namespace mgmLis3 #endif /* MISSION_DEVICES_DEVICEDEFINITIONS_MGMLIS3HANDLERDEFS_H_ */