All the functionalities and the communication between processes is ensured by a common list of parameters. The first 26 parameters (A -> Z) will be saved regularly in the log. These values will be recovered when the bioreactor reboots.
| id | p | name | description |
|---|---|---|---|
| 0 | A | PARAM_TEMP_LIQ | temperature of the solution |
| 1 | B | PARAM_TEMP_PCB | temperature of the PCB |
| 2 | C | PARAM_TEMP_PID | current heating power |
| 3 | D | PARAM_TEMP_TARGET | target temperature of the liquid |
| 4 | E | PARAM_WEIGHT | in unit of the balance |
| 5 | F | PARAM_WEIGHT_G | in unit of the balance |
| 6 | G | PARAM_WEIGHT_SINCE_LAST_EVENT | |
| 7 | H | PARAM_WEIGHT_MIN | weight value for low level |
| 8 | I | PARAM_WEIGHT_MAX | weight value for high level |
| 24 | Y | PARAM_ERROR | |
| 25 | Z | PARAM_STATUS | currently active service |
| 26 | AA | PARAM_STEPPER_SPEED | motor speed |
| 27 | AB | PARAM_STEPPER_STEPS | number of steps before changing the direction of the motor |
| 31 | AF | PARAM_SEDIMENTATION_TIME | number of minutes to wait without rotation before emptying |
| 32 | AG | PARAM_FILLED_TIME | number of minutes to stay in the filled state |
| 33 | AH | PARAM_WEIGHT_FACTOR | weight calibration: conversion factor digital -> gr |
| 34 | AI | PARAM_WEIGHT_OFFSET | weight calibration: digital offset value when bioreactor is empty |
| 51 | AZ | PARAM_ENABLED | enabled service (set by user) |
| id | p | name | description |
|---|---|---|---|
| PARAM_PH | current pH | ||
| PARAM_PH_STATE | 0: Pause 1 : normal acquisition, 2 : purge of pipes, 4: calibration pH=4, 7: calibration pH=7, 10: calibration pH=10 | ||
| PARAM_FLUX_GAS1 | |||
| PARAM_FLUX_GAS2 | |||
| PARAM_FLUX_GAS3 | |||
| PARAM_FLUX_GAS4 | |||
| PARAM_CONDUCTIVITY | |||
| 35 | AJ | PARAM_TARGET_PH | desired pH |
| 36 | AK | PARAM_PH_FACTOR_A | |
| 37 | AL | PARAM_PH_FACTOR_B | |
| 39 | AN | PARAM_DESIRED_FLUX_GAS1 | |
| 40 | AO | PARAM_DESIRED_FLUX_GAS2 | |
| 41 | AP | PARAM_DESIRED_FLUX_GAS3 | |
| 42 | AQ | PARAM_DESIRED_FLUX_GAS4 | |
| 43 | AR | PARAM_ANEMO_OFFSET1 | anemometer calibration: offset of the digital value (digital value when no gas is flowing) |
| 44 | AS | PARAM_ANEMO_OFFSET2 | |
| 45 | AT | PARAM_ANEMO_OFFSET3 | |
| 46 | AU | PARAM_ANEMO_OFFSET4 | |
| 47 | AV | PARAM_ANEMO_FACTOR1 | anemometer calibration factor: conversion between gas flux (of air) and digital unit |
| 48 | AW | PARAM_ANEMO_FACTOR2 | |
| 49 | AX | PARAM_ANEMO_FACTOR3 | |
| 50 | AY | PARAM_ANEMO_FACTOR4 |
There are 3 important variables that will manage the state of the bioreactor
The PARAM_ENABLED will allow to activate or deactivate some function of the bioreactor. It is for example possible to disable heating while keeping all the other functionalities active.
PARAM_STATUS will display the currently active functionalities. It is composed of different bits that can
be enabled or disabled using the method start and stop. You may also check the status of one of the functions using getStatus.
| Bit | PARAM_STATUS | Comment |
|---|---|---|
| 0 | FLAG_STEPPER_CONTROL | enable/disable agitation control |
| 1 | FLAG_FOOD_CONTROL | enable/disable food control |
| 2 | FLAG_PID_CONTROL | enable/disable heating |
| 3 | FLAG_PH_CONTROL | enable/disable pH control |
| 4 | FLAG_GAS_CONTROL | enable/disable gas control |
| 7 | FLAG_SEDIMENTATION | enable/disable sedimentation (one of the phases of food control) |
| 8 | FLAG_RELAY_FILLING | enable/disable filling pump (one of the phases of food control) |
| 9 | FLAG_RELAY_EMPTYING | enable/disable emptying pump (one of the phases of food control) |
| 11 | FLAG_PH_CALIBRATE | enable/disable pH calibration |
| 12 | FLAG_RELAY_ACID | enable/disable acid addition |
| 13 | FLAG_RELAY_BASE | enable/disable base addition |
The status is currently the Z parameter. You can change the status by changing this value. For example
if you want to force the bioreactor to go in the emptying state you should ensure that the bits FLAG_FOOD_CONTROL & FLAG_RELAY_EMPTYING are set. In other words, you may have to add 2^1 (2) + 2^9 (512) = 514 to your value of the parameter Z (in the case it was not yet enabled). Same procedure is to be implemented for filling.
PARAM_ENABLED allows to enable or disable some functionalities of the bioreactor. Currently, it can control heating, food control and agitation.
| Bit | PARAM_STATUS | Comment |
|---|---|---|
| 0 | FLAG_STEPPER_CONTROL | enable/disable agitation control |
| 1 | FLAG_FOOD_CONTROL | enable/disable food control |
| 2 | FLAG_PID_CONTROL | enable/disable heating |
If you want to control everything the value of PARAM_ENABLED should be 7.
| Bit | PARAM_ERROR | Comment |
|---|---|---|
| 0 | FLAG_TEMP_PCB_PROBE_ERROR | pcb probe failed (one wire not answering)1 |
| 1 | FLAG_TEMP_LIQ_PROBE_ERROR | liquid probe failed (one wire not answering) |
| 2 | FLAG_TEMP_PCB_RANGE_ERROR | temperature of pcb is outside range |
| 3 | FLAG_TEMP_LIQ_RANGE_ERROR | temperature of liquid is outside range |
| 4 | FLAG_TEMP_TARGET_RANGE_ERROR | target temperature is outside range |
| 5 | FLAG_WEIGHT_RANGE_ERROR | weight is outside range |