aboutsummaryrefslogtreecommitdiff
path: root/tests
diff options
context:
space:
mode:
Diffstat (limited to 'tests')
0 files changed, 0 insertions, 0 deletions
generated by cgit v1.2.3 (git 2.25.1) at 2024-11-27 22:28:29 +0000
92ce4da







5349ac4






684b0c0

5349ac4


684b0c0






5349ac4

684b0c0

5349ac4



684b0c0

5349ac4

854a8ba







5349ac4

684b0c0



5349ac4










684b0c0


5349ac4

684b0c0

5349ac4

684b0c0

5349ac4

684b0c0



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
71
72
73
74

75
76
77
78
79
80

81

82
83

84
85
86
87
88
89

90

91

92
93
94

95

96

97
98
99
100
101
102
103

104

105
106
107

108
109
110
111
112
113
114
115
116
117

118
119

120

121

122

123

124

125
126
127


                                         



                                                                          


                                                                              



































                                                                        
                                     








                                                                          











                                                                         






                                                                        





                                                                          
                                                                 

                                  





                                                                        
 
                                                                      


                                                                         
                                                                      
 






                                       
 


                                                                   









                                                                  

                                                                        
 
                                            
 
                                                                            
 


                                                                         

   

STM32 software for dev-bridge/Alpha board


The dev-bridge board is a daughterboard for the Novena, which talks to the
Novena's FPGA through the high-speed expansion connector.


The Alpha board is a stand-alone board with an Artix-7 FPGA, a STM32 Cortex-M4
microcontroller, two USB interfaces etc.


See user/ft/stm32-dev-bridge/hardware/rev01 for schematics of the bridge
board. There will be more information on the wiki shortly.


Copyrights


The license for all work done on this in the CrypTech project is a
3-clause BSD license (see LICENSE.txt for details). Some files have
been generated using the STMicroelectronics initialization code
generator STM32CubeMX and thus have additional copyright header(s).


The "Noise generator" and "Amplifier" parts of the circuit diagram are
copied from Benedikt Stockebrand's ARRGH project. ARRGH copyright
statement is included in LICENSE.txt.


A stripped down copy of the ARM CMSIS library version 3.20 is included
in the Drivers/CMSIS/ directory. Unused parts (and documentation etc.)
have been removed, but every attempt have been made to keep any
licensing information intact. See in particular the file
Drivers/CMSIS/CMSIS END USER LICENCE AGREEMENT.pdf.


A full copy of the STM32F4xx HAL Drivers is included in the
Drivers/STM32F4xx_HAL_Driver/ directory.


Building


The following packages need to be installed (on Ubuntu 14.04):


apt-get install gcc-arm-none-eabi gdb-arm-none-eabi openocd


To build the source code, issue "make" from the top level directory
(where this file is). The first time, this will build the complete STM
CMSIS library. A subsequent "make clean" will not clean away the CMSIS
library, but a "make distclean" will.


Installing


Do "bin/flash-target" from the top level directory (where this file is)
to flash a built image into the microcontroller. See the section ST-LINK
below for information about the actual hardware programming device needed.


Example loading the bootloader and the led-test firmware to get some LEDs
flashing:


$ make bootloader board-test
  $ ./bin/flash-target projects/board-test/led-test
  $ ./bin/flash-target projects/bootloader/bootloader


At this point, the STM32 will reset into the bootloader which flashes the
blue LED five times in one second, and then execution of the LED test
firmware will begin. The LED test firmware will flash the green, yellow,
red and blue LEDs in order until the end of time.


Once the bootloader is installed, regular firmware can be loaded without
an ST-LINK cable like this:


$ ./bin/dfu projects/board-test/led-test.bin


Then reboot the Alpha board.


ST-LINK


To program the MCU, an ST-LINK adapter is used. The cheapest way to get
one is to buy an evaluation board with an ST-LINK integrated, and pinouts
to program external chips. This should work with any evaluation board from
STM; we have tested with STM32F4DISCOVERY (with ST-LINK v2.0) and
NUCLEO-F411RE (with ST-LINK v2.1).


The ST-LINK programming pins is called J1 and is near the CrypTech logo
printed on the circuit board. The pin-outs is shown on the circuit board
(follow the thin white line from J1 to the white box with STM32_SWD
written in it). From left to right, the pins are


3V3, CLK, GND, I/O, NRST and N/C


This matches the pin-out on the DISCO and NUCLEO boards we have tried.


First remove the pair of ST-LINK jumpers (CN4 on the DISCO, CN2 on the
NUCLEO). Then find the 6-pin SWD header on the left of the STM board (CN2
on the DISCO, CN4 on the NUCLEO), and connect them to the Alpha board:


NUCLEO / DISCO       CRYPTECH ALPHA
--------------       --------------




    

  • 1 VDD_TARGET      <->  3V3
    • 

  • 2 SWCLK / T_JTCK  <->  CLK
    • 

  • 3 GND             <->  GND
    • 

  • 4 SWDIO / T_JTMS  <->  IO
    • 

  • 5 NRST / T_NRST   <->  NRST
    • 



N/C (pin 6) means Not Connected.


The Alpha board should be powered on before attempting to flash it.


Debugging the firmware


This site shows several ways to use various debuggers to debug the
firmware in an STM32:


http://fun-tech.se/stm32/OpenOCD/gdb.php


There is a shell script called 'bin/debug' that starts an OpenOCD server
and GDB. Example:


$ ./bin/debug projects/board-test/led-test


Once in GDB, issue "monitor reset halt" to reset the STM32 before debugging.


Remember that the first code to run will be the bootloader, but if you do
e.g. "break main" and "continue" you will end up in led-test main() after
the bootloader has jumped there.