Introduction

Welcome to the amazon-freertos wiki!

• This wiki describes our FreeRTOS products, how to use, use cases, technical information, and more.
• We support some devices of RX, RE, and RL78 family.
  • If you have Renesas Starter Kit+ for RX65N-2MB, you can find quick start guide into Amazon Web Services FreeRTOS certified hardware platform.
  • In the future, there may be more families to be supported.
• Now we are trying translating this wiki to English.

Important Notice!

• This repository is now deprecated.
  • https://github.com/renesas/amazon-freertos#-deprecated
• Now Renesas is developing new iot-reference repository on:
  • https://github.com/renesas/iot-reference-rx
    • Maybe after consolidating this repo for whole of Renesas devices, we would use...
      • https://github.com/renesas/iot-reference-renesas (now considering)
• Please visit the URL above if you would like to use FreeRTOS 202210.01-LTS or later.

Tutorial Videos

YouTube

• https://www.youtube.com/watch?v=L6KjIfdMbAc (EN)
• https://www.youtube.com/watch?v=c2QE48GsvEY (JP)
• https://www.bilibili.com/video/BV1Wt4y1A7vi/ (CN)

Renesas (same as YouTube contents)

• https://www.renesas.com/us/en/video/getting-started-freertos-iot-using-smart-configurator-e2-studio (EN)
• https://www.renesas.com/us/ja/video/getting-started-freertos-iot-using-smart-configurator-e2-studio (JP)
• https://www.renesas.com/us/zh/video/getting-started-freertos-iot-using-smart-configurator-e2-studio (CN)

Products

Product List

Product List

• Sorry, it's old information. We will update it.

Release tags

https://github.com/renesas/amazon-freertos/releases

How to clone

1. clone the master branch
   • git clone https://github.com/renesas/amazon-freertos.git
2. change directory to the master branch
   • cd amazon-freertos
3. check out the release tag like
   • git checkout v202002.00-rx-1.0.0
4. update the submodules like
   • git submodule update --init --recursive
5. Please rename from amazon-freertos to afr if you would use RTOS configuration features on SmartConfigrator.
   • (this issue will be fixed at next e2 studio version from 2020-07)

How to import demo or create new project

• Sorry, under construction. Please refer to application notes in our device's web page in Renesas Web.

About FreeRTOS

• FreeRTOS has traditionally only had real-time OS processing.
• However, since it has been managed by Amazon Web Services since 2018, the distribution now includes code for AWS connectivity called IoT Libraries.
• For the sake of convenience, we call them as follows:
  • "FreeRTOS(with IoT Libraries)": FreeRTOS with IoT Libraries
  • "FreeRTOS(Kernel Only)": Real-time OS part only, it's as before 2018.
• Initially, "Amazon FreeRTOS", which is was officially called by Amazon, means "FreeRTOS(with IoT Libraries)", but this has been consolidated into the "FreeRTOS" brand name.
• When "Amazon FreeRTOS" is mentioned in this wiki, it can be read as "FreeRTOS(with IoT Libraries)".

Distribution scheme

AWS Led qualification version

• AWS is always maintaining whole of master source code at:
  • https://github.com/aws/amazon-freertos
• You can download separated/configured for each MCU vendors specific IDE projects from FreeRTOS console:
  • https://docs.aws.amazon.com/freertos/latest/userguide/freertos-ocw.html
• This is latest version of Amazon FreeRTOS implementation.
• RX65N RSK is champion case for AWS Led qualification for Renesas.

Partner Led qualification version

• Partner (MCU vendor) is always maintaining for specific MCU boards (optional against AWS Led qualification boards) related code.
  • The URL below includes renesas qualified boards:
    • https://devices.amazonaws.com/search?kw=renesas&page=1
      • You can access source code download link ">>source code access" on each pages.
        • ">>source code access" link exists if board link would have "Qualified for FreeRTOS" mark.
• This may not be latest version of Amazon FreeRTOS implementation.
• This version exists in specific branch like:
  • https://github.com/renesas/amazon-freertos/releases/tag/v202002.00-rl78-1.0.3
    • click: 287ad67 link
      • jump to specific commit onto the branch named "rl78_pkcs_test".

RX Cloud Connectivity Solutions

• https://www.renesas.com/products/microcontrollers-microprocessors/rx-32-bit-performance-efficiency-mcus/cloud-solution

Amazon FreeRTOS for Renesas MCUs versioning / tags, branches naming / asset naming

https://github.com/renesas/amazon-freertos/issues/8

Technical Support

• Please contact Customer Support Center on Renesas website
  • https://www.renesas.com/contact-us
• Please add an issue ticket on GitHub if you would find the clear way to re-produce the issue
  • https://github.com/renesas/amazon-freertos/issues
• Please add an pull requests ticket on GitHub if you would have actual code can solve the issue (improving idea is also OK)
  • https://github.com/renesas/amazon-freertos/pulls

Currently, following contents are for Japanese only.

---

はじめに

RX65Nを用いたAmazon FreeRTOSの使用方法を解説します。 Amazon FreeRTOSを用いてRX65NをAWS(Amazon Web Services)に接続することが可能です。 RX65Nに接続されたセンサ情報をAWSにアップロードし、AWSの各種サービスと連携させることができます。

開発環境

1. 開発環境を揃える
2. 開発環境を使う
3. CS+を使う

動作確認状況

• 動作確認状況

ダウンロード

• 各種ダウンロード方法の解説

チュートリアル

1. デバイスをAWS IoTに登録する
2. Amazon FreeRTOSをダウンロードする
3. Amazon FreeRTOSを設定する
4. Amazon FreeRTOSを実行し、RX65NをAWS IoTに接続する

トラブルシューティング

• https://www.renesas.com/document/apn/troubleshooting-when-using-amazon-web-services

AWSの各種サービスを使用する

1. シャドウを使用しAWSからRX65Nを制御
2. ElasticSearchを使用しRX65Nに接続されたセンサデータをAWSで可視化
3. Lambdaを使用しAWS経由でRX65N間のM2M通信

Tracealyzerの活用

1. Tracealyzerの活用

OTAの活用

1. OTAの活用

Amazon FreeRTOSのシステムに関する考察

1. ソフトウェアアーキテクチャ
2. 機能ブロックとAPIプロトタイプ
3. RXマイコンにおける実装(システムタイマとソフトウェア割り込み)
4. スリープ機能
5. タスク切り替えと割り込み発生時のレイテンシ
6. ネットワークインタフェースとデバイスドライバの結合
7. Amazon FreeRTOS Qualification Program
8. Amazon FreeRTOS ROM/RAM容量考察
9. Amazon FreeRTOS でFreeRTOS+TCPのみ使う方法
10. シミュレータで動作させる
11. 乱数生成

Amazon FreeRTOSの通信性能に関する考察

1. TCP/IP層の通信性能評価
2. RX65N内蔵セキュリティIPを活用したSSL/TLS層の通信性能評価
3. Tracealyzerを用いた通信中のCPU負荷率評価

セキュリティに関する考察

1. RX65N内蔵セキュリティIP Trusted Secure IP
2. モノの証明書に紐づく秘密鍵等の重要データをTrusted Secure IPで秘匿する方法
3. SSL/TLS通信のマスターシークレットをTrusted Secure IPで秘匿する方法
4. セキュアブート/セキュアアップデートの実現方法
5. NIST FIPS140-2 CMVPとTrusted Secure IP
6. Trusted Secure IP と Arm TrustZone
7. EEMBC SecureMark
8. Trusted Secure IPの暗号処理性能評価

無線モジュールに関する考察

1. SX-ULPGN(Silex)
2. ESP32(Espressif)

Amazon FreeRTOS 関連外部リンク集

1. Amazon FreeRTOS
2. Amazon FreeRTOS の使用開始
3. Amazon FreeRTOS ドキュメント
   1. Amazon FreeRTOS ユーザーガイド
   2. Amazon FreeRTOS API リファレンス
   3. FreeRTOS カーネルリファレンスマニュアル
   4. FreeRTOS カーネル開発者ガイド

リアルタイムOS解説動画

1. RTOSチュートリアル（1/7）：なぜRTOSは必要なのか
2. RTOSチュートリアル（2/7）：タスク
3. RTOSチュートリアル（3/7）：ハンドラ
4. RTOSチュートリアル（4/7）：システムコール その1
5. RTOSチュートリアル（5/7）：システムコール その2
6. RTOSチュートリアル（6/7）：構造と性能
7. RTOSチュートリアル（7/7）：マルチコアとRTOS

設計メモ

1. 設計メモ