I've tried to transport YOS on ATmega328P implemented previously for ATmega328P to STM32.
前に作っているATmega328Pで動いているYOSをSTM32に移植してみます。
STM32F401RCT6 MCU
| STM32F401RCT6 PIN | Function（機能） | Connect to Device（接続先） | PIN of connected device（接続先PIN） |
|---|---|---|---|
| PA10/RX | UART Receive | Serial/USB-Serial module | TX |
| PA9/TX | UART Transmit | Serial/USB-Serial module | RX |
| PB6 | IIC SCL | SSD1306 OLED | SCL |
| AHT20 | SCL | ||
| PB7 | IIC SDA | SSD1306 OLED | SDA |
| AHT20 | SDA | ||
| PA4 | SPI CS | SD Card Module | CS |
| PA5 | SPI SCK | SD Card Module | CLK |
| PA6 | SPI MISO | SD Card Module | MOSI |
| PA7 | SPI MOSI | SD Card Module | MISO |
- ARM Cortex M4
- 84 MHz CPU
- 64 KB SRAM
- 256 KB Flash
- VS Code with PlatformIO extension
- libopencm3
-
Up to 8 tasks
最大8個タスク
-
Scheduling by time slice
タイムスライスでスゲージュリング
-
delay/msleep/schedule functions to give up current running chance
delay/msleep/schedule関数で自発的にスゲジュウルします
-
Mutex
Mutex
-
Up to 8 User Timer
最大8個ユーザー用タイマー
-
YFS
A abstract file system, and the interfaces are implemented with FAT and LittleFS
抽象化層ファイルシステム、インタフェースはFAT、LittleFSに実現しています
-
USART
For cmdline use
コマンドライン用
-
IIC
-
SPI
-
A cmdline interface
コマンドライン
-
SSD1306 oled (3rd library used)
SSD1306 OLED（第三者ライブラリ利用）
-
AHT20 Temperature & Humidity Sensor (3rd library used)
AHT20温湿度センサー（第三者ライブラリ利用）
-
SD Card Module (3rd library used)
SDカードモジュール（第三者ライブラリ利用）
** Please notice that the SDSC card seems not supported by the 3rd library, and only one type of SDHC card is confirmed by myself: KIOXIA 16GB
※利用している第三者ライブラリの説明によって、SDSCカードは利用できません。今の時点ではたった一つのSDHCカードに動作確認しました：KIOXIA 16GB
It is quite easy to use YOS, maybe it will be faster to go and have a look at main()
YOSは使いやすいと思います、main()関数を見ていただければすぐ分かるようになりますでしょう
The main() does some initializations like USART, IIC, ADC firstly.
main()関数は最初にいくつかの初期化処理を行います、例えばUSART、IIC、ADCなど。
And then call yos_init() to initialize the YOS.
そしてyos_init()を呼び出して、YOSの初期化します。
After that, some tasks are created with yos_create_task function.
次に、yos_create_task関数を呼び出して、いくつかのタスクを作成します。
At last, yos_start() is called and tasks created are scheduled to run.
最後に、yos_start()を呼び出してから、YOSを動かせて、さっき作成されたタスクはそれぞれスゲージュルされて動くようになります
int main()
{
system_clock_setup();
user_timer_init();
if (basic_io_init(yusart_io_operations) != 0) {
return -1;
}
if (yiic_master_init(100000) != 0) {
basic_io_printf("IIC master init failed\n");
return -1;
}
basic_io_printf("-------------\n");
basic_io_printf("YOS starts on STM32\n");
yos_init();
if (yos_create_task(_cmdline_task, NULL, 1024, "cmdtask") < 0) {
return -1;
}
#if (HAS_SSD1306_OLED == 1)
if (yos_create_task(_oled_task, NULL, 1024, "oledtak") < 0) {
basic_io_printf("Failed to create oled task\n");
return -1;
}
#endif
#if (HAS_AHT20_SENSOR == 1)
if (yos_create_task(_aht20_task, NULL, 1024, "ahttsk") < 0 ) {
basic_io_printf("Failed to create aht20 task\n");
return -1;
}
#endif
yos_start();
/*
* Not going here
*
* ここに着くことはありません
*/
return 0;
}
And you can find each task functions which are as below:
タスク関数は全部下記のような形となります：
int _XXX_task(void *para)
{
/* Do prepare work first */
_XXX_prepare_work_1();
......
_XXX_prepare_work_N();
while (1) {
/* Do work repeatedly */
_XXX_do_work_1();
......
_XXX_do_work_M();
/* Sleep some time for the next loop */
yos_task_msleep(1000);
}
return 0;
}
USART settings are like below:
- Baudrate: 115200 8N1
- Flow control: None
- Newline character（改行コード）: LF
Right now the following commands are available:
いまは下記のコマンドが利用できます：
-
help
Show all the available commands
全部利用できるコマンドを表示します
-
echo
Echo the input as argument arrays(i.e. argc and argv)
入力された内容をアーギュメント配列として表示します（あるいはargc、argvの形で）
-
sd
SD card commands(init, deinit, info, etc)
SDカード操作用コマンドです(初期化、解除、情報表示など)
-
si
Display some system info
いくつかのシステム情報を表示します
-
sleep
Sleep for given time(ms)
指定する時間（ミリ秒）で待ち合わせます
-
ts
Show task status
タスク情報を表示します
ID: Task ID（タスクID）
ST: Task status（タスク状態）
SS: Stack size（スタックサイズ）
MSS: Max size used in stack by now（今までスタックを利用している最大サイズ）
NAME: Task name（タスク名）
-
yfs
YFS commands(mount, umount, status, etc)
YFS操作コマンドです(マウント、解除、情報表示など)
-
yls
list files or directories
ファイルまたフォルダをリストします
-
ycat
display file contents
ファイル内容を表示します
-
yapp
append data to the end of file
ファイルにデータを追加します
-
ymkdir
make directory
フォルダを作成します
-
ymv
move file/directory
ファイルまたフォルダを移動します
-
yrm
remove file/directory
ファイルまたフォルダを削除します
-
ycp
copy file
ファイルをコピーします
-
ydd
copy file data
ファイルデータをコピーします
-
ytouch
create an empty file
空ファイルを新規します
-
exit
Exit command line
コマンドを終了します
Example（例）:
-------------
YOS starts on STM32
STM32 cmdline started.
Input [help] to show all available commands,
or [exit] to exit STM32 cmdline.
-
Command [help]
コマンド[help]
STM32> help help Show cmd info briefly echo Echo cmdline info sd SD card cmds si Show system info sleep Sleep given ms ts Show tasks info yfs mount yfs yls list files of file system ycat display file contents yapp append data to the end of file ymkdir make directory ymv move file/directory yrm remove file/directory ycp copy file ydd data copy ytouch create an empty file exit Exit cmdline -
Command [echo]
コマンド[echo]
STM32> echo hello yos on stm32! Echo got 5 paramaters: [ 0] [echo] [ 1] [hello] [ 2] [yos] [ 3] [on] [ 4] [stm32!] Last cmd ret: [0] STM32> echo "hello yos on stm32!" Echo got 2 paramaters: [ 0] [echo] [ 1] [hello yos on stm32!] Last cmd ret: [0] -
Command [sd]
コマンド[sd]
STM32> sd init [lib\sd-spi-driver\src\sd_utils.c:43] sd_card_into_idle: CMD0 idle success This is a SDHC card > Name: "sdcard0" > Capacity: 14784 MB > Block size: 512 B > Erase sector size: 65536 KB init sd OK STM32> sd info got sd info: Type: 3 Sector Size: 512 Sector Number: 30277632 Erase block size: 67108864 -
Command [si]
コマンド[si]
STM32> si MCU: STM32F401RCT6 Max Freq: 84000000 Hz Flash: 262144 Bytes RAM: 65536 Bytes sz char=1 sz short=2 sz int=4 sz long=4 sz float=4 sz double=8 sz void *=4 -
Command [sleep]
コマンド[sleep]
STM32> sleep 5000 sleep 5000 ms 5000 ms slept -
Command [ts]
コマンド[ts]
STM32> ts ID ST SS MSS NAME 000 1 128 72 yosidle 001 1 1024 488 cmdtask -
Command [yfs]
[sd init] command must be executed before [yfs start]
コマンド[yfs]
[sd init]コマンドを実行してから[yfs start]を行います
STM32> yfs start [lib\sd-spi-driver\src\sd_utils.c:43] sd_card_into_idle: CMD0 idle success This is a SDHC card > Name: "sdcard0" > Capacity: 14784 MB > Block size: 512 B > Erase sector size: 65536 KB YFS started OK STM32> yfs status YFS status: type: 0 subtype: 3 block size: 65536 block count: 1890050 block allocated: 32 max filename length: 255 max file size: 0 mount point: /sd -
YFS commands examples
YFS操作コマンド例
STM32> yls /sd Files on /sd: T Size Name - 0 System Volume Information d TestScripts - 18549 f1 - 0 newfile STM32> yapp at /sd/hello.txt "Hello YFS World!" yapp: write 16 bytes to file[/sd/hello.txt] STM32> yls /sd Files on /sd: T Size Name - 0 System Volume Information d TestScripts - 18549 f1 - 0 newfile - 16 hello.txt STM32> ycat t /sd/hello.txt Hello YFS World! STM32>
The following infomations are displayed on OLED:
OLEDで下記の情報が表示されます
-
YOS OLED
-
UP Time
起動してから経った時間
-
Temperature and humidity
温湿度
The OLED inverses display every minute.
OLEDの表示は「分（60秒）」毎で色反転になります
The following 3rd libraries are used and let me thanks the authors.
下記の第三者ライブラリを利用しています、著作者方々に感謝の意を表させてください。
-
For AHT20(https://github.com/kpierzynski/AVR_aht20)
is under the folder [lib/AVR_aht20]
フォルダ[lib/AVR_aht20]に格納します
-
For SSD1306 OLED(https://github.com/tinusaur/ssd1306xled)
is under the folder [lib/ssd1306xled]
フォルダ[lib/ssd1306xled]に格納します
-
For FatFS(https://elm-chan.org/fsw/ff/)
is under the folder [lib/ff16]
フォルダ[lib/ff16]に格納します
-
For SD Card(https://github.com/SouthernSandbox/sd-spi-driver)
is under the folder [lib/sd-spi-driver]
フォルダ[lib/sd-spi-driver]に格納します
It seems that it is difficult to exclude source files of a 3rd-library from building with PlatformIO, and some source files make building errors.
I changed the file name with a suffix of [.org]
PlatformIOを利用していますが、第三者ライブラリの中に指定するソースファイルだけをビルド対象にするのは難しそうです。いくつかのソースファイルのビルドにエラーが出ました。
それらのソースファイル名に「.org」をつけて変更させていただきました。
And to make it better to do with YOS, some source files are modified and some new source files are added.
いくつかの新規ソースファイルも追加させていただきました、YOSの動けるようにするためです。
MIT License
Copyright (c) 2025 Ashibananon(Yuan)