Skip to content

Commit dcaba7b

Browse files
zafersnzafersn
committed
boards: shields: add swir_hl78xx_ev kit
add support for HL78xx driver Signed-off-by: Zafer SEN <zafersn93@gmail.com>
1 parent 5c443de commit dcaba7b

File tree

6 files changed

+164
-0
lines changed

6 files changed

+164
-0
lines changed

‎boards/shields/swir_hl78xx_ev_kit/Kconfig.shield

Lines changed: 5 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,5 @@
1+
# Copyright (c) 2025 Netfeasa Ltd.
2+
# SPDX-License-Identifier: Apache-2.0
3+
4+
config SHIELD_SWIR_HL78XX_EV_KIT
5+
def_bool $(shields_list_contains,swir_hl78xx_ev_kit)

‎boards/shields/swir_hl78xx_ev_kit/doc/img/SW-Dev-RC76.3.webp

98.3 KB
Binary file not shown.

‎boards/shields/swir_hl78xx_ev_kit/doc/index.rst

Lines changed: 79 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,79 @@
1+
.. _swir_hl78xx_ev_kit:
2+
3+
HL/RC Module Evaluation Kit Shield
4+
##################################
5+
6+
Overview
7+
********
8+
9+
Welcome to the HL78 module getting started guide.
10+
This guide will help you set up the evaluation kit (eval kit)
11+
for sending AT commands to the HL78 module and initiating data transmission.
12+
13+
.. figure:: img/SW-Dev-RC76.3.webp
14+
:align: center
15+
:alt: HL/RC Module Evaluation Kit Shield Shield
16+
17+
HL/RC Module Evaluation Kit Shield Shield (Credit: Sierrra Wireless)
18+
19+
More information about the shield can be found at the `HL/RC Module Evaluation Kit Shield guide website`_.
20+
21+
Pins Assignment of HL/RC Module Evaluation Kit Shield Shield
22+
============================================================
23+
+--------------------------+----------------------------------------------------------+
24+
| Shield Connector Pin | Function |
25+
+==========================+==========================================================+
26+
| CN403 alias | UART 1 (with CTS and RTS pins) |
27+
+--------------------------+----------------------------------------------------------+
28+
| CN303 alias | SPI / UART 3 |
29+
+--------------------------+----------------------------------------------------------+
30+
| CN1000 alias | GPIO Test Pins |
31+
+--------------------------+----------------------------------------------------------+
32+
| GPIO6 CN1000_3 | LOW POWER MONITORING |
33+
+--------------------------+----------------------------------------------------------+
34+
| VGPIO alias | Indirect indicator of hibernate mode entry/exit |
35+
+--------------------------+----------------------------------------------------------+
36+
| RESET CN1000_12 | RESET SIGNAL |
37+
+--------------------------+----------------------------------------------------------+
38+
| WAKE-UP CN1000_8 | SPI / UART 3 |
39+
+--------------------------+----------------------------------------------------------+
40+
41+
Please refer to the website for more information about HL/RC Module Evaluation Kit Shield Shield setup.
42+
.. _HL/RC Module Evaluation Kit Shield guide website:
43+
44+
Checking Your Basic Configurations in PuTTY
45+
===========================================
46+
Before trying to set up a wired connection between the board and a host MCU,
47+
it's a good idea to first go through this list of basic AT commands over a
48+
USB COM port on a PC. For reference, you can find all the AT commands for the
49+
HL78xx modules in the Source.
50+
51+
Requirements
52+
************
53+
54+
This shield can be used with any boards which provides a configuration for
55+
header connectors and defines node aliases for UART, SPI and USB interfaces (see
56+
:ref:`shields` for more details).
57+
58+
Programming
59+
***********
60+
61+
Set ``--shield swir_hl78xx_ev_kit`` when you invoke ``west build``. For
62+
example:
63+
64+
.. zephyr-app-commands::
65+
:zephyr-app: samples/drivers/modem/hello_hl78xx
66+
:board: st/nucleo_u575zi_q
67+
:shield: swir_hl78xx_ev_kit
68+
:goals: build
69+
70+
References
71+
**********
72+
73+
.. target-notes::
74+
75+
.. _HL/RC Module Evaluation Kit Shield guide website:
76+
https://source.sierrawireless.com/resources/airprime/development_kits/hl78xx-hl7900-development-kit-guide/
77+
78+
.. _HL/RC Module Evaluation Kit Shield specification website:
79+
https://info.sierrawireless.com/iot-modules-evaluation-kit#guide-for-the-hl78-series-evaluation-kit

‎boards/shields/swir_hl78xx_ev_kit/swir_hl78xx_ev_kit.overlay

Lines changed: 34 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,34 @@
1+
/*
2+
* Copyright (c) 2025 Netfeasa Ltd.
3+
*
4+
* SPDX-License-Identifier: Apache-2.0
5+
*/
6+
7+
/ {
8+
aliases {
9+
modem-uart = &usart2;
10+
modem = &modem;
11+
};
12+
};
13+
14+
&usart2 {
15+
pinctrl-0 = <&usart2_tx_pa2 &usart2_rx_pa3 &usart2_rts_pd4 &usart2_cts_pd3 >;
16+
pinctrl-1 = <&analog_pa2 &analog_pa3 &analog_pd4 &analog_pd3 >;
17+
dmas = <&gpdma1 0 27 STM32_DMA_PERIPH_TX
18+
&gpdma1 1 26 STM32_DMA_PERIPH_RX>;
19+
dma-names = "tx", "rx";
20+
pinctrl-names = "default", "sleep";
21+
current-speed = <115200>;
22+
status = "okay";
23+
hw-flow-control;
24+
modem: hl_modem {
25+
compatible = "swir,hl7812";
26+
status = "okay";
27+
mdm-reset-gpios = <&gpiod 5 (GPIO_ACTIVE_LOW)>;
28+
mdm-wake-gpios = <&gpioe 15 (GPIO_ACTIVE_HIGH)>;
29+
mdm-vgpio-gpios = <&gpiob 2 0>;
30+
mdm-uart-cts-gpios = <&gpiod 3 0>;
31+
mdm-gpio6-gpios = <&gpioa 8 0>;
32+
};
33+
34+
};

‎dts/bindings/modem/swir,hl7812.yaml

Lines changed: 8 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,8 @@
1+
# Copyright (c) 2025, Netfeasa Ltd.
2+
# SPDX-License-Identifier: Apache-2.0
3+
4+
description: Sierra Wireless HL7812 Modem
5+
6+
compatible: "swir,hl7812"
7+
8+
include: swir,hl78xx.yaml

‎dts/bindings/modem/swir,hl78xx.yaml

Lines changed: 38 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,38 @@
1+
# Copyright (c) 2025, Netfeasa Ltd.
2+
# SPDX-License-Identifier: Apache-2.0
3+
4+
description: Sierra Wireless HL78XX Modem
5+
6+
compatible: "swir,hl78xx"
7+
8+
include:
9+
- uart-device.yaml
10+
11+
properties:
12+
mdm-wake-gpios:
13+
type: phandle-array
14+
required: true
15+
16+
mdm-reset-gpios:
17+
type: phandle-array
18+
required: true
19+
20+
mdm-pwr-on-gpios:
21+
type: phandle-array
22+
23+
mdm-fast-shutd-gpios:
24+
type: phandle-array
25+
26+
mdm-vgpio-gpios:
27+
type: phandle-array
28+
required: true
29+
30+
mdm-uart-dsr-gpios:
31+
type: phandle-array
32+
33+
mdm-uart-cts-gpios:
34+
type: phandle-array
35+
required: true
36+
37+
mdm-gpio6-gpios:
38+
type: phandle-array

0 commit comments

Comments
 (0)