From 7c9566cfbcb3c1d1b0f87d142f32e3321a72cadf Mon Sep 17 00:00:00 2001 From: YunHorn Technology Date: Thu, 22 Sep 2022 17:32:23 +0800 Subject: [PATCH] updated readme --- readme.txt | 197 ++++++----------------------------------------------- 1 file changed, 19 insertions(+), 178 deletions(-) diff --git a/readme.txt b/readme.txt index ef36826..a1fd45a 100644 --- a/readme.txt +++ b/readme.txt @@ -1,3 +1,21 @@ +/** + ****************************************************************************** + * @file Vibration Sensor for Consumer Product Detection and Industry Level Machine Fault Analysis + * @author Yunhorn (r) Technology Limited Application Team * + * @brief Yunhorn (r) SmarToilets (r) Product configuration file. * + ****************************************************************************** + * @attention + * + * Copyright (c) 2022 Yunhorn Technology Limited. + * Copyright (c) 2022 Shenzhen Yunhorn Technology Co., Ltd. + * All rights reserved. + * + * This software is licensed under terms that can be found in the LICENSE file + * in the root directory of this software component. + * If no LICENSE file comes with this software, it is provided AS-IS. + * + ****************************************************************************** + */ ============ STM32WL 55 ======================================== BUT1_PIN PA.0 CN10 Pin nbr 1 [PC.13 CN7 Pin nbr 23] @@ -215,181 +233,4 @@ lorawan_conf.h /*#define REGION_RU864*/ =========================================================================================================== - - -/** - @page LoRaWAN_End_Node Readme file - - @verbatim - ****************************************************************************** - * @file Applications/LoRaWAN/LoRaWAN_End_Node/readme.txt - * @author MCD Application Team - * @brief This application is a simple demo application software of a LoRa - * modem connecting to Network server. Data sent can be checked on - * Network server for eg Loriot. Traces are displayed over UART - ****************************************************************************** - * - * Copyright (c) 2020-2021 STMicroelectronics. - * All rights reserved. - * - * This software is licensed under terms that can be found in the LICENSE file - * in the root directory of this software component. - * If no LICENSE file comes with this software, it is provided AS-IS. - * - ****************************************************************************** - @endverbatim - -@par Description - -This directory contains a set of source files that implements a LoRa application -device sending sensors data to LoRa Network server. -Data are sent periodically on timer event or on "user button 1" depending on the configuration. - -This application is targeting the STM32WLxx Nucleo board embedding the STM32WLxx. - ****************************************************************************** - -@par Keywords - -Applications, SubGHz_Phy, LoRaWAN, End_Node, SingleCore - -@par Directory contents - - - - LoRaWAN_End_Node/Core/Inc/adc.h This file contains all the function prototypes for - the adc.c file - - LoRaWAN_End_Node/Core/Inc/adc_if.h Header for ADC interface configuration - - LoRaWAN_End_Node/Core/Inc/dma.h This file contains all the function prototypes for - the dma.c file - - LoRaWAN_End_Node/Core/Inc/flash_if.h This file contains definitions for FLASH Interface functionalities. - - LoRaWAN_End_Node/Core/Inc/gpio.h This file contains all the function prototypes for - the gpio.c file - - LoRaWAN_End_Node/Core/Inc/main.h : Header for main.c file. - This file contains the common defines of the application. - - LoRaWAN_End_Node/Core/Inc/platform.h Header for General HW instances configuration - - LoRaWAN_End_Node/Core/Inc/rtc.h This file contains all the function prototypes for - the rtc.c file - - LoRaWAN_End_Node/Core/Inc/stm32wlxx_hal_conf.h HAL configuration file. - - LoRaWAN_End_Node/Core/Inc/stm32wlxx_it.h This file contains the headers of the interrupt handlers. - - LoRaWAN_End_Node/Core/Inc/stm32wlxx_nucleo_conf.h STM32WLxx_Nucleo board configuration file. - - LoRaWAN_End_Node/Core/Inc/stm32_lpm_if.h Header for Low Power Manager interface configuration - - LoRaWAN_End_Node/Core/Inc/subghz.h This file contains all the function prototypes for - the subghz.c file - - LoRaWAN_End_Node/Core/Inc/sys_app.h Function prototypes for sys_app.c file - - LoRaWAN_End_Node/Core/Inc/sys_conf.h Applicative configuration, e.g. : debug, trace, low power, sensors - - LoRaWAN_End_Node/Core/Inc/sys_debug.h Configuration of the debug.c instances - - LoRaWAN_End_Node/Core/Inc/sys_sensors.h Header for sensors application - - LoRaWAN_End_Node/Core/Inc/timer_if.h configuration of the timer_if.c instances - - LoRaWAN_End_Node/Core/Inc/usart.h This file contains all the function prototypes for - the usart.c file - - LoRaWAN_End_Node/Core/Inc/usart_if.h Header for USART interface configuration - - LoRaWAN_End_Node/Core/Inc/utilities_conf.h Header for configuration file to utilities - - LoRaWAN_End_Node/Core/Inc/utilities_def.h Definitions for modules requiring utilities - - LoRaWAN_End_Node/LoRaWAN/App/app_lorawan.h Header of application of the LRWAN Middleware - - LoRaWAN_End_Node/LoRaWAN/App/CayenneLpp.h Implements the Cayenne Low Power Protocol - - LoRaWAN_End_Node/LoRaWAN/App/Commissioning.h End-device commissioning parameters - - LoRaWAN_End_Node/LoRaWAN/App/lora_app.h Header of application of the LRWAN Middleware - - LoRaWAN_End_Node/LoRaWAN/App/lora_app_version.h Definition the version of the application - - LoRaWAN_End_Node/LoRaWAN/App/lora_info.h To give info to the application about LoRaWAN configuration - - LoRaWAN_End_Node/LoRaWAN/App/se-identity.h Secure Element identity and keys - - LoRaWAN_End_Node/LoRaWAN/Target/lorawan_conf.h Header for LoRaWAN middleware instances - - LoRaWAN_End_Node/LoRaWAN/Target/mw_log_conf.h Configure (enable/disable) traces for CM0 - - LoRaWAN_End_Node/LoRaWAN/Target/radio_board_if.h Header for Radio interface configuration - - LoRaWAN_End_Node/LoRaWAN/Target/radio_conf.h Header of Radio configuration - - LoRaWAN_End_Node/LoRaWAN/Target/systime.h Map middleware systime - - LoRaWAN_End_Node/LoRaWAN/Target/timer.h Wrapper to timer server - - - LoRaWAN_End_Node/Core/Src/adc.c This file provides code for the configuration - of the ADC instances. - - LoRaWAN_End_Node/Core/Src/adc_if.c Read status related to the chip (battery level, VREF, chip temperature) - - LoRaWAN_End_Node/Core/Src/dma.c This file provides code for the configuration - of all the requested memory to memory DMA transfers. - - LoRaWAN_End_Node/Core/Src/flash_if.c This file provides set of firmware functions to manage Flash - Interface functionalities. - - LoRaWAN_End_Node/Core/Src/gpio.c This file provides code for the configuration - of all used GPIO pins. - - LoRaWAN_End_Node/Core/Src/main.c : Main program body - - LoRaWAN_End_Node/Core/Src/rtc.c This file provides code for the configuration - of the RTC instances. - - LoRaWAN_End_Node/Core/Src/stm32wlxx_hal_msp.c This file provides code for the MSP Initialization - and de-Initialization codes. - - LoRaWAN_End_Node/Core/Src/stm32wlxx_it.c Interrupt Service Routines. - - LoRaWAN_End_Node/Core/Src/stm32_lpm_if.c Low layer function to enter/exit low power modes (stop, sleep) - - LoRaWAN_End_Node/Core/Src/subghz.c This file provides code for the configuration - of the SUBGHZ instances. - - LoRaWAN_End_Node/Core/Src/system_stm32wlxx.c CMSIS Cortex Device Peripheral Access Layer System Source File - - LoRaWAN_End_Node/Core/Src/sys_app.c Initializes HW and SW system entities (not related to the radio) - - LoRaWAN_End_Node/Core/Src/sys_debug.c Configure probes pins RealTime debugging and JTAG/SerialWires for LowPower - - LoRaWAN_End_Node/Core/Src/sys_sensors.c Manages the sensors on the application - - LoRaWAN_End_Node/Core/Src/timer_if.c Configure RTC Alarm, Tick and Calendar manager - - LoRaWAN_End_Node/Core/Src/usart.c This file provides code for the configuration - of the USART instances. - - LoRaWAN_End_Node/Core/Src/usart_if.c Configuration of UART driver interface for hyperterminal communication - - LoRaWAN_End_Node/LoRaWAN/App/app_lorawan.c Application of the LRWAN Middleware - - LoRaWAN_End_Node/LoRaWAN/App/CayenneLpp.c Implements the Cayenne Low Power Protocol - - LoRaWAN_End_Node/LoRaWAN/App/lora_app.c Application of the LRWAN Middleware - - LoRaWAN_End_Node/LoRaWAN/App/lora_info.c To give info to the application about LoRaWAN configuration - - LoRaWAN_End_Node/LoRaWAN/Target/radio_board_if.c This file provides an interface layer between MW and Radio Board - - LoRaWAN_End_Node/STM32CubeIDE/Application/User/Core/syscalls.c STM32CubeIDE Minimal System calls file - - LoRaWAN_End_Node/STM32CubeIDE/Application/User/Core/sysmem.c STM32CubeIDE System Memory calls file - - -@par Hardware and Software environment - - - This example runs on the STM32WLxx Nucleo board. - - - STM32WLxx Nucleo board Set-up - - Connect the Nucleo board to your PC with a USB cable type A to micro-B - to ST-LINK connector. - - Please ensure that the ST-LINK connector jumpers are fitted. - - - Configure the software via the configuration files: - - sys_conf.h, radio_conf.h, lorawan_conf.h, lora_app.c, lora_app.h, Commissioning.h, se-identity.h, mw_log_conf.h, main.h, etc - - Careful: - - the region and class chosen on LoRaWAN/App/lora_app.h shall be compatible with LoRaWAN/Target/lorawan_conf.h list - - -Set Up: - - -------------------------- V V -------------------------- - | LoRa Object | | | | LoRa Network | - | | | | | | - ComPort<--| |--| |--| |-->Web Server - | | | | - -------------------------- -------------------------- - -@par How to use it ? -In order to make the program work, you must do the following : - - Open your preferred toolchain - - Rebuild all files and load your image into target memory - - Run the example - - Open a Terminal, connected the LoRa Object - - UART Config = 115200, 8b, 1 stopbit, no parity, no flow control - -@par How to debug ? - - make sure the flag DEBUGGER_ENABLED to 1 in sys_conf.h - - simpler to define the flag LOW_POWER_DISABLE to 1 as well - - compile, download and attach - -@par How to use MX to modify some RF middleware and application settings - This example is compatible (with some problems/limitations) with STM32CubeMX - and the RF application and middleware configuration can be modified via GUI. Few warnings and guidelines: - - ioc file is provided in the project directory and can be opened with STM32CubeMX v6.5.0 or higher. - - warning: when regenerating with the provided ioc file, - the IDE projects are regenerated and paths to HAL and MWs files from STM32Cube/Repository location are erroneously added; to avoid that, - user shall uncheck the "Use Default Firmware Location" in the GUI "Project-Manager" panel - and shall replace "Firmware Relative Path" with the root directory of the STM32CubeWL firmware package (e.g. C:\myDir\STM32Cube_FW_WL_V1.2.0\); - problem will be fixed in next STM32CubeMX version. - - .extSettings file allows to add to the generated IDE projects additional files not generated natively by MX (e.g. BSP files). - - when regenerating on existing code and existing linker files: - - STM32CubeMX updates the existing project content and preserves linker files. - - STM32CubeMX does not update the USER CODE sections (lines between /* USER CODE BEGIN Xxx */ and /* USER CODE END Xxx */). - - when regenerating after copying only the ioc file in an empty directory: - - STM32CubeMX generates default project files and default linker files. (Please check original linker file from project directory) - - it is up to the user to to fill the USER CODE sections with his application code. - -@par How to use it with Azure ThreadX RTOS? - This example can be combined with Azure ThreadX RTOS via STM32CubeMX. The video tutorial: - "STM32WL - How to port an existing RF application on Azure ThreadX RTOS" - is available on https://www.youtube.com/playlist?list=PLnMKNibPkDnE2eaR-ZGM3ZJXadyQLtTpX - - *

© COPYRIGHT STMicroelectronics

- */ \ No newline at end of file +/* SmarToilets Products */ \ No newline at end of file