MBee API - установка масок каналов

Здравствуйте! Когда мы разрабатывали ПО MB-ZigBee, мы старались сделать такие настройки линий ввода/вывода "по умолчанию", чтобы можно было решить подавляющее большинство задач, связанных с беспроводными системами, основанными на протоколе ZigBee. И действительно, за годы, прошедшие с момента релиза данного ПО, Вы оказались первым, кому такие изменения понадобились У нас в документации есть даже ссылка на Приложение с описанием настроек линий ввода/вывода, но самого этого приложения нет, чтобы не загромождать и так объемный документ. На самом деле MB-ZigBee обеспечивает полный доступ к настройкам портов по эфиру через кластер IO_CONFIG (0x0203 – считать, 0x0403 - установить). Однако, чтобы понять как и чего настраивать, надо неплохо владеть чипом CC2530. Если для Вас необходимо какое-то разовое изменение, то мы можем подготовить для вас специальную прошивку с требуемыми Вам значениями "по умолчанию". Если же Вам необходимо регулярно вносить изменения в конфигурацию линий ввода/вывода, то мы можем выслать вам описание формата данных для кластера IO_CONFIG в виде С-структур. А от вас потребуется проштудировать datasheet на CC2530...

Добрый день! Извините, пожалуйста, за не очень оперативные ответы - загрузка очень большая. Давайте разбираться по частям. Для краткости форматы описываются с помощью конструкций C. Если это будет непонятно, то будем искать другой способ. Подскажите только, пожалуйста, какой. Итак:
Формат фрейма Cluster ID = 0103:

#define ADC_COUNT_MAX 8 //Максимальное количество данных АЦП.

#define COUNT_INPUTS_ENABLE //Включает поддержку счетных входов.

#if defined(COUNT_INPUTS_ENABLE)
#define COUNT_INPUT_MAX_NUMBER 2 //Число поддерживаемых счетных входов.
#endif

typedef unsigned long counterValue_t;

typedef struct
{
uint16 sPeriod;
uint16 digMask;
uint8 adcMask;
uint8 extMask;
uint16 digData;
uint16 adcData[ADC_COUNT_MAX];
uint16 adcPVdd;
uint16 adcTmpr;
#if defined(COUNT_INPUTS_ENABLE)
counterValue_t counter[COUNT_INPUT_MAX_NUMBER];
#endif
} SysmcIoSample_t;

Перед этими байтами передаются 5 байт номера версии. Восемь нулей в конце - это состояние счетных входов, которые по умолчанию поддерживаются в количестве 2 штук.
Поле extMask показывает включены ли в пакет поля с температурой, напряжения питания и счетчиков:

//Биты маски extMask.
#define VDD_MASKBIT 1
#define VTEMP_MASKBIT 2
#if defined(COUNT_INPUTS_ENABLE)
#define COUNTER1_MASKBIT 4
#define COUNTER2_MASKBIT 8
#define COUNTER3_MASKBIT 16
#define COUNTER4_MASKBIT 32
#endif

С помощью кластера 0x403 можно управлять ВСЕМИ регистрами СС2530, отвечающими за настройки линий входа/выхода, а также таймерами, формирующими ШИМ. В документации на MB-ZigBee есть упоминание о Приложении «Управление конфигурацией выводов» (п.4.2). В действительности это приложение не существует в оформленном виде, поскольку, как я уже писал, в большинстве случаев хватает настроек "по-умолчанию".
Если Вас устраивает способ описания формата, который использовался в этом посте, то можно будет поступить подобным же образом и при описании фреймов 0x403/0x203.

Здравствуйте! Ниже приведен формат поля данных, передающийся при запросе кластера 0x203.
void GetIoConfigFromRegisters( uint8 *nvConfig, uint8 *sysmcUserBinaryIoControl )
{
uint8 i;
// считать значения из регистров в массив(буфер)
*nvConfig++ = PERCFG; //offset 0

*nvConfig++ = IEN1; //offset 1
*nvConfig++ = IEN2; //offset 2

*nvConfig++ = P0SEL; //offset 3
*nvConfig++ = P1SEL; //offset 4
*nvConfig++ = P2SEL; //offset 5

*nvConfig++ = P0DIR; //offset 6
*nvConfig++ = P1DIR; //offset 7
*nvConfig++ = P2DIR; //offset 8

*nvConfig++ = P0INP; //offset 9
*nvConfig++ = P1INP; //offset 10
*nvConfig++ = P2INP; //offset 11

*nvConfig++ = PICTL; //offset 12

*nvConfig++ = P0IEN; //offset 13
*nvConfig++ = P1IEN; //offset 14
*nvConfig++ = P2IEN; //offset 15

*nvConfig++ = OBSSEL0; //offset 16
*nvConfig++ = OBSSEL1; //offset 17
*nvConfig++ = OBSSEL2; //offset 18
*nvConfig++ = OBSSEL3; //offset 19
*nvConfig++ = OBSSEL4; //offset 20
*nvConfig++ = OBSSEL5; //offset 21

*nvConfig++ = T1CC0H; //offset 22
*nvConfig++ = T1CC0L; //offset 23

*nvConfig++ = T1CC1H; //offset 24
*nvConfig++ = T1CC1L; //offset 25

*nvConfig++ = T1CC2H; //offset 26
*nvConfig++ = T1CC2L; //offset 27

*nvConfig++ = T1CC3H; //offset 28
*nvConfig++ = T1CC3L; //offset 29

*nvConfig++ = T1CC4H; //offset 30
*nvConfig++ = T1CC4L; //offset 31

*nvConfig++ = SysmcAdcMAsk; //offset 32
*nvConfig++ = HalAdcGetReference(); //offset 33

*nvConfig++ = SysmcSensorPowerControl; //offset 34

*nvConfig++ = SysmcSleepStatusControl; //offset 35

*nvConfig++ = SysmcSystemLedControl; //offset 36

for (i = 0; i < KEYS_MAX_COUNT; i++)
{
*nvConfig++ = SysmcButtonControl[i];
}
for (i = 0; i < MAX_USER_BINARY_IO - KEYS_MAX_COUNT; i++)
{
*nvConfig++ = *sysmcUserBinaryIoControl++;
}
}

Видно, что первые 32 байта представляют собой внутренние регистры CC2530. А остальные - это уже пользовательские настройки. Мы понимаем, что такое представление сложно для восприятия. Да и мы предполагали ранее, что управлять настройками линий ввода/вывода будет специальное ПО типа X-STU от DIGI и пользователям не потребуется самостоятельно разбирать этот пакет. Однако пока работы над указанной программой приостановлены по внутренним причинам. Если у Вас еще сохранится желание самостоятельно управлять настройками всех линий ввода вывода, то в следующих постах мы приведем описание байтов, следующих за offset 31. А пока добавлю, что при записи этих параметров по кластеру 0x403, осуществляется проверка по длине принятого пакета. Если он оказывается больше или меньше, чем приведенный выше формат, то запись не производится.

Здравствуйте! Вот очередная порция информации по проекту. Не скрою, приятно общаться с настоящим, по хорошему "упертым" профессионалом. В целях совершенствования нашей документации, не могли бы Вы прислать нам список опечаток/некорректностей в ней? Если Вы, конечно, еще их не забыли.

//На Координаторе и Маршрутизаторе имеются кнопки - SYSTEM BUTTON, DI1, COUNT1, COUNT2. На Конечном устройстве поддерживается дополнительная кнопка - вход SLEEP_REQUEST. Однако максимальное число
//кнопок устанавливается одинаковым, чтобы одинаковой для всех конфигураций была длина константы SYSMC_IO_CONFIG_LEN.
#define KEYS_MAX_COUNT 5

#define MAX_USER_BINARY_IO 16 //Максимальное число цифровых входов/выходов, назначаемых пользователем.

#define SYSMC_IO_CONFIG_LEN (37 + KEYS_MAX_COUNT + MAX_USER_BINARY_IO)

#if (SYSMC_MODULE_ID == MODULE_MBee3_0)
//Опции по конфигурациям оставлены, чтобы можно было сразу сделать разные значения по умолчанию.
#if (ZSTACK_DEVICE_BUILD & DEVICE_BUILD_COORDINATOR)
#define P0_OUTPUTS 0x32 ///Светодиод SYSTEM, выход SLEEP_STATUS и SENSOR_POWER.
#define P2_OUTPUTS 0x01 //Выход D03 на плате MB-Tag v2.1
#define SYSMC_ADC_MASK_DEFAULT 0x48 //маска аналоговых каналов
#define P0_TRISTATES 0x48 //Отключаем pull up и pull down для аналоговых входов.
#elif (ZSTACK_DEVICE_BUILD & DEVICE_BUILD_ROUTER)
#define P0_OUTPUTS 0x32 ///Светодиод SYSTEM, выход SLEEP_STATUS и SENSOR_POWER.
#define P2_OUTPUTS 0x01 //Выход D03 на плате MB-Tag v2.1
#define SYSMC_ADC_MASK_DEFAULT 0x48 //маска аналоговых каналов
#define P0_TRISTATES 0x48 //Отключаем pull up и pull down для аналоговых входов.
#elif (ZSTACK_DEVICE_BUILD == DEVICE_BUILD_ENDDEVICE)
#define P0_OUTPUTS 0x32 //Светодиод SYSTEM, выход SLEEP_STATUS и SENSOR_POWER.
#define P2_OUTPUTS 0x01 //Выход D03 на плате MB-Tag v2.1
#define SYSMC_ADC_MASK_DEFAULT 0x48 //маска аналоговых каналов
#define P0_TRISTATES 0x48 //Отключаем pull up и pull down для аналоговых входов.
#else
#error Unknown device build!
#endif
#elif (SYSMC_MODULE_ID == MODULE_MBee2_1) || (SYSMC_MODULE_ID == MODULE_MBee3_1)
//Опции по конфигурациям оставлены, чтобы можно было сразу сделать разные значения по умолчанию.
#if (ZSTACK_DEVICE_BUILD & DEVICE_BUILD_COORDINATOR)
#define P0_OUTPUTS 0x32 ///Светодиод SYSTEM, выход SLEEP_STATUS и SENSOR_POWER.
#define P2_OUTPUTS 0x01 //Выход D03 на плате MB-Tag v2.1
#define SYSMC_ADC_MASK_DEFAULT 0xC0 //маска аналоговых каналов
#define P0_TRISTATES 0xC0 //Отключаем pull up и pull down для аналоговых входов.
#elif (ZSTACK_DEVICE_BUILD & DEVICE_BUILD_ROUTER)
#define P0_OUTPUTS 0x32 ///Светодиод SYSTEM, выход SLEEP_STATUS и SENSOR_POWER.
#define P2_OUTPUTS 0x01 //Выход D03 на плате MB-Tag v2.1
#define SYSMC_ADC_MASK_DEFAULT 0xC0 //маска аналоговых каналов
#define P0_TRISTATES 0xC0 //Отключаем pull up и pull down для аналоговых входов.
#elif (ZSTACK_DEVICE_BUILD == DEVICE_BUILD_ENDDEVICE)
#define P0_OUTPUTS 0x32 //Светодиод SYSTEM, выход SLEEP_STATUS и SENSOR_POWER.
#define P2_OUTPUTS 0x01 //Выход D03 на плате MB-Tag v2.1
#define SYSMC_ADC_MASK_DEFAULT 0xC0 //маска аналоговых каналов
#define P0_TRISTATES 0xC0 //Отключаем pull up и pull down для аналоговых входов.
#else
#error Unknown device build!
#endif
#else
#error ERROR! Unknown board identifier!
#endif

//Параметры для установки опорного напряжения (offset 33) с помощью функции HalAdcSetReference(). 0 означает, что опорное напряжение равно 1,25В.

#define HAL_ADC_REF_125V 0x00 /* Internal Reference (1.25V-CC2430)(1.15V-CC2530) */
#define HAL_ADC_REF_AIN7 0x40 /* AIN7 Reference */
#define HAL_ADC_REF_AVDD 0x80 /* AVDD_SOC Pin Reference */

Далее, начиная с offset 34 следуют байты, позволяющие назначать системные и пользовательские линии ввода/вывода на конкретные выводы CC2530. Формат каждого байта одинаковый:

Младшие 5 бит определяют номер линии вывода. Р0.0 соответствует номер 0, Р2.2 - номер 18
Бит 5 определяет активный уровень 1 - высокий, 0 - низкий.
Бит 7 включение/выключение вывода. 1 - включен, 0 - выключен.
Бит 8 определяет задействована линия или нет.

Ниже приведены значения "по-умолчанию", действующие для проекта MB-ZigBee.

//Назначения для переменных, определяющих линии ввода/вывода
//1. Линии общие для всех типов модулей и конфигураций
#define SYSMC_BUTTON_CONTROL_DEFAULT 0x80 //(P0.0 кнопка SYSTEM BUTTON)

#if (SYSMC_MODULE_ID == MODULE_MBee3_0)
#define DI1_INPUT_CONTROL_DEFAULT 0x8E //P1.6 вход DI1 на плате MB-Tag v1.1.
#define COUNT1_INPUT_CONTROL_DEFAULT 0x82 //P0.2 вход COUNT1 на плате MB-Tag v1.1.
#define COUNT2_INPUT_CONTROL_DEFAULT 0x88 //P1.0 вход COUNT2 на плате MB-Tag v1.1.
#define SYSMC_SENSOR_POWER_CONTROL_DEFAULT 0xA5 //Выход включения питания внешних устройств.
#define SYSMC_SLEEP_STATUS_CONTROL_DEFAULT 0xA4 //Выход SLEEP_STATUS.
#define DO3_OUTPUT_CONTROL_DEFAULT 0xB0//P2.0. Цифровой выход DO3 на плате MB-Tag v1.1.
#define SLEEP_REQUEST_INPUT_CONTROL_DEFAULT 0x89 //P1.1 вход SLEEP_REQUEST. Определяется для всех конфигураций. Для Координатора и Маршрутизатора выполняет роль цифрового входа общего назначения.

#elif (SYSMC_MODULE_ID == MODULE_MBee2_1) || (SYSMC_MODULE_ID == MODULE_MBee3_1)
#define DI1_INPUT_CONTROL_DEFAULT 0x8E //P1.6 вход DI1 на плате MB-Tag v1.1.
#define COUNT1_INPUT_CONTROL_DEFAULT 0x82 //P0.2 вход COUNT1 на плате MB-Tag v1.1.
#define COUNT2_INPUT_CONTROL_DEFAULT 0x83 //P0.3 вход COUNT2 на плате MB-Tag v1.1.
#define SYSMC_SENSOR_POWER_CONTROL_DEFAULT 0xA5//P0.5 выход включения питания внешних устройств.
#define SYSMC_SLEEP_STATUS_CONTROL_DEFAULT 0xA4 //P0.4 выход SLEEP_STATUS.
#define DO3_OUTPUT_CONTROL_DEFAULT 0xB0 //P2.0 на плате MB-Tag v1.1 используется как цифровой выход.
#define SLEEP_REQUEST_INPUT_CONTROL_DEFAULT 0x8F //P1.7 вход SLEEP_REQUEST. Определяется для всех конфигураций. Для Координатора и Маршрутизатора выполняет роль цифрового входа общего назначения.
#else
#error ERROR! Unknown board identifier!
#endif

//Назначения для цифровых линий, которые отображаются в массив пользовательских линий sysmcUserBinaryIoControl[]. Текущие значения цифровых входов/выходов, имеющих копии в массиве sysmcUserBinaryIoControl[]
//будут автоматически помещаться в маску цифровых каналов регулярного пакета. Однако необходимо помнить, что при формировании регулярного пакета используется вызов функции UserIoSwitchOnOffAndStateReturn(),
//которая, кроме считывания текущих значений, еще и управляет цифровыми выходами. Таким образом, если какой-либо системный цифровой выход включается/выключается в соответствии с логикой программы
//(например выход SysmcSensorPowerControl), то, чтобы при вызове UserIoSwitchOnOffAndStateReturn() он не выключился за счет того, что в соответствующем элементе массива, бит, управляющий
//включением/выключением данного выхода сброшен, необходимо каждый раз перед вызовом UserIoSwitchOnOffAndStateReturn() проводить копирование переменных, которые управляют системными ВЫХОДАМИ
//в соответствующие элементы массива. Системными выходами являются: SysmcSensorPowerControl, SysmcSleepStatusControl и SysmcSystemLedControl.
#define SYSMC_USER_BINARY_IO_CONTROL_DEFAULT_0 SYSMC_SYSTEM_LED_CONTROL_DEFAULT
#define SYSMC_USER_BINARY_IO_CONTROL_DEFAULT_1 SYSMC_BUTTON_CONTROL_DEFAULT
#define SYSMC_USER_BINARY_IO_CONTROL_DEFAULT_2 SLEEP_REQUEST_INPUT_CONTROL_DEFAULT
#define SYSMC_USER_BINARY_IO_CONTROL_DEFAULT_3 SYSMC_SLEEP_STATUS_CONTROL_DEFAULT
#define SYSMC_USER_BINARY_IO_CONTROL_DEFAULT_4 SYSMC_SENSOR_POWER_CONTROL_DEFAULT
#define SYSMC_USER_BINARY_IO_CONTROL_DEFAULT_5 DI1_INPUT_CONTROL_DEFAULT
#define SYSMC_USER_BINARY_IO_CONTROL_DEFAULT_6 DO3_OUTPUT_CONTROL_DEFAULT
#define SYSMC_USER_BINARY_IO_CONTROL_DEFAULT_7 COUNT1_INPUT_CONTROL_DEFAULT
#define SYSMC_USER_BINARY_IO_CONTROL_DEFAULT_8 COUNT2_INPUT_CONTROL_DEFAULT

Если что будет непонятно - пишите.