services/modem/index.html · services/modem/index.rst 공식 원문 ↗

Zephyr 3.7.0 · OS Services · Modem

Modem Modules

Thread-safe pipe를 중심으로 physical modem, PPP framing과 여러 DLCI logical channel을 조합합니다.

Official pathservices/modem/index.html
Source fileservices/modem/index.rst
Source versionZephyr 3.7.0
TranslationFull · reviewed

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

Part 1

요약·해설

UART·CMUX backend abstraction, L2 PPP wrapping, 3GPP 27.010 multiplexing과 driver/application decoupling을 설명합니다.

Transport

modem_pipe

Network

PPP

Multiplex

CMUX DLCI

Part 2

접을 수 있는 영어 원문 전체

영어 원문 전체 펼치기
원문 SHA-256 ADC15B3309FA01846229AC26CFE2725C98958BFC3616BBCF788DC6F39005CC3F
.. _modem:

Modem modules
#############

This service provides modules necessary to communicate with modems.

Modems are self-contained devices that implement the hardware and
software necessary to perform RF (Radio-Frequency) communication,
including GNSS, Cellular, WiFi etc.

The modem modules are inter-connected dynamically using
data-in/data-out pipes making them independently testable and
highly flexible, ensuring stability and scalability.

Modem pipe
**********

This module is used to abstract data-in/data-out communication over
a variety of mechanisms, like UART and CMUX DLCI channels, in a
thread-safe manner.

A modem backend will internally contain an instance of a modem_pipe
structure, alongside any buffers and additional structures required
to abstract away its underlying mechanism.

The modem backend will return a pointer to its internal modem_pipe
structure when initialized, which will be used to interact with the
backend through the modem pipe API.

.. doxygengroup:: modem_pipe

Modem PPP
*********

This module defines and binds a L2 PPP network interface, described in
:ref:`net_l2_interface`, to a modem backend. The L2 PPP interface sends
and receives network packets. These network packets have to be wrapped
in PPP frames before being transported via a modem backend. This module
performs said wrapping.

.. doxygengroup:: modem_ppp

Modem CMUX
**********

This module is an implementation of CMUX following the 3GPP 27.010
specification. CMUX is a multiplexing protocol, allowing for multiple
bi-directional streams of data, called DLCI channels. The module
attaches to a single modem backend, exposing multiple modem backends,
each representing a DLCI channel.

.. doxygengroup:: modem_cmux

Modem pipelink
**************

This module is used to share modem pipes globally. This module aims to
decouple the creation and setup of modem pipes in device drivers from
the users of said pipes. See
:zephyr_file:`drivers/modem/modem_at_shell.c` and
:zephyr_file:`drivers/modem/modem_cellular.c` for examples of how to
use the modem pipelink between device driver and application.

.. doxygengroup:: modem_pipelink

Part 3

한국어 전문 번역

이 service는 modem과 통신하는 데 필요한 module을 제공합니다.

Modem은 GNSS, Cellular, Wi-Fi 같은 RF communication에 필요한 hardware와 software를 자체적으로 구현한 device입니다.

Modem module은 data-in/data-out pipe로 동적으로 연결됩니다. 각 module을 독립적으로 test할 수 있고 조합이 유연하므로 stability와 scalability를 높일 수 있습니다.

Modem pipe

Modem pipe는 UART와 CMUX DLCI channel 같은 여러 mechanism의 data-in/data-out communication을 thread-safe하게 추상화합니다.

Modem backend 내부에는 modem_pipe structure instance와 underlying mechanism을 감추는 데 필요한 buffer와 추가 structure가 들어 있습니다. Backend initialization이 끝나면 internal modem_pipe pointer를 반환하고, user는 modem pipe API로 backend와 상호작용합니다.

관련 API는 modem_pipe Doxygen group에 있습니다.

Modem PPP

이 module은 L2 PPP network interface를 modem backend에 정의하고 bind합니다. L2 PPP interface가 보내고 받는 network packet은 modem backend로 운반하기 전에 PPP frame으로 감싸야 하며 이 module이 wrapping을 수행합니다.

관련 API는 modem_ppp Doxygen group에 있습니다.

Modem CMUX

이 module은 3GPP 27.010 specification을 따르는 CMUX implementation입니다. CMUX는 DLCI channel이라 부르는 양방향 data stream 여러 개를 multiplex합니다. Physical modem backend 하나에 attach하고, DLCI channel마다 하나씩 여러 logical modem backend를 노출합니다.

관련 API는 modem_cmux Doxygen group에 있습니다.

Modem pipelink

Modem pipelink는 modem pipe를 global하게 공유합니다. Device driver에서 pipe를 생성·설정하는 code와 그 pipe를 사용하는 application을 분리하는 것이 목적입니다.

Device driver와 application 사이에서 pipelink를 사용하는 예는 drivers/modem/modem_at_shell.c와 drivers/modem/modem_cellular.c에서 확인할 수 있습니다. API는 modem_pipelink Doxygen group에 있습니다.

Source

출처

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