README.md
1# wolfSSH/AlphaProject Boad Simple Ssh Example Server Setup Guide
2This demo is tested with the following condition.
3
4* Renesas : CS+ v8.01
5* Board : Alpha Project AP-RX71M-0A w/ Sample program v2.0
6* wolfSSL : 4.0.0
7* wolfSSH : 1.3.1
8
9## Setup process:
10### 1. Download software
11
12 - Unzip AlphaProject firmware
13 - Unzip wolfssl under the same directory
14 - Unzip wolfssh under the same directory
15
16### 2. Set up wolfSSL and wolfSSH
17 - Open wolfssh\ide\Renesas\cs+\wolfssl_lib\wolfssl_lib.mtpj with CS+ and build
18 - Open wolfssh\ide\Renesas\cs+\wolfssh_lib\wolfssh_lib.mtpj with CS+ and build
19 - Open demo_server.mtpj and build. This create demo program library.
20
21### 3. Set up AlphaProject
22 - The demo uses ap_rx71m_0a_sample_cs\Sample\ap_rx71m_0a_usbfunc_sample_cs\ap_rx71m_0a_ether_sample_cs.mtpj
23 - Open and edit ap_rx71m_0a_sample_cs\Sample\ap_rx71m_0a_usbfunc_sample_cs\src\AP_RX71M_0A.c
24 insert wolfSSL_init() in UsbfInit().
25```
26 CanInit();
27 SciInit();
28 EthernetAppInit();
29 UsbfInit();
30 wolfSSL_init(); <- insert this line
31```
32
33 - Modify stack and heap size in ap_rx71m_0a_sample_cs\Sample\ap_rx71m_0a_usbfunc_sample_cs\src\smc_gen\r_config\r_bsp_config.h
34```
35 Line 154 #pragma stacksize su=0x2000
36 Line 175 #define BSP_CFG_HEAP_BYTES (0xa000)
37```
38 - Modify IP address Sample\ap_rx71m_0a_usbfunc_sample_cs\src\tcp_sample\config_tcpudp.c as needed
39
40```
41 #define MY_IP_ADDR0 192,168,1,200 /* Local IP address */
42 #define GATEWAY_ADDR0 192,168,1,254 /* Gateway address (invalid if all 0s) */
43 #define SUBNET_MASK0 255,255,255,0
44```
45 - Add project properties of linking library in ap_rx71m_0a_usbfunc_sample_cs.mtpj
46 wolfssh\ide\Renesas\cs+\Projects\wolfssl_lib\DefaultBuild\wolfssl_lib.lib
47 wolfssh\ide\Renesas\cs+\Projects\wolfssh_lib\DefaultBuild\wolfssh_lib.lib
48 wolfssh\ide\Renesas\cs+\Projects\demo_server\DefaultBuild\demo_sever.lib
49
50 - Set CC-RX(Build Tool)->Library Geberation->Library Configuration to"C99" and enable ctype.h.
51
52 - Build the project and start execut. You see message on the console prompting command.
53```
54 Start server_test
55```
56 - wolfSSH simple server will be open on port 50000 which can be connected to by using the example client bundled with wolfSSH
57```
58 $ ./examples/client/client -h 192.168.1.200 -p 50000 -u jill
59 Sample public key check callback
60 public key = 0x55a0890864ea
61 public key size = 279
62 ctx = You've been sampled!
63 Password: <---- input "upthehill"
64 Server said: Hello, wolfSSH!
65```
66## Support
67
68Email us at [support@wolfssl.com](mailto:support@wolfssl.com).
69
README_jp.md
1# wolfSSH シンプル SSH サーバ セットアップガイド
2
3このデモは以下の環境でテストしています。
4
5* Renesas : CS+ v8.01
6* Board : Alpha Project AP-RX71M-0A w/ Sample program v2.0
7* wolfSSL : 4.0.0
8* wolfSSH : 1.3.1
9
10## セットアップ手順：
11### １ ソフトウェアの入手
12
13- APボード付属のソフトウェア一式を適当なフォルダー下に解凍します。
14- 同じフォルダー下にwolfssl一式を解凍します。
15- 同じフォルダー下にwolfssh一式を解答します。
16### ２ wolfSSL及びwolfSSHのセットアップ
17
18- CS+にてwolfssh\ide\Renesas\cs+\下のwolfssl_lib\wolfssl_lib.mtpjを開き
19 wolfSSLライブラリーのビルドをします。
20- CS+にてwolfssh\ide\Renesas\cs+\下のwolfssh_lib\wolfssj_lib.mtpjを開き
21 wolfSShライブラリーのビルドをします。
22- 同じフォルダの下のdemo_server.mtpjを開き、デモプログラムのビルドをします。
23 このプログラムもライブラリー形式でビルドされます。
24
25### ３ AlphaProject側のセットアップ
26デモはap_rx71m_0a_sample_cs\Sample\ap_rx71m_0a_usbfunc_sample_csフォルダ下の
27ap_rx71m_0a_usbfunc_sample_cs.mtpjプロジェクトを利用します。
28
29- ap_rx71m_0a_sample_cs\Sample\ap_rx71m_0a_ether_sample_cs\srcフォルダ下のAP_RX71M_0A.cファイルを開き、
30 UsbfInit()の下にwolfSSL_init()を挿入します。
31
32```
33 CanInit();
34 SciInit();
35 EthernetAppInit();
36 UsbfInit();
37 wolfSSL_init(); <- この行を挿入
38```
39- ap_rx71m_0a_sample_cs\Sample\ap_rx71m_0a_usbfunc_sample_cs\src\smc_gen\r_config\r_bsp_config.h
40 を開き、スタックサイズとヒープサイズを以下のように設定します。
41 154行目 #pragma stacksize su=0x2000
42 175行目 #define BSP_CFG_HEAP_BYTES (0xa000)
43
44- IPアドレスのデフォルト値は以下のようになっています。
45 必要があれば、Sample\ap_rx71m_0a_ether_sample_cs\src\tcp_sample\config_tcpudp.c
46 内の139行目からの定義を変更します。
47
48```
49 #define MY_IP_ADDR0 192,168,1,200 /* Local IP address */
50 #define GATEWAY_ADDR0 192,168,1,254 /* Gateway address (invalid if all 0s) */
51 #define SUBNET_MASK0 255,255,255,0 /* Subnet mask */
52```
53- CS+でap_rx71m_0a_usbfunc_sample_cs.mtpjプロジェクトを開き、wolfSSL、wolfSSH及びデモライブラリを
54 登録します。CC-RX(ビルドツール)->リンク・オプションタブ->使用するライブラリに
55 以下の二つのファイルを登録します。
56
57 - CC-RX(ビルドツール)->ライブラリージェネレーションタブ->ライブラリー構成を「C99」に、
58 ctype.hを有効にするを「はい」に設定します。
59
60- プロジェクトのビルド、ターゲットへのダウンロードをしたのち、表示->デバッグ・コンソール
61 からコンソールを表示させます。実行を開始するとコンソールに以下の表示が出力されます。
62```
63 Start server_test
64```
65- シンプル wolfSSH サーバは、50000番のポートを開いて待ちます。サーバへは、wolfSSHに付サンプルクライアントを
66使って以下のように接続することができます。
67```
68 $ ./examples/client/client -h 192.168.1.200 -p 50000 -u jill
69 Sample public key check callback
70 public key = 0x55a0890864ea
71 public key size = 279
72 ctx = You've been sampled!
73 Password: <---- input "upthehill"
74 Server said: Hello, wolfSSH!
75```
76
77## サポート
78サポートが必要な場合は、[support@wolfssl.com](mailto:support@wolfssl.com)へご連絡ください。
79
80以上
81