Added image, flashing and driver docs

This commit is contained in:
Andreas Schmidberger 2025-08-09 09:27:59 +02:00
parent f784b5a8a6
commit dc6ed73d73

View file

@ -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].