annotate Small_CPU/Inc/compass_LSM303DLHC.h @ 240:625d20070261 div-fixes-5

Improvement SPI stability/recoverability The core part of this commit comes from careful code reading. The core is the swap of Scheduler_Request_sync_with_SPI(SPI_SYNC_METHOD_SOFT) and SPI_Start_single_TxRx_with_Master(). This code is sitting in an if-clause that is triggered on SPI comms failure. Instead of blindly trying to communicate again (which will very likely fail again), first try to reset the comms link, and then try to communicate again. That simply makes more sense in this case. This is heavily tested, on 2 simple dives, and 5 very long deco schedules from the simulator (10+ hour deco's), and a lot of small simulated dives (upto 2h runtime). Of all these tests, only one long session failed after 9 out of 11h runtime. Analyzing that one failure, suggests that the RTE is looping in some error handler, which (obviously) results in a SPI comms failure as a result. I consider this not part of this change. Additionally, some more cleanup is done in this code. Signed-off-by: Jan Mulder <jlmulder@xs4all.nl>
author Jan Mulder <jlmulder@xs4all.nl>
date Mon, 08 Apr 2019 11:49:13 +0200
parents 5f11787b4f42
children
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
38
5f11787b4f42 include in ostc4 repository
heinrichsweikamp
parents:
diff changeset
1 /**
5f11787b4f42 include in ostc4 repository
heinrichsweikamp
parents:
diff changeset
2 ******************************************************************************
5f11787b4f42 include in ostc4 repository
heinrichsweikamp
parents:
diff changeset
3 * @file compass_LSM303DLHC.h
5f11787b4f42 include in ostc4 repository
heinrichsweikamp
parents:
diff changeset
4 * @author heinrichs weikamp gmbh
5f11787b4f42 include in ostc4 repository
heinrichsweikamp
parents:
diff changeset
5 * @date 17-August-2017
5f11787b4f42 include in ostc4 repository
heinrichsweikamp
parents:
diff changeset
6 * @version V0.1.0
5f11787b4f42 include in ostc4 repository
heinrichsweikamp
parents:
diff changeset
7 * @since 17-August-2017
5f11787b4f42 include in ostc4 repository
heinrichsweikamp
parents:
diff changeset
8 * @brief STMicroelectronics LSM303DLHC accelerometer & magnetometer driver
5f11787b4f42 include in ostc4 repository
heinrichsweikamp
parents:
diff changeset
9 *
5f11787b4f42 include in ostc4 repository
heinrichsweikamp
parents:
diff changeset
10 @verbatim
5f11787b4f42 include in ostc4 repository
heinrichsweikamp
parents:
diff changeset
11 ==============================================================================
5f11787b4f42 include in ostc4 repository
heinrichsweikamp
parents:
diff changeset
12 ##### How to use #####
5f11787b4f42 include in ostc4 repository
heinrichsweikamp
parents:
diff changeset
13 ==============================================================================
5f11787b4f42 include in ostc4 repository
heinrichsweikamp
parents:
diff changeset
14 @endverbatim
5f11787b4f42 include in ostc4 repository
heinrichsweikamp
parents:
diff changeset
15 ******************************************************************************
5f11787b4f42 include in ostc4 repository
heinrichsweikamp
parents:
diff changeset
16 * @attention
5f11787b4f42 include in ostc4 repository
heinrichsweikamp
parents:
diff changeset
17 *
5f11787b4f42 include in ostc4 repository
heinrichsweikamp
parents:
diff changeset
18 * <h2><center>&copy; COPYRIGHT(c) 2017 heinrichs weikamp</center></h2>
5f11787b4f42 include in ostc4 repository
heinrichsweikamp
parents:
diff changeset
19 *
5f11787b4f42 include in ostc4 repository
heinrichsweikamp
parents:
diff changeset
20 ******************************************************************************
5f11787b4f42 include in ostc4 repository
heinrichsweikamp
parents:
diff changeset
21 */
5f11787b4f42 include in ostc4 repository
heinrichsweikamp
parents:
diff changeset
22
5f11787b4f42 include in ostc4 repository
heinrichsweikamp
parents:
diff changeset
23 /* Define to prevent recursive inclusion -------------------------------------*/
5f11787b4f42 include in ostc4 repository
heinrichsweikamp
parents:
diff changeset
24 #ifndef COMPASS_LSM303DLHC_H
5f11787b4f42 include in ostc4 repository
heinrichsweikamp
parents:
diff changeset
25 #define COMPASS_LSM303DLHC_H
5f11787b4f42 include in ostc4 repository
heinrichsweikamp
parents:
diff changeset
26
5f11787b4f42 include in ostc4 repository
heinrichsweikamp
parents:
diff changeset
27 /* Exported constants --------------------------------------------------------*/
5f11787b4f42 include in ostc4 repository
heinrichsweikamp
parents:
diff changeset
28
5f11787b4f42 include in ostc4 repository
heinrichsweikamp
parents:
diff changeset
29 //#include "compass_LSM303D.h"
5f11787b4f42 include in ostc4 repository
heinrichsweikamp
parents:
diff changeset
30
5f11787b4f42 include in ostc4 repository
heinrichsweikamp
parents:
diff changeset
31 #define DLHC_CTRL_REG1_A 0x20
5f11787b4f42 include in ostc4 repository
heinrichsweikamp
parents:
diff changeset
32 #define DLHC_CTRL_REG2_A 0x21
5f11787b4f42 include in ostc4 repository
heinrichsweikamp
parents:
diff changeset
33 #define DLHC_CTRL_REG3_A 0x22
5f11787b4f42 include in ostc4 repository
heinrichsweikamp
parents:
diff changeset
34 #define DLHC_CTRL_REG4_A 0x23
5f11787b4f42 include in ostc4 repository
heinrichsweikamp
parents:
diff changeset
35 #define DLHC_CTRL_REG5_A 0x24
5f11787b4f42 include in ostc4 repository
heinrichsweikamp
parents:
diff changeset
36 #define DLHC_CTRL_REG6_A 0x25
5f11787b4f42 include in ostc4 repository
heinrichsweikamp
parents:
diff changeset
37
5f11787b4f42 include in ostc4 repository
heinrichsweikamp
parents:
diff changeset
38 #define DLHC_CRA_REG_M 0x00
5f11787b4f42 include in ostc4 repository
heinrichsweikamp
parents:
diff changeset
39 #define DLHC_CRB_REG_M 0x01
5f11787b4f42 include in ostc4 repository
heinrichsweikamp
parents:
diff changeset
40 #define DLHC_MR_REG_M 0x02
5f11787b4f42 include in ostc4 repository
heinrichsweikamp
parents:
diff changeset
41
5f11787b4f42 include in ostc4 repository
heinrichsweikamp
parents:
diff changeset
42 #define DLHC_OUT_X_L_M 0x03
5f11787b4f42 include in ostc4 repository
heinrichsweikamp
parents:
diff changeset
43 #define DLHC_OUT_X_H_M 0x04
5f11787b4f42 include in ostc4 repository
heinrichsweikamp
parents:
diff changeset
44 #define DLHC_OUT_Y_L_M 0x05
5f11787b4f42 include in ostc4 repository
heinrichsweikamp
parents:
diff changeset
45 #define DLHC_OUT_Y_H_M 0x06
5f11787b4f42 include in ostc4 repository
heinrichsweikamp
parents:
diff changeset
46 #define DLHC_OUT_Z_L_M 0x07
5f11787b4f42 include in ostc4 repository
heinrichsweikamp
parents:
diff changeset
47 #define DLHC_OUT_Z_H_M 0x08
5f11787b4f42 include in ostc4 repository
heinrichsweikamp
parents:
diff changeset
48
5f11787b4f42 include in ostc4 repository
heinrichsweikamp
parents:
diff changeset
49 // identisch mit 303D
5f11787b4f42 include in ostc4 repository
heinrichsweikamp
parents:
diff changeset
50 #define DLHC_OUT_X_L_A 0x28
5f11787b4f42 include in ostc4 repository
heinrichsweikamp
parents:
diff changeset
51 #define DLHC_OUT_X_H_A 0x29
5f11787b4f42 include in ostc4 repository
heinrichsweikamp
parents:
diff changeset
52 #define DLHC_OUT_Y_L_A 0x2A
5f11787b4f42 include in ostc4 repository
heinrichsweikamp
parents:
diff changeset
53 #define DLHC_OUT_Y_H_A 0x2B
5f11787b4f42 include in ostc4 repository
heinrichsweikamp
parents:
diff changeset
54 #define DLHC_OUT_Z_L_A 0x2C
5f11787b4f42 include in ostc4 repository
heinrichsweikamp
parents:
diff changeset
55 #define DLHC_OUT_Z_H_A 0x2D
5f11787b4f42 include in ostc4 repository
heinrichsweikamp
parents:
diff changeset
56
5f11787b4f42 include in ostc4 repository
heinrichsweikamp
parents:
diff changeset
57 #endif /* COMPASS_LSM303DLHC_H */
5f11787b4f42 include in ostc4 repository
heinrichsweikamp
parents:
diff changeset
58
5f11787b4f42 include in ostc4 repository
heinrichsweikamp
parents:
diff changeset
59 /******************* (C) COPYRIGHT 2017 heinrichs weikamp *****END OF FILE****/