Microserver is a modular embedded server built for TinyCLR OS IoT devices. Be sure to follow this project on our YouTube channel.
Build modular tcp/udp service with an extendable pipeline and SSL transport security.
Create a modular web services including middleware, moduler routing, digest authentication, controllers, action results, view engine, storage / resource file serving, default file routing, JSON integration, and websockets.
- HTTP Server
- Diagnostics
- Authentication
- Cookie Support
- Static File Handling
- Model-View-Controllers (MVC)
- JavaScript Object Notation (JSON)
- Cross-origin Resource Sharing (CORS)
This repo contains several runtime libraries built for TinyCLR OS. These libraries provide implementations for logging, middleware and dependency injection.
Install release package from NuGet. Preview packages are available as attached artifacts on successful build workflow.
Software: Visual Studio 2019 and GHI Electronics TinyCLR OS 2.1 or higher.
Hardware: Project tested using FEZ Portal single board computers and SCD-20260D development board.
External RAM: Devices with external RAM have the option of extending managed heap into unsecure external memory. TinyCLR Config can be used to extend the heap into external SDRAM increasing performance for simultaneous sessions. Please note this feature provides a large amount of managed heap space but data is stored outside of the microcontroller chip where it's less secure.
If you like or are using this project to start your solution, please give it a star. Thanks!
We encourage you to play with the samples and test programs. See the working Samples for an example of how to use packages. The Playground also includes many working examples.
using Bytewizer.TinyCLR.Http;
static void Main()
{
//Initialize networking
var server = new HttpServer(options =>
{
options.Pipeline(app =>
{
app.UseRouting();
app.UseEndpoints(endpoints =>
{
endpoints.Map("/", context =>
{
string response = "<doctype !html><html><head><title>Hello, world!" +
"</title><meta http-equiv='refresh' content='5'></head><body>" +
"<h1>" + DateTime.Now.Ticks.ToString() + "</h1></body></html>";
context.Response.Write(response);
});
});
});
});
server.Start();
}// Url: http://{ip:port}/example/GetById?id=10
static void Main()
{
//Initialize networking and sd storage
var server = new HttpServer(options =>
{
options.Pipeline(app =>
{
app.UseRouting();
app.UseEndpoints(endpoints =>
{
endpoints.MapControllers();
});
});
});
server.Start();
}
// Page url is automatically created from the controller name and action method.
public class ExampleController : Controller
{
public override void OnActionExecuting(ActionExecutingContext filterContext)
{
// called before action method
if (filterContext.HttpContext.Request.Method != HttpMethods.Get)
{
filterContext.Result = new BadRequestResult();
}
}
public override void OnActionExecuted(ActionExecutedContext filterContext)
{
// called after action method
}
public override void OnException(ExceptionContext filterContext)
{
// called on action method execption
var actionName = ControllerContext.ActionDescriptor.DisplayName;
filterContext.ExceptionHandled = true;
filterContext.Result = new ContentResult($"An error occurred in the {actionName} action.")
{
ContentType = "text/plain",
StatusCode = StatusCodes.Status500InternalServerError
};
}
// Any public IActionResult method inherited from Controller is made available as an endpoint
public IActionResult GetById(long id)
{
string response = "<doctype !html><html><head><title>Hello, world!</title>" +
"<style>body { background-color: #111 }" +
"h1 { font-size:3cm; text-align: center; color: white;}</style></head>" +
"<body><h1>" + $"{id}" + "</h1></body></html>";
return Content(response, "text/html");
}
}master :: This is the branch containing the latest release build. No contributions should be made directly to this branch. The development branch will periodically be merged to the master branch, and be released to NuGet.
develop :: This is the development branch to which contributions should be proposed by contributors as pull requests. Development build packages are available as attached artifacts on successful build workflows.
Have a look here if your looking for the original MicroServer built for Microsoft .NET Micro Framework (NETMF).
Contributions to this project are always welcome. Please consider forking this project on GitHub and sending a pull request to get your improvements added to the original project.
All source, documentation, instructions and products of this project are provided as-is without warranty. No liability is accepted for any damages, data loss or costs incurred by its use.