Guide for handling "module not found" issue. And add support for tested modules.

Author: Fan Lin

documentation/devices/linemb.md

@@ -8,7 +8,7 @@ Notice this is only tested with Ubuntu 22.04 for the host machine.
 Key steps:
 ```bash
 sudo 
-export MODDABLE=/workspaces/linfan/moddable
+export MODDABLE=[your moddalbe root folder]
 export PATH=$PATH:$MODDABLE/build/bin/lin/release
 cd $MODDABLE/build/makefiles/lin
 make
@@ -46,7 +46,8 @@ mcconfig -d -m -p linemb/x86_64
 The generated executable can be found at:
 `$MODDABLE/build/bin/linemb/x86_64/debug/helloworld/helloworld`
 
-## ARM(32-bit) example
+## Running on ARM devices
+### ARM(32-bit)
 ```bash
 cd $MODDABLE/examples/helloworld
 mcconfig -d -m -p linemb/armhf
@@ -55,7 +56,7 @@ mcconfig -d -m -p linemb/armhf
 The generated executable can be found at:
 `$MODDABLE/build/bin/linemb/armhf/debug/helloworld/helloworld`
 
-## ARM(64-bit) example
+### ARM(64-bit)
 ```bash
 cd $MODDABLE/examples/helloworld
 mcconfig -d -m -p linemb/arm64
@@ -64,6 +65,7 @@ mcconfig -d -m -p linemb/arm64
 The generated executable can be found at:
 `$MODDABLE/build/bin/linemb/arm64/debug/helloworld/helloworld`
 
+### Copy to device
 Find a way to copy this file to the target board (e.g., using scp):
 
 ```bash
@@ -78,6 +80,50 @@ Hello, world - sample
 instruments: 248,32768,2432,65504,1344,12288,0,2,1,0,0,0
 instruments: 248,32768,2432,65504,416,12288,0,2,1,0,0,0
 instruments: 248,32768,2432,65504,416,12288,0,2,1,0,0,0
+```
+
+# Fix "module unsupported" issue
+
+If you encounter an error like "XXX module unsupported" when using the linemb platform, it's because the module's `manifest.json` file doesn't specify a C language implementation for the linemb platform.
+
+The simplest solution is to copy the implementation from the "lin" platform. Follow these steps:
+
+1. Open the module's `manifest.json` file (e.g., `modules/files/file/manifest.json` for file module)
+2. Ensure the linemb platform configuration includes the module implementation, for example:
+
+```json
+"linemb": {
+    "modules": {
+        "*": "$(MODULES)/files/file/lin/*"
+    },
+    "config": {
+        "file": {
+            "root": "/tmp/"
+        }
+    }
+}
+```
+
+Please note that many modules for the `lin` platform (especially hardware-related ones) have not been thoroughly tested. It's recommended to enable modules according to your specific needs and perform adequate testing to ensure proper functionality.
+
+If you encounter issues with the `lin` platform implementation, a better approach is to create a linemb-specific implementation:
+
+1. Create a new folder for the linemb platform implementation (e.g., `modules/files/file/linemb/`)
+2. Implement the necessary C files specifically for the linemb platform
+3. Update the manifest.json to use this implementation:
+
+```json
+"linemb": {
+    "modules": {
+        "*": "$(MODULES)/files/file/linemb/*"
+    },
+    "config": {
+        "file": {
+            "root": "/tmp/"
+        }
+    }
+}
+```
 
+This approach allows you to create optimized implementations tailored to the linemb platform.
 
-```

examples/manifest_net.json

@@ -47,6 +47,7 @@
 		},	
 		"mac": {},
 		"lin": {},
+		"linemb": {},
 		"win": {},
 		"...": {
 			"error": "manifest_net - unsupported platform"

modules/files/file/manifest.json

@@ -69,6 +69,16 @@
 				}
 			}
 		},
+		"linemb": {
+			"modules": {
+				"*": "$(MODULES)/files/file/lin/*"
+			},
+			"config": {
+				"file": {
+					"root": "/tmp/"
+				}
+			}
+		},
 		"qca4020": {
 			"modules": {
 				"*": "$(MODULES)/files/file/qca4020/*"

modules/io/manifest.json

@@ -26,6 +26,9 @@
 		"lin": {
 			"include": "./manifests/lin/manifest.json"
 		},
+		"linemb": {
+			"include": "./manifests/lin/manifest.json"
+		},
 		"win": {
 			"include": "./manifests/win/manifest.json"
 		}

modules/network/ethernet/manifest.json

@@ -25,6 +25,9 @@
         "lin": {
             "include": "$(MODULES)/network/wifi/manifest.json"
         },
+        "linemb": {
+            "include": "$(MODULES)/network/wifi/manifest.json"
+        },
         "mac": {
             "include": "$(MODULES)/network/wifi/manifest.json"
         },

modules/network/net/manifest.json

@@ -45,6 +45,14 @@
 				]
 			}
 		},
+		"linemb": {
+			"modules": {
+				"*": [
+					"$(MODULES)/network/net/net",
+					"$(MODULES)/network/net/lin/*"
+				]
+			}
+		},
 		"mac": {
 			"modules": {
 				"*": [

modules/network/socket/manifest.json

@@ -40,6 +40,14 @@
 				]
 			}
 		},
+		"linemb": {
+			"modules": {
+				"*": [
+					"$(MODULES)/network/socket/*",
+					"$(MODULES)/network/socket/lin/*"
+				]
+			}
+		},
 		"mac": {
 			"modules": {
 				"*": [

modules/network/wifi/manifest.json

@@ -37,6 +37,13 @@
                 ]
             }
         },
+        "linemb": {
+            "modules": {
+                "*": [
+                    "$(MODULES)/network/wifi/sim/*"
+                ]
+            }
+        },
         "mac": {
             "modules": {
                 "*": [