samples/subsys/zbus/benchmark/README.html · samples/subsys/zbus/benchmark/README.rst 공식 원문 ↗

Zephyr 3.7.0 · Samples · Zbus

Zbus Benchmark

Listener·subscriber·message subscriber의 duration, RAM과 ROM을 조합별로 비교합니다.

Official pathsamples/subsys/zbus/benchmark/README.html
Source filesamples/subsys/zbus/benchmark/README.rst
Source versionZephyr 3.7.0
TranslationFull · reviewed

본문 기준: Zephyr 3.7.0 LTS3 · 이후 유지보수 패치는 별도입니다.

Part 1

요약·해설

Message size·consumer 수와 Robot Framework 자동 benchmark를 설명합니다.

Payload

256 KiB total

Consumers

1 · 4 · 8

Observers

LIS · SUB · MSG_SUB

Part 2

접을 수 있는 영어 원문 전체

영어 원문 전체 펼치기
원문 SHA-256 77E1F6285B446C85FEC404DC21078477DB9A4BC5E0D5FF1F13B6B42FD54F68FE
.. zephyr:code-sample:: zbus-benchmark
   :name: Benchmarking
   :relevant-api: zbus_apis

   Measure the time for sending 256KB from a producer to N consumers.

This sample implements an application to measure the time for sending 256KB from the producer to the
consumers.

Building and Running
********************

.. zephyr-app-commands::
   :zephyr-app: samples/subsys/zbus/dyn_channel
   :host-os: unix
   :board: qemu_cortex_m3
   :gen-args: -DCONFIG_BM_MESSAGE_SIZE=512 -DCONFIG_BM_ONE_TO=1 -DCONFIG_BM_LISTENERS=y
   :goals: build run

Notice we have the following parameters:

* **CONFIG_BM_MESSAGE_SIZE** the size of the message to be transferred (2 to 4096 bytes);
* **CONFIG_BM_ONE_TO** number of consumers to send (1 up to 8 consumers);
* **CONFIG_BM_LISTENERS** Use y to perform the benchmark listeners;
* **CONFIG_BM_SUBSCRIBERS** Use y to perform the benchmark subscribers;
* **CONFIG_BM_MSG_SUBSCRIBERS** Use y to perform the benchmark message subscribers.

Sample Output
=============
The result would be something like:

.. code-block:: console

   *** Booting Zephyr OS build zephyr-vX.Y.Z ***
   I: Benchmark 1 to 1 using LISTENERS to transmit with message size: 512 bytes
   I: Bytes sent = 262144, received = 262144
   I: Average data rate: 12.62MB/s
   I: Duration: 0.019805908s

   @19805


Running the benchmark automatically
===================================

There is a `Robot framework <https://robotframework.org/>`_ script called ``benchmark_256KB.robot`` which runs all the input combinations as the complete benchmark.
The resulting file, ``zbus_dyn_benchmark_256KB.csv`` is generated in the project root folder. It takes a long time to execute. In the CSV file, we have the following columns:

+-----------------+---------------------+--------------------------+---------------+-------------+-------------+
| Observer type   | Number of consumers | Message size (bytes)     | Duration (ns) | RAM (bytes) | ROM (bytes) |
+=================+=====================+==========================+===============+=============+=============+
| LIS/SUB/MSG_SUB | 1,4,8               | 2,8,32,128,512           | float         | int         | int         |
+-----------------+---------------------+--------------------------+---------------+-------------+-------------+

The complete benchmark command using Robot framework is:

.. code-block:: console

    robot --variable serial_port:/dev/ttyACM0 --variable board:nrf52dk/nrf52832 -d /tmp/benchmark_out   benchmark_256KB.robot

An example of execution using the ``nrf52dk/nrf52832`` board would generate a file like this:

.. code-block::

   LISTENERS,1,2,890787.3333333334,9247,23091
   LISTENERS,1,8,237925.0,9253,23091
   LISTENERS,1,32,74513.0,9277,23151
   LISTENERS,1,128,33813.0,9565,23231
   LISTENERS,1,512,35746.0,10717,23623
   LISTENERS,4,2,314198.3333333333,9274,23142
   LISTENERS,4,8,82244.33333333333,9280,23142
   LISTENERS,4,32,24057.333333333332,9304,23202
   LISTENERS,4,128,9816.0,9592,23282
   LISTENERS,4,512,9277.0,10744,23674
   LISTENERS,8,2,211465.66666666666,9310,23202
   LISTENERS,8,8,56294.0,9316,23210
   LISTENERS,8,32,15635.0,9340,23270
   LISTENERS,8,128,5818.0,9628,23350
   LISTENERS,8,512,4862.0,10780,23742
   SUBSCRIBERS,1,2,7804351.333333333,9927,23463
   SUBSCRIBERS,1,8,1978179.3333333333,9933,23463
   SUBSCRIBERS,1,32,514139.3333333333,9957,23523
   SUBSCRIBERS,1,128,146759.0,10309,23603
   SUBSCRIBERS,1,512,55104.0,11845,23995
   SUBSCRIBERS,4,2,5551961.0,11994,24134
   SUBSCRIBERS,4,8,1395009.0,12000,24134
   SUBSCRIBERS,4,32,354583.3333333333,12024,24194
   SUBSCRIBERS,4,128,92976.66666666667,12568,24274
   SUBSCRIBERS,4,512,28015.0,15256,24666
   SUBSCRIBERS,8,2,5449839.0,14750,24858
   SUBSCRIBERS,8,8,1321766.6666666667,14756,24866
   SUBSCRIBERS,8,32,332804.0,14780,24926
   SUBSCRIBERS,8,128,85489.33333333333,15580,25006
   SUBSCRIBERS,8,512,23905.0,19804,25398
   MSG_SUBSCRIBERS,1,2,8783538.333333334,10371,25615
   MSG_SUBSCRIBERS,1,8,2249592.6666666665,10377,25615
   MSG_SUBSCRIBERS,1,32,610168.0,10401,25675
   MSG_SUBSCRIBERS,1,128,207295.0,10753,25755
   MSG_SUBSCRIBERS,1,512,143584.66666666666,12289,26147
   MSG_SUBSCRIBERS,4,2,5787699.0,12318,26126
   MSG_SUBSCRIBERS,4,8,1473907.0,12324,26126
   MSG_SUBSCRIBERS,4,32,396127.6666666667,12348,26186
   MSG_SUBSCRIBERS,4,128,126362.66666666667,12892,26266
   MSG_SUBSCRIBERS,4,512,59040.666666666664,15580,26658
   MSG_SUBSCRIBERS,8,2,5453999.333333333,14914,26610
   MSG_SUBSCRIBERS,8,8,1356312.3333333333,14920,26650
   MSG_SUBSCRIBERS,8,32,361368.3333333333,14944,26710
   MSG_SUBSCRIBERS,8,128,113148.66666666667,15744,26790
   MSG_SUBSCRIBERS,8,512,51218.333333333336,19968,27182

Part 3

한국어 전문 번역

Producer에서 N개의 consumer로 총 256 KiB를 보낼 때 걸리는 시간을 측정하는 Zbus benchmark application입니다.

빌드 및 실행

다음 official command는 message size 512 byte, consumer 1개와 listener observer를 선택해 qemu_cortex_m3에서 build하고 실행합니다.

# From the root of the zephyr repository
west build -b qemu_cortex_m3 samples/subsys/zbus/dyn_channel -- -DCONFIG_BM_MESSAGE_SIZE=512 -DCONFIG_BM_ONE_TO=1 -DCONFIG_BM_LISTENERS=y
west build -t run

Benchmark parameter는 다음과 같습니다.

  • CONFIG_BM_MESSAGE_SIZE: 전송할 message 크기, 2~4096 byte.
  • CONFIG_BM_ONE_TO: 전송 대상 consumer 수, 1~8개.
  • CONFIG_BM_LISTENERS=y: listener benchmark를 실행합니다.
  • CONFIG_BM_SUBSCRIBERS=y: subscriber benchmark를 실행합니다.
  • CONFIG_BM_MSG_SUBSCRIBERS=y: message subscriber benchmark를 실행합니다.

샘플 출력

Output은 1-to-1 listener 전송에서 262144 byte를 모두 보내고 받았는지, 평균 data rate, duration과 Robot script가 읽을 수 있는 microsecond marker를 보여 줍니다.

*** Booting Zephyr OS build zephyr-vX.Y.Z ***
I: Benchmark 1 to 1 using LISTENERS to transmit with message size: 512 bytes
I: Bytes sent = 262144, received = 262144
I: Average data rate: 12.62MB/s
I: Duration: 0.019805908s

@19805

Benchmark 자동 실행

Robot Framework script인 benchmark_256KB.robot은 모든 input 조합을 실행해 전체 benchmark를 수행합니다. 실행 시간이 오래 걸리며 project root에 zbus_dyn_benchmark_256KB.csv를 생성합니다.

Observer typeConsumer 수Message size(byte)Duration(ns)RAM(byte)ROM(byte)
LIS/SUB/MSG_SUB1, 4, 82, 8, 32, 128, 512floatintint

Robot Framework로 전체 benchmark를 실행하는 command는 다음과 같습니다. Serial port와 board를 실제 환경에 맞게 지정합니다.

robot --variable serial_port:/dev/ttyACM0 --variable board:nrf52dk/nrf52832 -d /tmp/benchmark_out   benchmark_256KB.robot

다음은 nrf52dk/nrf52832에서 생성된 CSV example입니다. Listener, subscriber, message subscriber별로 consumer 수와 message 크기를 바꾸며 duration, RAM, ROM 사용량을 기록합니다.

LISTENERS,1,2,890787.3333333334,9247,23091
LISTENERS,1,8,237925.0,9253,23091
LISTENERS,1,32,74513.0,9277,23151
LISTENERS,1,128,33813.0,9565,23231
LISTENERS,1,512,35746.0,10717,23623
LISTENERS,4,2,314198.3333333333,9274,23142
LISTENERS,4,8,82244.33333333333,9280,23142
LISTENERS,4,32,24057.333333333332,9304,23202
LISTENERS,4,128,9816.0,9592,23282
LISTENERS,4,512,9277.0,10744,23674
LISTENERS,8,2,211465.66666666666,9310,23202
LISTENERS,8,8,56294.0,9316,23210
LISTENERS,8,32,15635.0,9340,23270
LISTENERS,8,128,5818.0,9628,23350
LISTENERS,8,512,4862.0,10780,23742
SUBSCRIBERS,1,2,7804351.333333333,9927,23463
SUBSCRIBERS,1,8,1978179.3333333333,9933,23463
SUBSCRIBERS,1,32,514139.3333333333,9957,23523
SUBSCRIBERS,1,128,146759.0,10309,23603
SUBSCRIBERS,1,512,55104.0,11845,23995
SUBSCRIBERS,4,2,5551961.0,11994,24134
SUBSCRIBERS,4,8,1395009.0,12000,24134
SUBSCRIBERS,4,32,354583.3333333333,12024,24194
SUBSCRIBERS,4,128,92976.66666666667,12568,24274
SUBSCRIBERS,4,512,28015.0,15256,24666
SUBSCRIBERS,8,2,5449839.0,14750,24858
SUBSCRIBERS,8,8,1321766.6666666667,14756,24866
SUBSCRIBERS,8,32,332804.0,14780,24926
SUBSCRIBERS,8,128,85489.33333333333,15580,25006
SUBSCRIBERS,8,512,23905.0,19804,25398
MSG_SUBSCRIBERS,1,2,8783538.333333334,10371,25615
MSG_SUBSCRIBERS,1,8,2249592.6666666665,10377,25615
MSG_SUBSCRIBERS,1,32,610168.0,10401,25675
MSG_SUBSCRIBERS,1,128,207295.0,10753,25755
MSG_SUBSCRIBERS,1,512,143584.66666666666,12289,26147
MSG_SUBSCRIBERS,4,2,5787699.0,12318,26126
MSG_SUBSCRIBERS,4,8,1473907.0,12324,26126
MSG_SUBSCRIBERS,4,32,396127.6666666667,12348,26186
MSG_SUBSCRIBERS,4,128,126362.66666666667,12892,26266
MSG_SUBSCRIBERS,4,512,59040.666666666664,15580,26658
MSG_SUBSCRIBERS,8,2,5453999.333333333,14914,26610
MSG_SUBSCRIBERS,8,8,1356312.3333333333,14920,26650
MSG_SUBSCRIBERS,8,32,361368.3333333333,14944,26710
MSG_SUBSCRIBERS,8,128,113148.66666666667,15744,26790
MSG_SUBSCRIBERS,8,512,51218.333333333336,19968,27182

Source

출처

영어 원문에는 문단, 문서 지시문, 표, 코드, 코드 심벌, 경로를 그대로 보존했습니다.