Skip to content

Commit 8475cea

Browse files
OlivierJourdanOlivierJourdan
committed
add the general set-up instruction (LV VM)
1 parent 2862d0b commit 8475cea

2 files changed

Lines changed: 301 additions & 0 deletions

File tree

‎en/modules/ROOT/nav.adoc‎

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1,2 +1,3 @@
11
* xref:index.adoc[The CTI project]
2+
* xref:set-up.adoc[General set-up]
23
* xref:contributing.adoc[How to contribute]

‎en/modules/ROOT/pages/set-up.adoc‎

Lines changed: 300 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,300 @@
1+
= Set-up Instructions
2+
3+
CAUTION: {wip}
4+
5+
== Install Virtualbox
6+
7+
Go to https://www.virtualbox.org/wiki/Downloads[Virtualbox.org] and download version 7.0.X
8+
9+
image::in_001.00_DownoadVirtualBox.png[]
10+
11+
Click on the Download Button, that will take you to the Downloads page
12+
13+
image::in_001.01_DownoadVirtualBox-DownloadsPage.png[]
14+
15+
there, scroll down to click on "Previous Releases"
16+
17+
image::in_001.02_DownoadVirtualBox-ClickOnPreviousReleases.png[]
18+
19+
Select the 7.0.X release
20+
21+
image::in_001.03_DownoadVirtualBox-SelectVersion7.0.png[]
22+
23+
and install.
24+
25+
== Import VM
26+
Visit https://gcentral.org/cti/[Gcentral/cti] and download the OVA file for the CTI virtual machine
27+
28+
image::in_001.04_GCentral-CTI.png[]
29+
30+
Now menu:File[Import Appliance into Virtualbox]
31+
32+
image::in_002.00_ImportAppliance.png[]
33+
34+
Find the downloaded OVA and press Next
35+
36+
image::in_003.00_ApplianceToImport.png[]
37+
38+
image::in_004.00_ApplianceSettings.png[]
39+
40+
Press finish and the OVA will Import and appear as a new Virtual Machine (VM).
41+
42+
image::in_005.00_ImportingAppliance.png[]
43+
44+
image::in_006.00_Start.png[]
45+
46+
When imported open the new VM
47+
48+
You may need to click on the "Show" button to get to your Virtual Machine
49+
50+
image::in_008_Show.png[]
51+
52+
NOTE: Tip, the right ctrl button will free your mouse if the VM steals it.
53+
54+
We no longer log in as a ROOT. The amazing team behind CTI has figured out how to avoid the need to have a ROOT Login. We will be using instead the CTI STUDENT log in with password = labviewtraining
55+
56+
image::in_009.00_LogIn.png[]
57+
58+
You will see the following Desktop
59+
60+
image::in_011.00_Desktop.png[]
61+
62+
== Setting Up Your Keyboard
63+
64+
To change to a different keyboard, open up the start-up menu:
65+
66+
image::in_012.00_ClickOnMenu.png[]
67+
68+
Type Keyboard and click on "Keyboard and Mouse"
69+
70+
image::in_012.01_TypeKeyboard.png[]
71+
72+
Click on "Keyboard Layout"
73+
Select the keyboard that suits from the extensive list!
74+
75+
image::in_013.00_KeyboardLanguage.png[]
76+
77+
== Load and Activate LabVIEW
78+
79+
We strongly recommend that you open Firefox before you activate LabVIEW.
80+
Open up the start-up menu and click on Other>>Post a question on the NI Forums
81+
This will open the NI Forums.
82+
83+
image::in_014.00_OpenNIwebsite.png[]
84+
85+
If you don't have an account, please create one and log in. If you already have an account, please log in.
86+
The first time you open Firefox it may take a little longer to refresh.
87+
88+
image::in_014.01_CreateNIaccountOrLogIn.png[]
89+
90+
You also need to have LabVIEW Community Edition Listed as one of your products. To verify this, go to "My Products". This may take a couple of minutes.
91+
92+
image::in_014.02_MyProducts.png[]
93+
94+
You should have LabVIEW Community Edition, Linux listed as one of your products
95+
96+
image::in_014.04_LabVIEWCommunityEditionLinux.png[]
97+
98+
99+
.Don't see LabVIEW Community Edition Listed
100+
[%collapsible]
101+
====
102+
103+
If you don't see, it, you will need to initiate the LabVIEW download process to gain that entitlement.
104+
105+
To download, go to Products>>LabVIEW
106+
107+
image::in_014.05_ProductsLabVIEW.png[]
108+
109+
Click on the Download button
110+
111+
image::in_014.06_ClickDownload.png[]
112+
113+
Select the Community Edition for Linux and click Download
114+
115+
image::in_014.07_SelectLinuxCommunityEdition.png[]
116+
117+
You can cancel the download process because LabVIEW is already installed on your VM. You just needed to initiate the download process to get the entitlement.
118+
119+
====
120+
121+
Now, you can minimize Firefox for now and let's open LabVIEW to activate it.
122+
Double-click on the LabVIEW shortcut on the VM desktop
123+
124+
image::in_014.08_ClickOnLabVIEWdesktopShortcut.png[]
125+
126+
Activate LabVIEW Community Edition License. You will need to log in again to your NI Account on on NI.com.
127+
128+
image::in_015.00_ActivateLabVIEWCommunityEdition.png[]
129+
130+
This will load the activation website in using Firefox
131+
132+
image::in_016.00_NIuserAccount.png[]
133+
134+
Tap in your user account details and the LabVIEW license will activate.
135+
136+
LabVIEW will now load as normal
137+
138+
== Install Course Materials
139+
140+
image::in_018.00_AccessCommunityTrainingResources.png[]
141+
142+
Open the start-up menu and click on Other>>Visit LabVIEW Community Training on GitHub
143+
144+
image::in_019.00_GitHubCTImaterial.png[]
145+
146+
Select the course you wish to give.
147+
148+
image::in_020.00_DownloadZIP.png[]
149+
150+
Download as a zip file
151+
152+
image::in_021.00_OpenDownloads.png[]
153+
154+
Click on the file symbol
155+
156+
image::in_022.00_Extract.png[]
157+
158+
and extract to Desktop
159+
160+
image::in_023.00_ExtractDestination.png[]
161+
162+
You should now have a desktop that resembles this
163+
164+
image::in_024.00_ExtractedMaterials.png[]
165+
166+
== Installing Drivers
167+
168+
169+
Open up ../4) LabVIEW Instrument Drivers in a window
170+
171+
Clicking on the Computer icon on the desktop and then on the File System, navigate to /usr/local/natinst/LabVIEW-2024-64/instr.lib
172+
173+
Drag HandsOnPi2040 directory to ../instr.lib
174+
175+
image::in_025.00_DragInstrumentDriverTOinstr.lib.png[]
176+
177+
Open LabVIEW and create a new VI. Check the drivers are in the instr.lib as expected
178+
179+
image::in_026.00_HandsOnInstrumentPalette.png[]
180+
181+
182+
== Making Emulator Exe run in Linux
183+
184+
185+
The file CTIPicoVISAEmulator.exe needs to be set to be executable
186+
Open the GettingStartedLabVIEW1-English-main folder and navigate to 3) LabVIEW Instrument Emulator/builds/HandsOn
187+
and right-click on CTIPicoVISAEmulator folder and select "Open in Terminal"
188+
189+
image::in_026.99_OpenInTerminal.png[]
190+
191+
Then type ls kbd:[Enter]
192+
193+
Then type ./CTIPicoVISAEmulator.exe kbd:[Enter]
194+
195+
If you get a Permission denied, then type
196+
197+
chmod u+x CTIPicoVISAEmulator.exe kbd:[Enter]
198+
199+
Now you should be able to type ./CTIPicoVISAEmulator.exe kbd:[Enter]
200+
201+
image::in_027.00_MarkEXE.png[]
202+
203+
.Click here if you are getting other errors
204+
[%collapsible]
205+
====
206+
If you get other errors, then you need to build the Emulator executable for your VM.
207+
208+
Navigate to Desktop/GettingStartedLabVIEW1-English-main/3) LabVIEW Instrument Emulator/Project and double-click on HandsOn.lvproj ot open it in LabVIEW
209+
210+
Double-click Build Specifications
211+
212+
Right-click on CTIPicoVISAEmulator and click on Build
213+
214+
image::in_027.01_BuildSpecifications.png[]
215+
216+
Once is done, click on the Explore button
217+
218+
image::in_027.02_Explore.png[]
219+
220+
and you should be able to execute the exe
221+
222+
image::in_027.03_EmulatorExecuting.png[]
223+
224+
====
225+
226+
227+
== Setting Pico Firmware
228+
229+
230+
Each Raspberry Pi Pico will need the course firmware installed on it.
231+
232+
Hold the BOOTSEL button down on the Pico and plug the USB cable into the computer. The Pico will act as a flash drive.
233+
234+
image::in_028.00_BOOTSEL.png[]
235+
236+
In the Linux VM select Devices>>USB>>Raspberry Pi RP2 Boot [0100] (or similar)
237+
238+
image::in_029.00_DevicesUSB.png[]
239+
240+
This will mount the hard drive on the desktop
241+
242+
image::in_030.00_DeviceAsUSBflashDrive.png[]
243+
244+
Next drag and drop the course firmware file onto the Pico. This will install and the Pico LED will flash green 6 times.
245+
246+
image::in_031.00_DragFirmware.png[]
247+
248+
== Connect and Test the Pico
249+
250+
251+
In the Linux VM select Devices>>USB>>Raspberry Pi Pico [0100] (or similar)
252+
253+
image::in_032.00_ConnectVMtoUSBdevice.png[]
254+
255+
Connect the Pico
256+
257+
258+
== Hardware
259+
USA and UK Suppliers
260+
261+
Raspberry Pi Pico:
262+
263+
* https://thepihut.com/products/raspberry-pi-pico[Pi Hut]
264+
* https://www.digikey.com/en/products/detail/raspberry-pi/SC0917/16608257[Digikey]
265+
266+
267+
Pico Breadboard Kit:
268+
269+
* https://thepihut.com/products/breadboard-kit-for-raspberry-pi-pico[Pi Hut]
270+
* https://www.pishop.us/product/pico-breadboard-kit[Pi Shop]
271+
* https://www.digikey.com/en/products/detail/sb-components-ltd/SKU20843/16836965[Digikey]
272+
273+
274+
Analog Test Board:
275+
276+
* https://thepihut.com/products/analog-test-board[Pi Hut]
277+
* https://www.waveshare.com/analog-test-board.htm[Waveshare]
278+
279+
China Suppliers
280+
281+
Pico Breadboard Kit:
282+
283+
* https://item.taobao.com/item.htm?id=777230738353&pisk=gN0trRYk3BCTbH3Ttf-hoYUj8jdnWHcwAAl5o-2GcvHK_ABmshlcHEMgKO2gmxVxvbkYII-aSDexdvesShycktHIi1q_fSsQd5PO1N_1lDCxavHY0Cy0h-HmGcAHrUcZ_rzjHLYkr37MeSHY1lw1OIN0w1O3fFdsobzXELYAx6ZwIrMGa3RvAXwUMS61lxZCd7wQ15NjhJZQNS__lxMbdwNba5sbc5_CdJPPCOZbCX6QG5_1fRMjOBF0itablxaB9S7B4KeC15QxVtViqJj8lZ_jJ5EBVfwBtq3Q6vy-1V3jk2LzX8G_pZ9y4Gzbd73B3O2qJXgs1g7or4nuGT28iGOp9iS4fW5v-1iIxSSZNWek6EIV0oVU98ApFisfKWPLECpl0ir0T&spm=a312a.7700824.w4002-22466606371.11.12a259a9THMYw0[Taobao]
284+
285+
Raspberry Pi Pico:
286+
287+
* https://item.taobao.com/item.htm?_u=j2prh5pla744&id=637653493419&pisk=gv___D2PutQEej8xGhVeOeLG5BLfCWzzkjOAZs3ZMFL9cqCNFIu20lAjlp18sdr0jtsCH9xwBK-2lI6yK1u4s1PblsCJBESwQIBFh9mNQZJVLr1lFhuNMZlGxT5-7NrMuqTMoEezUzzrs1YDkl4SkXMgJCR8umK9DFYKUdGa2zzPs6Gw675LzNryCadZDqBvXH3pipdtkqdYOHdXZE39DVnKppvpkVptkedp_CdtWKBxvpdJac39Hcpp9IR6kKBvkW1pKITvHwEmNIZ6M1NOK9yXzvmftpgxkwOLCLC_oqOF-Cs9F1Qsr4VD1h9R6pwyNxA9cOt18PMk1MCWegJSzLOtEmGBqqOBUWNImmm8q1U4SgEs1hdH1HPQOviDXBABtZPIfmx9tCO_OWMIm&spm=a1z09.2.0.0.6a382e8dVcWth6[Taobao]
288+
289+
290+
[sidebar]
291+
.Note
292+
--
293+
For Lesson 5, you’ll be testing the Pico board’s analog inputs. The course manual references a blue board with two potentiometers, but this specific board is not included with the hardware provided. Instead, you’ll only need a single potentiometer for this lesson. Please ensure you have one available before proceeding.
294+
--
295+
== Support Software
296+
297+
298+
Part of the idea behind this project is there to be zero costs for the software side of things.
299+
The VM is pre-loaded with LibreOffice – it is the preferred medium for Manuals
300+
The VM also has a program called Pinta – this is a layered graphics program similar to Paint.net. The wiring diagrams are made with this.

0 commit comments

Comments
 (0)