Update CCS12 peripheral firmware and documentation

Source/Internal/tools.c

@@ -1,3 +1,12 @@
+/**
+ * @file tools.c
+ * @brief Низкоуровневая настройка XINTF Zone 7 и микросекундные задержки.
+ *
+ * init_zone7() программирует GPIO и временные параметры внешней 16-битной шины.
+ * Значения lead/active/trail привязаны к частоте SYSCLKOUT и характеристикам
+ * внешней памяти. pause_us() является активным ожиданием и блокирует процессор,
+ * поэтому подходит только для коротких аппаратных пауз вне критичных ISR.
+ */
 #include "DSP2833x_Device.h"     // DSP281x Headerfile Include File
 
 // Configure the timing paramaters for Zone 7.
@@ -5,6 +14,12 @@
 //    This function should not be executed from XINTF
 //    Adjust the timing based on the data manual and
 //    external device requirements.
+/**
+ * @brief Включает XINTF и программирует временную диаграмму Zone 7.
+ * @pre Функция исполняется не из памяти, отображённой в настраиваемую Zone 7.
+ * @post Внешняя шина работает в 16-битном режиме с XTIMCLK=SYSCLKOUT.
+ * @warning Значения тактов рассчитаны для штатной частоты платы.
+ */
 void init_zone7(void)
 {
 
@@ -55,6 +70,11 @@ void init_zone7(void)
    asm(" RPT #7 || NOP");
 }
 
+/**
+ * @brief Выполняет блокирующую паузу приблизительно t микросекунд.
+ * @param t Требуемая длительность при текущей конфигурации SYSCLKOUT.
+ * @note Во время цикла процессор не выполняет foreground-работу.
+ */
 void pause_us(unsigned long t)
 {
   unsigned long i;