View source for Single-Board-Heater-System/C2/Using-SBHS-Virtual-Labs-on-Windows/English-timed

{| Border=1
| <center>'''Time'''</center>
| <center>'''Narration'''</center>

|-
|00:01
| Welcome to the '''spoken tutorial''' on '''Using Single Board heater System Virtual labs on Windows OS'''.

|-
| 00:11
| In this spoken tutorial, we will learn about: '''Software installation'''s required on the remote users' computer

|-
| 00:17
|Using '''SBHS''' website 

|-
| 00:20
|Performing a '''Step test''' experiment remotely.

|-
|00:24
| As a pre-requisite, watch the following tutorials-  '''Introduction to SBHS '''and '''Introduction to Xcos'''.

|-
| 00:32
|These are available on the '''spoken tutorial '''website.

|-
| 00:35
| I am recording this tutorial on a '''Windows-7, 32-bit Operating System'''.

|-
| 00:42
| Ensure that '''Scilab '''is installed on your computer.

|-
| 00:45
|Scilab can be downloaded from '''sbhs dot os hyphen hardware dot in slash downloads '''OR '''www dot scilab dot org'''.

|-
| 00:58
|Please note that you will need internet connectivity to install Scilab.

|-
| 01:11
| All '''SBHS '''experiment Scilab codes are written using '''Scilab 5.3.3 '''and is the recommended version.

|-
| 01:21
|A higher version of Scilab will work equally well.

|-
| 01:25
|However, code modified in a higher version of Scilab cannot be re-used in the lower version.

|-
| 01:33
| I have already installed '''Scilab 5.3.3.'''

|-
| 01:37
|Now, the next step is to download the experiment Scilab code.

|-
| 01:42
| Open a web browser.

|-
| 01:44
|In the address bar, type: '''os hyphen hardware dot in''' and press the '''Enter''' key.

|-
| 01:53
|This is the website for '''Open Source - Hardware'''.

|-
|01:57
| Click on the project '''SBHS.'''

|-
| 02:01
| On the left hand side, click on '''Downloads'''.

|-
| 02:05
| Click on the download link for '''SBHS Scilab codes for Windows'''.

|-
| 02:13
|It will download the '''Scilab code'''.

|-
| 02:15
| '''Save''' it on the Desktop. 

|-
| 02:18
|Here it is!

|-
| 02:28
| The file downloaded will be in '''zip''' format.

|-
| 02:31
|'''Extract''' the content of this zip file on the Desktop.

|-
| 02:35
| To do so, right-click on it and choose '''Extract Here.'''

|-
| 02:42
|The contents inside this folder will be discussed at a later part of this tutorial.

|-
| 02:48
| Now, let us see the '''SBHS Virtual labs''' website.

|-
| 02:52
| On the left hand side, click on the link '''Virtual Labs.'''

|-
| 02:57
| This is the '''interface''' from where one can gain access to do remote experiments on '''SBHS'''.

|-
|03:05
| A first time user needs to register once, by clicking on the '''Login/Register''' option.

|-
| 03:14
| After this, a '''form''' has to be filled and submitted.

|-
| 03:19
|An activation link is emailed to the user after the '''form''' is submitted successfully.

|-
| 03:25
|The '''link''' received in the email should be used to complete the registration process.

|-
| 03:31
|Note that the activation process may not be immediate. It may take a few minutes.

|-
| 03:37
| I will now login with my registered '''account'''.

|-
| 03:41
|I will enter my '''username''' and '''password'''.

|-
| 03:47
| After a successful login, a user has access to '''Book Slot, View/Delete Slot '''etc.

|-
| 03:55
|A '''slot''' is the time duration in which you can perform an experiment.

|-
| 04:00
|In our case, a '''slot''' lasts for 55 minutes of every hour.

|-
| 04:06
| After clicking on the '''Book Slot '''option, the client will have two choices.

|-
| 04:12
| One can either book '''Current Slot''' or a '''Future Slot'''.

|-
| 04:17
| '''Book Now''' option will appear only if the current '''slot is''' vacant.

|-
| 04:22
|'''Book future slot''' option will always be available.

|-
| 04:26
|It will allow two non-consecutive slots to be booked, each day.

|-
| 04:31
| I will click on the '''Book Now '''option.

|-
| 04:34
| You will receive an acknowledgement with your booking details appearing on the top side.

|-
| 04:41
|The slot booking part is over. Let us now '''run''' a simple '''Step Test''' experiment, downloaded from the website.

|-
| 04:50
| Open the folder you downloaded and saved on the Desktop.

|-
|04:55
| You can see that there is a '''StepTest '''folder and a '''common files '''folder.

|-
| 05:04
|Do not move any of the folders from their location. 

|-
| 05:07
|If the directory structure is changed, the experiment will not '''execute'''.

|-
| 05:12
|If you want one experiment to be copied elsewhere, make sure you copy the '''common_files''' folder too.

|-
| 05:19
|However, make sure the '''common files''' folder is always outside the experiment folder.

|-
| 05:26
| Open the '''common files''' folder. Open the file '''config'''.

|-
| 05:32
|This file is used to do the '''proxy settings'''.

|-
| 05:36
| Do not change the contents of '''config file''' if you are inside '''IIT Bombay''' OR

|-
| 05:42
|you are outside '''IIT Bombay''' and using an '''open network'''.

|-
| 05:48
|For example, at home or using a '''mobile internet'''.

|-
| 05:53
| Change the contents of the '''config file''' if you are outside '''IIT Bombay''' and using a '''proxy network.''' 

|-
| 06:01
|For example- at an institute, office etc.

|-
| 06:06
| Put the value of '''use proxy''' as '''Yes''' with '''Y''' capital.

|-
| 06:12
|Change the other details as per the '''proxy network''' which you are on.

|-
| 06:17
|'''Save''' and close this file. 

|-
|06:20
| Open the '''StepTest''' folder.

|-
| 06:24
| Locate and double-click on the file '''run'''.

|-
| 06:28
| It will open the '''python''' based ''''SBHS client' application'''. 

|-
| 06:32
|Note that the first time execution of this file will take a minute to open the '''SBHS client.'''

|-
| 06:40
|It will show various parameters of the experiment like-

|-
| 06:44
|'''SBHS Connection, Client version, User login '''and''' Experiment status'''.

|-
| 06:51
|Green dots mean that the '''SBHS client''' can connect to the '''server'''. 

|-
| 06:57
|It also shows that the '''client version''' I am using is the latest.

|-
| 07:03
|'''User login''' and '''Experiment''' status is red because I have still not logged in and the experiment is not running.

|-
| 07:13
| It will also give you an option to login.

|-
| 07:17
|Type your '''username''' and '''password'''.

|-
| 07:22
|This '''username''' and '''password''' is the same as you used to book a '''slot'''.

|-
| 07:27
|Click on '''login'''.

|-
| 07:30
|Ensure that you login on the booked date and time, with correct login details.

|-
| 07:35
|Expect the message "Ready to execute scilab code".

|-
| 07:40
| Switch to the '''StepTest '''folder which has the experiment files.

|-
| 07:45
| Double-click on the '''stepc '''file.

|-
| 07:56
|This should open '''Scilab''' automatically.

|-
| 08:00
|It should also open the file in '''Scilab editor'''.

|-
| 08:04
| If it doesn't, click on the '''File''' menu. Click on '''Open a file'''.

|-
| 08:11
|Choose the file '''stepc '''and click on '''Open'''.

|-
| 08:17
| Switch to the '''Scilab console.'''

|-
| 08:37
|Type the command: '''getd space dot dot slash common files '''and press '''Enter'''.

|-
| 08:47
| Switch to the '''scilab editor'''.

|-
| 08:50
|On the menu bar, click on '''Execute '''option and then click on '''File with echo '''.

|-
| 08:58
|If the network is working properly, it will open an '''Xcos''' diagram.

|-
| 09:04
|If it doesn't, it will show error on the '''Scilab console'''.

|-
| 09:09
| Using the '''step test Xocs''' diagram, we can set the experiment parameters such as '''Heat''' and '''Fan.''' 

|-
| 09:18
|Double-click on each '''block''' to change its parameters.

|-
| 09:23
| I will set the heat to vary from 30% to 45% after 300 seconds.

|-
| 09:30
|I will put the '''Initial Value''' as 30, '''Final Value''' equal to 45 and '''Step Time '''equal to 300.

|-
| 09:43
|Similarly, I will set the '''Fan''' to be constant at 50% which is the default value.

|-
| 09:52
| Now, let us '''save''' and '''execute''' the '''xcos diagram.'''

|-
| 09:57
|To execute, click on the '''Start''' button on the menu bar.

|-
| 10:02
| If there is no error, it will open a '''plot window.'''

|-
| 10:06
| It will consist of three graphs, '''Heat''', '''Fan''' and '''Temperature''' from top to bottom. 

|-
| 10:15
| Switch to the''' SBHS client.'''

|-
| 10:18
| It shows the values of '''current iteration, heat, fan, temperature''' and time left for experimentation.

|-
| 10:28
| It shows the '''Log file''' name, it has created for this experiment.

|-
| 10:33
| Switch to the browser. Click on the '''Show video''' option.

|-
| 10:40
|It will give a live video feed of the '''SBHS''' you are currently accessing.

|-
| 10:45
| This is a real experiment and will take some time to complete.

|-
| 10:49
|I will pause this recording for some time and then resume again.

|-
| 10:55
| After sufficient time of experiment, the '''graph''' obtained is as shown.

|-
| 11:00
| I will stop the simulation by clicking on  '''stop''' button, available on the '''Xcos''' window. 

|-
| 11:08
| Close the '''SBHS client '''window after the experiment is over.

|-
| 11:13
| Now, switch to the experiment folder and open the '''logs''' folder. 

|-
| 11:20
|It will have a folder named after your '''username'''.

|-
| 11:24
| Open this folder and locate your '''log file.'''

|-
| 11:29
|Read the '''log''' file name as '''year month date hours minutes seconds dot txt'''.

|-
| 11:38
|Use this '''log''' file for further analysis. 

|-
| 11:42
| Let us summarise. 

|-
| 11:43
|In this tutorial, we learnt: what are the software installations required to do a remote experiment on '''SBHS'''

|-
| 11:53
|How to use the '''SBHS virtual labs''' website

|-
| 11:56
|How to use the '''python''' based '''SBHS client application'''

|-
| 12:00
|How to execute the '''Scilab code''' of an experiment.

|-
| 12:04
| Watch the video available at the following link.

|-
| 12:07
|It summarises the '''Spoken Tutorial''' project. 

|-
| 12:10
|If you do not have good bandwidth, you can download and watch it.

|-
| 12:14
| The Spoken Tutorial project team: Conducts workshops using spoken tutorials

|-
| 12:18
|Gives certificates to those who pass an online test.

|-
| 12:23
|For more details, please write to:  '''contact at spoken-tutorial.org'''.

|-
| 12:30
| '''Spoken Tutorial''' project is a part of the '''Talk to a Teacher''' project. 

|-
| 12:34
|It is supported by the National Mission on Education through ICT, MHRD, Government of India.

|-
| 12:41
|More information on this mission is available at: http://spoken-tutorial.org/NMEICT-Intro

|-
| 12:54
|Thanks for joining. This is Rupak Rokade from '''IIT Bombay''', signing off. Thank You.

|}