From dc6ed73d73d546c1cc65c9752e4d605789d5c5fb Mon Sep 17 00:00:00 2001 From: Andreas Schmidberger <83550429+OE3ANC@users.noreply.github.com> Date: Sat, 9 Aug 2025 09:27:59 +0200 Subject: [PATCH] Added image, flashing and driver docs --- README.md | 38 +++++++++++++++++++++++++++++--------- 1 file changed, 29 insertions(+), 9 deletions(-) diff --git a/README.md b/README.md index cdc65da..9e275ec 100644 --- a/README.md +++ b/README.md @@ -25,15 +25,7 @@ The device uses an [MCM-iMX93](https://www.compulab.com/products/computer-on-mod * 500kHz bandwidth complete IQ transceiver ## Software -Developers can use C/C++/Python as well as (or in conjunction with) GNU Radio flowgraphs. Tools such as gcc are built-in. The experimental Linux image is available [here](https://m17project.org/linht/). - -Instructions for setting up the Yocto build environment can be found in the [M17 Wiki](https://wiki.m17foundation.org/index.php?title=LinHT_Image_Build). - -All layers required to build the image are located in the M17 Project GitHub: - -- [meta-linht-hardware](https://github.com/M17-Project/meta-linht-hardware): Provides machine configuration and hardware support for the LinHT hardware. -- [meta-linht-software](https://github.com/M17-Project/meta-linht-software): Provides application software, libraries, and system configuration for digital radio communication and M17 protocol support. -- [meta-linht-sdr](https://github.com/M17-Project/meta-linht-sdr): A modified version of [meta-sdr](https://github.com/balister/meta-sdr), providing the GNU Radio package. +Developers can use C/C++/Python as well as (or in conjunction with) GNU Radio flowgraphs. Tools such as gcc are built-in. ### Supported modes (so far): @@ -45,6 +37,34 @@ All layers required to build the image are located in the M17 Project GitHub: Other modes can be added later (FreeDV, APRS, etc.). +## Images + +### Download images + +Prebuilt images for LinHT can be downloaded [here](https://m17project.org/linht/). + +### Building images + +Instructions for setting up the Yocto build environment can be found in the [M17 Wiki](https://wiki.m17foundation.org/index.php?title=LinHT_Image_Build). +All layers required to build the image are located in the M17 Project GitHub: + +- [meta-linht-hardware](https://github.com/M17-Project/meta-linht-hardware): Provides machine configuration and hardware support for the LinHT hardware. +- [meta-linht-software](https://github.com/M17-Project/meta-linht-software): Provides application software, libraries, and system configuration. +- [meta-linht-sdr](https://github.com/M17-Project/meta-linht-sdr): A modified version of [meta-sdr](https://github.com/balister/meta-sdr), providing the GNU Radio package. + +### Flashing + +To flash the images to LinHT the [Universal Update Utility](https://github.com/nxp-imx/mfgtools/releases) is needed. +LinHT needs to be booted into flash mode (holding the secondary side button while booting). +Once in flash mode, the image can be written with uuu: +```bash +uuu -v -b emmc_all imx-boot-mcm-imx93-sd.bin-flash_singleboot linht-image-mcm-imx93.rootfs.wic.zst +``` + +## Driver + +To access LinHTs network device under windows, [RNDIS driver](https://www.catalog.update.microsoft.com/Search.aspx?q=USB%20RNDIS%20Gadget) need to be installed. + ## License This work is licensed under a [Creative Commons Attribution-NonCommercial-ShareAlike 4.0 International License][cc-by-nc-sa].