Ten post chciałbym poświęcić na opisanie sposobu podłączenia wielu czujników na linii One Wire oraz obsługę alarmu od czujnika DS18B20.
[Źródło: http://www.st.com/en/evaluation-tools/stm32f4discovery.html]
Program:
Tutaj należy zmodyfikować kilka funkcji z poprzedniej biblioteki oraz dodać kilka nowych do biblioteki.
Funkcja uruchamiająca czujniki wygląda następująco:
- uint8_t ds18b20Init(uint8_t mode)
- {
- int i = 0, j=0;
- uint8_t deviceDat[8];
- /* If skip rom then we adress all devices on one line
- * with the same setting */
- if(mode == SKIP_ROM)
- {
- /* Send Reset pulse then wait for Presence Pulse */
- if(ds18b20ResetDevice() != 1)
- {
- return 0;
- }
- ds18b20WriteByte(COM_SKIP_ROM);
- ds18b20WriteByte(COM_WRITE_SCRATCHPAD);
- /* Set Th high temp alarm for 50 */
- ds18b20WriteByte(0x32);
- /* Set Tl low temp alarm for -10 */
- ds18b20WriteByte(0x8A);
- ds18b20WriteByte(RESOLUTION_12BIT);
- }
- else if(mode == NO_SKIP_ROM)
- {
- /* find devices, read ROM */
- for(i=1;i<=DS18B20_CONNECTED_DEV;i++)
- {
- if(ds18b20SearchRom(deviceDat))
- {
- ds18b20_data.Dev_Cnt++;
- memcpy(ds18b20_data.Dev_ID[ds18b20_data.Dev_Cnt-1],deviceDat,sizeof(deviceDat));
- }
- else
- {
- break;
- }
- }
- /* pass all settings to devices on line */
- for(i=1;i<=ds18b20_data.Dev_Cnt;i++)
- {
- if(ds18b20ResetDevice() != 1)
- {
- return 0;
- }
- /* Use for adres one of connected sensors */
- ds18b20WriteByte(COM_MATCH_ROM);
- for(j=0;j<=7;j++)
- {
- ds18b20WriteByte(ds18b20_data.Dev_ID[i-1][j]);
- }
- ds18b20WriteByte(COM_WRITE_SCRATCHPAD);
- /* Set Th high temp alarm for 50 */
- ds18b20WriteByte(0x32);
- /* Set Tl low temp alarm for -10 */
- ds18b20WriteByte(0x8A);
- ds18b20WriteByte(RESOLUTION_12BIT);
- }
- }
- return 1;
- }
Tutaj wprowadzona została modyfikacja. Pierwsza część adresująca wszystkie urządzenia nie została zmieniona. Doszła natomiast druga część dotycząca ustawienia konkretnych danych dla każdego z czujników. Wyszukiwanie odbywa się za pomocą funkcji SEARCH ROM. Następnie do układu przesyłana jest komenda MATCH ROM. Jej zadaniem jest zaadresowanie konkretnego urządzenia. Na jej wywołanie ma odpowiedzieć układ, którego adres ROM zostanie wysłany. Każde inne podłączone układy podrzędne będą czekać na sygnał RESET PULSE.
Modyfikacji uległa także funkcja przesyłająca komendą READ SCRATCHPAD:
Tutaj tak jak poprzednio wpisujemy adres ROM układu który nas interesuje. Po czym przechodzimy do wpisania komendy READ SCRATCHPAD i odczytania umieszczonych w nim wartości:
- void ds18b20ReadScratchpad(uint8_t mode, uint8_t *data, uint8_t deviceNumber)
- {
- uint8_t i;
- ds18b20ResetDevice();
- if(mode == SKIP_ROM)
- {
- ds18b20WriteByte(COM_SKIP_ROM);
- }
- else if(mode == NO_SKIP_ROM)
- {
- ds18b20WriteByte(COM_MATCH_ROM);
- for(i=0;i<=7;i++)
- {
- ds18b20WriteByte(ds18b20_data.Dev_ID[deviceNumber-1][i]);
- }
- }
- ds18b20WriteByte(COM_READ_SCRATCHPAD);
- for(i=0;i<8;i++)
- {
- data[i] = ds18b20ReadByte();
- }
- }
W przypadku funkcji odpowiedzialnej za konwersję temperatury również należy przygotować wersję odczytującą adres ROM układu.
- void ds18b20DevConTemp(uint8_t mode, uint8_t deviceNumber)
- {
- uint8_t i = 0;
- ds18b20ResetDevice();
- if(mode == SKIP_ROM)
- {
- ds18b20WriteByte(COM_SKIP_ROM);
- }
- else if(mode == NO_SKIP_ROM)
- {
- ds18b20WriteByte(COM_MATCH_ROM);
- for(i=0;i<=7;i++)
- {
- ds18b20WriteByte(ds18b20_data.Dev_ID[deviceNumber-1][i]);
- }
- }
- ds18b20WriteByte(COM_CONVERT_T);
- /*
- * Delay to wait for convert temperature finish.
- * With resolution of 12, time to end is give or take 750ms
- * */
- HAL_Delay(800);
- }
Ustawianie alarmu dla wybranego czujnika:
- uint8_t ds18b20SetAlarm(uint8_t Dev[DS18B20_CONNECTED_DEV][8], uint8_t sensor, uint8_t highAlarm, uint8_t lowAlarm)
- {
- uint8_t j=0;
- if(ds18b20ResetDevice() != 1)
- {
- return 0;
- }
- ds18b20WriteByte(COM_MATCH_ROM);
- for(j=0;j<=7;j++)
- {
- ds18b20WriteByte(ds18b20_data.Dev_ID[sensor][j]);
- }
- ds18b20WriteByte(COM_WRITE_SCRATCHPAD);
- /* Set Th high temp alarm */
- ds18b20WriteByte(highAlarm);
- /* Set Tl low temp alarm */
- ds18b20WriteByte(lowAlarm);
- ds18b20WriteByte(RESOLUTION_12BIT);
- return 1;
- }
Funkcja powyżej pobiera urządzenie, które zostało wcześniej odczytane. Na linie przesyłana jest komenda MATCH ROM. Po niej zostanie przesłany adres konkretnego układu. Wobec tego tylko on przyjmie kolejne komendy jak i ustawienie poszczególnych alarmów.
Po ustaleniu wybranego czujnika na generowanie alarmu należy sprawdzić czy dany czujnik wywołał alarm. Można tego dokonać w podobny sposób jak wywoływanie komendy SEARCH ROM. Jedyną różnicą w tym przypadku jest to, że przy wywołaniu komendy ALARM SEARCH odpowie tylko czujnik, który wygenerował alarm.
- uint8_t ds18b20Search(uint8_t *Addr, uint8_t command)
- {
- uint8_t id_bit_number = 1;
- uint8_t last_zero = 0;
- uint8_t rom_byte_number = 0;
- uint8_t search_result = 0;
- uint8_t id_bit = 0;
- uint8_t cmp_id_bit = 0;
- uint8_t rom_byte_mask = 1;
- uint8_t search_direction = 0;
- /* If last call was not the last one */
- if (!ds18b20_data.LastDeviceFlag)
- {
- /* 1-Wire reset */
- if(ds18b20ResetDevice() == 1)
- {
- ds18b20WriteByte(command);
- }
- }
- /* loop for search */
- do
- {
- /* read a bit */
- id_bit = ds18b20ReadBit();
- cmp_id_bit = ds18b20ReadBit();
- /* check for no devices on one wire line */
- if ((id_bit == 1) && (cmp_id_bit == 1))
- {
- break;
- }
- else
- {
- /* all coupled devices have 0 or 1 */
- if (id_bit != cmp_id_bit)
- {
- /* write bit value for search */
- search_direction = id_bit;
- }
- else
- {
- if (id_bit_number < ds18b20_data.LastDiscrepancy)
- {
- search_direction = ((ds18b20_data.ROM_NO[rom_byte_number] & rom_byte_mask) > 0);
- }
- else
- {
- search_direction = (id_bit_number == ds18b20_data.LastDiscrepancy);
- }
- if (search_direction == 0)
- {
- last_zero = id_bit_number;
- /* Check for last family disperancy */
- if (last_zero < 9)
- {
- ds18b20_data.LastFamilyDiscrepancy = last_zero;
- }
- }
- }
- /* set or clear the bit in the ROM byte, with mask */
- if (search_direction == 1)
- {
- ds18b20_data.ROM_NO[rom_byte_number] |= rom_byte_mask;
- }
- else
- {
- ds18b20_data.ROM_NO[rom_byte_number] &= ~rom_byte_mask;
- }
- /* serial number, search direction */
- ds18b20WriteBit(search_direction);
- /*
- * increment byte counter
- * next shift mask
- * */
- id_bit_number++;
- rom_byte_mask <<= 1;
- if (rom_byte_mask == 0)
- {
- rom_byte_number++;
- rom_byte_mask = 1;
- }
- }
- }while(rom_byte_number < 8);
- /* If the search was successful */
- if (!(id_bit_number < 65))
- {
- ds18b20_data.LastDiscrepancy = last_zero;
- /* check last device */
- if (ds18b20_data.LastDiscrepancy == 0)
- {
- ds18b20_data.LastDeviceFlag = 1;
- }
- search_result = 1;
- }
- if (!search_result || !ds18b20_data.ROM_NO[0])
- {
- ds18b20_data.LastDiscrepancy = 0;
- ds18b20_data.LastDeviceFlag = 0;
- ds18b20_data.LastFamilyDiscrepancy = 0;
- search_result = 0;
- }
- else
- {
- for (int i = 0; i < 8; i++)
- {
- Addr[i] = ds18b20_data.ROM_NO[i];
- }
- /* If there is alarm then display ROM RAW of device */
- if(command == COM_ALARM_SEARCH)
- {
- sprintf(str1,"Device deploy alarm: %02X %02X %02X %02X %02X %02X %02X %02X\r\n",
- Addr[0], Addr[1], Addr[2], Addr[3], Addr[4], Addr[5], Addr[6], Addr[7]);
- HAL_UART_Transmit(&huart2,(uint8_t*)str1,strlen(str1),0x1000);
- }
- }
- return search_result;
- }
Funkcje wywoływane w pętli głównej wyglądają następująco:
- void ds18b20InitReadData(void)
- {
- uint8_t buffer[60];
- uint8_t status = 0;
- uint8_t i = 0;
- /* Init all sensors */
- status = ds18b20Init(NO_SKIP_ROM);
- if(status == 1)
- {
- sprintf((char*)buffer,"Initialization status OK\r\n");
- HAL_UART_Transmit(&huart2,(uint8_t*)buffer,strlen((char*)buffer),0x1000);
- }
- else
- {
- sprintf((char*)buffer,"Initialization status Error\r\n");
- HAL_UART_Transmit(&huart2,(uint8_t*)buffer,strlen((char*)buffer),0x1000);
- }
- sprintf((char*)buffer,"Number of devices on line: %d\r\n", ds18b20_data.Dev_Cnt);
- HAL_UART_Transmit(&huart2,(uint8_t*)buffer,strlen((char*)buffer),0x1000);
- /* Get device informations */
- for(i=1;i<=ds18b20_data.Dev_Cnt;i++)
- {
- sprintf((char*)buffer,"Device number: %d\r\n", i);
- HAL_UART_Transmit(&huart2,(uint8_t*)buffer,strlen((char*)buffer),0x1000);
- sprintf((char*)buffer,"ROM RAW: %02X %02X %02X %02X %02X %02X %02X %02X\r\n",
- ds18b20_data.Dev_ID[i-1][0], ds18b20_data.Dev_ID[i-1][1], ds18b20_data.Dev_ID[i-1][2], ds18b20_data.Dev_ID[i-1][3],
- ds18b20_data.Dev_ID[i-1][4], ds18b20_data.Dev_ID[i-1][5], ds18b20_data.Dev_ID[i-1][6], ds18b20_data.Dev_ID[i-1][7]);
- HAL_UART_Transmit(&huart2,(uint8_t*)buffer,strlen((char*)buffer),0x1000);
- sprintf((char*)buffer,"Family CODE: 0x%02X\r\n", ds18b20_data.Dev_ID[i-1][0]);
- HAL_UART_Transmit(&huart2,(uint8_t*)buffer,strlen((char*)buffer),0x1000);
- sprintf((char*)buffer,"ROM CODE: 0x%02X%02X%02X%02X%02X%02X\r\n",
- ds18b20_data.Dev_ID[i-1][6], ds18b20_data.Dev_ID[i-1][5],
- ds18b20_data.Dev_ID[i-1][4], ds18b20_data.Dev_ID[i-1][3],
- ds18b20_data.Dev_ID[i-1][2], ds18b20_data.Dev_ID[i-1][1]);
- HAL_UART_Transmit(&huart2,(uint8_t*)buffer,strlen((char*)buffer),0x1000);
- sprintf((char*)buffer,"CRC: 0x%02X\r\n", ds18b20_data.Dev_ID[i-1][7]);
- HAL_UART_Transmit(&huart2,(uint8_t*)buffer,strlen((char*)buffer),0x1000);
- }
- /* set alarm on one device */
- ds18b20SetAlarm(ds18b20_data.Dev_ID, 0x01, 0x14, 0x8A);
- }
- void ds18b20ReadTempFromDev(void)
- {
- uint8_t buffer[60];
- uint8_t i;
- uint8_t device[8];
- uint16_t readDataRaw;
- float tempValue;
- char sign;
- for(i=1;i<=ds18b20_data.Dev_Cnt;i++)
- {
- ds18b20DevConTemp(NO_SKIP_ROM, i);
- }
- for(i=1;i<=ds18b20_data.Dev_Cnt;i++)
- {
- ds18b20ReadScratchpad(NO_SKIP_ROM, device, i);
- sprintf((char*)buffer,"READ SCRATCHPAD SEN:%d - %02X %02X %02X %02X %02X %02X %02X %02X; ",
- i, device[0], device[1], device[2], device[3], device[4], device[5], device[6], device[7]);
- HAL_UART_Transmit(&huart2,(uint8_t*)buffer,strlen((char*)buffer),0x1000);
- readDataRaw = ((uint16_t)device[1]<<8)|device[0];
- if(ds18b20ReadSign(readDataRaw)) { sign='-'; }
- else { sign='+'; }
- tempValue = ds18b20GetTemp(readDataRaw);
- sprintf((char*)buffer,"RegVal: 0x%04X - %c%.2f\r\n", readDataRaw, sign, tempValue);
- HAL_UART_Transmit(&huart2,(uint8_t*)buffer,strlen((char*)buffer),0x1000);
- }
- }
- void ds18b20AlarmSearch(void)
- {
- uint8_t device[8];
- uint8_t buffer[60];
- while(ds18b20Search(device, COM_ALARM_SEARCH))
- {
- sprintf((char*)buffer,"Alarm deploy!\r\n");
- HAL_UART_Transmit(&huart2,(uint8_t*)buffer,strlen((char*)buffer),0x1000);
- }
- }
Funkcja ds18b20InitReadData odczytuje parametry z czujników, dodatkowo ustawiając alarmy oraz rozdzielczość. Następnie funkcja ds18b20ReadTempFromDev odczytuje scratchpada oraz pobiera temperaturę. No i na końcu sprawdzenie czy któryś z podłączonych czujników wywołał alarm ds18b20AlarmSearch.
Ilość podłączonych czujników definiuje się w pliku ds18b20.h:
- #define DS18B20_CONNECTED_DEV 2
Dane przechowywane są w strukturze:
- typedef struct ds18b20SensorsData_t{
- uint8_t LastDeviceFlag;
- uint8_t LastDiscrepancy;
- uint8_t LastFamilyDiscrepancy;
- uint8_t ROM_NO[8];
- uint8_t Dev_ID[DS18B20_CONNECTED_DEV][8];
- uint8_t Dev_Cnt;
- }ds18b20SD_t;
- ds18b20SD_t ds18b20_data;
Po uruchomieniu programu testowego i poprawnym podłączeniu na komputer będą wysyłane następujące informacje:
Bibliotekę można pobrać pod tym linkiem. Po jego otwarciu należy wejście w folder STM32 a następnie STM32F4_Discovery.