Software developpement¶

The software we are proposing is a variation of the software proposed in the [[Sputnik strikes back:Software| Sputnik strikes back]] project.
As they had to do, we are going to retrieve on a sensor datas, tranform them in a more appropriate format so as to send them by through the RF transmitter.

General principle¶

We are developping for an RTOS, a real time operating system. As presented in the generalities Technical Generalities and requirements, this kind of software runs on a RTOS driven event basis. That is to say we are creating tasks inside infinite loops (so that they keep running) and a scheduler will be operating the shift between the tasks.

In order for the tasks to release or take the processing power they need, the system implement a priority basis : tasks with higher priority, when they need to process, interrupts tasks with lower priorities to take control. These high prioritiy tasks need to release the control in order for the lower priority tasks to be able to run. This is done by what we call a "context switch" functionality present in the scheduler, and notably in the "OS_Delay()" function that enables the tasks to wait and release the processing power to another task.

In order to set the timing between the tasks, we will implement flags, which will serve to determine when some functionalities will be accessed in the tasks.

Software definition¶

Tasks definition¶

We are going to define the following tasks and function :

• task_temp_phys(): this task is the main one, is used to send to the RF transmitter the bits.
• sensor_get_update() : task used to retrieve from the ADC the voltage value and fill the buffer with the temperature
• init_ADC(): used in sensor_update() to initialize the ADC registers
• bin_volt(): used to convert the results from the ADC to a temperature
• celcius_coding() : used to convert the temperarture over a 7-bits word.

We created the following buffer to conserve the data

• bitCharBuf: contains the 7-bits word we are planning to send

We are using the following flags :

• rts_flag : Ready To Send flag, allow the main task to know when data is ready to be sent.
• cod_flag : Flag used to tell the update function that all the data has been sent and it can now retrieve the data

Sequence of events¶

We are retrieving data from the thermocouple thanks to the sensor_get_update(). As the sensor is intern, we will retrieve it only when we need this operation. We are supposing that the dynamic of the temperature we want to measure is slow, that's why we are going to scan one wire at a time and not simultaneoulsy.

Once the two analog inputs have been scanned, we are using bin_voltage() function to convert the ADC output value to a voltage, and then map the voltage difference to a negative or positive temperature thanks to known tables associated to the thermocouple.

When the temperature value has been identified, we are translating it to a 7-bit word by using the celcius_coding() function.
The format chosen for the 7-bits word is the following "0bsdddddd" where:

• s contains the sign of the temperature, "1" being positive and "0" bieng negative
• "dddddd" : contains the absolute value of the temperature. As the range of temperature we are considereing was determined as [-20 : +40] in the lab conditions, we can code it on 6 bits (2⁶ = 64).

When the word is ready, we are setting the rts_flag so that the main tasks knows that data is ready to be sent.

Once the task_temp_phy() "sees" that the rts_flag has been set, it takes over and begins to transmit to the lower level (RF transmitter). It transmit to th RF transmitter by setting the I/O output port wired to the RF to high when a "1" has to be transmitted and to low when a "0" has to be transmitted.
As a Manchester encoding has been selected to comply with the bit rate of the RF transmitter (see [[Sptunik strikes back:]]), we are sendding for half a bit period a "1" if the bit transmitted is "1", and "0" on the second half period. The reverse is done when the bit to be transmitted is a "0".

Once a bit has been trasnmitted, we increase a bitpointer value, refering to the index in the word to be transmitted, and we send the next bit. This continue until all the bits have been transmitted. finally, the task set the rts_flag to "0" to signify the temperature has been sent, set the cod_flag to "1" to ask for new data, and go back to an idle state