Bluetooth/en - Revision history

FuzzyBot: Updating to match new version of source page

2024-02-02T13:51:42Z

Updating to match new version of source page

← Older revision		Revision as of 15:51, 2 February 2024
Line 1:		Line 1:
	[[Category~~:ARIS~~:Bluetooth]]		[[Category:Bluetooth]]
	<languages/>		<languages/>
	The Bluetooth feature allows a bidirectional information exchange between the [[ARIS:main\|ARIS]] ~~system~~ and the [[MobileApp:Main\|Mobile App]]. When enabled, the users will be able to establish a wireless connection with ARIS within the Mobile App, and perform two basic operations from the device.		The Bluetooth feature allows a bidirectional information exchange between the [[ARIS:main\|ARIS]] and the [http://dl-prod.essi.upc.edu/IMAGINGwiki/index.php/MobileApp:Main Mobile App]. When enabled, the users will be able to establish a wireless connection with ARIS within the Mobile App, and perform two basic operations from the device.
	# Extract from ARIS a list of test identifiers (i.e., a worklist) from those [[~~ARIS:~~Configuration#Analytical_tests\|Analytical tests]] which are in ''Processing'' state and marked as ''Automatic''.		# Extract from ARIS a list of test identifiers (i.e., a worklist) from those [[Configuration#Analytical_tests\|Analytical tests]] which are in ''Processing'' state and marked as ''Automatic''.
	# Transfer back to ARIS the images taken from each one of those tests, captured with the Mobile app through the microscope.		# Transfer back to ARIS the images taken from each one of those tests, captured with the Mobile app through the microscope.

Line 8:		Line 8:

	==Relevant system paremeters==		==Relevant system paremeters==

	===''bluetooth_enabler''===		===''bluetooth_enabler''===

	[[File:DownloadingNN.PNG\|right\|600px\|thumb\|Window while downloading AI model]]		[[File:DownloadingNN.PNG\|right\|600px\|thumb\|Window while downloading AI model]]
	By default, the Bluetooth functionality is disabled for everybody.		By default, the Bluetooth functionality is disabled for everybody.
	To allow the usage of this feature, a logged ''System Administrator'' must set the 'bluetooth_enabler' parameter to 'Enabled' from the [[~~ARIS:~~System_administration#Parameters\|Parameters]] configuration page.		To allow the usage of this feature, a logged ''System Administrator'' must set the 'bluetooth_enabler' parameter to 'Enabled' from the [[System_administration#Parameters\|Parameters]] configuration page.
	Immediately, the download process of the Artificial Intelligence model for automatic image analysis will start, in case that the required file was not previously downloaded.		Immediately, the download process of the Artificial Intelligence model for automatic image analysis will start, in case that the required file was not previously downloaded.
	After this, in case of success (note that internet connection is required in order to perform the download), a Bluetooth icon will be visible to all ''Laboratory Technicians'' in the [[~~ARIS:~~User Guide#Navigation bar\|Navigation bar]] section, allowing them to enable and disable the Bluetooth connections of the ARIS system by clicking the mentioned icon.		After this, in case of success (note that internet connection is required in order to perform the download), a Bluetooth icon will be visible to all ''Laboratory Technicians'' in the [[User Guide#Navigation bar\|Navigation bar]] section, allowing them to enable and disable the Bluetooth connections of the ARIS system by clicking the mentioned icon.

	In the same way, the Bluetooth functionality can be disabled anytime by a logged ''System Administrator'' from the same [[~~ARIS:~~System_administration#Parameters\|Parameters]] configuration page by setting the 'bluetooth_enabler' parameter to 'Disabled'. This change will hide back the Bluetooth icon, preventing ''Laboratory Technitians'' from enabling or disabling Bluetooth connections.		In the same way, the Bluetooth functionality can be disabled anytime by a logged ''System Administrator'' from the same [[System_administration#Parameters\|Parameters]] configuration page by setting the 'bluetooth_enabler' parameter to 'Disabled'. This change will hide back the Bluetooth icon, preventing ''Laboratory Technitians'' from enabling or disabling Bluetooth connections.

	===''max_image_volume''===		===''max_image_volume''===
	The 'max_image_volume' parameter from the [[~~ARIS:~~System_administration#Parameters\|Parameters]] configuration page refers to the maximum number of megabytes used to store images from the automatically analyzed tests in the whole system. Once the limit is reached, the oldest images in the folder are deleted until the image volume is below the indicated value.
			The 'max_image_volume' parameter from the [[System_administration#Parameters\|Parameters]] configuration page refers to the maximum number of megabytes used to store images from the automatically analyzed tests in the whole system. Once the limit is reached, the oldest images in the folder are deleted until the image volume is below the indicated value.

	==Usage==		==Usage==
	When the Bluetooth functionality is enabled from system [[~~ARIS:~~System_administration#Parameters\|Parameters]], one of three different icons can be seen in the [[~~ARIS:~~User Guide#Navigation bar\|Navigation bar]].		When the Bluetooth functionality is enabled from system [[System_administration#Parameters\|Parameters]], one of three different icons can be seen in the [[User Guide#Navigation bar\|Navigation bar]].

	===Bluetooth OFF===		===Bluetooth OFF===

	[[File:Bluetooth_off.PNG\|left\|50px]]		[[File:Bluetooth_off.PNG\|left\|50px]]
	A grey Bluetooth OFF icon indicates that, currently, ARIS is not being visible to other devices, such as those running the [[MobileApp:Main\|Mobile App]], preventing them from establishing Bluetooth connections with the system.		A grey Bluetooth OFF icon indicates that, currently, ARIS is not being visible to other devices, such as those running the [http://dl-prod.essi.upc.edu/IMAGINGwiki/index.php/MobileApp:Main Mobile App], preventing them from establishing Bluetooth connections with the system.
	If clicked, the Bluetooth OFF icon turns into an orange [[~~ARIS:~~Bluetooth#Bluetooth_ON\|Bluetooth ON]] icon.		If clicked, the Bluetooth OFF icon turns into an orange [[Bluetooth#Bluetooth_ON\|Bluetooth ON]] icon.

	===Bluetooth ON===		===Bluetooth ON===

	[[File:Bluetooth_on.PNG\|left\|50px]]		[[File:Bluetooth_on.PNG\|left\|50px]]
	An orange Bluetooth ON icon indicates that ARIS is visible to other devices, and therefore a [[MobileApp:Main\|Mobile App]] can establish a Bluetooth connection with the system whenever needed.		An orange Bluetooth ON icon indicates that ARIS is visible to other devices, and therefore a [http://dl-prod.essi.upc.edu/IMAGINGwiki/index.php/MobileApp:Main Mobile App] can establish a Bluetooth connection with the system whenever needed.
	If clicked, the Bluetooth ON icon turns into a grey [[~~ARIS:~~Bluetooth#Bluetooth_OFF\|Bluetooth OFF]] icon.		If clicked, the Bluetooth ON icon turns into a grey [[Bluetooth#Bluetooth_OFF\|Bluetooth OFF]] icon.

	===Loading===		===Loading===

	[[File:Bluetooth_loading.PNG\|left\|50px]]		[[File:Bluetooth_loading.PNG\|left\|50px]]
	When image transmission using the Bluetooth feature is taking place between the [[MobileApp:Main\|Mobile App]] and ARIS, the [[~~ARIS:~~Bluetooth#Bluetooth_ON\|Bluetooth ON]] icon turns automatically into an animated orange circle. This icon is not clickable and keeps visible while the mentioned procedure is not over. Moreover, a dropdown next to it appears showing, for all tests being transmited, the download progress or the number of images being analyzed, depending on the stage of the process each test is at.		When image transmission using the Bluetooth feature is taking place between the [http://dl-prod.essi.upc.edu/IMAGINGwiki/index.php/MobileApp:Main Mobile App] and ARIS, the [[Bluetooth#Bluetooth_ON\|Bluetooth ON]] icon turns automatically into an animated orange circle. This icon is not clickable and keeps visible while the mentioned procedure is not over. Moreover, a dropdown next to it appears showing, for all tests being transmited, the download progress or the number of images being analyzed, depending on the stage of the process each test is at.
	Once the image transmission finalizes, this icon turns automatically into the previous [[~~ARIS:~~Bluetooth#Bluetooth_ON\|Bluetooth ON]] icon and the dropdown disappears.		Once the image transmission finalizes, this icon turns automatically into the previous [[Bluetooth#Bluetooth_ON\|Bluetooth ON]] icon and the dropdown disappears.
	[[File:Receiving.png\|centre\|200px]]		[[File:Receiving.png\|centre\|200px]]

	==States==		==States==

	<div style="float:right; margin: 0px 0px 0px 0px">		<div style="float:right; margin: 0px 0px 0px 0px">
	<graphviz border='frame' format='svg' caption='ARIS Bluetooth states'>		<graphviz border='frame' format='svg' caption='ARIS Bluetooth states'>
Line 62:		Line 69:
	ExecutingModel -> ReceivingImages; // [constraint=false];		ExecutingModel -> ReceivingImages; // [constraint=false];
	Waiting -> End [label="Disable Bluetooth"]; // [constraint=false];		Waiting -> End [label="Disable Bluetooth"]; // [constraint=false];

	//{ rank=same; Begin Registered Processing WithResults Validated}		//{ rank=same; Begin Registered Processing WithResults Validated}
	//{ rank=same; Cancelled End}		//{ rank=same; Cancelled End}
Line 68:		Line 74:
	</graphviz>		</graphviz>
	</div>		</div>
	In any given time, the Bluetooth system can be in four different states if [[~~ARIS:~~Bluetooth#Bluetooth_ON\|Bluetooth is ON]].		In any given time, the Bluetooth system can be in four different states if [[Bluetooth#Bluetooth_ON\|Bluetooth is ON]].

	===Waiting===		===Waiting===
	ARIS is visible to other devices and ready to respond to requests made from the [[MobileApp:Main\|Mobile App]]. At this point, it can receive the order to send the current worklist to the Mobile, to receive images from the Mobile or, otherwise, disable any Bluetooth connection by turning the [[~~ARIS:~~Bluetooth#Bluetooth_OFF\|Bluetooth OFF]] in the [[~~ARIS:~~User Guide#Navigation bar\|Navigation bar]].
			ARIS is visible to other devices and ready to respond to requests made from the [http://dl-prod.essi.upc.edu/IMAGINGwiki/index.php/MobileApp:Main Mobile App]. At this point, it can receive the order to send the current worklist to the Mobile, to receive images from the Mobile or, otherwise, disable any Bluetooth connection by turning the [[Bluetooth#Bluetooth_OFF\|Bluetooth OFF]] in the [[User Guide#Navigation bar\|Navigation bar]].

	===Transfering Worklist===		===Transfering Worklist===
	ARIS is sending to the [[MobileApp:Main\|Mobile App]] that has made the request the list of test identifiers from those [[~~ARIS:~~Configuration#Analytical_tests\|Analytical tests]] which are in ''Processing'' state and marked as ''Automatic'', known as worklist. Once the transfer is done, ARIS goes back to [[~~ARIS:~~Bluetooth#Waiting\|Waiting]] state.
			ARIS is sending to the [http://dl-prod.essi.upc.edu/IMAGINGwiki/index.php/MobileApp:Main Mobile App] that has made the request the list of test identifiers from those [[Configuration#Analytical_tests\|Analytical tests]] which are in ''Processing'' state and marked as ''Automatic'', known as worklist. Once the transfer is done, ARIS goes back to [[Bluetooth#Waiting\|Waiting]] state.

	===Receiving Images===		===Receiving Images===
	ARIS is receiving the images taken from one or more of those previously sent tests, captured with the [[MobileApp:Main\|Mobile App]] through the microscope. Every test in the set of images can have as many images as needed. Once the last image of a test is received, the model is executed in parallel for all of the images from that test. Meanwhile, ARIS can keep receiving images of other tests, or go back to [[~~ARIS:~~Bluetooth#Waiting\|Waiting]] state if no more images are being transferred.
			ARIS is receiving the images taken from one or more of those previously sent tests, captured with the [http://dl-prod.essi.upc.edu/IMAGINGwiki/index.php/MobileApp:Main Mobile App] through the microscope. Every test in the set of images can have as many images as needed. Once the last image of a test is received, the model is executed in parallel for all of the images from that test. Meanwhile, ARIS can keep receiving images of other tests, or go back to [[Bluetooth#Waiting\|Waiting]] state if no more images are being transferred.

	===Executing Model===		===Executing Model===
	ARIS is running the AI Model for all of the previously received images of an [[~~ARIS:~~Configuration#Analytical_tests\|Analytical test]], in order to automatically analyze them and obtain a diagnosis.
			ARIS is running the AI Model for all of the previously received images of an [[Configuration#Analytical_tests\|Analytical test]], in order to automatically analyze them and obtain a diagnosis.

FuzzyBot: Updating to match new version of source page

2024-01-17T14:25:23Z

Updating to match new version of source page

New page

[[Category:ARIS:Bluetooth]]
<languages/>
The Bluetooth feature allows a bidirectional information exchange between the [[ARIS:main|ARIS]] system and the [[MobileApp:Main|Mobile App]]. When enabled, the users will be able to establish a wireless connection with ARIS within the Mobile App, and perform two basic operations from the device.
# Extract from ARIS a list of test identifiers (i.e., a worklist) from those [[ARIS:Configuration#Analytical_tests|Analytical tests]] which are in ''Processing'' state and marked as ''Automatic''.
# Transfer back to ARIS the images taken from each one of those tests, captured with the Mobile app through the microscope.

__TOC__

==Relevant system paremeters==
===''bluetooth_enabler''===
[[File:DownloadingNN.PNG|right|600px|thumb|Window while downloading AI model]]
By default, the Bluetooth functionality is disabled for everybody.
To allow the usage of this feature, a logged ''System Administrator'' must set the 'bluetooth_enabler' parameter to 'Enabled' from the [[ARIS:System_administration#Parameters|Parameters]] configuration page.
Immediately, the download process of the Artificial Intelligence model for automatic image analysis will start, in case that the required file was not previously downloaded.
After this, in case of success (note that internet connection is required in order to perform the download), a Bluetooth icon will be visible to all ''Laboratory Technicians'' in the [[ARIS:User Guide#Navigation bar|Navigation bar]] section, allowing them to enable and disable the Bluetooth connections of the ARIS system by clicking the mentioned icon.

In the same way, the Bluetooth functionality can be disabled anytime by a logged ''System Administrator'' from the same [[ARIS:System_administration#Parameters|Parameters]] configuration page by setting the 'bluetooth_enabler' parameter to 'Disabled'. This change will hide back the Bluetooth icon, preventing ''Laboratory Technitians'' from enabling or disabling Bluetooth connections.

===''max_image_volume''===
The 'max_image_volume' parameter from the [[ARIS:System_administration#Parameters|Parameters]] configuration page refers to the maximum number of megabytes used to store images from the automatically analyzed tests in the whole system. Once the limit is reached, the oldest images in the folder are deleted until the image volume is below the indicated value.

==Usage==
When the Bluetooth functionality is enabled from system [[ARIS:System_administration#Parameters|Parameters]], one of three different icons can be seen in the [[ARIS:User Guide#Navigation bar|Navigation bar]].

===Bluetooth OFF===
[[File:Bluetooth_off.PNG|left|50px]]
A grey Bluetooth OFF icon indicates that, currently, ARIS is not being visible to other devices, such as those running the [[MobileApp:Main|Mobile App]], preventing them from establishing Bluetooth connections with the system.
If clicked, the Bluetooth OFF icon turns into an orange [[ARIS:Bluetooth#Bluetooth_ON|Bluetooth ON]] icon.

===Bluetooth ON===
[[File:Bluetooth_on.PNG|left|50px]]
An orange Bluetooth ON icon indicates that ARIS is visible to other devices, and therefore a [[MobileApp:Main|Mobile App]] can establish a Bluetooth connection with the system whenever needed.
If clicked, the Bluetooth ON icon turns into a grey [[ARIS:Bluetooth#Bluetooth_OFF|Bluetooth OFF]] icon.

===Loading===
[[File:Bluetooth_loading.PNG|left|50px]]
When image transmission using the Bluetooth feature is taking place between the [[MobileApp:Main|Mobile App]] and ARIS, the [[ARIS:Bluetooth#Bluetooth_ON|Bluetooth ON]] icon turns automatically into an animated orange circle. This icon is not clickable and keeps visible while the mentioned procedure is not over. Moreover, a dropdown next to it appears showing, for all tests being transmited, the download progress or the number of images being analyzed, depending on the stage of the process each test is at.
Once the image transmission finalizes, this icon turns automatically into the previous [[ARIS:Bluetooth#Bluetooth_ON|Bluetooth ON]] icon and the dropdown disappears.
[[File:Receiving.png|centre|200px]]

==States==
<div style="float:right; margin: 0px 0px 0px 0px">
<graphviz border='frame' format='svg' caption='ARIS Bluetooth states'>
digraph StatesDiagram {
node [shape=rectangle style=rounded fontsize="9pt"];
edge [fontsize="7pt"];
//----- Main graph
// Nodes
Begin [label="" shape="circle" style=filled fillcolor=black fixedsize=true width=0.2 height=0.2];
Waiting [label="Waiting"];
TransferingWorklist [label="Transfering Worklist"];
ReceivingImages [label="Receiving Images"];
ExecutingModel [label="Executing Model"];
End [label="" shape="doublecircle" style=filled fillcolor="black" fixedsize=true width=0.2 height=0.2];
// Edges
Begin -> Waiting [label="Enable Bluetooth"]; // [constraint=false];
Waiting -> TransferingWorklist [label="Mobile request"];
TransferingWorklist -> Waiting; // [constraint=false];
Waiting -> ReceivingImages [label="Mobile request"];
ReceivingImages -> Waiting; // [constraint=false];
ReceivingImages -> ExecutingModel [label="Last image of a test"];
ExecutingModel -> ReceivingImages; // [constraint=false];
Waiting -> End [label="Disable Bluetooth"]; // [constraint=false];

//{ rank=same; Begin Registered Processing WithResults Validated}
//{ rank=same; Cancelled End}
}
</graphviz>
</div>
In any given time, the Bluetooth system can be in four different states if [[ARIS:Bluetooth#Bluetooth_ON|Bluetooth is ON]].
===Waiting===
ARIS is visible to other devices and ready to respond to requests made from the [[MobileApp:Main|Mobile App]]. At this point, it can receive the order to send the current worklist to the Mobile, to receive images from the Mobile or, otherwise, disable any Bluetooth connection by turning the [[ARIS:Bluetooth#Bluetooth_OFF|Bluetooth OFF]] in the [[ARIS:User Guide#Navigation bar|Navigation bar]].

===Transfering Worklist===
ARIS is sending to the [[MobileApp:Main|Mobile App]] that has made the request the list of test identifiers from those [[ARIS:Configuration#Analytical_tests|Analytical tests]] which are in ''Processing'' state and marked as ''Automatic'', known as worklist. Once the transfer is done, ARIS goes back to [[ARIS:Bluetooth#Waiting|Waiting]] state.

===Receiving Images===
ARIS is receiving the images taken from one or more of those previously sent tests, captured with the [[MobileApp:Main|Mobile App]] through the microscope. Every test in the set of images can have as many images as needed. Once the last image of a test is received, the model is executed in parallel for all of the images from that test. Meanwhile, ARIS can keep receiving images of other tests, or go back to [[ARIS:Bluetooth#Waiting|Waiting]] state if no more images are being transferred.

===Executing Model===
ARIS is running the AI Model for all of the previously received images of an [[ARIS:Configuration#Analytical_tests|Analytical test]], in order to automatically analyze them and obtain a diagnosis.