ZigBee学习笔记_HalDriverInit()_1

看名字是初始化一些硬件驱动，里面全都是调用一些子函数来实现，包括TIMER、ADC、DMA、FLASH等等，如下

void HalDriverInit (void){  /* TIMER */#if (defined HAL_TIMER) && (HAL_TIMER == TRUE)  HalTimerInit();#endif  /* ADC */#if (defined HAL_ADC) && (HAL_ADC == TRUE)  HalAdcInit();#endif  /* DMA */#if (defined HAL_DMA) && (HAL_DMA == TRUE)  // Must be called before the init call to any module that uses DMA.  HalDmaInit();#endif  /* Flash */#if (defined HAL_FLASH) && (HAL_FLASH == TRUE)  // Must be called before the init call to any module that uses Flash access or NV.  HalFlashInit();#endif  /* AES */#if (defined HAL_AES) && (HAL_AES == TRUE)  HalAesInit();#endif   /* LED */#if (defined HAL_LED) && (HAL_LED == TRUE)  HalLedInit();#endif  /* UART */#if (defined HAL_UART) && (HAL_UART == TRUE)  HalUARTInit();#endif  /* KEY */#if (defined HAL_KEY) && (HAL_KEY == TRUE)  HalKeyInit();#endif  /* SPI */#if (defined HAL_SPI) && (HAL_SPI == TRUE)  HalSpiInit();#endif   /* LCD */#if (defined HAL_LCD) && (HAL_LCD == TRUE)  HalLcdInit();#endif}

宏定义如下

/* Set to TRUE enable H/W TIMER usage, FALSE disable it */#ifndef HAL_TIMER#define HAL_TIMER FALSE#endif/* Set to TRUE enable ADC usage, FALSE disable it */#ifndef HAL_ADC#define HAL_ADC TRUE#endif/* Set to TRUE enable DMA usage, FALSE disable it */#ifndef HAL_DMA#define HAL_DMA TRUE#endif/* Set to TRUE enable Flash access, FALSE disable it */#ifndef HAL_FLASH#define HAL_FLASH TRUE#endif/* Set to TRUE enable AES usage, FALSE disable it */#ifndef HAL_AES#define HAL_AES TRUE#endif#ifndef HAL_AES_DMA#define HAL_AES_DMA TRUE#endif/* Set to TRUE enable LCD usage, FALSE disable it */#ifndef HAL_LCD#define HAL_LCD TRUE#endif/* Set to TRUE enable LED usage, FALSE disable it */#ifndef HAL_LED#define HAL_LED TRUE#endif#if (!defined BLINK_LEDS) && (HAL_LED == TRUE)#define BLINK_LEDS#endif/* Set to TRUE enable KEY usage, FALSE disable it */#ifndef HAL_KEY#define HAL_KEY TRUE#endif/* Set to TRUE enable UART usage, FALSE disable it */#ifndef HAL_UART#if (defined ZAPP_P1) || (defined ZAPP_P2) || (defined ZTOOL_P1) || (defined ZTOOL_P2)#define HAL_UART  TRUE#else#define HAL_UART FALSE#endif#endif

可以看到除了TIMER和UART以外其他宏定义均是TRUE，在定时器服务的初始化中涉及到的是定时器1、3、4，查看代码

void HalTimerInit (void){  T1CCTL0 = 0;    /* Make sure interrupts are disabled */  T1CCTL1 = 0;    /* Make sure interrupts are disabled */  T1CCTL2 = 0;    /* Make sure interrupts are disabled */  T3CCTL0 = 0;    /* Make sure interrupts are disabled */  T3CCTL1 = 0;    /* Make sure interrupts are disabled */  T4CCTL0 = 0;    /* Make sure interrupts are disabled */  T4CCTL1 = 0;    /* Make sure interrupts are disabled */  /* Setup prescale & clock for timer0 */  halTimerRecord[HW_TIMER_1].prescale    = HAL_TIMER1_16_PRESCALE;  halTimerRecord[HW_TIMER_1].clock       = HAL_TIMER_32MHZ;  halTimerRecord[HW_TIMER_1].prescaleVal = HAL_TIMER1_16_PRESCALE_VAL;  /* Setup prescale & clock for timer2 */  halTimerRecord[HW_TIMER_3].prescale    = HAL_TIMER3_8_PRESCALE;  halTimerRecord[HW_TIMER_3].clock       = HAL_TIMER_32MHZ;  halTimerRecord[HW_TIMER_3].prescaleVal = HAL_TIMER3_8_PRESCALE_VAL;  /* Setup prescale & clock for timer3 */  halTimerRecord[HW_TIMER_4].prescale    = HAL_TIMER4_8_PRESCALE;  halTimerRecord[HW_TIMER_4].clock       = HAL_TIMER_32MHZ;  halTimerRecord[HW_TIMER_4].prescaleVal = HAL_TIMER4_8_PRESCALE_VAL;  /* Setup Timer1 Channel structure */  halTimerChannel[HW_TIMER_1].TxCCTL =  TCHN_T1CCTL;  halTimerChannel[HW_TIMER_1].TxCCL =   TCHN_T1CCL;  halTimerChannel[HW_TIMER_1].TxCCH =   TCHN_T1CCH;  halTimerChannel[HW_TIMER_1].TxOVF =   TCNH_T1OVF;  halTimerChannel[HW_TIMER_1].ovfbit =  TCHN_T1OVFBIT;  halTimerChannel[HW_TIMER_1].intbit =  TCHN_T1INTBIT;……}

定时器3、4的配置与定时器1相同，节省下空间，都是一些寄存器的配置，先看下宏定义吧

#define HW_TIMER_1        0x00#define HW_TIMER_3        0x01#define HW_TIMER_4        0x02#define HW_TIMER_INVALID  0x03#define HW_TIMER_MAX      0x03#define HAL_TIMER1_16_PRESCALE      HAL_TIMER1_16_TC_DIV128#define HAL_TIMER1_16_PRESCALE_VAL  128#define HAL_TIMER3_8_PRESCALE       HAL_TIMER34_8_TC_DIV128#define HAL_TIMER3_8_PRESCALE_VAL   128#define HAL_TIMER4_8_PRESCALE       HAL_TIMER34_8_TC_DIV128#define HAL_TIMER4_8_PRESCALE_VAL   128#define HAL_TIMER1_16_TC_DIV128   0x0c  /* Clock pre-scaled by 128 */#define HAL_TIMER34_8_TC_DIV128   0xE0  /* Clock pre-scaled by 128 *//* Clock settings */#define HAL_TIMER_16MHZ           16#define HAL_TIMER_32MHZ           32/* Default all timers to use channel 0 */#define TCHN_T1CCTL   &(X_T1CCTL0)#define TCHN_T1CCL    &(X_T1CC0L)#define TCHN_T1CCH    &(X_T1CC0H)#define TCNH_T1OVF    &(X_TIMIF)#define TCHN_T1OVFBIT TIMIF_T1OVFIM#define TCHN_T1INTBIT IEN1_T1IE

貌似有点多看着，而且这里面还用到了一个halTimerRecord数组和一个halTimerChannel数组，查看下其定义

typedef struct{  bool configured;  bool intEnable;  uint8 opMode;  uint8 channel;  uint8 channelMode;  uint8 prescale;  uint8 prescaleVal;  uint8 clock;  halTimerCBack_t callBackFunc;} halTimerSettings_t;typedef struct{  uint8 volatile XDATA *TxCCTL;  uint8 volatile XDATA *TxCCH;  uint8 volatile XDATA *TxCCL;  uint8 volatile XDATA *TxOVF;  uint8 ovfbit;  uint8 intbit;} halTimerChannel_t;/********************************************************************* * GLOBAL VARIABLES */static halTimerSettings_t halTimerRecord[HW_TIMER_MAX];static halTimerChannel_t  halTimerChannel[HW_TIMER_MAX];

用这两个数组管理者三个定时器，跟定时器1相关的寄存器有以下几个

T1CNTH和T1CNTL没啥可说的，保存16位计数值，T1CCnH和T1CCnL是保存通道的捕获/比较16位数值，T1CTL是定时器1的控制寄存器，T1STAT是定时器1的状态寄存器如下

T1CTL管理定时器的分频以及工作模式，T1STAT是一些中断标志位，T1CCTLn是各个通道的捕获/比较控制器，在这里是一个重要的寄存器，T3CTL分频占了3位略微有点区别。

该寄存器配置通道的使能、模式选择（比较模式还是捕获模式），模式的控制（两个模式的配置），寄存器一目了然，看代码才是王道，首先是屏蔽通道中断，然后配置时钟分频器，对于定时器1来说取得值是0x0c，对比与T1CTL来说就是128分频，而后设置适中源32MHz，对于prescaleVal目前还不清楚是做啥子的，赋值为128，定时器3和定时器4也是128分频，时钟源是32MHz，但这只是为这个结构体赋值了，并没有对具体的寄存器赋值还。接着是设置定时器通道结构体，默认都是通道0，这里用到了两个寄存器如下

都是一些中断标志位，这段代码里就将结构体与寄存器联系在一起了，他的定义用的是寄存器。HalTimerInit()函数只是一些定时器的配置，也没有啥是性质东西，不过那两个结构体要搞清楚方便管理定时器。

接下来看一哈HalAdcInit()这个函数，同样只是一些简单的配置

void HalAdcInit (void){#if (HAL_ADC == TRUE)  volatile uint8  tmp;  ADCCON1 = HAL_ADC_STSEL | HAL_ADC_RAND_GEN | 0x03;  ADCCON2 = HAL_ADC_REF_VOLT | HAL_ADC_DEC_RATE | HAL_ADC_SCHN;  /*  *  After reset, the first ADC reading of the extra conversion always reads GND level.  *  We will do a few dummy conversions to bypass this bug.  */  tmp = ADCL;     /* read ADCL,ADCH to clear EOC */  tmp = ADCH;  ADCCON3 = HAL_ADC_REF_VOLT | HAL_ADC_DEC_RATE | HAL_ADC_ECHN;  while ((ADCCON1 & HAL_ADC_EOC) != HAL_ADC_EOC);   /* Wait for conversion */  tmp = ADCL;     /* read ADCL,ADCH to clear EOC */  tmp = ADCH;  ADCCON3 = HAL_ADC_REF_VOLT | HAL_ADC_DEC_RATE | HAL_ADC_ECHN;  while ((ADCCON1 & HAL_ADC_EOC) != HAL_ADC_EOC);   /* Wait for conversion */  tmp = ADCL;     /* read ADCL,ADCH to clear EOC */  tmp = ADCH;#endif}

ADC一共三个寄存器ADCCON1、ADCCON2以及ADCCON3，其中ADCCON3在供电检测的时候用到过了，

ADCCON1主要用于控制，启动ADC转换，ADCCON2主要是配置，

#define HAL_ADC_STSEL       HAL_ADC_STSEL_ST#define HAL_ADC_RAND_GEN    HAL_ADC_RAND_STOP#define HAL_ADC_REF_VOLT    HAL_ADC_REF_AVDD#define HAL_ADC_DEC_RATE    HAL_ADC_DEC_064#define HAL_ADC_SCHN        HAL_ADC_CHN_VDD3#define HAL_ADC_ECHN        HAL_ADC_CHN_GND#define HAL_ADC_STSEL_ST    0x30    /* ADCCON1.ST =1 Trigger */#define HAL_ADC_RAND_STOP   0x0c    /* Stop Random Generator */#define HAL_ADC_REF_AVDD    0x80    /* AVDD_SOC Pin Reference */#define HAL_ADC_DEC_064     0x00    /* Decimate by 64 : 8-bit resolution */#define HAL_ADC_CHN_VDD3    0x0f    /* VDD/3 */#define HAL_ADC_CHN_GND     0x0c    /* GND */#define HAL_ADC_EOC         0x80    /* End of Conversion bit */

进入该函数首先是一个判断，第一条语句是设置利用ADCCON1的ST位启动一个新的转换序列，关闭16位随机数发生器，最后两位保留写1。第二条语句设置序列转换的参考电压为AVDD5引脚（他给的注释是与CC2430相符合的，貌似注释都是沿用CC2430的，）唉！64抽取率，序列通道为VDD/3（也就是单个ADC转换了），读取ADCL、ADCH。设置ADCCON3选择用于额外转换的参考电压为AVDD5，64抽取率，通道为GND，当转换完成时，读取转换结果，后面又进行了一次转换，看其注释说道，重启之后，首先对ADC的外部转换都是GND level，所以在这里做了几次转换来避过这个bug。

下面看一下DMA的初始化，这个代码更简短

void HalDmaInit( void ){  HAL_DMA_SET_ADDR_DESC0( &dmaCh0 );  HAL_DMA_SET_ADDR_DESC1234( dmaCh1234 );#if (HAL_UART_DMA || \   ((defined HAL_SPI) && (HAL_SPI == TRUE))  || \   ((defined HAL_IRGEN) && (HAL_IRGEN == TRUE)))  DMAIE = 1;#endif}

DMA有5个通道，3个可配置的DMA通道优先级，32个可配置的传送触发事件等等，DMA的状态图如下

用户需要为每一个通道配置以下几个参数：源地址、目标地址、传送长度，可变长度（VLEN）、优先级别、触发事件、源地址和目标地址增量、传送模式、字节传送或字传送、中断屏蔽以及M8，参数有点多貌似。

#define HAL_DMA_SET_ADDR_DESC0( a ) \  st( \    DMA0CFGH = (uint8)( (uint16)(a) >> 8 );  \    DMA0CFGL = (uint8)( (uint16)(a) );       \  )#define HAL_DMA_SET_ADDR_DESC1234( a ) \  st( \    DMA1CFGH = (uint8)( (uint16)(a) >> 8 );  \    DMA1CFGL = (uint8)( (uint16)(a) );       \  )

这里只是为DMA赋值为通道n的配置数据结构的开始地址，通道0与通道1234是分开的，其结构如下

typedef struct {  uint8 srcAddrH;  uint8 srcAddrL;  uint8 dstAddrH;  uint8 dstAddrL;  uint8 xferLenV;  uint8 xferLenL;  uint8 ctrlA;  uint8 ctrlB;} halDMADesc_t;

更细致的DMA操作还是等到后面再学习吧。