Skip to the content
2 layers85 × 60 mmAmemiya gateway, the printed circuit board in 3D

Amemiya gateway

Andre-Macedo/amemiya

Metrology System for Amemiya

Size
85 × 60 mm
Copper layers
2
Thickness
1.6 mm
Parts
31
Nets
47
Pads
115
Tracks, vias
224, 0
Pours
2
Routed
Yes
KiCad
KiCad 9.0 (file 20241229)
Created
9 Sep 2025
Updated
4 Nov 2026

Overview

Amemiya gateway is an open-source printed circuit board by Andre-Macedo, from the Andre-Macedo/amemiya repository on GitHub, published under the MIT licence. It is a 2-layer board of 85 × 60 mm with 31 parts on 47 nets, routed with 224 tracks and 0 vias.

It is built around the E220-900T22D and 470UF 25V. Its parts include 4 capacitors and 2 diodes. It belongs with the ESP32 boards of this library.

Main components

2

README

README.md

Sistema de Metrologia Lean Tech

Repositório do Sistema de Metrologia Lean Tech, uma aplicação web desenvolvida em Laravel e Filament para gestão de instrumentos de medição, calibrações e processos metrológicos, assegurando conformidade e rastreabilidade.


1. Objetivo

Este documento detalha o processo de configuração e execução do ambiente de desenvolvimento local da aplicação utilizando Docker. O objetivo é permitir que todos os membros da equipe, independentemente do nível técnico, possam executar e testar o sistema.


2. Pré-requisitos de Software

As seguintes ferramentas são necessárias para a configuração do ambiente de desenvolvimento:

  1. Git:

    • Descrição: Sistema de controle de versões distribuído, utilizado para clonar o repositório do projeto.
    • Instalação: Acessar git-scm.com/downloads e seguir as instruções específicas para o seu sistema operacional (Windows, macOS ou Linux). Para Windows, baixe o instalador e siga as opções padrão ("Next").
  2. Docker Desktop:

    • Descrição: Plataforma para desenvolvimento, envio e execução de aplicações em containers. Abstrai as dependências de sistema (PHP, Nginx, MySQL, etc.), encapsulando-as em ambientes isolados.
    • Instalação: Acessar www.docker.com/products/docker-desktop/ e seguir as instruções de instalação para o seu sistema operacional. Após a instalação, garantir que o Docker Desktop esteja em execução (verificar o ícone da baleia na bandeja do sistema).
  3. PhpStorm (Opcional - Recomendado para Desenvolvimento):

    • Descrição: Ambiente de Desenvolvimento Integrado (IDE) robusto para PHP, facilitando a edição de código, depuração e integração com ferramentas de desenvolvimento, incluindo um terminal integrado que usaremos.
    • Instalação: Acessar www.jetbrains.com/phpstorm/.
    • Licenciamento: Licenças educacionais gratuitas estão disponíveis para estudantes através do Programa Educacional da JetBrains.

3. Configuração do Projeto (Passo a Passo com PhpStorm)

Os passos seguintes detalham o processo para iniciar a aplicação utilizando o PhpStorm e Docker.

  1. Abrir o Projeto no PhpStorm:

    • Abra o PhpStorm.
    • Na tela de boas-vindas, clique em "Get from VCS".
    • No campo "URL", cole a URL do repositório Git do projeto.
    • Escolha a pasta no seu computador onde deseja salvar o projeto (campo "Directory").
    • Clique em "Clone". O PhpStorm fará o download do código.
  2. Criar Arquivo de Configuração (.env):

    • No painel "Project" do PhpStorm (geralmente à esquerda), localize o arquivo chamado .env.example.
    • Clique com o botão direito sobre ele e escolha "Copy".
    • Clique com o botão direito na raiz do projeto (a pasta principal listada no painel "Project") e escolha "Paste".
    • Na janela que aparecer, nomeie o novo arquivo como .env (apenas ponto-env) e clique "OK".
  3. Abrir o Terminal Integrado no PhpStorm:

    • Na barra inferior do PhpStorm, clique na aba "Terminal". Isso abrirá um painel de linha de comando já no diretório correto do projeto.
  4. Iniciar os Containers Docker:

    • No Terminal do PhpStorm, copie e cole o seguinte comando e pressione Enter:
      bash
      docker-compose up -d --build
    • Aguarde a conclusão. Na primeira vez, pode levar alguns minutos. Quando o prompt do terminal reaparecer, o processo estará concluído.
  5. Instalar Dependências PHP (via Terminal do PhpStorm):

    • Copie e cole o seguinte comando e pressione Enter:
      bash
      docker-compose exec app composer install
    • Aguarde a instalação das bibliotecas.
  6. Gerar Chave da Aplicação (via Terminal do PhpStorm):

    • Copie e cole o seguinte comando e pressione Enter:
      bash
      docker-compose exec app php artisan key:generate
  7. Preparar o Banco de Dados (via Terminal do PhpStorm):

    • Execute as migrações globais e dos módulos:
      bash
      docker-compose exec app php artisan migrate
      docker-compose exec app php artisan module:migrate Metrology
      docker-compose exec app php artisan module:migrate IoT
    • Execute os seeders de dados iniciais:
      bash
      docker-compose exec app php artisan module:seed Metrology
  8. Linkar Armazenamento (via Terminal do PhpStorm):

    • Copie e cole o seguinte comando e pressione Enter:
      bash
      docker-compose exec app php artisan storage:link

Configuração concluída! A aplicação está instalada e pronta para ser acessada.


4. Criação do Usuário Administrador (Via Filament)

O acesso ao painel de administração requer um usuário.

  1. No Terminal integrado do PhpStorm, execute o comando:
    bash
    docker-compose exec app php artisan make:filament-user
  2. Siga as instruções no terminal, fornecendo:
    • Name: Seu nome completo.
    • Email address: Seu endereço de e-mail.
    • Password: Uma senha segura (não será visível durante a digitação). Confirme a senha quando solicitado.
  3. Anote o e-mail e a senha que você criou.

5. Acesso aos Serviços

Abra seu navegador web:

  • Aplicação Principal (Painel Filament):

  • phpMyAdmin (Gerenciamento do Banco de Dados):

  • MailHog (Visualizador de E-mails de Teste):


6. Arquitetura Modular e Estrutura do Projeto

Este projeto adota uma arquitetura modular (nwidart/laravel-modules). A funcionalidade está organizada em módulos independentes com baixo acoplamento:

  • Modules/Metrology/: Módulo metrológico completo. Gestão de calibrações, instrumentos, padrões de referência RBC, cálculo de incerteza (GUM), cartas de controle de Shewhart (ILAC-G24), laudos de impacto e integridade forense criptográfica (ISO 17025 / FDA 21 CFR Part 11).
  • Modules/IoT/: Monitoramento contínuo em tempo real. Ponte MQTT Mosquitto, telemetria de vibração e temperatura, classificação de severidade ISO 20816-3 e microserviço de inteligência artificial (XGBoost).
  • Modules/System/: Multi-tenancy central, perfis e permissões via Filament Shield, auditoria de acessos e usuários.
  • hardware/: Projetos de eletrônica e mecânica. Esquemáticos KiCad modulares, placas de circuito impresso (Main Node, Gateway LoRa, Torre de Sensores), arquivos de fabricação e modelos 3D CAD/STEP para montagem de bancadas industriais (NR-12).

7. Parar o Ambiente Docker

Quando terminar de usar a aplicação, você pode parar os containers.

  • Opção 1 (via Terminal do PhpStorm):
    bash
    docker-compose down
  • Opção 2 (via Docker Desktop):
    1. Abra o Docker Desktop.
    2. Vá à seção "Containers".
    3. Localize o grupo de containers do projeto (terá o nome da pasta do projeto).
    4. Clique no botão "Stop" associado ao grupo.

(Para iniciar novamente, use docker-compose up -d no terminal ou o botão "Start" no Docker Desktop.)


8. Documentação Adicional

Para mais detalhes técnicos sobre as tecnologias utilizadas:


9. Resolução de Problemas Comuns (Troubleshooting)

  • Erro "port is already allocated" no docker-compose up: Outra aplicação está usando uma das portas (8000, 8080, 3307, etc.). Feche a aplicação conflitante ou pare outros projetos Docker. Tente docker-compose down e depois docker-compose up -d --build.
  • localhost:8000 não carrega ("Connection Refused"): Verifique no Docker Desktop se os containers amemiya-app e amemiya-nginx estão com status "Running" (verde). Se não, tente iniciá-los. Verifique os logs no Docker Desktop (clique no container > Logs).
  • Comandos docker-compose exec falham: Verifique se os containers estão realmente em execução (docker ps no terminal ou no Docker Desktop).

Para outros problemas, por favor, reporte à equipe de desenvolvimento.

Parts

31
QtyValueFootprintReferences
4MountingHole_M3MountingHole_3.2mm_M3_PadH1, H2, H3, H4
3100nFC_Disc_D3.8mm_W2.6mm_P2.50mmC2, C3, C4
3330R_Axial_DIN0207_L6.3mm_D2.5mm_P7.62mm_HorizontalR_LORA, R_MQTT, R_NET
21N5819D_DO-41_SOD81_P10.16mm_HorizontalD1, D2
24.7kR_Axial_DIN0207_L6.3mm_D2.5mm_P7.62mm_HorizontalR_SCL, R_SDA
110kR_Axial_DIN0207_L6.3mm_D2.5mm_P7.62mm_HorizontalR_M0
11kR_Axial_DIN0207_L6.3mm_D2.5mm_P7.62mm_HorizontalR_PWR
1470uF_25VCP_Radial_D6.3mm_P2.50mmC1
1Amarelo_3mmLED_D3.0mmD_MQTT
1Azul_3mmLED_D3.0mmD_LORA
1Botao_ConfigSW_PUSH_6mm_H5mmSW_CFG
1Buzzer_5VBuzzer_12x9.5RM7.6BZ1
1Conn_USB_5V_AUXPinHeader_1x02_P2.54mm_VerticalJ_USB_PWR
1E220-900T22DPinHeader_1x07_P2.54mm_VerticalU_LORA
1ESP32-S3_LeftPinHeader_1x22_P2.54mm_VerticalU_ESP_L
1ESP32-S3_RightPinHeader_1x22_P2.54mm_VerticalU_ESP_R
1LED_PWR_VerdeLED_D3.0mmD_PWR
1MP1584EN_BuckPinHeader_1x04_P2.54mm_VerticalU_BUCK
1OLED_SSD1306PinHeader_1x04_P2.54mm_VerticalJ_OLED
1TerminalBlock_9-24VTerminalBlock_Phoenix_MKDS-1,5-2-5.08_1x02_P5.08mm_HorizontalJ_PWR_IN
1Verde_3mmLED_D3.0mmD_NET
1W5500_EthernetPinHeader_1x08_P2.54mm_VerticalJ_ETH

More from Andre-Macedo/amemiya

2
  • 2 layers90 × 65 mmAmemiya main node, the printed circuit board in 3D

    Amemiya main node

    Andre-Macedo/amemiya

    Metrology System for Amemiya

    19 partsMIT
  • 2 layers24 × 48 mmAmemiya probe tower, the printed circuit board in 3D

    Amemiya probe tower

    Andre-Macedo/amemiya

    Metrology System for Amemiya

    6 partsMIT

Similar boards

  • 2 layers24.5 × 145 mmRocketry circuit, the printed circuit board in 3D

    Rocketry circuit

    AdLunamUnizar/avionics

    Repositorio del departamento de electrónica del equipo de cohetería ALUnizar.

    24 parts
  • 2 layers90 × 100 mmLeitor, the printed circuit board in 3D

    Leitor

    TuliodeCastro/estacao_meteorologica

    Sistema de monitoramento climático com nó sensor completo (temperatura, pressão, umidade, velocidade e direção do vento, chuva e irradiância solar) e gateway LoRa, ambos baseados em ESP8266.

    20 partsMIT
  • 2 layers140 × 100 mmNeuromorphic retina encoder pcb pre 3d refresh, the printed circuit board in 3D

    Neuromorphic retina encoder pcb pre 3d refresh

    RyanHailey21/neuromorphic-retina-encoder-pcb

    Hardware-accelerated neuromorphic vision encoder and closed-loop motor reflex PCB system built around the Raspberry Pi RP2040 and a 16-neuron hardware Leaky Integrate-and-Fire (LIF) analog spiking neural network.

    166 parts
  • 2 layers52 × 57.5 mmArduCore, the printed circuit board in 3D

    ArduCore

    urjadoshi2024etc-creator/ArduCore-Custom-Arduino-Board

    My own Arduino-style development board built from scratch using a DIP ATmega328P and custom KiCad PCB.

    19 parts
  • 4 layers112 × 90 mmNova pcb v6, the printed circuit board in 3D

    Nova pcb v6

    Ace2932/Fennec

    This project is a heavily modified fork of the open-source NovaSM3 quadruped, redesigned to serve as a research platform for embodied AI.

    55 parts1MIT
  • 2 layers44.5 × 46.9 mmOSO SWAT B1-jig, the printed circuit board in 3D

    OSO SWAT B1-jig

    joeycastillo/Sensor-Watch

    A board replacement for the classic Casio F-91W wristwatch

    31 parts2.1k
  • 2 layers65 × 30 mmRgb to hdmi, the printed circuit board in 3D

    Rgb to hdmi

    hoglet67/RGBtoHDMI

    Bare-metal Raspberry Pi project that provides pixel-perfect sampling of Retro Computer RGB/YUV video and conversion to HDMI

    31 parts1kGPL-3.0

Questions

How big is the Amemiya gateway PCB?

It measures 85 × 60 mm and has 2 copper layers, 1.6 mm thick.

What parts does the Amemiya gateway use?

31 parts, built around the E220-900T22D and 470UF 25V. The full list of its parts is on this page, with links to each part's symbol and footprint where PCBKit's library has them.

Where can I download the Amemiya gateway KiCad files?

From the Andre-Macedo/amemiya repository on GitHub, at the commit this page was made from: the board is hardware/kicad/amemiya_gateway/amemiya_gateway.kicad_pcb and its schematic hardware/kicad/amemiya_gateway/amemiya_gateway.kicad_sch. PCBKit opens the board in the browser, with nothing to install.

Can I use the Amemiya gateway design in my own project?

Its repository publishes it under the MIT licence: you may reuse it on that licence's terms (keep the author's notice, and for a copyleft licence share your changes alike).