1.. _acsip_s76s:
2
3AcSIP S76S
4##########
5
6========
7Overview
8========
9
10The `AcSIP S76S`_  is an SiP from AcSIP_ containing an `STMicro STM32L073RZ`_ MCU,
11a `Semtech SX1276`_ LoRaWAN transceiver, and a +20 dBm power amplifier.  Refer to the
12`AcSIP S76S Product Information Brief`_ for details.  Further information is available
13from the `AcSIP Product Data Download`_ site (may need login). The parts are `available through TechShip`_.
14
15Zephyr applications may use the **acsip_s76s** configuration to use this SiP.
16
17.. figure:: img/acsip_s76s.jpg
18     :align: center
19     :alt: AcSIP S76S system on a chip, containing STMicro STM32L073RZ and Semtech SX1276
20
21     AcSIP S76S
22
23================
24Device Resources
25================
26
27The embedded `STMicro STM32L073RZ`_ has some GPIOs and SPI2 internally committed to the LoRaWAN
28transceiver operation.  See `internally committed table`_ for a list of resources committed to this function.
29
30As a result, some functions, ports and features of the `STMicro STM32L073RZ`_ are not available.
31See `unavailable table`_ for a list of resources not available due to a lack of pin-out.
32
33Available pinned-out resources are listed in `this table`_.  The actual `S76S pinout table`_ is below.
34
35These tables are STM32L07x generic - some pinned-out resources may be unavailable due to limitations
36on the `STMicro STM32L073RZ`_ processor itself.  Consult with the `STMicro STM32L073RZ`_ documentation.
37
38===========
39Development
40===========
41
42The Ronoth_ LoDev_ board is an open source development board, see its board description files.
43
44=========
45Debugging
46=========
47
48Programming and debugging uses the SWD port, as on any STM32 processor.  An ST-LINK/V2 adapter
49may be used with the appropriate software (*st-utils* package on Linux).
50
51.. _S76S pinout table:
52
53==================================
54Pin Assignments and Available Pins
55==================================
56
57-------------------
58S76S Pin Assignment
59-------------------
60
61=== ================ === ================
62Pin Function         Pin Function
63=== ================ === ================
641   NC               32  GND
652   GND              33  RF_ANT
663   GND              34  GND
674   PC1              35  GND
685   PC2              36  PA1\_RF\_FEM_CPS
696   PC3              37  GND
707   NC               38  NC
718   NC               39  GND
729   NC               40  NC
7310  NC               41  GND
7411  NC               42  NC
7512  nReset           43  VDD
7613  PA0              44  VDD
7714  GND              45  PA8\_USART1\_CK
7815  GND              46  PA10\_USART1\_RX
7916  PA2\_TxD\_A      47  PA9\_USART1\_TX
8017  PA3\_RxD\_A      48  PA11\_USART1\_CTS
8118  PA4\_SPI1\_NSS   49  PA12\_USART1\_RTS
8219  PA5\_SPI1\_SCK   50  PA13_SWDIO
8320  PA6\_SPI1\_MISO  51  PA14_SWCLK
8421  PA7\_SPI1\_MOSI  52  PC10
8522  PC4              53  PC11
8623  PC5              54  PC12
8724  PB0\_IO\_INT1    55  PD2
8825  PB1\_IO\_INT2    56  PB5
8926  PC6              57  PB6_SCL
9027  PC7              58  PB7_SDA
9128  PC8              59  BOOT0
9229  PC9              60  PB8\_IO\_LED_FCT
9330  RXTX/RFMOD       61  GND
9431  GND              62  GND
95=== ================ === ================
96
97.. _this table:
98
99--------------------------------
100Ports Connected to External Pins
101--------------------------------
102
103======== ======== ============= ==== ========================================================================================================== =======================================
104Pin name Pin Type I/O Structure Note Alternate functions                                                                                        Additional functions
105======== ======== ============= ==== ========================================================================================================== =======================================
106BOOT0    I                      -    -                                                                                                          -
107NRST     I/O      -             -    -                                                                                                          -
108PA0      I/O      TC            -    TIM2_CH1, TSC_G1_IO1, USART2_CTS, TIM2_ETR, USART4_TX, COMP1_OUT                                           COMP1_INM, ADC_IN0, RTC_TAMP2/WKUP1
109PA1      I/O      FT            -    EVENTOUT, LCD_SEG0, TIM2_CH2, TSC_G1_IO2, USART2_RTS/USART2_DE, TIM21_ETR, USART4_RX                       COMP1_INP, ADC_IN1
110PA2      I/O      FT            -    TIM21_CH1, LCD_SEG1, TIM2_CH3, TSC_G1_IO3, USART2_TX, LPUART1_TX, COMP2_OUT                                COMP2_INM, ADC_IN2
111PA3      I/O      FT            -    TIM21_CH2, LCD_SEG2, TIM2_CH4, TSC_G1_IO4, USART2_RX, LPUART1_RX                                           COMP2_INP, ADC_IN3
112PA4      I/O      TC            (1)  SPI1_NSS, TSC_G2_IO1, USART2_CK, TIM22_ETR                                                                 COMP1_INM, COMP2_INM, ADC_IN4, DAC_OUT1
113PA5      I/O      TC            -    SPI1_SCK, TIM2_ETR, TSC_G2_IO2, TIM2_CH1                                                                   COMP1_INM, COMP2_INM, ADC_IN5, DAC_OUT2
114PA6      I/O      FT            -    SPI1_MISO, LCD_SEG3, TIM3_CH1, TSC_G2_IO3, LPUART1_CTS, TIM22_CH1, EVENTOUT, COMP1_OUT                     ADC_IN6
115PA7      I/O      FT            -    SPI1_MOSI, LCD_SEG4, TIM3_CH2, TSC_G2_IO4, TIM22_CH2, EVENTOUT, COMP2_OUT                                  ADC_IN7
116PA8      I/O      FTf           -    MCO, LCD_COM0, USB_CRS_SYNC, EVENTOUT, USART1_CK, I2C3_SCL                                                 -
117PA9      I/O      FTf           -    MCO, LCD_COM1, TSC_G4_IO1, USART1_TX, I2C1_SCL, I2C3_SMBA                                                  -
118PA10     I/O      FTf           -    LCD_COM2, TSC_G4_IO2, USART1_RX, I2C1_SDA                                                                  -
119PA11     I/O      FT            (2)  SPI1_MISO, EVENTOUT, TSC_G4_IO3, USART1_CTS, COMP1_OUT                                                     USB_DM
120PA12     I/O      FT            (2)  SPI1_MOSI, EVENTOUT, TSC_G4_IO4, USART1_RTS/USART1_DE, COMP2_OUT                                           USB_DP
121PA13     I/O      FT            -    SWDIO, USB_NOE, LPUART1_RX                                                                                 -
122PA14     I/O      FT            -    SWCLK, USART2_TX, LPUART1_TX                                                                               -
123PB0      I/O      FT            -    EVENTOUT, LCD_SEG5, TIM3_CH3, TSC_G3_IO2                                                                   LCD_VLCD3, ADC_IN8, VREF_OUT
124PB1      I/O      FT            -    LCD_SEG6, TIM3_CH4, TSC_G3_IO3, LPUART1_RTS/LPUART1_DE                                                     ADC_IN9, VREF_OUT
125PB5      I/O      FT            -    SPI1_MOSI, LCD_SEG9, LPTIM1_IN1, I2C1_SMBA, TIM3_CH2/TIM22_CH2, USART1_CK, USART5_CK, USART5_RTS/USART5_DE COMP2_INP
126PB6      I/O      FTf           -    USART1_TX, I2C1_SCL, LPTIM1_ETR, TSC_G5_IO3                                                                COMP2_INP
127PB7      I/O      FTf           -    USART1_RX, I2C1_SDA, LPTIM1_IN2, TSC_G5_IO4, USART4_CTS                                                    COMP2_INP, PVD_IN
128PB8      I/O      FTf           -    LCD_SEG16, TSC_SYNC, I2C1_SCL                                                                              -
129PC1      I/O      FTf           -    LPTIM1_OUT, LCD_SEG19, EVENTOUT, TSC_G7_IO2, LPUART1_TX, I2C3_SDA                                          ADC_IN11
130PC2      I/O      FTf           -    LPTIM1_IN2, LCD_SEG20, SPI2_MISO/I2S2_MCK, TSC_G7_IO3                                                      ADC_IN12
131PC3      I/O      FT            -    LPTIM1_ETR, LCD_SEG21, SPI2_MOSI/I2S2_SD, TSC_G7_IO4                                                       ADC_IN13
132PC4      I/O      FT            -    EVENTOUT, LCD_SEG22, LPUART1_TX                                                                            ADC_IN14
133PC5      I/O      FT            -    LCD_SEG23, LPUART1_RX, TSC_G3_IO1                                                                          ADC_IN15
134PC6      I/O      FT            -    TIM22_CH1, LCD_SEG24, TIM3_CH1, TSC_G8_IO1                                                                 -
135PC7      I/O      FT            -    TIM22_CH2, LCD_SEG25, TIM3_CH2, TSC_G8_IO2                                                                 -
136PC8      I/O      FT            -    TIM22_ETR, LCD_SEG26, TIM3_CH3, TSC_G8_IO3                                                                 -
137PC9      I/O      FTf           -    TIM21_ETR, LCD_SEG27, USB_NOE/TIM3_CH4, TSC_G8_IO4, I2C3_SDA                                               -
138PC10     I/O      FT            -    LPUART1_TX, LCD_COM4/LCD_SEG2 8/LCD_SEG48, USART4_TX                                                       -
139PC11     I/O      FT            -    LPUART1_RX, LCD_COM5/LCD_SEG2 9/LCD_SEG49, USART4_RX                                                       -
140PC12     I/O      FT            -    LCD_COM6/LCD_SEG3 0/LCD_SEG50, USART5_TX, USART4_CK                                                        -
141PD2      I/O      FT            -    LPUART1_RTS/LPUART1_DE, LCD_COM7/LCD_SEG3 1/LCD_SEG51, TIM3_ETR, USART5_RX                                 -
142======== ======== ============= ==== ========================================================================================================== =======================================
143
144Notes:
145
1461. PA4 offers a reduced touch sensing sensitivity. It is thus recommended to use it as sampling capacitor I/O.
1472. These pins are powered by VDD_USB. For all characteristics that refer to VDD, VDD_USB must be used instead.
148
149.. _internally committed table:
150
151--------------------------
152Internally Dedicated Ports
153--------------------------
154
155======== ======== ============= ==== =========================
156Pin name Pin Type I/O Structure Note Function
157======== ======== ============= ==== =========================
158PA15     I/O      FT            -    INTERNAL SX1276 D5
159PB3      I/O      FTf           -    INTERNAL SX1276 D4
160PB4      I/O      FTf           -    INTERNAL SX1276 D3
161PB9      I/O      FTf           -    INTERNAL SX1276 D2
162PB10     I/O      FT            -    INTERNAL SX1276 Reset
163PB11     I/O      FT            -    INTERNAL SX1276 D0
164PB12     I/O      FT            -    INTERNAL SX1276 SPI nCS
165PB13     I/O      FTf           -    INTERNAL SX1276 SPI2_SCK
166PB14     I/O      FTf           -    INTERNAL SX1276 SPI2_MISO
167PB15     I/O      FT            -    INTERNAL SX1276 SPI2_MOSI
168PC13     I/O      FT            -    INTERNAL SX1276 D1
169======== ======== ============= ==== =========================
170
171.. _unavailable table:
172
173-----------------------------------
174Ports Not Available / Not Connected
175-----------------------------------
176
177====================== ======== ============= ==== ================================================================= ====================
178Pin name               Pin Type I/O Structure Note Alternate functions                                               Additional functions
179====================== ======== ============= ==== ================================================================= ====================
180PC0                    I/O      FTf           -    LPTIM1_IN1, LCD_SEG18, EVENTOUT, TSC_G7_IO1, LPUART1_RX, I2C3_SCL ADC_IN10
181PC14- OSC32_IN (PC14)  I/O      FT            -    -                                                                 OSC32_IN
182PC15- OSC32_OUT (PC15) I/O      TC            -    -                                                                 OSC32_OUT
183PD0                    I/O      FT            -    TIM21_CH1, SPI2_NSS/I2S2_WS                                       -
184PD1                    I/O      FT            -    SPI2_SCK/I2S2_CK                                                  -
185PD3                    I/O      FT            -    USART2_CTS, LCD_SEG44, SPI2_MISO/I2S2_MCK                         -
186PD4                    I/O      FT            -    USART2_RTS/USART2_DE, SPI2_MOSI/I2S2_SD                           -
187PD5                    I/O      FT            -    USART2_TX                                                         -
188PD6                    I/O      FT            -    USART2_RX                                                         -
189PD7                    I/O      FT            -    USART2_CK, TIM21_CH2                                              -
190PD8                    I/O      FT            -    LPUART1_TX, LCD_SEG28                                             -
191PD9                    I/O      FT            -    LPUART1_RX, LCD_SEG29                                             -
192PD10                   I/O      FT            -    LCD_SEG30                                                         -
193PD11                   I/O      FT            -    LPUART1_CTS, LCD_SEG31                                            -
194PD12                   I/O      FT            -    LPUART1_RTS/LPUART1_DE, LCD_SEG32                                 -
195PD13                   I/O      FT            -    LCD_SEG33                                                         -
196PD14                   I/O      FT            -    LCD_SEG34                                                         -
197PD15                   I/O      FT            -    USB_CRS_SYNC, LCD_SEG35                                           -
198PE0                    I/O      FT            -    LCD_SEG36, EVENTOUT                                               -
199PE1                    I/O      FT            -    LCD_SEG37, EVENTOUT                                               -
200PE2                    I/O      FT            -    LCD_SEG38, TIM3_ETR                                               -
201PE3                    I/O      FT            -    TIM22_CH1, LCD_SEG39, TIM3_CH1                                    -
202PE4                    I/O      FT            -    TIM22_CH2, TIM3_CH2                                               -
203PE5                    I/O      FT            -    TIM21_CH1, TIM3_CH3                                               -
204PE6                    I/O      FT            -    TIM21_CH2, TIM3_CH4                                               RTC_TAMP3/WKUP3
205PE7                    I/O      FT            -    LCD_SEG45, USART5_CK/USART5_RTS/USART5_DE                         -
206PE8                    I/O      FT            -    LCD_SEG46, USART4_TX                                              -
207PE9                    I/O      FT            -    TIM2_CH1, LCD_SEG47, TIM2_ETR, USART4_RX                          -
208PE10                   I/O      FT            -    TIM2_CH2, LCD_SEG40, USART5_TX                                    -
209PE11                   I/O      FT            -    TIM2_CH3, USART5_RX                                               LCD_VLCD1
210PE12                   I/O      FT            -    TIM2_CH4, SPI1_NSS                                                LCD_VLCD3
211PE13                   I/O      FT            -    LCD_SEG41, SPI1_SCK                                               -
212PE14                   I/O      FT            -    LCD_SEG42, SPI1_MISO                                              -
213PE15                   I/O      FT            -    LCD_SEG43, SPI1_MOSI                                              -
214PH0-OSC_IN (PH0)       I/O      TC            -    USB_CRS_SYNC                                                      OSC_IN
215PH1- OSC_OUT (PH1)     I/O      TC            -    -                                                                 OSC_OUT
216PH9                    I/O      FT            -    -                                                                 -
217PH10                   I/O      FT            -    -                                                                 -
218VDD_USB                S                      -    -                                                                 -
219VDDA                   S        -             -    -                                                                 -
220VLCD                   S                      -    -
221VREF-                  S        -             -    -                                                                 -
222VREF+                  S        -             -    -                                                                 -
223VSSA                   S        -             -    -                                                                 -
224====================== ======== ============= ==== ================================================================= ====================
225
226==========
227References
228==========
229
230.. _AcSIP: http://www.acsip.com.tw
231
232.. _AcSIP S76S: http://www.acsip.com.tw/index.php?action=products-detail&fid1=11&fid2=29&fid3=27&id=79&lang=3
233
234.. _AcSIP S76S Product Information Brief: https://www.acsip.com.tw/index.php?action=download_pro&perm=d&id=365
235
236.. _AcSIP Product Data Download: http://www.acsip.com.tw/index.php?action=technical
237
238.. _available through TechShip: https://techship.com/products/acsip-lorawan-module-s76s/
239
240.. _Ronoth: https://ronoth.com/
241
242.. _LoDev: https://ronoth.com/products/lodev-s76s-lora-soc-development-board?variant=31608819417220
243
244.. _STMicro STM32L073RZ: https://www.st.com/en/microcontrollers-microprocessors/stm32l073rz.html
245
246.. _Semtech SX1276: https://www.semtech.com/products/wireless-rf/lora-transceivers/sx1276
247
248=======
249License
250=======
251
252This document Copyright (c) 2021 Dean Weiten <dmw@weiten.com>
253
254SPDX-License-Identifier: Apache-2.0
255