blob: a00b024cc7da37c4ada042b87aea66b2570b792f [file] [log] [blame]
Summer Qin153f3df2022-11-17 15:51:02 +08001*********
2eRPC Host
3*********
4
5This host example is only tested for Linux.
6
7Example: UART Transportation on Musca_S1
8========================================
9
10Build instructions on the target
11--------------------------------
12
13.. code-block:: bash
14
15 cd <TF-M base folder>
16 cmake -G"Unix Makefiles" -S . -B cmake_build -DTFM_PLATFORM=musca_s1 -DTFM_TOOLCHAIN_FILE=toolchain_GNUARM.cmake -DCMAKE_BUILD_TYPE=Debug -DCONFIG_TFM_ERPC_TEST_FRAMEWORK=ON ../
17 cmake --build cmake_build/ -- install -j32
18
19Build instructions on the host
20------------------------------
21
22.. code-block:: bash
23
24 cd <TF-M tests base folder>/erpc/host_example
25 cmake -S . -B build -G "Unix Makefiles" -DTFM_INSTALL_PATH=<TF-M install folder> -DERPC_REPO_PATH=<eRPC base folder> -DERPC_TRANSPORT=UART -DPORT_NAME="/dev/ttyACM0"
26 cmake --build build/
27
28Run instructions on the host
29----------------------------
30
31.. code-block:: bash
32
33 cd <TF-M tests base folder>/erpc/host_example
34 ./build/erpc_main
35
36Example: TCP Transportation on AN521 FVP
37========================================
38
39Build instructions on the target
40--------------------------------
41
42.. code-block:: bash
43
44 cd <TF-M base folder>
45 cmake -G"Unix Makefiles" -S . -B cmake_build -DTFM_PLATFORM=an521 -DTFM_TOOLCHAIN_FILE=toolchain_GNUARM.cmake -DCMAKE_BUILD_TYPE=Debug -DCONFIG_TFM_ERPC_TEST_FRAMEWORK=ON ../
46 cmake --build cmake_build/ -- install -j32
47
48Build instructions on the host
49------------------------------
50
51.. code-block:: bash
52
53 cd <TF-M tests base folder>/erpc/host_example
54 cmake -S . -B build -G "Unix Makefiles" -DTFM_INSTALL_PATH=<TF-M install folder> -DERPC_REPO_PATH=<eRPC base folder> -DERPC_TRANSPORT=TCP -DERPC_HOST="0.0.0.0" -DERPC_PORT=5001
55 cmake --build build/
56
57Run instructions on the host
58----------------------------
59
60Start the AN521 FVP:
61
62.. code-block:: bash
63
64 <DS_PATH>/sw/models/bin/FVP_MPS2_AEMv8M \
65 --parameter fvp_mps2.platform_type=2 \
66 --parameter cpu0.baseline=0 \
67 --parameter cpu0.INITVTOR_S=0x10000000 \
68 --parameter cpu0.semihosting-enable=0 \
69 --parameter fvp_mps2.DISABLE_GATING=0 \
70 --parameter fvp_mps2.telnetterminal0.start_telnet=1 \
71 --parameter fvp_mps2.telnetterminal1.start_telnet=0 \
72 --parameter fvp_mps2.telnetterminal2.start_telnet=0 \
73 --parameter fvp_mps2.telnetterminal0.quiet=0 \
74 --parameter fvp_mps2.telnetterminal1.quiet=1 \
75 --parameter fvp_mps2.telnetterminal2.quiet=1 \
76 --parameter fvp_mps2.UART0.out_file=/dev/stdout \
77 --parameter fvp_mps2.UART0.unbuffered_output=1 \
78 --parameter fvp_mps2.telnetterminal1.mode=raw \
79 --parameter fvp_mps2.UART1.unbuffered_output=1 \
80 --parameter fvp_mps2.mps2_visualisation.disable-visualisation=1 \
81 --application cpu0=<APPLICATION> \
82 --data cpu0=<DATA>@0x10080000 \
83 -M 1
84
85.. code-block:: bash
86
87 cd <TF-M tests base folder>/erpc/host_example
88 ./build/erpc_main
89
90--------------
91
92*Copyright (c) 2023, Arm Limited. All rights reserved.*