-
Notifications
You must be signed in to change notification settings - Fork 2
/
Copy path0.Prerequisites.html
70 lines (65 loc) · 4.39 KB
/
0.Prerequisites.html
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
<html>
<head>
<link rel="stylesheet" type="text/css" href="style.css" />
</head>
<body>
<h1>Prerequisites</h1>
<h2>Knowledge Prerequisites</h2>
<ul>
<li>A basic understanding of C/C++. You won't need to write new code, but you should be able to understand and make changes to existing code.</li>
<li>How to use a breadboard for prototyping. If you haven't used a breadboard before, you can read up on how to use them on <a
href="https://learn.sparkfun.com/tutorials/how-to-use-a-breadboard">Adafruit</a>, paying attention to how they are internally wired.
</li>
<li>An understanding of the 1Wire protocol. If you are not familiar with it, this tutorial provides a good description (flash required):
<a href="https://www.maximintegrated.com/en/products/1-wire/flash/overview/">https://www.maximintegrated.com/en/products/1-wire/flash/overview/</a></li>
</ul>
<h2>Software Prerequisites</h2>
<p>The following packages are required:
<ul>
<li><a href="https://github.com/texane/stlink">STLink</a></li>
<li><a href="https://sigrok.org/">Sigrok/Pulseview</a></li>
</ul>
</p>
<h2>Fedora Setup</h2>
<ul>
<li>Install the required packages: <code>sudo dnf install uucp stlink pulseview sigrok-firmware-fx2lafw</code></li>
<li>Add yourself to the 'dialout' group: <code>sudo usermod -a -G dialout $USER; newgrp dialout</code></li>
</ul>
<h2>Debian/Ubuntu Setup</h2>
<ul>
<li>Install the required packages: <code>sudo apt install uucp sigrok</code></li>
<li>Add yourself to the 'dialout' group: <code>sudo usermod -a -G dialout $USER; newgrp dialout</code></li>
<li>Follow the <a href="https://github.com/texane/stlink/blob/master/doc/compiling.md">STLink compilation instructions</a> to build the STLink utilities.</li>
</ul>
<h2>Windows Setup</h2>
<ul>
<li>Download & install <a href="https://github.com/texane/stlink/releases">STLink</a>.</li>
<li>Download the <a href="https://sigrok.org/wiki/Downloads">Pulseview Nightly Installer</a></li>
<li>Download & install <a href="https://www.chiark.greenend.org.uk/~sgtatham/putty/latest.html">Putty</a>.
<li>Download & install <a href="https://www.silabs.com/products/development-tools/software/usb-to-uart-bridge-vcp-drivers">Silicon Image CP2102 driver</a>.</li>
</ul>
<h2>OSX Setup</h2>
<ul>
<li>Download & install the <a href="https://sigrok.org/wiki/Mac_OS_X">Pulseview Nightly Image</a></li>
<li>Download & install <a href="https://github.com/texane/stlink/releases">STLink</a>.</li>
<li>Download & install <a href="https://www.silabs.com/products/development-tools/software/usb-to-uart-bridge-vcp-drivers">Silicon Image CP2102 driver</a>.</li>
<li>Open a terminal, then run: <code>sudo kextload /Library/Extensions/SiLabsUSBDriver.kext</code> You should get a security error.</li>
<li>Open <em>System Preferences</em>, <em>Security & Privacy</em>, <em>General</em>. Click <em>Unlock</em> at the bottom of the screen and enter an administrator's password. There should be a warning near the bottom saying Silicon Image drivers were blocked loading. Click <em>Allow</em>.</li>
<li>Go back to the terminal, and try to kextload again. You should get no output.</li>
<li>There should be a device called <code>/dev/tty.SLAB_USBtoUART</code>.</li>
</ul>
<h2>General Setup</h2>
<ol>
<li>Create an account on <a href="https://os.mbed.com/compiler/">Mbed</a></li>
<li>Add the Nucleo-F103RB board to the online compiler by clicking <a target="_blank" href="https://os.mbed.com/platforms/ST-Nucleo-F103RB/add/">here</a>.
Note: This is not the board we are using, but has a microcontroller from the same family. The microcontroller we are using differs in that it may only have 64kB of flash (as per the datasheet), rather than 128kB, but often still has the full 128kB available.
</li>
<li>Select the Nucleo-F103RB board from the board selector in the top right of the online compiler. You may need to reload the page for the board to
appear.</li>
<li>Import the <a href="https://developer.mbed.org/compiler/#import:/users/hudakz/code/STM32F103C8T6_Hello/">STM32F103C8T6 Hello World demo</a></li>
<li>Select the STM32F103C8T6_Hello project from the navigation panel on the left, then select "Compile" from the menu. The browser should present you with
a '.bin' file to save.</li>
</ol>
<p><a href="1.Getting Started.html">Next</a></p>
</body>
</html>